关键词投放概览
关键词投放让您能够更好地管控投放和支出,确定要针对哪些关键词展示广告,并针对每个关键词优化竞价。投放是在广告组级别分配的,广告组中的所有商品共享创建的关键词投放。
进一步了解:
创建关键词
获得建议的关键词后,您可以创建关键词来关联到广告活动和广告组。
接口
参数
| 名称 | 可选 | 类型 | 说明 |
|--- |--- |--- |--- |
| campaignId | 不可以 | Number | 要与关键词进行关联的广告活动。 |
| adGroupId | 不可以 | String | 要与关键词进行关联的广告组。 |
| state | 不可以 | Enum | 当前资源状态。 |
| keywordText | 不可以 | String | 关键词文本。 |
| nativeLanguageKeyword | 可以 | String | 广告主首选区域设置语言的未翻译关键词文本。 |
| nativeLanguageLocale | 可以 | String | 广告主的首选区域设置。例如,如果广告主的首选语言是简体中文,则区域设置为 zh_CN
。支持的区域设置包括: 简体中文(区域设置:zh_CN),用于美国、英国和加拿大。英语(区域设置:en_GB),用于德国、法国、意大利和西班牙。 |
| matchType | 不可以 | String | 匹配类型。如希望进一步了解,请参阅广告平台支持中心中的匹配类型。 |
| bid | 不可以 | Number | 与此关键词进行关联的竞价。仅适用于可竞价的匹配类型。您还可以获得关键词竞价建议 |
示例
标准
大多数广告主不应使用 nativeLanguageLocale
,而应使用以下请求体(request body)结构:
curl --location --request POST 'https://advertising-api.amazon.com/sp/keywords' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxx' \
--header 'Authorization: Bearer xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spKeyword.v3+json' \
--header 'Content-Type: application/vnd.spKeyword.v3+json' \
--data-raw '{
"keywords": [
{
"campaignId": "153839444046652",
"matchType": "EXACT",
"state": "ENABLED",
"bid": 0.02,
"adGroupId": "208676741301789",
"keywordText": "soap bar"
}
]
}'
{
"keywords": {
"error": [],
"success": [
{
"index": 0,
"keyword": {
"adGroupId": "80908659241419",
"bid": 0.02,
"campaignId": "152865535357884",
"keywordId": "104465559608285",
"keywordText": "soap bar",
"matchType": "EXACT",
"state": "ENABLED"
},
"keywordId": "104465559608285"
}
]
}
}
使用 nativeLanguageLocale
在其他地区投放广告的广告主可以使用 nativeLanguageLocale
和 nativeLanguageKeyword
参数,以其首选语言指定等效的 keywordText
用于报告。
curl --location --request POST 'https://advertising-api.amazon.com/sp/keywords' \
--header 'Authorization: Bearer xxxxxxxx ' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Amazon-Advertising-API-ClientId: xxxxxxxx' \
--header 'Accept: application/vnd.spKeyword.v3+json' \
--header 'Prefer: return=representation' \
--header 'Content-Type: application/vnd.spKeyword.v3+json' \
--data-raw '{
"keywords": [
{
"campaignId": "153839444046652",
"matchType": "EXACT",
"state": "ENABLED",
"bid": 0.02,
"adGroupId": "208676741301789",
"keywordText": "soap bar",
"nativeLanguageLocale" : "zh_CN",
"nativeLanguageKeyword" : "肥皂"
}
]
}'
{
"keywords": {
"error": [],
"success": [
{
"index": 0,
"keyword": {
"adGroupId": "80908659241419",
"bid": 0.02,
"campaignId": "153839444046652",
"keywordId": "104465559608285",
"keywordText": "soap bar",
"matchType": "EXACT",
"nativeLanguageKeyword": "肥皂",
"nativeLanguageLocale": "zh_CN",
"state": "ENABLED"
},
"keywordId": "104465559608285"
}
]
}
}