开发人员指南概述

亚马逊广告 API 概览

否定关键词投放

否定关键词有助于防止广告在不符合广告活动目标的购物搜索结果页面上展示。否定关键词投放可以在广告活动级别或广告组级别使用。

广告活动与广告组级别的否定关键词投放

在广告活动级别使用否定关键词投放时，该投放将适用于在特定广告活动下创建的所有广告组。当在广告组级别使用否定关键词投放时，它将仅适用于该特定广告组。

接口

| 广告活动级别的关键词 | 广告组级别的关键词 | |--- |--- | | POST /sp/campaignNegativeKeywords | POST /sp/negativeKeywords |

广告活动级别的否定关键词的创建

参数

| 名称 | 可选 | 类型 | 描述 | |--- |--- |--- |--- | | campaignId | 否 | String | 广告活动的编号 | | matchType | 否 | 枚举 | 匹配的类型。可以是 NEGATIVE_EXACT 或 NEGATIVE_PHRASE。有关更多信息，请参阅广告平台帮助中心 中的匹配类型。 | | state | 否 | 枚举 | 当前资源状态，可以是 ENABLED 或 PAUSED | | adGroupId | 否 | String | 广告组的编号。仅与广告组级别的否定关键词相关。 | | keywordText | 否 | String | 关键词文本。 |

示例

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaignNegativeKeywords' \
--header 'Amazon-Advertising-API-ClientId: xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Authorization: xxxxxxxx \
--header 'Accept: application/vnd.spNegativeKeyword.v3+json' \
--header 'Content-Type: application/vnd.spNegativeKeyword.v3+json' \

--data-raw '[
  {
    "campaignId": 104465559608285,
    "state": "enabled",
    "keywordText": "toy",
    "matchType": "NEGATIVE_EXACT"
  }
]'

响应

成功的响应将返回一个 207 状态代码，其中包含任何错误的错误数组和一个带有 campaignNegativeKeywordId 的成功数组。

{
  "campaignNegativeKeywords": {
    "error": [],
    "success": [
      {
        "campaignNegativeKeywordId": "219480858473246",
        "index": 0
      }
    ]
  }
}

广告组级别的否定关键词的创建

示例

curl --location --request POST 'https://advertising-api.amazon.com/sp/negativeKeywords' \
--header 'Amazon-Advertising-API-ClientId: xxxxxxxx \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Authorization: Bearer xxxxxxxx \
--header 'Accept: application/vnd.spCampaignNegativeKeyword.v3+json' \
--header 'Content-Type: application/vnd.spCampaignNegativeKeyword.v3+json' \
--data-raw '[
  {
    "campaignId": 153839444046652,
    "adGroupId": 104465559608285,
    "state": "ENABLED",
    "keywordText": "expensive",
    "matchType": "NEGATIVE_EXACT"
  }
]'

响应

成功的响应将返回一个 207 状态代码，其中包含任何错误的错误数组和一个带有 NegativeKeywordId 的成功数组。

{
  "negativeKeywords": {
    "error": [],
    "success": [
      {
        "index": 0,
        "negativeKeywordId": "227104043184993"
      }
    ]
  }
}
Amazon Advertising logo