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

Vertical ads provide specialized features for AI Max for Search campaigns-enabled Search campaigns that are linked to a vertical feed, such as hotels. You can control which vertical ad formats are served at the ad group level, and you can control which feed entities are targeted using vertical ads item group rules.

Обзор

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

1. Управление форматами: Включение или отключение определенных форматов рекламы (текстовая реклама, ссылки для бронирования и вертикальная рекламная реклама) на уровне группы объявлений.
2. Vertical ads items management: Filter and target specific inventory from your linked vertical (formerly called travel) feed using a rule-based system that involves SharedSet and SharedCriterion .

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

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

• Тип кампании: Обязательно поисковая кампания.
• Vertical feed: An active vertical data feed must be linked at the customer or campaign level. See Link vertical data feeds at the campaign level to link a feed at the campaign level. Linking a vertical data feed activates Travel Feeds in Search Ads (TFSA) and enables vertical ads controls for the campaign.
• Для кампаний с использованием AI Max в поисковой рекламе: параметр AI Max для кампаний в поисковой рекламе должен быть включен.

Примечание: Изменение настроек управления форматом в кампании без AI Max для поиска или активного вертикального потока данных завершается ошибкой VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX или VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED . Аналогично, добавление правила группы элементов с измерением, не поддерживаемым для вертикального типа, завершается ошибкой VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE .

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

Чтобы активировать функцию «Туристические фиды в поисковой рекламе» (TFSA) и включить элементы управления вертикальными объявлениями в вашей кампании, вы можете связать набор данных вертикального фида на уровне кампании, выполнив следующие шаги. В качестве альтернативы, чтобы включить эти функции для всех кампаний в вашем аккаунте, вы можете связать фид на уровне клиента, следуя инструкциям по связыванию на уровне клиента в руководстве по функции «Туристические фиды в поисковой рекламе».

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

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

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

You can configure which vertical ad formats are active for a specific ad group. This is managed through the vertical_ads_format_setting ( VerticalAdsFormatSetting ) field on the AdGroup resource.

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

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

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

• Для одной группы объявлений нельзя одновременно отказаться от всех трех форматов.
• enable_booking_links можно установить в true только в том случае, если активная вертикальная лента кампании — HOTELS или THINGS_TO_DO .
• Эти настройки применяются только к группам объявлений типов 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(
        AdGroup.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 ) можно фильтровать сущности по следующим параметрам в зависимости от vertical_ads_item_vertical_type SharedSet :

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

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

В этом примере на 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 : Отображаемые имена участников в списке мероприятий, такие как исполнители, докладчики или команды.
• 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 : Процентная разница между ценой, предложенной рекламодателем, и самой низкой ценой конкурента на тот же товар.

Note: The metrics.vertical_ads_* metrics and the itinerary dimension segments ( segments.advance_booking_window , segments.length_of_booking , segments.start_date , segments.start_day_of_week , and segments.user_set_dates ) cannot be selected together in the same GAQL query.

Примеры запросов GAQL

Этот запрос извлекает конкурентные показатели и показатели бронирования вертикальных объявлений, сегментированные по городу размещения, ценовой категории и типу тарифа:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Этот запрос сегментирует стандартные показатели производительности по параметрам бронирования маршрута:

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.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

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

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

Код ошибки	Причина	Рекомендуемые действия
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING	Все три формата рекламы (текст, ссылка для бронирования, рекламные объявления) были отключены одновременно, либо enable_booking_links был включен для вертикали, отличной от HOTELS или THINGS_TO_DO .	Убедитесь, что в VerticalAdsFormatSetting включен хотя бы один формат, и включите ссылки для бронирования только для фидов HOTELS или THINGS_TO_DO .
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX	В данной рекламной кампании функция AI Max для поисковых кампаний не включена.	Включите функцию AI Max для поисковых кампаний в настройках кампании.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED	В рамках кампании отсутствует активная вертикальная подача данных.	Убедитесь, что на уровне клиента или кампании подключен корректный вертикальный фид.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	Указанное в AdGroupCriterion имя ресурса SharedSet не существует или не имеет типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .	Убедитесь, что имя ресурса shared_set ссылается на существующий SharedSet типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET	SharedSet на который ссылается AdGroupCriterion имеет статус REMOVED .	Укажите в качестве примера включенный SharedSet типа VERTICAL_ADS_ITEM_GROUP_RULE_LIST .
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE	Используемый критерий измерения не поддерживается для конкретной отрасли, например, для классификации отелей при прокате автомобилей.	Убедитесь, что параметр vertical_ads_item_group_rule соответствует вашему типу вертикальной рекламы.