Управление и фильтрация рекламного инвентаря для вертикальной рекламы

Вертикальные объявления предоставляют специализированные функции для поисковых кампаний с поддержкой AI Max for Search, связанных с вертикальным фидом, например, отелями. Вы можете контролировать, какие форматы вертикальных объявлений будут показываться на уровне группы объявлений, а также управлять тем, какие объекты фида будут таргетированы, используя правила для групп элементов вертикальных объявлений.

Обзор

В этом руководстве рассматриваются две основные функции для управления вертикальной рекламой:

1. Управление форматами: Включение или отключение определенных форматов рекламы (текстовая реклама, ссылки для бронирования и вертикальная рекламная реклама) на уровне группы объявлений.
2. Управление вертикальными рекламными объявлениями: фильтрация и таргетирование определенных объявлений из связанного вертикального (ранее называвшегося туристическим) фида с помощью системы правил, включающей SharedSet и SharedCriterion .

Предварительные требования

Прежде чем внедрять эти функции, убедитесь, что ваша кампания соответствует следующим требованиям:

• Тип кампании: Обязательно поисковая кампания.
• Вертикальный фид данных: Активный вертикальный фид данных должен быть связан на уровне клиента или кампании. Для связи фида на уровне кампании используйте ссылку «Связать вертикальные фиды данных на уровне кампании». Связывание вертикального фида данных активирует функцию «Туристические фиды в поисковой рекламе» (TFSA) и включает элементы управления вертикальными объявлениями для кампании.
• Для кампаний с использованием AI Max в поисковой рекламе: параметр AI Max для кампаний в поисковой рекламе должен быть включен.

Связывайте вертикальные потоки данных на уровне кампании.

To activate Travel Feeds in Search Ads (TFSA) and enable vertical ads controls within your campaign, you can link your vertical data feed asset set at the campaign level using the following steps. Alternatively, to enable these features for all campaigns in your account, you can link the feed at the customer level by following the customer-level linking instructions in the Travel Feeds in Search Ads guide.

1. Создайте объект CampaignAssetSet , установив для asset_set имя ресурса вашего набора ресурсов вертикального фида, а для campaign — имя ресурса вашей кампании.
2. Создайте операцию CampaignAssetSetOperation , указав в параметре create значение объекта CampaignAssetSet .
3. Отправьте операцию, используя CampaignAssetSetService.MutateCampaignAssetSets .

Для получения более подробной информации об управлении потоками туристических данных в больших масштабах обратитесь к документации по потокам туристических данных в поисковой рекламе .

Элементы управления форматом группы объявлений

Вы можете настроить, какие вертикальные форматы объявлений будут активны для конкретной группы объявлений. Это управляется через поле vertical_ads_format_setting ( VerticalAdsFormatSetting ) в ресурсе AdGroup .

Доступные форматы

• Текстовая реклама ( disable_text_ads ): включена по умолчанию. Может быть отключена.
• Ссылки для бронирования ( enable_booking_links ): Требуется подтверждение согласия.
• Вертикальная рекламная реклама ( enable_vertical_promotion_ads ): требуется подтверждение согласия.

Правила проверки

• Для одной группы объявлений нельзя одновременно отказаться от всех трех форматов.
• Эти настройки применяются только к группам объявлений типов SEARCH_STANDARD и SEARCH_DYNAMIC_ADS .

Пример: Обновить настройки формата

Следующий пример на Java демонстрирует, как отключить текстовые объявления и включить вертикальные рекламные объявления для существующей группы объявлений:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .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-звездочные отели», необходимо использовать правила группировки элементов вертикальных объявлений.

Как работает модель данных

В модели данных используется подход с общими критериями:

1. SharedSet : Создайте SharedSet типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .
2. SharedCriterion : Добавьте правила (критерии) в этот набор. Каждое правило задает измерение, например, «Город» или «Класс отеля», и значение. Вы также можете создавать отрицательные критерии для исключения элементов.
3. AdGroupCriterion : Свяжите SharedSet с вашей AdGroup , используя AdGroupCriterion ( vertical_ads_item_group_rule_list ).

