開発者ガイドの概要

Amazon Ads APIの概要

テーマベースの推奨入札額 - クイックスタートガイド

概要

テーマベースの入札額推奨機能では、複数のテーマで推奨事項とインパクト指標が提示されるので、キャンペーンに最も合ったテーマから入札額を選択することができます。

最初にリリースされたテーマは、売上拡大に向けた推奨入札額であり、インパクト指標は類似商品で発生した週次のクリック数と注文数です。推奨入札額は、類似商品の最近の落札価格を基に算出され、マーケットプレイスの変化を反映して定期的に更新されます。推奨入札額には、APIエンドポイントが紐づけられているマーケットプレイスの現地通貨が使用されます。

注

APIは現在、オートターゲティングとキーワードターゲティングの推奨入札額をサポートしています。商品ターゲティングのサポートは今後追加される予定です。

インパクト指標

これらの新しいインパクト指標を使用すると、入札額の値によるクリック数と注文数の増加を確認し、ターゲットに合った適切な入札額を選択できます。

キーワードターゲティングの指標を受け取るには、広告グループごとに最低5つのキーワードを指定してAPIを呼び出す必要があります。レスポンスには、キーワードごとに推奨入札額が3つ含まれています。さらに、レスポンスには、広告グループレベルで集計された3セットのインパクト指標が含まれています。それぞれ最低入札額、中央入札額、最高入札額に関連しています。

オートターゲティングのリクエストとレスポンスも同様に機能しますが、選択するマッチタイプの数に最低要件はありません。インパクト指標は、入札額を選択する際の目安となるような類似商品の過去のパフォーマンスに基づいており、予測されるパフォーマンスの推定値ではありません。また、キャンペーンが予算超過しないことを前提に計算されています。

よくある質問

テーマベースの推奨入札額は、現在の推奨入札額とどう違うのですか?

現在の推奨入札額サービスでは、インパクト指標をサポートする入札額は提供されません。テーマベースの推奨入札額では、選択すべき入札額の目安となるように、入札額に加えて、過去の週次のクリック数と注文数のインパクト指標が表示されます。推奨入札額はターゲティング項目レベルで返され、インパクト指標は広告グループレベルで集計されます。

現在の推奨入札額サービスは引き続き使用できますか？

テーマベースの推奨入札額は、現在オープンベータ版でリリースされています。現在のサービスは将来廃止されます。廃止する数か月前に通知する予定です。この期間中は、現在のサービスと新しいテーマベースの推奨入札額の両方が有効になり、サポートされます。ただし、現在の推奨入札額サービスの機能改善が今後リリースされることはありません。新しいテーマベースの推奨入札額を試して、改良された機能を活用することをおすすめします。

すでに推奨入札額を採用しているキャンペーンはどうなりますか？

テーマベースの推奨入札額は、新しいキャンペーンと既存のキャンペーンの両方をサポートします。キャンペーンですでに設定されている入札額が、新しい推奨機能の影響を受けることはありません。キャンペーンに影響を与えるには、テーマベースの入札額推奨機能による入札額を採用する必要があります。

この機能で使用する必要がある新しいレポートはありますか？

いいえ、この機能で使用する必要がある新しいレポートはありません。検索ワードレポート、キャンペーンパフォーマンスレポート、インプレッションランクレポートを使用して、現在アクセスしている通常の広告指標を取得できます。

コードサンプル

SPキャンペーン： 名前 - 「ThemeBasedBidRecommendation」、URL - /sp/targets/bid/recommendations、メソッド – POST

シナリオ1： 新しいオートターゲティングキャンペーンについての推奨入札額とインパクト指標を受け取る。

リクエスト本文

{
  "recommendationType": "BIDS_FOR_NEW_AD_GROUP",
  "asins": [
    "asin1",
    "asin2"
  ],
  "targetingExpressions": [
    {
      "type": "CLOSE_MATCH"
    },
    {
      "type": "LOOSE_MATCH"
    },
    {
      "type": "SUBSTITUTES"
    },
    {
      "type": "COMPLEMENTS"
    }
  ],
  "bidding": {
    "strategy": "AUTO_FOR_SALES",
    "adjustments": null
  }
}

シナリオ1のレスポンス

