开发人员指南概述

亚马逊广告 API 概览

商品推广关键词建议

借助商品推广关键词建议，您可以检索关键词投放的竞价建议，以及给定 ASIN 列表或指定广告活动标识符和相关广告组标识符的影响指标。在响应中，建议关键词使用您选择的排序维度进行排名，同时为不同主题的关键词提供竞价建议。

目前有三个版本的关键词建议资源：版本 3、版本 4 和版本5。如果您当前已集成版本 3 或版本 4，请尽快集成版本 5。

版本 3

版本 3 引入了关键词建议，并允许检索给定 ASIN 列表或指定的广告活动标识符和关联的广告组标识符的建议。响应支持按照点击量、转化量或默认维度进行排序。

版本 4

版本 4 包含了版本 3 的所有功能，还添加了搜索词指标。搜索词展示量份额表示您在过去 30 天内通过该关键词获得的所有归因于广告的展示量中所占的百分比份额。该指标可以帮助广告主根据其通过相关关键词的份额来确定潜在机会。搜索词展示量排名表示您在某个站点按广告展示量排列的某个关键词在所有广告主中的排名。它可以让广告主了解具有更高广告展示量份额的广告主所占比例。搜索词信息仅适用于广告主借助广告展示量进行投放的关键词。

版本 5

版本 5 包含了版本 4 的所有功能，并添加了基于主题的竞价建议，为每个关键词返回了改进的竞价建议。基于主题的竞价建议为每个关键词提供了主题和影响力指标，以及各项相应的竞价建议，帮助您为关键词投放选择合适的竞价。版本 5 还新增了影响力指标，其中包括对点击量和具有竞价价值的采购订单增长的洞察，帮助您选择适合您投放内容目标的合适竞价。响应中包含了每个关键词的三种建议竞价。该资源包括在与低、中、高竞价分别对应的广告组级别聚合的三组影响力指标。

请注意，影响力指标是基于相似商品的历史绩效来提供对竞价选择的指导，并不是预期绩效的估算。另外，影响力指标是在假设广告活动没有用完预算的前提下计算的。版本 5 提供了每周点击量和订单量的历史绩效指标，以针对竞价选择提供指导。建议竞价将在关键词级别返回，影响力指标在广告组级别汇总。

影响力指标反映了响应中所有建议关键词的汇总绩效。如果您只想查看选定关键词子集的影响力指标，可以使用针对此子集的关键词建议服务，以获取此集合的竞价和影响力指标。或者，您也可以请求按照维度（转化量和点击量）排序时返回前 N 个关键词，这将返回仅与此 N 个关键词集合相对应的指标。

开始使用商品推广关键词建议

通过 POST /sp/targets/keywords/recommendations资源，根据给定的广告 ASIN 列表或指定的广告活动标识符和关联的广告组标识符，检索建议的关键词投放内容。在该请求中，使用 recommendationType 字段指定此选项。

在响应中，关键词建议按照点击量或展示量的降序排列，取决于请求中的 sortDimension 字段的设置。该字段可以设置为 clicks、conversions 或 default 中的一个。

请注意，您可以使用请求体中的 targets 数组将自己的关键词投放内容与关键词建议一起排名。

最后，使用 locale 字段将关键词翻译为指定区域的语言。可以使用 /keywords/localize 资源检索支持的站点与区域的映射关系。

示例

要获取新广告组的关键词建议，请按点击量对关键词进行排序，并使用“动态竞价 - 提高和降低”。

请求体：

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

Response body:

{  
  "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
}

Response:

{  
  "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        
        }
      }
    }
  ]
}

获取现有广告组的两个关键词建议，并使用默认的排名启发式方法对关键词进行排序，但不需要竞价建议。

请求体：

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

Response:

{  
  "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
}
Amazon Advertising logo