開発者ガイドの概要

Amazon Ads APIの概要

スポンサープロダクト広告のキーワードに関する推奨事項

スポンサープロダクト広告の推奨キーワードを使用すると、キーワードターゲットの推奨入札額に加え、特定のASINリストや指定されたキャンペーン識別子、関連付けられた広告グループ識別子のインパクト指標を確認できます。レスポンスでは、推奨キーワードは選択したソート条件をもとにランク付けされ、さまざまなテーマにおけるキーワードの推奨入札額が表示されます。

現在、キーワード推奨リソースには、バージョン3、バージョン4、バージョン5の3つのバージョンがあります。現在、バージョン3またはバージョン4と統合している場合は、できるだけ早くバージョン5と統合することをおすすめします。

バージョン3

バージョン3ではキーワードに関する推奨事項が導入され、特定のASINリストや指定されたキャンペーン識別子、関連付けられた広告グループ識別子のいずれかに関する推奨事項を確認できるようになりました。レスポンスでは、クリック数コンバージョンデフォルトディメンションのいずれかによるソートがサポートされました。

バージョン4

バージョン4にはバージョン3のすべての機能が含まれていますが、検索用語指標が追加されています。検索用語のインプレッションシェアは、過去30日にそのキーワードで獲得したすべての広告起因インプレッションのパーセンテージを示します。この指標は、広告主が関連性の高いキーワードのシェアに基づいて潜在的な機会を特定するのに役立ちます。検索用語のインプレッションランクは、マーケットプレイスでの広告インプレッション数による、キーワードに関するすべての広告主の中のランキングを示します。これは、広告主に、広告インプレッションのシェアが高かった広告主の数を伝えます。検索用語情報は、広告主が広告インプレッションでターゲットにしたキーワードについてのみ使用できます。

バージョン5

バージョン5には、バージョン4のすべての機能が含まれ、各キーワードの改善された入札額に関する推奨事項を返すテーマベースの入札額に関する推奨事項が追加されています。テーマベースの入札額に関する推奨事項では、キーワードターゲットに適した入札額を選択するのに役立つテーマインパクト指標が各推奨入札額とともに表示されます。バージョン5では、クリック数と注文数の増加に関するインサイトと入札額を含むインパクト指標も追加されているため、目標に合った適切な入札額を選択しやすくなります。レスポンスには、各キーワードの推奨入札額が3つ含まれています。リソースには、それぞれ入札額、中央入札額、入札額に関連する広告グループレベルで集計された3セットのインパクト指標が含まれています。

インパクト指標は、入札額を選択する際の目安となるような類似商品の過去のパフォーマンスに基づいており、期待されるパフォーマンスの推定値ではないことに注意してください。また、インパクト指標は、キャンペーンの予算が超過していないことを前提に計算されます。バージョン5では、入札額に加え、週ごとのクリック数と注文の過去のインパクト指標が表示され、どの入札額を選択すべきかについてのガイダンスが示されます。推奨入札額はキーワードレベルで返され、インパクト指標は広告グループレベルで集約されます。

インパクト指標は、レスポンスに含まれるすべての推奨キーワードのパフォーマンスを集計したものです。特定のキーワードのサブセットのみのインパクト指標を確認したい場合は、キーワード推奨サービスをこのサブセットでのみ使用して、このセットの入札額とインパクト指標を確認できます。または、ディメンション(コンバージョンとクリック数)順に上位N個のキーワードを受け取るようにリクエストすることもできます。これにより、このN個のキーワードのセットのみに対応する指標が返されます。

スポンサープロダクト広告のキーワードに関する推奨事項の利用を開始する

POST /sp/targets/keywords/recommendationsリソースは、広告ASINのリスト、または指定されたキャンペーンIDと関連する広告グループ識別子のいずれかを指定して、推奨キーワードターゲットを取得します。リクエストでは、recommendationTypeフィールドを使用してこの選択を指定します。