{
  "bidRecommendations": [
    {
      "theme": "CONVERSION_OPPORTUNITIES",
      "bidRecommendationsForTargetingExpressions": [
        {
          "targetingExpression": {
            "type": "CLOSE_MATCH",
            "value": null
          },
          "bidValues": [
            {
              "suggestedBid": 0.14
            },
            {
              "suggestedBid": 0.44
            },
            {
              "suggestedBid": 0.78
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "COMPLEMENTS",
            "value": null
          },
          "bidValues": [
            {
              "suggestedBid": 0.33
            },
            {
              "suggestedBid": 0.61
            },
            {
              "suggestedBid": 0.96
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "LOOSE_MATCH",
            "value": null
          },
          "bidValues": [
            {
              "suggestedBid": 0.13
            },
            {
              "suggestedBid": 0.14
            },
            {
              "suggestedBid": 0.54
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "SUBSTITUTES",
            "value": null
          },
          "bidValues": [
            {
              "suggestedBid": 0.14
            },
            {
              "suggestedBid": 0.31
            },
            {
              "suggestedBid": 0.52
            }
          ]
        }
      ],
      "impactMetrics": {
        "clicks": {
          "values": [
            {
              "lower": 30,
              "upper": 70
            },
            {
              "lower": 80,
              "upper": 90
            },
            {
              "lower": 95,
              "upper": 120
            }
          ]
        },
        "orders": {
          "values": [
            {
              "lower": null,
              "upper": null
            },
            {
              "lower": 7,
              "upper": 10
            },
            {
              "lower": 11,
              "upper": 15
            }
          ]
        }
      }
    }
  ]
}

シナリオ2： 新しいキーワードターゲティングキャンペーンについての推奨入札額とインパクト指標を受け取る。

リクエスト本文

{
  "recommendationType": "BIDS_FOR_NEW_AD_GROUP",
  "asins": [
    "asin1",
    "asin2"
  ],
  "targetingExpressions": [
    {
      "type": "KEYWORD_BROAD_MATCH",
      "value": "sandals"
    },
    {
      "type": "KEYWORD_BROAD_MATCH",
      "value": "shoe"
    },
    {
      "type": "KEYWORD_EXACT_MATCH",
      "value": "basketball"
    },
    {
      "type": "KEYWORD_PHRASE_MATCH",
      "value": "net"
    },
    {
      "type": "KEYWORD_PHRASE_MATCH",
      "value": "phone"
    }    
  ],
  "bidding": {
    "strategy": "AUTO_FOR_SALES",
    "adjustment": null
  }
}

シナリオ2のレスポンス

{
  "bidRecommendations": [
    {
      "theme": "CONVERSION_OPPORTUNITIES",
      "bidRecommendationsForTargetingExpressions": [
        {
          "targetingExpression": {
            "type": "KEYWORD_BROAD_MATCH",
            "value": "sandals"
          },
          "bidValues": [
            {
              "suggestedBid": 0.15
            },
            {
              "suggestedBid": 0.45
            },
            {
              "suggestedBid": 0.77
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "KEYWORD_BROAD_MATCH",
            "value": "shoe"
          },
          "bidValues": [
            {
              "suggestedBid": 0.14
            },
            {
              "suggestedBid": 0.44
            },
            {
              "suggestedBid": 0.78
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "KEYWORD_EXACT_MATCH",
            "value": "basketball"
          },
          "bidValues": [
            {
              "suggestedBid": 0.33
            },
            {
              "suggestedBid": 0.61
            },
            {
              "suggestedBid": 0.96
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "KEYWORD_PHRASE_MATCH",
            "value": "net"
          },
          "bidValues": [
            {
              "suggestedBid": 0.28
            },
            {
              "suggestedBid": 0.55
            },
            {
              "suggestedBid": 0.87
            }
          ]
        },
        {
          "targetingExpression": {
            "type": "KEYWORD_PHRASE_MATCH",
            "value": "phone"
          },
          "bidValues": [
            {
              "suggestedBid": 0.13
            },
            {
              "suggestedBid": 0.14
            },
            {
              "suggestedBid": 0.54
            }
          ]
        }
      ],
      "impactMetrics": {
        "clicks": {
          "values": [
            {
              "lower": 30,
              "upper": 70
            },
            {
              "lower": 80,
              "upper": 90
            },
            {
              "lower": 95,
              "upper": 120
            }
          ]
        },
        "orders": {
          "values": [
            {
              "lower": null,
              "upper": null
            },
            {
              "lower": 7,
              "upper": 10
            },
            {
              "lower": 11,
              "upper": 15
            }
          ]
        }
      }
    }
  ]
}

シナリオ3： 既存のオートターゲティング広告グループについての推奨入札額とインパクト指標を受け取る。

リクエスト本文

{
  "recommendationType": "BIDS_FOR_EXISTING_AD_GROUP",
  "targetingExpressions": [
    {
      "type": "CLOSE_MATCH"
    },
    {
      "type": "COMPLEMENTS"
    },
    {
      "type": "LOOSE_MATCH"
    },
    {
      "type": "SUBSTITUTES"
    }
  ],
  "campaignId": "12345678XYZ",
  "adGroupId": "987654321XYZ"
}

シナリオ3のレスポンス

シナリオ1のレスポンスと同じです。

シナリオ4： 既存のキーワードターゲティング広告グループについての推奨入札額とインパクト指標を受け取る。

リクエスト本文

{
  "recommendationType": "BIDS_FOR_EXISTING_AD_GROUP",
  "targetingExpressions": [
    {
      "type": "KEYWORD_BROAD_MATCH",
      "value": "sandals"
    },
    {
      "type": "KEYWORD_BROAD_MATCH",
      "value": "shoe"
    },
    {
      "type": "KEYWORD_EXACT_MATCH",
      "value": "basketball"
    },
    {
      "type": "KEYWORD_PHRASE_MATCH",
      "value": "net"
    },
    {
      "type": "KEYWORD_PHRASE_MATCH",
      "value": "phone"
    }
  ],
  "campaignId": "12345678XYZ",
  "adGroupId": "987654321XYZ"
}

シナリオ4のレスポンス

シナリオ2のレスポンスと同じです。

Amazon Advertising logo