スポンサープロダクト広告の商品ターゲティングの推奨

ターゲットにする商品が確かでない場合は、広告主が広告掲載しているASINに基づいてAmazonより商品を推奨することが可能です。

リクエスト

ヒント

リクエストに複数のASINを含める場合は、それらが類似の商品であることを確認してください。レスポンスには、リクエストに含まれるすべてのASINのおすすめ商品が含まれます。

テーマ別またはASIN別に推奨をリクエストできます。テーマ別の推奨では、テーマのリスト（類似のアイテムや補完アイテムなど）が返されます。各テーマには、そのカテゴリーに分類されるASINのリストが含まれています。ASIN別の推奨では、ASINのリストが返されます。各ASINには、どのテーマに一致するかの説明が含まれています。詳細については、以下の例をご覧ください。レスポンスのタイプはAcceptヘッダーの値によって決まります。

エンドポイント

GET /sp/targets/products/recommendations endpoint

ASIN別

リクエスト

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/products/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Accept: application/vnd.spproductrecommendationresponse.asins.v3+json' \
--header 'Content-Type: application/vnd.spproductrecommendationresponse.asins.v3+json' \
--data-raw '{
  "adAsins": [
    "B09LJWZT6G"
  ],
  "count": "5",
  "locale": "en_US"
}'

レスポンス

{
  "recommendations": [
    {
      "recommendedAsin": "B08YJY5KW5",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B09TGKBFCM",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B01LL9ITX8",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B07C8RCNXD",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B06XWRGMVT",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    }
  ],
  "nextCursor": "h9oGnf2jn2qd3ymV4nWLsA=="
}

注

リクエスト内のカウントによって、レスポンスで返されるASINの数が決まります。新しいリクエストにnextCursorまたはpreviousCursorの値を使用することで、次のASINセットを返すことができます。

テーマ別

リクエスト

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/products/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: 904444984714944' \
--header 'Accept: application/vnd.spproductrecommendationresponse.themes.v3+json' \
--header 'Content-Type: application/vnd.spproductrecommendationresponse.themes.v3+json' \
--data-raw '{
  "adAsins": [
    "B09LJWZT6G"
  ],
  "locale": "en_US",
  "count": 5
}'

レスポンス

{
  "recommendations": [
    {
      "theme": "Similar items (frequently viewed together)",
      "description": "Items that shoppers frequently view and click along with your advertised item during a shopping session.",
      "recommendedAsins": [
        "B08YJY5KW5",
        "B09TGKBFCM",
        "B01LL9ITX8",
        "B07C8RCNXD",
        "B06XWRGMVT",
        "B09TK2394N"
      ]
    },
    {
      "theme": "Complements",
      "description": "Items frequently bought together as complements (e.g. tennis balls with tennis raquets)",
      "recommendedAsins": [
        "B091K1C3KD",
        "B09VPFJYVR",
        "B09TLM53P7",
        "B099QV15NM",
        "B0B4BFTB3D",
        "B09B4QD42W"
      ]
    }
  ],
  "nextCursor": null,
  "previousCursor": null
}

注

リクエスト内のcountによって、レスポンスで返されるテーマの数が決まります。新しいリクエストにnextCursorとpreviousCursorの値を使用することで、次のテーマセットを返すことができます。

次に、推奨を使用して、ターゲティングエクスプレッションを作成できます。