除外キーワードターゲティング

除外キーワードは、キャンペーン目標に適合しない商品検索結果ページに広告が表示されないようにするのに役立ちます。除外キーワードターゲティングは、キャンペーンレベルまたは広告グループレベルで使用できます。

キャンペーンレベルと広告グループレベルの除外キーワードターゲティングの違い

キャンペーンレベルで除外キーワードターゲティングを使用する場合、ターゲティングはその特定のキャンペーンで作成されたすべての広告グループに適用されます。広告グループレベルで除外キーワードターゲティングを使用する場合は、ターゲティングはその特定の広告グループにのみ適用されます。

エンドポイント

キャンペーンレベルの除外キーワードの作成

パラメーター

| 名前 | 任意 | タイプ | 説明 | |--- |--- |--- |--- | | campaignId | いいえ | String | キャンペーンのID | | matchType | いいえ | Enum | マッチのタイプ。NEGATIVE_EXACTまたはNEGATIVE_PHRASEを指定できます。マッチタイプの詳細については、広告コンソールヘルプセンターをご覧ください。 | | state | いいえ | Enum | 現在のリソースの状態。ENABLEDまたはPAUSEDを指定できます | | adGroupId | いいえ | String | 広告グループのID。広告グループレベルの除外キーワードにのみ使用されます。 | | 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"
  }
]'

応答

成功した場合、レスポンスでは、存在するすべてのエラーを含むerror配列と、campaignNegativeKeywordIdを含むsuccess配列を含む207が返されます。

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

応答

成功した場合、レスポンスでは、存在するすべてのエラーを含むerror配列と、NegativeKeywordIdを含むsuccess配列を含む207が返されます。

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

開発者ガイドの概要

Amazon Ads APIの概要