開発者ガイドの概要

Amazon Ads APIの概要

スポンサーディスプレイ広告の推奨API

Amazonは、広告がクリックされる確率を高め、商品の認知度とコンバージョンを促進するのに役立つ、潜在的な商品、カテゴリー、入札額に関するインサイトを提供します。商品またはカテゴリーをターゲットにするキャンペーンを作成または管理する場合、ASINまたはカテゴリーを含むターゲット項目を作成して、Amazon内外両方で広告対象商品を表示できます。この戦略により、商品ページを保護したり、カタログ内の商品をアップセルしたり、隣接する商品やカテゴリーのビジネスを成長させたりすることができます。

現在、以下の推奨事項がサポートされています。

ターゲティング戦略 APIのID 推奨事項のタイプ
商品ターゲティング T00020 商品、類似商品、カテゴリー、および入札額
オーディエンス T00030 完全一致の商品、類似商品、カテゴリー、および入札額

商品とカテゴリーのターゲティングに関する推奨

スポンサーディスプレイ広告の商品とカテゴリーの推奨機能を使用することで、指定した一連の広告対象商品（ASINまたはSKU）に基づいて、ターゲットとして設定する推奨商品や推奨カテゴリーをプログラムからクエリすることができます。それらの推奨事項は、閲覧から購入までのデータ（それらの推奨商品を閲覧している購入者は、広告対象商品を購入する可能性が高い）に基づいています。また、カタログのメタデータを使用して、ページビュー数が最も少ない新商品のための推奨ターゲットを取得し、カバレッジを広げることもできます。規模とパフォーマンスを向上させる重要な要素は、規模を得るために十分広く、パフォーマンスを得るために十分関連性の高い、最適なターゲティングを提供することです。このデータは、ターゲットとして設定するのに適した商品やカテゴリーに関する新しい情報が得られると更新されるので、APIに積極的にクエリを実行して、新しい推奨事項を取得することが必要です。また、レスポンスで返される推奨商品は、ターゲット商品の商品詳細ページの閲覧数、ならびにターゲット商品と広告対象商品の類似性に基づいてランク付けされているので、上位のランクの推奨商品ほど広告のクリック数が多くなる可能性があります。この推奨サービスは、スポンサーディスプレイ広告専用に構築されているため、スポンサープロダクト広告やスポンサーブランド広告の推奨APIの代わりに使用する必要があります。

1つの広告グループに複数の類似するASINを含める場合は、1回のリクエストでそれらのASINを指定してAPIを呼び出す必要があります。または、1つのASINのみを使用してAPIを呼び出し、1つのASINのみについての推奨事項を取得することもできます。このサービスはキャンペーンを作成しなくても呼び出せるので、ターゲットとして設定できるASIN候補についてのインサイトを試験的に得ることができます。その後、Amazon Ads APIを使用してキャンペーンを簡単に作成または更新し、それらのASINをターゲット項目に含めることができます。

ターゲティング推奨APIの使用

推奨APIについては、スポンサーディスプレイ広告のOpen API仕様に記載されています。次のように、リクエスト本文に複数の入力パラメーターを設定できます。

POST /sd/targets/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.1+json
{
    "tactic": "T00020",
    "products": [
        {
            "asin": "B015FK1EH2"
        },
        {
            "asin": "B00NMOYPVG"
        }
    ],
    "typeFilter": [
        "PRODUCT", "CATEGORY"
    ]
}

このリクエストのレスポンスは、以下を返します。

{
    "recommendations": {
        "products": [
            {
                "asin": "B07XJ8C8F5",
                "rank": 1
            },
            {
                "asin": "B07XQ5QV37",
                "rank": 2
            },
            {
                "asin": "B08D7JL5RM",
                "rank": 100
            }
        ]
        "categories": [
            {
                "category": 1234,
                "name": "test category 1",
                "path": [
                    "root",
                    "node1",
                    "node2"
                ],
                "targetableAsinCountRange": {
                    "rangeLower": 1,
                    "rangeUpper": 4
                }
            },
            {
                "category": 4567,
                "name": "test category 2",
                "path": [
                    "root",
                    "node1",
                    "node2"
                ],
                "targetableAsinCountRange": {
                    "rangeLower": 1,
                    "rangeUpper": 4
                }
            }
        ]
    }
}

