Настройки и фильтрация инвентаря для вертикальных объявлений

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

Обзор

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

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

Требования

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

• Тип кампании. Должна быть поисковая кампания.
• Фид вертикали. Активный фид данных вертикали должен быть связан на уровне клиента или кампании. Подробнее о том, как связать фид данных на уровне кампании… Привязка фида данных по вертикали активирует фиды туристических услуг в поисковых объявлениях и позволяет управлять вертикальными объявлениями в кампании.
• AI Max для поисковых кампаний. В кампании должна быть включена функция AI Max для поисковых кампаний.

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

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

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

Подробную информацию о массовом управлении фидами путешествий можно найти в документации по фидам путешествий в поисковых объявлениях.

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

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

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

• Текстовые объявления (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. 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. 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...

Назначение цены за клик вручную для отдельных объектов

Начиная с v25 в поисковых кампаниях для туризма (поисковых кампаниях с включенной стратегией AI Max для поисковых кампаний и связанным фидом гостиниц), в которых используется стратегия назначения ставок "Назначение цены за клик вручную" (BiddingStrategyType.MANUAL_CPC), вы можете задать переопределения ставки (cpc_bid_micros) для отдельных элементов фида гостиниц с помощью критерия EntityBid (ad_group_criterion.entity_bid) с CriterionType.VERTICAL_ADS_ITEM_BID и entity_bid.item_code.

Минус-критерии (negative = true), кампании, не относящиеся к поисковой сети, и стратегии автоматического или интеллектуального назначения ставок не поддерживаются для VERTICAL_ADS_ITEM_BID и возвращают ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Показатели эффективности не заполняются для критериев VERTICAL_ADS_ITEM_BID. Полная схема, запросы GAQL и примеры полезной нагрузки для изменения приведены в разделе Назначение цены за клик вручную на уровне объекта руководства по фидам путешествий в поисковых объявлениях. Чтобы задать мультипликативные корректировки ставок на уровне группы объявлений для параметров маршрута путешествия в рекламе отелей с помощью AdGroupBidModifier, ознакомьтесь со статьей Как корректировать ставки с помощью модификаторов ставок.

Отчеты по эффективности

Показатели эффективности вертикальных объявлений можно получить с помощью методов 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 – аккаунт партнера в Партнерском центре (например, Hotel Center), который предоставляет данные фида ассортимента.
• 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 – разница в процентах между ценой, предложенной рекламодателем, и самой низкой конкурирующей ценой на тот же объект.

Примеры запросов 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

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

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