開発者ガイドの概要

Amazon Ads APIの概要

スポンサープロダクト広告

プロダクト広告はキャンペーンの最小単位で、広告を掲載する個々の商品を表します。キャンペーンの構造に関する詳細については、キャンペーン階層をご覧ください。

各プロダクト広告は、SKU（出品者様）またはASIN（お取引企業様と著者様）のいずれかによって単一商品に関連付けられます。

各プロダクト広告は、広告グループに関連付けられます。類似商品、または類似のターゲティング条件を共有する商品を同じ広告グループにまとめることをおすすめします。

始める前に

商品の利用資格の確認

商品に広告の利用資格があるかどうかを確認するには、POST /eligibility/product/listエンドポイントを使用できます。広告を配信するには、商品の在庫がなければなりません。

例

この例では、ASIN B0B9VJLZ69の利用資格を確認します。

curl --location --request POST 'https://advertising-api.amazon.com/eligibility/product/list' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Content-Type: text/plain' \
--data-raw '{
  "adType": "sp",
  "productDetailsList": [
    {
      "asin": "B0B9VJLZ69"
    }
  ]
}'

リクエスト

プロダクト広告を作成するには、campaignId、adGroupId、asin（お取引企業様とKDP著者様）またはsku（出品者様）、stateを含める必要があります。

エンドポイント

POST sp/productAds

例

お取引企業様

お取引企業様は、リクエストボディにASINを含める必要があります。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "asin": "B09XBVBHR2",
    "state": "enabled"
  }
]

出品者様

商品に関連付けられたSKUを探す必要がある出品者様は、セラーセントラルで調べることができます。商品に関連付けられているASINがわかっている場合は、商品メタデータのエンドポイントを使用してSKUを取得することもできます。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "sku": "a140aafa-1a23",
    "state": "enabled"
  }
]

KDP

KDP著者様は、customTextフィールドを使用して広告にカスタム広告のコピーを追加するかどうかを選択できます。商品広告にcustomTextを追加した場合、その広告グループに追加できる商品広告は1つだけです。customTextを使用しない場合は、広告グループに複数の商品広告を追加できます。

[
  {
    "campaignId": {{campaignIdManual}},
    "adGroupId": {{adGroupIdManual}},
    "asin": "B09XBVBHR2",
    "state": "enabled",
    "customText": "An exciting thriller for all!"
  }
]

完全なcURL

curl --location --request POST 'https://advertising-api.amazon.com/sp/productAds' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spProductAd.v3+json' \
--header 'Content-Type: application/vnd.spProductAd.v3+json' \
--data-raw '{
  "productAds": [
    {
      "campaignId": "52978233888897",
      "state": "ENABLED",
      "asin": "B087TKYT4X",
      "adGroupId": "36453868083101"
    }
  ]
}'

レスポンス

呼び出しが成功すると、207レスポンスコードが返されます。レスポンスボディには、リクエスト内の各productAdオブジェクトのステータスを持つオブジェクトのJSON配列が含まれます。

ヒント

レスポンスでキャンペーンオブジェクト全体を受け取りたい場合は、Preferヘッダーをreturn=representationに設定して使用します。

次のステップ

マニュアルキャンペーンの場合は、プロダクト広告を作成したら、キーワードまたはターゲティング項目を追加する必要があります。

自動キャンペーンの場合は、プロダクト広告を作成したら準備は完了です。

Amazon Advertising logo