展示型推广建议 API

亚马逊提供对潜在商品、品类和竞价的洞察，有助于提高广告点击率，并提高商品知名度和转化量。在创建或管理广告活动以进行商品投放或品类投放时，您可以创建包含 ASIN 或品类的定向子句，以便在亚马逊站内及站外展示您推广的商品。借助这种方案，您可以保护自己的商品页面，对目录中的商品进行升级销售，或者在相似的商品或品类中发展业务。

目前支持以下建议：

投放方案	API 中的标识符	建议类型
商品投放	T00020	商品、类似商品、品类和竞价
受众投放	T00030	精准商品、类似商品、品类和竞价

商品投放和品类投放建议

展示型推广商品和品类建议使您能够根据给定的一组推广的商品（ASIN 或 SKU），以程序化方式查询建议投放广告的商品或品类。这些有关商品的建议基于浏览定向购买行为数据（浏览这些推荐商品的顾客很可能会购买您推广的商品）。亚马逊还建议使用目录元数据对页面浏览量最低的新商品进行投放，从而确保为您提供更好的覆盖范围。有助于扩大规模并提升效果的关键因素是提供理想的投放方案，该方案需高度宽泛并达到一定的规模，还要高度相关以实现良好的效果。当亚马逊了解到有关要投放广告的优化商品或品类的新信息时，这些数据会被刷新，因此您应该积极查询 API 以了解新的建议。响应中的推荐商品还会根据目标投放商品的详情页面浏览量及其与推广的商品的相似度进行排名，因此排名最高的推荐商品可能会为您产生更多的广告点击量。这项商品推荐服务专为展示型推广而开发，并且应代替商品推广或品牌推广的商品推荐 API 使用。

如果您计划在一个广告组中包含多个相似的 ASIN，则应在单个请求中对这些 ASIN 调用 API。或者，您也可以仅对单个 ASIN 调用 API，这样您只能获得针对一个 ASIN 的建议。无需创建广告活动即可调用该服务，因此您可以进行试验并深入了解有可能需要投放广告的 ASIN。然后，您可以使用亚马逊广告 API 轻松创建或更新广告活动，并在定向子句中包含 ASIN。

使用投放建议 API

建议 API 在展示型推广 Open API 中进行了介绍。请求体允许您定义多个输入参数，例如：

POST /sd/targets/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.1+json
{
    "tactic": "T00020",
    "products": [
        {
            "asin": "B015FK1EH2"
        },
        {
            "asin": "B00NMOYPVG"
        }
    ],
    "typeFilter": [
        "PRODUCT", "CATEGORY"
    ]
}

• Content-Type 字段指定建议 API 的版本。原始版本 (3.0) 仅支持商品。最新版本 (3.1) 同时支持商品和品类。
• tactic 字段定义了广告活动类型。
• products 数组包含一个或多个目标 ASIN。这些 ASIN 代表广告活动中推广的商品。请求中的前 100 个 ASIN 用于生成建议。
• typeFilter 是一个定义建议类型的值构成的数组。支持的值为 PRODUCT 和 CATEGORY。请注意，方案“T00030”仅允许 CATEGORY。

此请求的响应返回以下内容：

{
    "recommendations": {
        "products": [
            {
                "asin": "B07XJ8C8F5",
                "rank": 1
            },
            {
                "asin": "B07XQ5QV37",
                "rank": 2
            },
            {
                "asin": "B08D7JL5RM",
                "rank": 100
            }
        ]
        "categories": [
            {
                "category": 1234,
                "name": "test category 1",
                "path": [
                    "root",
                    "node1",
                    "node2"
                ],
                "targetableAsinCountRange": {
                    "rangeLower": 1,
                    "rangeUpper": 4
                }
            },
            {
                "category": 4567,
                "name": "test category 2",
                "path": [
                    "root",
                    "node1",
                    "node2"
                ],
                "targetableAsinCountRange": {
                    "rangeLower": 1,
                    "rangeUpper": 4
                }
            }
        ]
    }
}

建议服务的响应包含一系列按潜在规模排名的商品 ASIN。具体而言，排名较高的 ASIN 有潜力显示在更多的商品详情页上。即使是排名较低的 ASIN 仍然是相关的，因此您应该查看所有建议，以确保您不会错过机会。返回的品类包含一个字段 targetableAsinCountRange，其中每个品类包含一个 ASIN 范围，以提供有关潜在规模的指导。

**使用竞价建议 API **

竞价建议根据近期 ASIN 的历史竞价值，通过中位数、下限和上限针对定向子句提供建议竞价。指定的竞价优化和成本类型用于优化竞价建议，以实现您的广告活动目标。这些建议将帮助广告主选择更有可能赢得展示量的竞价，并为向顾客展示的广告带来点击量。竞价建议是使用现有定向子句的精准结构在投放级别提供的，从而使您能够以程序化方式重复使用广告活动定向子句并获取竞价建议。

有关更多信息，请访问更新的竞价建议 API。

您需要：

• targetingClauses，可以通过以下方式获得：

GET /sd/targets/{targetId}

• 广告组中的 products (ASIN)，可以通过以下方式获得：

GET /sd/productAds?adGroupIdFilter={adGroupId}

使用这些信息，以下是竞价建议调用的示例：

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
   "bidOptimization": "clicks",
   "costType": "cpc",
   "products":[
      {
         "asin":"B123456789"
      }
   ],
   "targetingClauses":[
      {
         "targetingClause":{
            "expressionType":"manual",
            "expression":[
               {
                  "type":"asinSameAs",
                  "value":"B123456789"
               }
            ]
         }
      }
   ]
}

• Content-Type 标头指定建议 API 的版本。最新版本 (3.2) 支持竞价建议和 bidOptimization 输入。
• payload 中的 bidOptimization 字段包含的值为“clicks”或“conversions”。
• payload 中的 costType 字段包含广告活动的 costType，可以是“CPC”。
• payload 中的 products 字段包含一个或多个目标 ASIN。这些 ASIN 代表广告活动中推广的商品。请求中的前 100 个 ASIN 用于生成建议。
• payload 中的 targetingClauses 字段与 products 一起使用，以确定竞价建议。目前，API 将接受最多 100 个定向子句，这将在一个数组中返回一组竞价值，其顺序与请求相同。

上述请求的响应根据商品（推广的商品）和定向子句返回以下竞价建议：

{
   "bidOptimization": "clicks",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.25,
         "rangeUpper":0.79,
         "recommended":0.39
      }
   ]
}

如果您有多个定向子句，则会得到相同数量的竞价建议

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
    "bidOptimization": "conversions",
    "costType": "cpc",
    "products": [
        {
            "asin": "B123456789"
        }
    ],
    "targetingClauses": [
        {
            "targetingClause": {
                "expressionType": "manual",
                "expression": [
                    {
                        "type": "asinCategorySameAs",
                        "value": "12345"
                    }
                ]
            }
        },
        {
            "targetingClause": {
                "expressionType": "manual",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "asinCategorySameAs",
                                "value": "12345"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

将返回

{
   "bidOptimization": "conversions",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.25,
         "rangeUpper":0.79,
         "recommended":0.39
      },
      {
         "code":"200",
         "rangeLower":0.30,
         "rangeUpper":0.90,
         "recommended":0.45
      }
   ]
}

对受众浏览量采用 similarProduct 和 exactProduct 投放的其他示例。

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
    "bidOptimization": "conversions",
    "costType": "cpc",
    "products": [
        {
            "asin": "B123456789"
        }
    ],
    "targetingClauses": [
        {
            "targetingClause": {
                "expressionType": "auto",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "similarProduct"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "targetingClause": {
                "expressionType": "auto",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "exactProduct"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

将返回

{
   "bidOptimization": "conversions",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.28,
         "rangeUpper":0.79,
         "recommended":0.39
      },
      {
         "code":"200",
         "rangeLower":0.34,
         "rangeUpper":0.95,
         "recommended":0.45
      }
   ]
}

总结

在为广告活动确定了理想的 ASIN 或品类后，即可将其包含在商品投放中：

1. 根据建议的 ASIN 或品类使用定向子句创建新广告活动。
2. 根据建议使用定向子句更新现有广告活动。
3. 对于 1) 和 2)，根据竞价建议更新目标竞价值。

有关如何使用这些建议管理广告活动的详细信息，请参阅此处的教程。