智能广告系列

注意： 自 2026 年 9 月 23 日起，创建智能广告系列的功能将被弃用，不再受支持。尝试创建智能广告系列会在 v24（从 v24.2 开始）和 v25 中返回 SmartCampaignError.CREATION_FAILED，或在 v23（以及 v24.2 之前的 v24）中返回 AuthorizationError.ACTION_NOT_PERMITTED。您账号中的智能广告系列会继续投放广告，并且仍可在报告中更新或查询。

注意 ：在 v25（从 v25.2 开始）中，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 将智能广告系列转换为效果最大化广告系列（在 v24 及更早版本中不可用）。如需了解详情，请参阅将智能广告系列转换为效果最大化广告系列指南。

智能广告系列旨在帮助小型企业在线上覆盖更多客户。它们只需要极少的设置和维护。智能广告系列依靠 Google 的广告技术，根据您的业务详情和目标（无论是吸引客户来电、光顾实体店，还是在您的网站上执行特定操作）自动优化广告系列。

制作广告系列

智能广告系列的制作工作流程需要执行一些与其他广告系列类型不同的步骤。最佳做法是在单个 GoogleAdsService.Mutate 请求中添加实体。

以下是智能广告系列制作工作流程中的步骤（这些步骤中描述的实体关系和设置也适用于在您的账号中检查或更新智能广告系列）。如需了解详情，请查看完整的代码示例。

1. 根据 SmartCampaignSuggestService、KeywordThemeConstantService 中的建议或自由格式的关键字主题，构建关键字主题列表。这些关键字主题用于检索不同级别的预算建议、创建关键字主题广告系列定位条件，以及生成广告文字素材资源的建议。
2. 从 SmartCampaignSuggestService 中检索预算金额、广告标题和广告内容描述的建议。此服务会根据您的商家信息、目标地理位置、目标语言和关键字主题，建议 high、low 或 recommended 的每日预算金额，以及广告本身的最多三个标题和两个广告内容描述。
3. 使用建议的预算金额创建 CampaignBudget。使用建议的预算金额有助于最大限度地提升广告系列的效果。智能广告系列的预算无法与其他任何广告系列共用。
4. 创建 Campaign 和 SmartCampaignSetting。SmartCampaignSetting 无法独立于其关联的 Campaign 存在，因此请在同一 Mutate 请求中使用负的临时资源名称（例如 customers/{customer_id}/campaigns/-1）来关联相关资源，从而同时创建这两个实体。
5. 创建 CampaignCriterion 对象的列表。本指南将使用第 1 步中整理的关键字主题来创建关键字主题广告系列条件，并介绍其他受支持的广告系列条件类型。
6. 创建 AdGroup。一个智能广告系列只能关联一个AdGroup。
7. 使用包含 3 到 15 个标题和 2 到 4 条广告内容描述的 SmartCampaignAdInfo 创建 AdGroupAd。

商家资料中的营业地点

在生成建议或配置广告系列时，请提供您的商家资料位置标识符，以最大限度提升智能广告系列的效果。

您可以通过商家资料 API 的 name 字段或商家资料界面获取商家资料营业地点标识符。

如果为 SmartCampaignSuggestionInfo 或 SmartCampaignSetting 对象设置了此属性，则相应标识符应采用以下格式的字符串：

locations/locationId

如果从商家资料 API 检索，则标识符已采用正确的格式。不过，如果从界面检索，则需要将标识符附加到 locations/。

广告系列状态

如需检索智能广告系列的状态，请使用相应广告系列的 SmartCampaignSetting (customers/{customer_id}/smartCampaignSettings/{campaign_id}) 调用 SmartCampaignSettingService.GetSmartCampaignStatus resource_name。与 campaign.primary_status 或 campaign.primary_status_reasons 相比，此方法可提供智能广告系列状态的更汇总视图。

GetSmartCampaignStatusResponse 包含 SmartCampaignStatus（ELIGIBLE、NOT_ELIGIBLE、PENDING、PAUSED、REMOVED 或 ENDED），以及特定于状态的详细信息：

• not_eligible_details：包括 SmartCampaignNotEligibleReason（ACCOUNT_ISSUE、BILLING_ISSUE、BUSINESS_PROFILE_LOCATION_REMOVED 或 ALL_ADS_DISAPPROVED）。
• eligible_details：包括 last_impression_date_time（前 48 小时内观测到的最后一次展示的时间戳）和 end_date_time（如果适用）。
• paused_details、removed_details 和 ended_details：在客户的时区 (yyyy-MM-dd HH:mm:ss) 中包含相应的 paused_date_time、removed_date_time 或 end_date_time 时间戳。

报告注意事项

智能广告系列采用简化的结构，每个广告系列仅限包含一个广告组。此结构对报告具有特定影响：

• 广告组级指标：由于每个智能广告系列只有一个广告组，因此广告组级的所有效果指标（例如点击次数、展示次数和转化次数）都与整个广告系列的指标相同。
• 指标检索：在查询效果数据时，您可以检索广告系列级指标。虽然您可以检索广告组级指标，但这些指标不会提供比广告系列级指标更详细的信息。

对于大多数与智能广告系列相关的报告需求，查询 campaign 及其关联的指标可全面了解效果。