Поддерживаемые размеры

В SharedCriterion ( VerticalAdsItemGroupRuleInfo ) можно фильтровать объекты по следующим параметрам:

• item_code : Идентификатор конкретного товара.
• city_criterion_id , region_criterion_id , country_criterion_id : названия ресурсов Geo Target Constant ( geoTargetConstants/{id} ).
• hotel_class : Рейтинг (1-5 звезд).
• user_rating , venue , event_participant_display_name (начиная с v24 ): Фильтры для рейтинга мероприятий и вертикальных списков, места проведения и имени участника.

Пример кода: Создание и связывание правил

В этом примере на Python создается правило, которое включает объекты из "Бостона" или "Сан-Франциско" и исключает отели "1 звезда" и "2 звезды":

# 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_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

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

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
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 = (
      geo_target_constant_service.geo_target_constant_path(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
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
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 .

Вертикальные сегменты рекламы

• segments.vertical_ads_hotel_class : Целочисленное значение (от 1 до 5 звезд), указывающее класс рейтинга для объявления об отеле.
• segments.vertical_ads_listing : Идентификатор для конкретного списка вертикальных объявлений.
• segments.vertical_ads_listing_brand : Бренд, связанный с вертикальным рекламным объявлением.
• segments.vertical_ads_listing_city : Город, связанный с объявлением.
• segments.vertical_ads_listing_country : Страна, связанная с данным объявлением.
• segments.vertical_ads_listing_region : Регион, связанный с объявлением.
• segments.vertical_ads_partner_account : Партнерский аккаунт в Партнерском центре (например, в Центре отелей), который предоставляет данные для фида рекламных мест.
• segments.vertical_ads_vertical : Тип вертикальной рекламы, например, отель или прокат автомобилей.
• segments.vertical_ads_event_participant_display_names (начиная с v24 ): Отображаемые имена участников в списке событий, такие как исполнители, докладчики или команды.
• segments.vertical_ads_listing_user_rating (начиная с v24 ): Целочисленное значение (от 1 до 5), указывающее пользовательский рейтинг вертикального списка объявлений.
• segments.vertical_ads_listing_venue (начиная с v24 ): Название места размещения вертикальной рекламы (например, концертный зал).
• segments.vertical_ads_price_tier (начиная с v25 ): Категория относительной ценовой конкурентоспособности для объявлений о продаже отелей.
• segments.vertical_ads_rate_rule_id (начиная с v25 ): строковый идентификатор, соответствующий частным или условным правилам расчета ставок, применяемым к ставке или показу.
• segments.vertical_ads_rate_type (начиная с v25 ): Классификация типов ставок: публичные, частные или условные.

Сегменты измерения маршрута

Начиная с v25 , для вертикальных объявлений, связанных с лентами о путешествиях и размещении, вы можете сегментировать отчеты об эффективности, используя параметры маршрута:

• segments.advance_booking_window : Окно предварительного бронирования маршрута в днях.
• segments.length_of_booking : Продолжительность бронирования маршрута в днях.
• segments.start_date : Дата начала бронирования в формате yyyy-MM-dd .
• segments.start_day_of_week : Начальный день недели бронирования.
• segments.user_set_dates : Указывает, были ли выбраны даты, указанные пользователем ( USER_SELECTED или DEFAULT_SELECTION ).

Показатели вертикальной рекламы

Начиная с v25 , вы можете получать следующие метрики вертикальной рекламы:

• metrics.vertical_ads_potential_impressions : Потенциальные показы, представляющие собой общее количество показов, подходящих для просмотра в контексте запроса.
• metrics.vertical_ads_average_booking_value_micros : Средневзвешенная суточная стоимость в микросекундах с учетом налогов и сборов за весь период проживания.
• metrics.vertical_ads_price_difference_percentage : Процентная разница между ценой, предложенной рекламодателем, и самой низкой ценой конкурента на тот же товар.

Пример GAQL-запроса

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Обработка ошибок

Вот распространенные ошибки, с которыми вы можете столкнуться при настройке вертикальной рекламы:

Вертикальные объявления предоставляют специализированные функции для поисковых кампаний с поддержкой AI Max for Search, связанных с вертикальным фидом, например, отелями. Вы можете контролировать, какие форматы вертикальных объявлений будут показываться на уровне группы объявлений, а также управлять тем, какие объекты фида будут таргетированы, используя правила для групп элементов вертикальных объявлений.

Обзор

В этом руководстве рассматриваются две основные функции для управления вертикальной рекламой:

1. Управление форматами: Включение или отключение определенных форматов рекламы (текстовая реклама, ссылки для бронирования и вертикальная рекламная реклама) на уровне группы объявлений.
2. Управление вертикальными рекламными объявлениями: фильтрация и таргетирование определенных объявлений из связанного вертикального (ранее называвшегося туристическим) фида с помощью системы правил, включающей SharedSet и SharedCriterion .

Предварительные требования

Прежде чем внедрять эти функции, убедитесь, что ваша кампания соответствует следующим требованиям:

• Тип кампании: Обязательно поисковая кампания.
• Вертикальный фид данных: Активный вертикальный фид данных должен быть связан на уровне клиента или кампании. Для связи фида на уровне кампании используйте ссылку «Связать вертикальные фиды данных на уровне кампании». Связывание вертикального фида данных активирует функцию «Туристические фиды в поисковой рекламе» (TFSA) и включает элементы управления вертикальными объявлениями для кампании.
• Для кампаний с использованием AI Max в поисковой рекламе: параметр AI Max для кампаний в поисковой рекламе должен быть включен.

Связывайте вертикальные потоки данных на уровне кампании.

To activate Travel Feeds in Search Ads (TFSA) and enable vertical ads controls within your campaign, you can link your vertical data feed asset set at the campaign level using the following steps. Alternatively, to enable these features for all campaigns in your account, you can link the feed at the customer level by following the customer-level linking instructions in the Travel Feeds in Search Ads guide.

1. Создайте объект CampaignAssetSet , установив для asset_set имя ресурса вашего набора ресурсов вертикального фида, а для campaign — имя ресурса вашей кампании.
2. Создайте операцию CampaignAssetSetOperation , указав в параметре create значение объекта CampaignAssetSet .
3. Отправьте операцию, используя CampaignAssetSetService.MutateCampaignAssetSets .

Для получения более подробной информации об управлении потоками туристических данных в больших масштабах обратитесь к документации по потокам туристических данных в поисковой рекламе .

Элементы управления форматом группы объявлений

Вы можете настроить, какие вертикальные форматы объявлений будут активны для конкретной группы объявлений. Это управляется через поле vertical_ads_format_setting ( VerticalAdsFormatSetting ) в ресурсе AdGroup .

Доступные форматы

• Текстовая реклама ( disable_text_ads ): включена по умолчанию. Может быть отключена.
• Ссылки для бронирования ( enable_booking_links ): Требуется подтверждение согласия.
• Вертикальная рекламная реклама ( enable_vertical_promotion_ads ): требуется подтверждение согласия.

Правила проверки

• Для одной группы объявлений нельзя одновременно отказаться от всех трех форматов.
• Эти настройки применяются только к группам объявлений типов SEARCH_STANDARD и SEARCH_DYNAMIC_ADS .

Пример: Обновить настройки формата

Следующий пример на Java демонстрирует, как отключить текстовые объявления и включить вертикальные рекламные объявления для существующей группы объявлений:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .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-звездочные отели», необходимо использовать правила группировки элементов вертикальных объявлений.

Как работает модель данных

В модели данных используется подход с общими критериями:

1. SharedSet : Создайте SharedSet типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .
2. SharedCriterion : Добавьте правила (критерии) в этот набор. Каждое правило задает измерение, например, «Город» или «Класс отеля», и значение. Вы также можете создавать отрицательные критерии для исключения элементов.
3. AdGroupCriterion : Свяжите SharedSet с вашей AdGroup , используя AdGroupCriterion ( vertical_ads_item_group_rule_list ).

Поддерживаемые размеры

В SharedCriterion ( VerticalAdsItemGroupRuleInfo ) можно фильтровать объекты по следующим параметрам:

• item_code : Идентификатор конкретного товара.
• city_criterion_id , region_criterion_id , country_criterion_id : названия ресурсов Geo Target Constant ( geoTargetConstants/{id} ).
• hotel_class : Рейтинг (1-5 звезд).
• user_rating , venue , event_participant_display_name (начиная с v24 ): Фильтры для рейтинга мероприятий и вертикальных списков, места проведения и имени участника.

Пример кода: Создание и связывание правил

В этом примере на Python создается правило, которое включает объекты из "Бостона" или "Сан-Франциско" и исключает отели "1 звезда" и "2 звезды":

# 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_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

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

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
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 = (
      geo_target_constant_service.geo_target_constant_path(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
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
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 .

Вертикальные сегменты рекламы

• segments.vertical_ads_hotel_class : Целочисленное значение (от 1 до 5 звезд), указывающее класс рейтинга для объявления об отеле.
• segments.vertical_ads_listing : Идентификатор для конкретного списка вертикальных объявлений.
• segments.vertical_ads_listing_brand : Бренд, связанный с вертикальным рекламным объявлением.
• segments.vertical_ads_listing_city : Город, связанный с объявлением.
• segments.vertical_ads_listing_country : Страна, связанная с данным объявлением.
• segments.vertical_ads_listing_region : Регион, связанный с объявлением.
• segments.vertical_ads_partner_account : Партнерский аккаунт в Партнерском центре (например, в Центре отелей), который предоставляет данные для фида рекламных мест.
• segments.vertical_ads_vertical : Тип вертикальной рекламы, например, отель или прокат автомобилей.
• segments.vertical_ads_event_participant_display_names (начиная с v24 ): Отображаемые имена участников в списке событий, такие как исполнители, докладчики или команды.
• segments.vertical_ads_listing_user_rating (начиная с v24 ): Целочисленное значение (от 1 до 5), указывающее пользовательский рейтинг вертикального списка объявлений.
• segments.vertical_ads_listing_venue (начиная с v24 ): Название места размещения вертикальной рекламы (например, концертный зал).
• segments.vertical_ads_price_tier (начиная с v25 ): Категория относительной ценовой конкурентоспособности для объявлений о продаже отелей.
• segments.vertical_ads_rate_rule_id (начиная с v25 ): строковый идентификатор, соответствующий частным или условным правилам расчета ставок, применяемым к ставке или показу.
• segments.vertical_ads_rate_type (начиная с v25 ): Классификация типов ставок: публичные, частные или условные.

Сегменты измерения маршрута

Начиная с v25 , для вертикальных объявлений, связанных с лентами о путешествиях и размещении, вы можете сегментировать отчеты об эффективности, используя параметры маршрута:

• segments.advance_booking_window : Окно предварительного бронирования маршрута в днях.
• segments.length_of_booking : Продолжительность бронирования маршрута в днях.
• segments.start_date : Дата начала бронирования в формате yyyy-MM-dd .
• segments.start_day_of_week : Начальный день недели бронирования.
• segments.user_set_dates : Указывает, были ли выбраны даты, указанные пользователем ( USER_SELECTED или DEFAULT_SELECTION ).

Показатели вертикальной рекламы

Начиная с v25 , вы можете получать следующие метрики вертикальной рекламы:

• metrics.vertical_ads_potential_impressions : Потенциальные показы, представляющие собой общее количество показов, подходящих для просмотра в контексте запроса.
• metrics.vertical_ads_average_booking_value_micros : Средневзвешенная суточная стоимость в микросекундах с учетом налогов и сборов за весь период проживания.
• metrics.vertical_ads_price_difference_percentage : Процентная разница между ценой, предложенной рекламодателем, и самой низкой ценой конкурента на тот же товар.

Пример GAQL-запроса

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Обработка ошибок

Вот распространенные ошибки, с которыми вы можете столкнуться при настройке вертикальной рекламы:

Вертикальные объявления предоставляют специализированные функции для поисковых кампаний с поддержкой AI Max for Search, связанных с вертикальным фидом, например, отелями. Вы можете контролировать, какие форматы вертикальных объявлений будут показываться на уровне группы объявлений, а также управлять тем, какие объекты фида будут таргетированы, используя правила для групп элементов вертикальных объявлений.

Обзор

В этом руководстве рассматриваются две основные функции для управления вертикальной рекламой:

1. Управление форматами: Включение или отключение определенных форматов рекламы (текстовая реклама, ссылки для бронирования и вертикальная рекламная реклама) на уровне группы объявлений.
2. Управление вертикальными рекламными объявлениями: фильтрация и таргетирование определенных объявлений из связанного вертикального (ранее называвшегося туристическим) фида с помощью системы правил, включающей SharedSet и SharedCriterion .

Предварительные требования

Прежде чем внедрять эти функции, убедитесь, что ваша кампания соответствует следующим требованиям:

• Тип кампании: Обязательно поисковая кампания.
• Вертикальный фид данных: Активный вертикальный фид данных должен быть связан на уровне клиента или кампании. Для связи фида на уровне кампании используйте ссылку «Связать вертикальные фиды данных на уровне кампании». Связывание вертикального фида данных активирует функцию «Туристические фиды в поисковой рекламе» (TFSA) и включает элементы управления вертикальными объявлениями для кампании.
• Для кампаний с использованием AI Max в поисковой рекламе: параметр AI Max для кампаний в поисковой рекламе должен быть включен.

Связывайте вертикальные потоки данных на уровне кампании.

To activate Travel Feeds in Search Ads (TFSA) and enable vertical ads controls within your campaign, you can link your vertical data feed asset set at the campaign level using the following steps. Alternatively, to enable these features for all campaigns in your account, you can link the feed at the customer level by following the customer-level linking instructions in the Travel Feeds in Search Ads guide.

1. Создайте объект CampaignAssetSet , установив для asset_set имя ресурса вашего набора ресурсов вертикального фида, а для campaign — имя ресурса вашей кампании.
2. Создайте операцию CampaignAssetSetOperation , указав в параметре create значение объекта CampaignAssetSet .
3. Отправьте операцию, используя CampaignAssetSetService.MutateCampaignAssetSets .

Для получения более подробной информации об управлении потоками туристических данных в больших масштабах обратитесь к документации по потокам туристических данных в поисковой рекламе .

Элементы управления форматом группы объявлений

Вы можете настроить, какие вертикальные форматы объявлений будут активны для конкретной группы объявлений. Это управляется через поле vertical_ads_format_setting ( VerticalAdsFormatSetting ) в ресурсе AdGroup .

Доступные форматы

• Текстовая реклама ( disable_text_ads ): включена по умолчанию. Может быть отключена.
• Ссылки для бронирования ( enable_booking_links ): Требуется подтверждение согласия.
• Вертикальная рекламная реклама ( enable_vertical_promotion_ads ): требуется подтверждение согласия.

Правила проверки

• Для одной группы объявлений нельзя одновременно отказаться от всех трех форматов.
• Эти настройки применяются только к группам объявлений типов SEARCH_STANDARD и SEARCH_DYNAMIC_ADS .

Пример: Обновить настройки формата

Следующий пример на Java демонстрирует, как отключить текстовые объявления и включить вертикальные рекламные объявления для существующей группы объявлений:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .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-звездочные отели», необходимо использовать правила группировки элементов вертикальных объявлений.

Как работает модель данных

В модели данных используется подход с общими критериями:

1. SharedSet : Создайте SharedSet типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .
2. SharedCriterion : Добавьте правила (критерии) в этот набор. Каждое правило задает измерение, например, «Город» или «Класс отеля», и значение. Вы также можете создавать отрицательные критерии для исключения элементов.
3. AdGroupCriterion : Свяжите SharedSet с вашей AdGroup , используя AdGroupCriterion ( vertical_ads_item_group_rule_list ).

Поддерживаемые размеры

В SharedCriterion ( VerticalAdsItemGroupRuleInfo ) можно фильтровать объекты по следующим параметрам:

• item_code : Идентификатор конкретного товара.
• city_criterion_id , region_criterion_id , country_criterion_id : названия ресурсов Geo Target Constant ( geoTargetConstants/{id} ).
• hotel_class : Рейтинг (1-5 звезд).
• user_rating , venue , event_participant_display_name (начиная с v24 ): Фильтры для рейтинга мероприятий и вертикальных списков, места проведения и имени участника.

Пример кода: Создание и связывание правил

В этом примере на Python создается правило, которое включает объекты из "Бостона" или "Сан-Франциско" и исключает отели "1 звезда" и "2 звезды":

# 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_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

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

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
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 = (
      geo_target_constant_service.geo_target_constant_path(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
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
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 .

Вертикальные сегменты рекламы

• segments.vertical_ads_hotel_class : Целочисленное значение (от 1 до 5 звезд), указывающее класс рейтинга для объявления об отеле.
• segments.vertical_ads_listing : Идентификатор для конкретного списка вертикальных объявлений.
• segments.vertical_ads_listing_brand : Бренд, связанный с вертикальным рекламным объявлением.
• segments.vertical_ads_listing_city : Город, связанный с объявлением.
• segments.vertical_ads_listing_country : Страна, связанная с данным объявлением.
• segments.vertical_ads_listing_region : Регион, связанный с объявлением.
• segments.vertical_ads_partner_account : Партнерский аккаунт в Партнерском центре (например, в Центре отелей), который предоставляет данные для фида рекламных мест.
• segments.vertical_ads_vertical : Тип вертикальной рекламы, например, отель или прокат автомобилей.
• segments.vertical_ads_event_participant_display_names (начиная с v24 ): Отображаемые имена участников в списке событий, такие как исполнители, докладчики или команды.
• segments.vertical_ads_listing_user_rating (начиная с v24 ): Целочисленное значение (от 1 до 5), указывающее пользовательский рейтинг вертикального списка объявлений.
• segments.vertical_ads_listing_venue (начиная с v24 ): Название места размещения вертикальной рекламы (например, концертный зал).
• segments.vertical_ads_price_tier (начиная с v25 ): Категория относительной ценовой конкурентоспособности для объявлений о продаже отелей.
• segments.vertical_ads_rate_rule_id (начиная с v25 ): строковый идентификатор, соответствующий частным или условным правилам расчета ставок, применяемым к ставке или показу.
• segments.vertical_ads_rate_type (начиная с v25 ): Классификация типов ставок: публичные, частные или условные.

Сегменты измерения маршрута

Начиная с v25 , для вертикальных объявлений, связанных с лентами о путешествиях и размещении, вы можете сегментировать отчеты об эффективности, используя параметры маршрута:

• segments.advance_booking_window : Окно предварительного бронирования маршрута в днях.
• segments.length_of_booking : Продолжительность бронирования маршрута в днях.
• segments.start_date : Дата начала бронирования в формате yyyy-MM-dd .
• segments.start_day_of_week : Начальный день недели бронирования.
• segments.user_set_dates : Указывает, были ли выбраны даты, указанные пользователем ( USER_SELECTED или DEFAULT_SELECTION ).

Показатели вертикальной рекламы

Начиная с v25 , вы можете получать следующие метрики вертикальной рекламы:

• metrics.vertical_ads_potential_impressions : Потенциальные показы, представляющие собой общее количество показов, подходящих для просмотра в контексте запроса.
• metrics.vertical_ads_average_booking_value_micros : Средневзвешенная суточная стоимость в микросекундах с учетом налогов и сборов за весь период проживания.
• metrics.vertical_ads_price_difference_percentage : Процентная разница между ценой, предложенной рекламодателем, и самой низкой ценой конкурента на тот же товар.

Пример GAQL-запроса

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Обработка ошибок

Вот распространенные ошибки, с которыми вы можете столкнуться при настройке вертикальной рекламы: