竖屏广告的控制功能和广告资源过滤

垂直广告可为与垂直 Feed（例如酒店）相关联的启用 AI Max 的搜索广告系列提供专用功能。您可以在广告组一级控制投放哪些垂直广告格式，还可以使用垂直广告商品组规则控制定位哪些 Feed 实体。

概览

本指南介绍了用于管理竖屏广告的两项主要功能：

  1. 格式控制：在广告组一级选择启用或停用特定广告格式（文字广告、预订链接和竖屏宣传广告）。
  2. 垂直广告商品管理：使用基于规则的系统（涉及 SharedSet andSharedCriterion`）过滤和定位关联的垂直（以前称为旅游）Feed 中的特定广告资源。

前提条件

在实施这些功能之前，请确保您的广告系列满足以下要求：

  • 广告系列类型：必须是搜索广告系列。
  • 垂直 Feed：必须将有效的垂直数据 Feed 关联到广告系列。
  • AI Max：必须在广告系列中启用“AI Max”设置。

广告组格式控制功能

您现在可以配置特定广告组中哪些竖屏广告格式处于有效状态。此操作通过 AdGroup 资源中的 vertical_ads_format_setting 字段进行管理。

可用格式

  • 文字广告：默认处于启用状态。可以停用。
  • 预订链接：需要选择启用。
  • 行业专属促销广告：需要选择启用。

验证规则

  • 您无法同时针对单个广告组选择停用所有这三种格式。
  • 这些设置仅适用于 STANDARD 和 SEARCH_DYNAMIC_ADS 广告组类型。

示例：更新格式设置

以下示例演示了如何为现有广告组停用文字广告并启用竖屏宣传广告。

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .setVerticalAdsFormatSetting(
     
   VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

竖屏广告项管理

如需定位 Feed 商品目录中的特定子集，例如“波士顿的酒店”或“排除 1 星级酒店”，您必须使用垂直广告商品组规则。

数据模型的工作原理

数据模型采用共享条件方法：

  1. SharedSet：创建类型为 VERTICAL_ADS_ITEM_GROUP_RULE_LIST 的 SharedSet。
  2. SharedCriterion：向此集合添加规则（条件）。每条规则都指定一个维度（例如“城市”或“酒店星级”）和一个值。您还可以创建否定条件来排除商品。
  3. AdGroupCriterion：使用 AdGroupCriterion 将 SharedSet 关联到 AdGroup。

支持的维度

在 SharedCriterion 中，您可以根据以下维度过滤实体：

  • item_code：特定房源 ID。
  • city_criterion_id、region_criterion_id、country_criterion_id：地理位置定位常量。
  • brand_text：品牌名称。
  • hotel_class：星级评分（1-5）。
  • vertical_ads_item_category：类别，例如 CONCERT。

此示例创建了一条规则，用于纳入“波士顿”或“旧金山”中的商品，并排除“1 星级”和“2 星级”酒店。

Python

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
included_city_ids = [1006543, 1014221] # Geo Target Constant IDs
for city_id in included_city_ids:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.city_criterion_id = city_id
    shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.hotel_class = star_rating
    criterion.negative = True # Mark as exclusion
    shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

报告

您可以使用 GoogleAdsService.SearchStream 或 GoogleAdsService.Search 方法检索竖屏广告的效果指标。对于 Google Ads API，v23 新增了用于精细报告的特定细分。

新细分

  • segments.vertical_ads_listing_city：与房源相关联的城市。
  • segments.vertical_ads_vertical_type：垂直类型，例如酒店或租车。

GAQL 查询示例

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

错误处理

以下是配置竖屏广告时可能会遇到的常见错误。

错误代码 原因 推荐措施
INVALID_VERTICAL_ADS_FORMAT_SETTING 这三种广告格式（文字广告、预订链接广告、宣传广告）同时被停用。 确保在 VerticalAdsFormatSetting 中至少启用一种格式（设置为 true）。
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_... 相应广告系列未启用 AI Max，或者缺少有效的垂直行业 Feed。 在广告系列设置中启用 AI Max，并确保已关联有效的行业 Feed。
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST AdGroupCriterion 中提供的 SharedSet 资源名称不存在。 验证 shared_set 资源名称是否与已创建的集合匹配。
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED... 所用条件类型不受特定行业支持，例如租车行业的酒店类。 检查 vertical_ads_item_group_rule 维度是否与您的竖屏广告类型相符。