开发人员指南概述

亚马逊广告 API 概览

关键词投放概览

关键词投放让您能够更好地管控投放和支出,确定要针对哪些关键词展示广告,并针对每个关键词优化竞价。投放是在广告组级别分配的,广告组中的所有商品共享创建的关键词投放。

进一步了解:

创建关键词

获得建议的关键词后,您可以创建关键词来关联到广告活动和广告组。

接口

POST /sp/keywords

参数

| 名称 | 可选 | 类型 | 说明 | |--- |--- |--- |--- | | 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

在其他地区投放广告的广告主可以使用 nativeLanguageLocalenativeLanguageKeyword 参数,以其首选语言指定等效的 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"
            }
        ]
    }
}