开发人员指南概述

亚马逊广告 API 概览

Developer guides

API reference

重叠受众

重叠受众 API可帮助发现与您所选受众相似且可能希望在广告活动中进行定向投放的其他受众。您可以使用通过 Discovery API返回的任何受众作为输入项来生成重叠受众。

例如,要检索与编号为 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
    }

您可以使用一个或多个筛选条件来缩小结果范围。该 API 可供筛选 audienceCategory、minimumAudienceSize、maximumAudienceSize、minimumOverlapAffinity 和 maximumOverlapAffinity。

例如,以下请求可返回场内客群 audienceCategory 中前 30 位重叠的受众,且 minimumOverlapAffinity 的值为 2。

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