生成广告组主题

借助 KeywordPlanIdeaService，您 可以生成与现有关键字和广告组主题相同的关键字。

例如，如果主题是 bakery，则该服务会生成可 触发广告的关键字，以响应 bakery near me、local bakery 或 cake shop 等搜索查询。

关键字整理建议

整理关键字构想（例如，使用 GenerateKeywordIdeas发现的关键字构想或您自己的候选列表），以便使用 KeywordPlanIdeaService.GenerateAdGroupThemes用于 现有广告组。您可以自动将关键字和匹配类型分配给最匹配的目标广告组，而不是手动将建议的关键字分组到广告组中。

构建 GenerateAdGroupThemesRequest 时，请提供 以下必填字段：

• customer_id：您要为其生成广告组主题的客户的 ID。
• keywords：最多包含 10,000 个种子关键字字符串的列表，用于整理。
• ad_groups：最多包含 10,000 个现有广告组资源名称（格式为 customers/{customer_id}/adGroups/{ad_group_id}）的列表，用于作为目标主题。

该 API 会返回一个 GenerateAdGroupThemesResponse，其中包含：

• ad_group_keyword_suggestions： AdGroupKeywordSuggestion 对象的列表。每项建议都会将 keyword_text（以及规范化的 suggested_keyword_text）和 suggested_match_type（BROAD、PHRASE 或 EXACT）与 suggested_ad_group 和 suggested_campaign 配对。
• unusable_ad_groups： UnusableAdGroup 对象的列表，用于标识该服务无法用作主题目标的任何输入广告组（例如，如果广告组不是 ENABLED，或者属于既不是 ENABLED 也不是 PAUSED 的广告系列）。

由于 GenerateAdGroupThemes 不会直接更改您的账号，因此您可以：

1. 将返回的建议分组到 CampaignToForecast 内的 ForecastAdGroup 对象中，以使用 GenerateKeywordForecastMetrics估算 未来的流量。
2. 通过创建 AdGroupCriterion资源，使用 AdGroupCriterionService.MutateAdGroupCriteria将最终确定的建议应用于目标投放广告组。