スポンサープロダクト広告の商品カテゴリーターゲティングの推奨内容と絞り込み

カテゴリーターゲティングでは、商品のカテゴリー全体をターゲットとして設定できます。カテゴリーの絞り込みに役立つさまざまな絞り込み要素があります。

すべてのカテゴリーを取得する

初めてカテゴリーターゲティングを行う場合は、まず、利用可能なカテゴリーを理解する必要があります。

エンドポイント

GET sp/targets/categories

例

curl --location --request GET 'https://advertising-api.amazon.com/sp/targets/categories' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \

レスポンスでは、Amazon.comで現在利用可能なすべてのカテゴリーのツリーが返されます。

推奨カテゴリーを取得する

ASINのリストに基づいて推奨カテゴリーをリクエストすることもできます。このエンドポイントでは、ASINのリストを取得し、ターゲットとして設定可能な関連カテゴリーを返します。リクエストに指定したすべてのASINを対象として推奨項目が生成されるので、入力するASINはすべて類似したものでなければなりません。

エンドポイント

POST /sp/targets/categories/recommendations

例

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/categories/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \
--data-raw '{
  "includeAncestor": false,
  "asins": [
    "B08LM7291W"
  ]
}'

レスポンスには、関連するカテゴリーと、そのカテゴリーの商品の最小数と最大数が含まれています。

{
  "categories": [
    {
      "id": "11056341",
      "name": "Bath Soaps",
      "parentCategoryId": "11056281",
      "categoryPath": "/Beauty & Personal Care/Skin Care Products/Body Skin Care Products/Body Cleansers/Bath Soaps",
      "asinCounts": {
        "min": 8988,
        "max": 14980
      }
    }
  ]
}

カテゴリーの絞り込み

カテゴリーには、カテゴリー内のASINをさらに限定するために使用可能な絞り込み要素がある場合があります。絞り込み要素の例として、ブランド、年齢層、ジャンルなどがあります。

エンドポイント

GET sp/targets/category/{categoryId}/refinements

例

curl --location --request GET 'https://advertising-api.amazon.com/sp/targets/category/2522102011/refinements' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \

レスポンスには、そのカテゴリーに関連するすべてのブランド、年齢層、ジャンルが含まれます。すべてのカテゴリーにブランド、年齢層、ジャンルが関連付けられているわけではありません。レスポンスで返されたIDを、ターゲティングエクスプレッション中で使用することができます。

{
  "brands": [
    {
      "name": "Back to Basics",
      "id": "7048034011"
    },
    {
      "name": "DJECO",
      "id": "18681839011"
    },
    {
      "name": "Disney",
      "id": "18726768011"
    },
    {
      "name": "Pipity",
      "id": "20774946011"
    },
    {
      "name": "ALEX Toys",
      "id": "2581933011"
    },
    {
      "name": "Fashion Angels",
      "id": "7481406011"
    }
  ],
  "ageRanges": [
    {
      "name": "Birth to 24 Months",
      "id": "165813011"
    },
    {
      "name": "2 to 4 Years",
      "id": "165890011"
    },
    {
      "name": "8 to 13 Years",
      "id": "5442387011"
    },
    {
      "name": "5 to 7 Years",
      "id": "165936011"
    }
  ],
  "genres": null
}

ヒント

カテゴリーおよび目的の絞り込みでターゲットになる商品の点数を計算するには、POST /sp/targets/products/countエンドポイントを使用します。

推奨カテゴリーの取得と絞り込みが完了したので、カテゴリーターゲティングエクスプレッションを作成する準備が整いました。