レスポンスでは、キーワードに関する推奨事項は、リクエストのsortDimensionフィールドに設定されている値に応じて、クリック数またはインプレッションの降順でランク付けされます。この値は、clicksconversions、またはdefaultのいずれかです。

リクエストボディのtargets配列を使用して、キーワードに関する推奨事項と一緒にランク付けする独自のキーワードターゲットを含めることができます。

最後に、localeフィールドを使用して、キーワードを指定したロケールにローカライズします。サポートされているマーケットプレイスからロケールへのマッピングは、/keywords/localizeリソースを使用して取得できます。

新しい広告グループのキーワードに関する推奨事項を表示するには、キーワードをクリック数で並べ替え、「動的な入札 - アップとダウン」を使います。

リクエストボディ:

{
  "recommendationType": "KEYWORD_FOR_ASINS",
  "biddingStrategy": "AUTO_FOR_SALES",
  "sortDimension": "CLICKS",
  "asins": [
    "asin1",
    "asin2",
    "asin3"
  ],
  "bidsEnabled": true
}

レスポンスボディ:

{  
  "keywordTargetList": [    
    {      
      "keyword": "keyword1",     
      "bidInfo": [        
        {          
          "matchType": "BROAD",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 75,         
          "suggestedBid": {            
            "rangeStart": 50,           
            "suggested": 75,           
            "rangeEnd": 100          
          }
        },
        {          
          "matchType": "PHRASE",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 79,         
          "suggestedBid": {            
            "rangeStart": 54,           
            "suggested": 79,           
            "rangeEnd": 105          
          }
        },
        {          
          "matchType": "EXACT",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 76,         
          "suggestedBid": {            
            "rangeStart": 60,           
            "suggested": 76,           
            "rangeEnd": 98          
          }
        }
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345ABC"    
    },
    {      
      "keyword": "keyword2",     
      "bidInfo": [        
        {          
          "matchType": "BROAD",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 2,         
          "bid": 47,         
          "suggestedBid": {            
            "rangeStart": 34,           
            "suggested": 47,           
            "rangeEnd": 67          
          }
        },
        {          
          "matchType": "PHRASE",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 2,         
          "bid": 57,         
          "suggestedBid": {            
            "rangeStart": 43,           
            "suggested": 57,           
            "rangeEnd": 70          
          }
        },
        {          
          "matchType": "EXACT",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 2,         
          "bid": 58,         
          "suggestedBid": {            
            "rangeStart": 44,           
            "suggested": 58,           
            "rangeEnd": 70          
          }
        }
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345XYZ"    
    },
  ],
  "impactMetrics": [    
    {      
      "theme": "CONVERSION_OPPORTUNITIES",     
      "clicks": {        
        "lowRange": {          
          "lower": 10,         
          "upper": 18        
        },       
        "middleRange": {          
          "lower": 22,         
          "upper": 31        
        },       
        "highRange": {          
          "lower": 26,         
          "upper": 34        
        }
      },     
      "orders": {        
        "lowRange": {          
          "lower": 2,         
          "upper": 5        
        },       
        "middleRange": {          
          "lower": 4,       
          "upper": 8        
        },       
        "highRange": {          
          "lower": 5,         
          "upper": 9        
        }
      }
    }
  ]
}

新しい広告グループのキーワードに関する推奨事項を確認するには、キーワードをコンバージョン別に並べ替え、固定入札を設定して、推奨キーワードに対するご自身のキーワードの掲載結果を確認します。

リクエストボディ:

{
  "recommendationType": "KEYWORD_FOR_ASINS",
  "biddingStrategy": "MANUAL",
  "sortDimension": "CONVERSIONS",
  "asins": [
    "asin1",
    "asin2",
    "asin3"
  ],
  "targets": [
    {
      "keyword": "your own keyword1",
      "matchType": "EXACT"
    },
    {
      "keyword": "your own keyword2"
    }
  ],
  "bidsEnabled": true
}

レスポンス:

{  
  "keywordTargetList": [    
    {      
      "keyword": "keyword1",     
      "bidInfo": [        
        {          
          "matchType": "BROAD",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 75,         
          "suggestedBid": {            
            "rangeStart": 50,           
            "suggested": 75,           
            "rangeEnd": 100          
          }
        },
        {          
          "matchType": "PHRASE",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 79,         
          "suggestedBid": {            
            "rangeStart": 54,           
            "suggested": 79,           
            "rangeEnd": 105          
          }
        },
        {          
          "matchType": "EXACT",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 1,         
          "bid": 76,         
          "suggestedBid": {            
            "rangeStart": 60,           
            "suggested": 76,           
            "rangeEnd": 98          
          }
        }
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345ABC"    
    },
    {      
      "keyword": "your own keyword1",     
      "bidInfo": [        
        {          
          "matchType": "EXACT",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 2,         
          "bid": 29,         
          "suggestedBid": {            
            "rangeStart": 27,           
            "suggested": 29,           
            "rangeEnd": 34          
          }
        }
      ],           
      "userSelectedKeyword": true,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "54321DEF"    
    },
    {      
      "keyword": "keyword2",     
      "bidInfo": [        
        {          
          "matchType": "BROAD",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 3,         
          "bid": 47,         
          "suggestedBid": {            
            "rangeStart": 34,           
            "suggested": 47,           
            "rangeEnd": 67          
          }
        },
        {          
          "matchType": "PHRASE",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 3,         
          "bid": 57,         
          "suggestedBid": {            
            "rangeStart": 43,           
            "suggested": 57,           
            "rangeEnd": 70          
          }
        },
        {          
          "matchType": "EXACT",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 3,         
          "bid": 58,         
          "suggestedBid": {            
            "rangeStart": 44,           
            "suggested": 58,           
            "rangeEnd": 70          
          }
        }
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345XYZ"    
    },
    {      
      "keyword": "your own keyword2",     
      "bidInfo": [        
        {          
          "matchType": "BROAD",         
          "theme": "CONVERSION_OPPORTUNITIES",         
          "rank": 4,         
          "bid": 146,         
          "suggestedBid": {            
            "rangeStart": 86,           
            "suggested": 146,           
            "rangeEnd": 226          
          }
        }
      ],           
      "userSelectedKeyword": true,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "56789HIJ"    
    },
  ],
  "impactMetrics": [    
    {      
      "theme": "CONVERSION_OPPORTUNITIES",     
      "clicks": {        
        "lowRange": {          
          "lower": 10,         
          "upper": 18        
        },       
        "middleRange": {          
          "lower": 22,         
          "upper": 31        
        },       
        "highRange": {          
          "lower": 26,         
          "upper": 34        
        }
      },     
      "orders": {        
        "lowRange": {          
          "lower": 2,         
          "upper": 5        
        },       
        "middleRange": {          
          "lower": 4,       
          "upper": 8        
        },       
        "highRange": {          
          "lower": 5,         
          "upper": 9        
        }
      }
    }
  ]
}

既存の広告グループについてキーワードに関する推奨事項を2つ取得し、デフォルトのランキングヒューリスティックを使用してキーワードを並べ替えるが、推奨入札額は表示しない場合。

リクエストボディ:

{
  "recommendationType": "KEYWORD_FOR_ASINS",
  "maxRecommendations": 2,
  "campaignId": "A12345678",
  "adGroupId": "B12345678",
  "bidsEnabled": false
}

レスポンス:

{  
  "keywordTargetList": [    
    {      
      "keyword": "keyword1",     
      "bidInfo": [        
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345ABC"    
    },
    {      
      "keyword": "keyword2",     
      "bidInfo": [        
      ],           
      "userSelectedKeyword": false,     
      "searchTermImpressionRank": 0,     
      "searchTermImpressionShare": 0,     
      "recId": "12345XYZ"    
    },
  ],
  "impactMetrics":null
}