重複するオーディエンス

重複するオーディエンスAPIを使用すると、選択したオーディエンスに類似し、かつキャンペーンでターゲットとしたい他のオーディエンスを特定できます。検出APIから返されたオーディエンスをインプットとして使用することで、重複するオーディエンスを生成できます。

たとえば、IDが1234567890のオーディエンスの重複するオーディエンスは、以下の通りに取得します。

GET /insights/audiences/1234567890/overlappingAudiences?adType=DSP&advertiserId=112233445566

APIは、選択したオーディエンスと重複しており、指定された条件を満たす上位30人のオーディエンスを返します。以下に、選択したオーディエンスと、上位3人の重複するオーディエンスのみを含むサンプルを示します。

HTTP/1.1 200 
{
  "requestedAudienceMetadata": {
     "audienceId": "0000000000",
     "name": "Example 1",
     "size": 0,
     "category": "Example Category 1",
     "impressionForecastRange": {
       "lowerBound": 000000000
    }
   },
   "overlappingAudiences": [
     {
       "audienceMetadata": {
         "audienceId": "0000000000",
         "name": "Example 2",
         "size": 0,
         "category": "Example Category 2",
         "impressionForecastRange": {
          "lowerBound": 00000000,
          "upperBound": 00000000        }
       },
       "affinity": 00.00
    },
     {
       "audienceMetadata": {
         "audienceId": "0000000000",
         "name": "Example 3",
         "size": 0,
         "category": "Example Category 3",
         "impressionForecastRange": { 
          "lowerBound": 000000000,
          "upperBound": 000000000
        }
       },
       "affinity": 00.00
    },
     {
       "audienceMetadata": {
         "audienceId": "0000000000",
         "name": "Example 4",
         "size": 0,
         "category": "Example Category 4",
         "impressionForecastRange": {
          "lowerBound": 000000000
        }
       },
       "affinity": 00.00
    }

フィルターを1つ以上使用して結果を絞り込みます。APIには、audienceCategory、minimumAudienceSize、maximumAudienceSize、minimumOverlapAffinity、maximumOverlapAffinityのフィルターが用意されています。

たとえば、以下のリクエストは、in-market audienceCategoryに属し、minimumOverlapAffinityが2である、上位30人の重複するオーディエンスを返します。

GET /insights/audiences/1234567890/overlappingAudiences?adType=DSP&advertiserId=112233445566&audienceCategory=In-market&minimumOverlapAffinity=2

開発者ガイドの概要

Amazon Ads APIの概要

重複するオーディエンス