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

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

Обзор

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

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

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

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

• Тип кампании: Обязательно поисковая кампания.
• Вертикальный поток данных: К кампании должен быть привязан активный вертикальный поток данных.
• AI Max: Для проведения кампании необходимо включить параметр "AI Max".

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

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

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

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

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

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

• Для одной группы объявлений нельзя одновременно отказаться от всех трех форматов.
• Эти настройки применяются только к группам объявлений типов 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-звездочные отели», необходимо использовать правила группировки элементов вертикальных объявлений.

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

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

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

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

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

• item_code : Идентификатор конкретного товара.
• 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 . В версии 23 для API Google Ads добавлены специальные сегменты для детальной отчетности.

Новые сегменты

• 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 , либо отсутствует активная вертикальная лента.	Включите AI Max в настройках кампании и убедитесь, что подключена действительная вертикальная лента.
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 соответствует вашему типу вертикальной рекламы.