縦型広告のコントロールと広告枠のフィルタリング

業種別広告は、ホテルなど、業種別フィードにリンクされている AI 最大化設定が有効な検索キャンペーン向けの特別な機能を提供します。広告グループ単位で配信する業種別広告フォーマットを管理できます。また、業種別広告の商品グループルールを使用して、ターゲットとするフィードエンティティを管理できます。

概要

このガイドでは、業種別広告の管理に関する次の 2 つの主な機能について説明します。

フォーマットの管理: 広告グループ単位で、特定の広告フォーマット（テキスト広告、予約リンク、縦型プロモーション広告）を有効または無効にします。
垂直広告アイテムの管理: SharedSet andSharedCriterion` を含むルールベースのシステムを使用して、リンクされた垂直（以前の旅行）フィードから特定の広告枠をフィルタしてターゲットに設定します。

前提条件

これらの機能を実装する前に、キャンペーンが次の要件を満たしていることを確認してください。

キャンペーンタイプ: 検索キャンペーンである必要があります。
業種別フィード: 有効な業種別データフィードがキャンペーンにリンクされている必要があります。
AI 最大化設定: キャンペーンで [AI 最大化設定] を有効にする必要があります。

広告グループのフォーマットコントロール

特定の広告グループで有効にする業種別広告フォーマットを設定できるようになりました。これは、AdGroup リソースの vertical_ads_format_setting フィールドで管理されます。

使用可能な形式

テキスト広告: デフォルトで有効になっています。無効にできます。
予約リンク: オプトインが必要です。
業種別プロモーション広告: オプトインが必要です。

検証規則

1 つの広告グループで 3 つのフォーマットすべてを同時にオプトアウトすることはできません。
これらの設定は、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...

縦長広告アイテムの管理

「ボストンのホテル」や「1 つ星のホテルを除外」など、フィードインベントリの特定のサブセットをターゲットに設定するには、業種別広告の商品アイテムグループルールを使用する必要があります。

データモデルの仕組み

データモデルでは、共有基準アプローチが使用されます。

SharedSet: 型 VERTICAL_ADS_ITEM_GROUP_RULE_LIST の SharedSet を作成します。
SharedCriterion: このセットにルール（条件）を追加します。各ルールでは、都市やホテルクラスなどのディメンションと値を指定します。除外条件を作成してアイテムを除外することもできます。
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`	3 つの広告フォーマット（テキスト広告、予約リンク広告、プロモーション広告）が同時に無効になりました。	`VerticalAdsFormatSetting` で少なくとも 1 つの形式が有効（true に設定）になっていることを確認します。
`VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...`	キャンペーンで AI 最大化が有効になっていないか、有効な業種別フィードがありません。	キャンペーン設定で AI 最大化設定を有効にし、有効な業種別フィードがリンクされていることを確認します。
`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` ディメンションが業種と一致していることを確認します。