商品推广产品广告

产品广告是您广告活动的最小单元，意味着您希望进行推广的各个产品。您可以在可以在广告活动层次结构 中进一步了解广告活动结构。

每个产品广告都与单件商品相关联，可以使用 SKU（卖家）或 ASIN（供应商和作者）进行关联。

每个产品广告都与一个广告组相关联。我们建议将相似商品或共享相似投放条件的商品分组到同一个广告组中。

前提条件

• 创建广告活动
• 创建广告组

检查产品使用资格

要检查产品是否符合推广资格，您可以使用 POST /eligibility/product/list 接口。广告必须有库存才能进行投放。

示例

此示例用于检查 ASIN B0B9VJLZ69 的推广资格。

curl --location --request POST 'https://advertising-api.amazon.com/eligibility/product/list' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Content-Type: text/plain' \
--data-raw '{
  "adType": "sp",
  "productDetailsList": [
    {
      "asin": "B0B9VJLZ69"
    }
  ]
}'

请求

要创建产品广告，您必须添加 campaignId、adGroupId、asin（供应商和 KDP 作者）或 sku（卖家）和 state。

接口

POST sp/productAds

示例

供应商

供应商应在请求体中添加 ASIN。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "asin": "B09XBVBHR2",
    "state": "enabled"
  }
]

卖家

如果您是一位卖家并需要找到与商品关联的 SKU，您可以在卖家中心进行查找。如果您已经知道与商品关联的 ASIN，也可以使用产品元数据接口 获取与 ASIN 关联的 SKU。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "sku": "a140aafa-1a23",
    "state": "enabled"
  }
]

KDP

KDP 作者可以选择是否使用 customText 字段向其广告添加自定义文案。请注意，如果在产品广告中添加了 customText，则该广告组中只能有一个产品广告。如果不使用 customText，则广告组中可以有多个产品广告。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "asin": "B09XBVBHR2",
    "state": "enabled",
    "customText": "An exciting thriller for all!"
  }
]

完成 cURL

curl --location --request POST 'https://advertising-api.amazon.com/sp/productAds' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spProductAd.v3+json' \
--header 'Content-Type: application/vnd.spProductAd.v3+json' \
--data-raw '{
  "productAds": [
    {
      "campaignId": "52978233888897",
      "state": "ENABLED",
      "asin": "B087TKYT4X",
      "adGroupId": "36453868083101"
    }
  ]
}'

响应

成功调用将返回 207 响应代码。响应体中包含一个 JSON 对象数组，其中包含请求中每个 productAd 对象的状态。

提示

如果您希望在响应中接收完整的广告活动对象，请使用设置为 return=representation 的 Prefer 标头。

后续步骤

对于手动广告活动，创建产品广告后，您需要添加关键词或定向子句。

• 添加关键词
• 添加定向子句

对于自动广告活动，您在创建产品广告后就可以开始使用！