生成候选关键字

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

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

使用案例

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

种子关键字
种子广告组 ID
目标网站
地理位置
语言
产品和服务类别
以及其他多种因素

例如，如果您要创建新的广告系列，或优化现有的广告系列，则可以使用 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 文件夹中包含了一个完整代码示例：