生成候选关键字

AdWords 网页界面中的关键字规划师基于现有关键字和网站提出新的关键字提示。然后,您可以获取关键字的历史统计信息(平均每次点击费用,每月搜索量等),帮助您决定是否要使用这些关键字提示。

而 AdWords API 中的 TargetingIdeaService 可让您从自己的工具/平台获取定位提示,自动进行帐户优化,从而实现类似目标。

使用案例

TargetingIdeaService 可用来基于以下一些输入获取新的关键字提示:

例如,如果您要创建新的广告系列,或优化现有的广告系列,则可以使用 TargetingIdeaService,根据您现有的关键字分类,获取候选关键字的列表。

您可以使用该服务来获得类似于以下关键字规划师操作的结果:

  • 使用某个词组、网站或类别搜索新关键字
  • 组合多个关键字列表以获取新的关键字提示
  • 获取搜索量数据和搜索趋势

第四个关键字规划师函数获取点击和费用的效果预测值使用 TrafficEstimatorService

获取关键字提示

TargetingIdeaService 的主要输入是 TargetingIdeaSelector。以下是通过使用一对种子关键字,自 TargetingIdeaService 获取关键字提示的一个示例。

为请求做准备

首先,使用说明此请求的目的是为了获取关键字提示的参数,准备 TargetingIdeaSelector

TargetingIdeaSelector selector = new TargetingIdeaSelector();
selector.setRequestType(RequestType.IDEAS);
selector.setIdeaType(IdeaType.KEYWORD);

接下来,选择必须获取的属性。属性可以被认为是与关键字相关的各个列/字段:

selector.setRequestedAttributeTypes(new AttributeType[] {
    AttributeType.AVERAGE_CPC,
    AttributeType.COMPETITION,
    AttributeType.CATEGORY_PRODUCTS_AND_SERVICES,
    AttributeType.KEYWORD_TEXT,
    AttributeType.SEARCH_VOLUME
});

最后,使用 RelatedToQuerySearchParameter,指定从中产生新提示的种子关键字列表:

// Get ideas related to query search parameter.
RelatedToQuerySearchParameter relatedToQuerySearchParameter =
    new RelatedToQuerySearchParameter();
relatedToQuerySearchParameter.setQueries(new String[]
    {"bakery", "pastries", "birthday cake"});

selector.setSearchParameters(
    new SearchParameter[] {relatedToQuerySearchParameter});

配置了 TargetingIdeaSelector 之后,通过 get 操作进行发送,以获取关键字提示:

// Get keyword ideas.
TargetingIdeaPage page = targetingIdeaService.get(selector);

处理响应

响应由一列 TargetingIdea 对象组成。每个 TargetingIdea 对象包含与 Attribute 相关联的 AttributeType 的映射。将每个 TargetingIdea 对象看作数据行,每个 AttributeType 看作行的字段/列,相应的 Attribute 看作该数据单元格中的值,理解起来更容易。

for (TargetingIdea targetingIdea : page.getEntries()) {
    Map<AttributeType, Attribute> data =
        Maps.toMap(targetingIdea.getData());

    StringAttribute keyword =
        (StringAttribute) data.get(AttributeType.KEYWORD_TEXT);
    IntegerSetAttribute categories = (IntegerSetAttribute)
        data.get(AttributeType.CATEGORY_PRODUCTS_AND_SERVICES);
    LongAttribute averageMonthlySearches = ((LongAttribute)
        data.get(AttributeType.SEARCH_VOLUME)).getValue();
    …
}

这个示例请求选择了四个属性,所以示例响应可能如下所示:

KEYWORD_TEXT SEARCH_VOLUME AVERAGE_CPC COMPETITION
蛋糕店 170 0.485384 0.41
西饼故事 390 0.069918 0.12

获取关键字统计信息

获取关键字的历史统计信息与获取关键字提示非常相似。唯一的区别是,RequestType 必须设置为 STATS

TargetingIdeaSelector selector = new TargetingIdeaSelector();
selector.setRequestType(RequestType.STATS);

获取特定关键字的类别就是一个很好的例子。

TargetingIdeaSelector selector = new TargetingIdeaSelector();
selector.setRequestType(RequestType.STATS);
selector.setIdeaType(IdeaType.KEYWORD);
selector.setRequestedAttributeTypes(new AttributeType[] {
    AttributeType.KEYWORD_TEXT,
    AttributeType.CATEGORY_PRODUCTS_AND_SERVICES,
});
RelatedToQuerySearchParameter relatedToQuerySearchParameter =
    new RelatedToQuerySearchParameter();