この推奨サービスからのレスポンスには、潜在的な規模でランク付けされた商品ASINの配列が含まれています。具体的には、ランクの高いASINほど、より多く商品詳細ページに表示される可能性があります。ランクの低いASINでも関連性は高いので、すべての推奨事項を確認して、機会を逃さないようにする必要があります。潜在的な規模に関するガイダンスを提供するために、返されたカテゴリーに含まれているtargetableAsinCountRangeフィールドには、各カテゴリーのASINの範囲が入っています。

入札額推奨APIの使用

入札額推奨機能は、最近の期間におけるASINの入札額履歴に基づいて、中央値、下限、上限を含むターゲット項目の推奨入札額を提供します。入札額の最適化方法とコストタイプを指定して、キャンペーンの目標に合わせて推奨入札額を最適化することができます。推奨入札額は、インプレッションを獲得し、買い物客に表示されたターゲット広告がクリックされる可能性が高い入札額を広告主が選択するのに役立ちます。推奨入札額は、既存のターゲット項目の構造をそのまま使用してターゲットレベルで提供されるので、プログラムからキャンペーンのターゲット項目を再利用して、推奨入札額を取得することができます。

詳細については、更新された入札額推奨APIをご覧ください。

次のものが必要です。

GET /sd/targets/{targetId}

GET /sd/productAds?adGroupIdFilter={adGroupId}

この情報を使用した、推奨入札額の呼び出しの例を次に示します。

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
   "bidOptimization": "clicks",
   "costType": "cpc",
   "products":[
      {
         "asin":"B123456789"
      }
   ],
   "targetingClauses":[
      {
         "targetingClause":{
            "expressionType":"manual",
            "expression":[
               {
                  "type":"asinSameAs",
                  "value":"B123456789"
               }
            ]
         }
      }
   ]
}

上記のリクエストからのレスポンスでは、商品（広告対象商品）とターゲティング項目に基づいて、以下の推奨入札額が返されます。

{
   "bidOptimization": "clicks",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.25,
         "rangeUpper":0.79,
         "recommended":0.39
      }
   ]
}

複数のターゲット項目がある場合は、同じ数の推奨入札額が返されます

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
    "bidOptimization": "conversions",
    "costType": "cpc",
    "products": [
        {
            "asin": "B123456789"
        }
    ],
    "targetingClauses": [
        {
            "targetingClause": {
                "expressionType": "manual",
                "expression": [
                    {
                        "type": "asinCategorySameAs",
                        "value": "12345"
                    }
                ]
            }
        },
        {
            "targetingClause": {
                "expressionType": "manual",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "asinCategorySameAs",
                                "value": "12345"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

この場合は以下が返されます

{
   "bidOptimization": "conversions",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.25,
         "rangeUpper":0.79,
         "recommended":0.39
      },
      {
         "code":"200",
         "rangeLower":0.30,
         "rangeUpper":0.90,
         "recommended":0.45
      }
   ]
}

similarProductターゲティングとexactProductターゲティングを使用したオーディエンス閲覧数のその他の例。

POST /sd/targets/bid/recommendations HTTP/1.1
Content-Type: application/vnd.sdtargetingrecommendations.v3.2+json
{
    "bidOptimization": "conversions",
    "costType": "cpc",
    "products": [
        {
            "asin": "B123456789"
        }
    ],
    "targetingClauses": [
        {
            "targetingClause": {
                "expressionType": "auto",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "similarProduct"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "targetingClause": {
                "expressionType": "auto",
                "expression": [
                    {
                        "type": "views",
                        "value": [
                            {
                                "type": "exactProduct"
                            },
                            {
                                "type": "lookback",
                                "value": "30"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

この場合は以下が返されます

{
   "bidOptimization": "conversions",
   "costType":"cpc",
   "bidRecommendations":[
      {
         "code":"200",
         "rangeLower":0.28,
         "rangeUpper":0.79,
         "recommended":0.39
      },
      {
         "code":"200",
         "rangeLower":0.34,
         "rangeUpper":0.95,
         "recommended":0.45
      }
   ]
}

まとめ

キャンペーンに最適なASINまたはカテゴリーを決定したら、以下のようにそれらを商品ターゲティングに含めることができます。

  1. 推奨されたASINまたはカテゴリーを使用して、ターゲティング項目を指定して新しいキャンペーンを作成する。
  2. 推奨機能を使用して、既存のキャンペーンのターゲティング項目を更新する。
  3. 1)と2)について、推奨入札額に基づいて、ターゲット入札額を更新する。

これらの推奨機能を使用してキャンペーンを管理する方法の詳細については、こちらのチュートリアルをご覧ください。

Amazon Advertising logo