开发人员指南概述

亚马逊广告 API 概览

商品推广否定商品和品牌投放概览

自动商品推广活动和手动商品推广活动均可使用否定商品投放。否定商品投放让您能够从投放内容中排除某些商品和品牌。您可以在广告平台文档中进一步了解否定商品投放。

您可以在广告组或广告活动级别创建否定投放表达式。任何广告活动级别的否定商品投放表达式都会影响所有在广告活动中使用商品投放的广告组。对于所有商品推广活动，您都可选择否定商品投放。

您可以在广告活动层次结构中进一步了解广告活动结构。

警告

：针对手动广告活动的广告活动级别的否定商品投放仅适用于供应商。卖家可以在自动广告活动中添加广告活动级别的否定投放，但不能在手动广告活动中进行添加。

接口

| 广告活动级别的投放 | 广告组级别的投放 | |--- |--- | | POST /sp/campaignNegativeTargets | POST /sp/negativeTargets |

操作前注意事项

在创建商品投放表达式之前，您需要完成以下操作：

请求

参数

请求使用以下参数创建投放：

| 名称 | 可选 | 类型 | 说明 | |--- |--- |--- |--- | | campaignId | 不可选 | number | 与投放表达式相关联的广告活动。 | | adGroupId | 不可选 | String | 与广告活动相关联的广告组。只有广告组级别的否定投放才需要 adGroupId。 | | expression.type | 不可选 | string | ASIN_SAME_AS 或 ASIN_BRAND_SAME_AS | | expression.value | 不可选 | string | 基于表达式类型的 ASIN 或品牌 ID。您可以使用 POST sp/negativeTargets/brands/search 接口并通过关键词来获取建议的品牌 ID。 | | state | 不可选 | string | 投放表达式的状态，分别为 ENABLED 或 PAUSED。 |

示例

广告组级别的 ASIN

curl --location --request POST 'https://advertising-api.amazon.com/sp/negativeTargets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spNegativeTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spNegativeTargetingClause.v3+json' \
--data-raw '{
  "negativeTargetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B07YT8NVF9"
        }
      ],
      "campaignId": "26256301417055",
      "state": "ENABLED",
      "adGroupId": "169462822148652"
    }
  ]
}'

广告活动级别的品牌

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaignNegativeTargets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spCampaignNegativeTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spCampaignNegativeTargetingClause.v3+json' \
--data-raw '{
  "negativeTargetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_BRAND_SAME_AS",
          "value": "18681839011"
        }
      ],
      "campaignId": "26256301417055",
      "state": "ENABLED"
    }
  ]
}'

响应

成功的请求会返回一个 207 响应，其中包含了每个投放子句的状态信息。您应检查成功数组是否包含了您计划创建的所有对象。任何失败信息都会在错误数组中表明。

提示

如果您希望在请求中返回整个投放对象，请确保在标头（header）中包含 Prefer: return=representation。

Amazon Advertising logo