relatedToQuerySearchParameter.setQueries(new String[]
    {"bakery"});
selector.setSearchParameters(
    new SearchParameter[] {relatedToQuerySearchParameter});

将广告组 ID 用作种子

如果您已经有现成的广告系列和广告组,则可以使用 SeedAdGroupIdSearchParameter 提供广告组 ID,获取定位提示。

// Get ideas related to query search parameter.
SeedAdGroupIdSearchParameter seedAdGroupIdSearchParameter =
    new seedAdGroupIdSearchParameter();
seedAdGroupIdSearchParameter.setAdGroupId(…);

selector.setSearchParameters(
    new SearchParameter[] {seedAdGroupIdSearchParameter});

与关键字规划师的对照

有关 TargetingIdeaService 的最常见问题之一是:“为什么 TargetingIdeaService 与关键字规划师工具所得结果不同?”

其原因是,TargetingIdeaSelector 可以使用多个不同的 SearchParameter 进行配置,使用不同的 SearchParameter,所返回的结果可能明显不同。

选择正确的投放网络

最常见的错误之一是不指定 NetworkSearchParameter。例如,关键字规划师可能只搜索 Google 搜索网络的关键字提示,但不能用于其他投放网络。在这种情况下,一定要在 TargetingIdeaSelector 中设置 NetworkSearchParameter。例如,如果只希望获取搜索网络的提示,请按以下方式设置 NetworkSearchParameter

TargetingIdeaSelector selector = new TargetingIdeaSelector();
…
// Set the network.
NetworkSearchParameter networkSearchParameter =
    new NetworkSearchParameter();

NetworkSetting networkSetting = new NetworkSetting();
networkSetting.setTargetGoogleSearch(true);
networkSetting.setTargetSearchNetwork(false);
networkSetting.setTargetContentNetwork(false);
networkSetting.setTargetPartnerNetwork(false);

networkSearchParameter.setNetworkSetting(networkSetting);

NetworkSearchParameter 的配置方式要与潜在广告系列的配置方式一致,这一点很重要。

使用某个词组、网站或类别搜索新关键字

要实现与此关键字规划师功能类似的功能,每个输入字段都可以映射到相应的 TargetingIdeaSelector 配置(如 SearchParameter):

关键字规划师 AdWords API
您的产品或服务 RelatedToQuerySearchParameter
您的着陆页 RelatedToUrlSearchParameter
您的产品类别 CategoryProductsAndServicesSearchParameter(请参考我们的产品和服务类别分类或 ID)
定位 - 地理位置 LocationSearchParameter
定位 - 语言 LanguageSearchParameter
定位 - 投放网络 NetworkSearchParameter
日期范围(每月搜索量) 选择 AttributeType.TARGETED_MONTHLY_SEARCHES
关键字过滤条件 - 平均每月搜索量 SearchVolumeSearchParameter
关键字过滤条件 - 竞争程度 CompetitionSearchParameter
包含/排除关键字 IdeaTextFilterSearchParameter
ExcludedKeywordSearchParameter

最后,将 TargetingIdeaSelector.requestType 设置为 IDEAS

组合多个关键字列表以获取新的关键字提示

AdWords API 不会自动计算关键字组合。为了实现同样的功能,您需要以编程方式确定合并的关键字列表,然后相应地设置 TargetingIdeaSelector

关键字规划师 AdWords API
列表 1 和列表 2 采用编程方式合并两个列表,然后使用 RelatedToQuerySearchParameter
定位 - 地理位置 LocationSearchParameter
定位 - 投放网络 NetworkSearchParameter

参数映射类似于其他此类功能:

关键字规划师 AdWords API
输入关键字 RelatedToQuerySearchParameter
定位 - 地理位置 LocationSearchParameter
定位 - 投放网络 NetworkSearchParameter
日期范围(每月搜索量) 选择 AttributeType.TARGETED_MONTHLY_SEARCHES

最后,将 TargetingIdeaSelector.requestType 设置为 STATS

代码示例

每个客户端库都在 Optimization 文件夹中包含了一个完整代码示例:

发送以下问题的反馈:

此网页
AdWords API
AdWords API
需要帮助?请访问我们的支持页面