開発者ガイドの概要

Amazon Ads APIの概要

入札額の管理

入札額の管理は、入札戦略と呼ばれる、広告主様が設定した基準に基づきオークションの入札額が自動調整される便利な入札機能です。これを有効化することで、入札戦略により、コンバージョンや販売の可能性に基づき入札額が自動的に増減されます。

入札額の管理には、検索結果ページの上部および商品ページに優先順位を設定する機能もあります。また広告主様は、入札額調整の対象とならない、固定の入札額を指定することもできます。入札額の管理戦略と掲載枠ごとの入札額調整は、個別に使用することも、併用することも可能です。Amazon Adsは両方の設定を反映させて、リアルタイムで入札額を算出します。

**注:**入札額の管理はスポンサープロダクト広告にのみ適用され、スポンサーブランド広告では使用できません。入札額の管理とプレミアム入札調整(Bid+)機能を併用することはできません。いずれかの機能のみを使用してください。

サンドボックス環境での入札額の管理の使用

サンドボックスでは、入札額の管理機能はデフォルトでは有効になっていません。サンドボックスで入札額の管理を使用する場合は、API呼び出しでヘッダーを追加する必要があります。入札額の管理ヘッダーは、他のヘッダーの標準構文には従いません。入札額の管理を有効にするヘッダーで指定できる値は、trueまたはyesです。ヘッダーに「true」または「yes」以外の値が含まれている場合、リクエストは受理されますが、入札額の管理機能は無効のままとなります。

GET /v1/sp/campaigns                                                   

 Host: advertising-api.amazon.com                                  
 Authorization: Bearer Atza|IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR…  
 Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.a8358a60…
 Amazon-Advertising-API-Scope: 1834670349583049580398              
 BIDDING_CONTROLS_ON: true
 Content-Type: application/json

入札戦略

キャンペーンレベルで利用可能な入札戦略は3つあります。

属性名 戦略名 説明
legacyForSales 入札の調整(ダウンのみ) 広告が販売につながる可能性が低い場合に随時入札額を下げます。2018年10月より前に作成されたキャンペーンでは、デフォルトでこの設定が使用されています。
autoForSales 入札の調整(アップとダウン) 広告が販売につながる可能性が高い場合に随時入札額を上げます(最大100%)。販売につながる可能性が低い場合には、入札額を下げます。
manual 固定入札額 広告主様が設定した固定の入札額とマニュアル調整を使用します。これは、入札調整の対象にはなりません。

掲載枠別の入札額調整

この管理を有効にすると、掲載枠の位置に応じて入札額を調整できます。入札額の管理を使用する位置を指定します。設定するパーセント値は、当初の入札額に対して金額を引き上げる調整割合(パーセント)です。たとえば、入札額が1米ドルで調整が50%とすると、指定の掲載枠を獲得できる機会の入札額が1.5米ドルに増えます。

| 述語 | 掲載枠 | 上昇率範囲 | | --- | --- | | placementTop | 検索結果ページの上部 | 0~900% | | placementProductPage | 商品ページ上 | 0~900% |

メソッド

メソッド URL ユースケース
GET /v1/sp/campaigns/{campaignId} IDを指定してキャンペーンを取得します
GET /v1/sp/campaigns キャンペーンのリストを取得します
PUT /v1/sp/campaigns <campaign_obj_json> campaign_obj_jsonに含まれる値で、キャンペーンのリストの入札額の管理を更新します
POST /v1/sp/campaigns campaign_obj_jsonに含まれる値で、キャンペーンのリストに対し、新しい入札額の管理を作成します

リソース表現

キャンペーン

{
   "campaignType": "sponsoredProducts",
   "dailyBudget": 1.00,
   "endDate": "20190401",
   "campaignId": 248014350279610,
   "name": "Bid_controls_test_campaign",
   "targetingType": "manual",
   "state": "enabled",
   "premiumBidAdjustment": false,
   "startDate": "20190101",
   "bidding": {
       "strategy": "autoForSales",
       "adjustments": [
            {
               "predicate": "placementTop",
               "percentage": 50
            }
        ]
    }
  }

入札額の管理とプレミアム入札調整(Bid+)

入札額の管理は、プレミアム入札調整(Bid+とも呼ばれます)の代替機能です。プレミアム入札調整機能は今後廃止される予定です。Bid+はまだ使用可能な機能ですが、Bid+と入札管理は併用できないことにご注意ください。現在キャンペーンでBid+を使用している場合は、次の入札戦略に変換されます: 「従来の販売(ダウンのみ)」と検索結果の上部掲載枠に対する50%の調整。

レポートとスナップショット

入札額の管理データは、キャンペーンレポートとスナップショットに表示されます。キャンペーンパフォーマンスレポートにplacementパラメーターを含めることで、検索結果の上部および商品ページのパフォーマンスを評価できます。