キーワードターゲティングの概要

キーワードターゲティングを使用すると、ターゲティングと広告費をより細かく管理し、広告を表示するキーワードを見極め、各キーワードへの入札額を最適化することができます。ターゲティングは広告グループレベルで割り当て、作成したキーワードターゲティングは、広告グループのすべての商品で共有されます。

詳細はこちら：

キーワードの作成

推奨キーワードを取得したら、キャンペーンや広告グループに関連付けるキーワードを作成できます。

エンドポイント

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を使用せず、次のリクエスト本文構造を使用するはずです。

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"
            }
        ]
    }
}

開発者ガイドの概要

Amazon Ads APIの概要

キーワードターゲティングの概要

キーワードの作成

エンドポイント

パラメーター

例