Фиды туристических услуг в поисковых объявлениях

Если вы свяжете фиды товаров из категорий "Отели", "Жилье для отпуска" или "Things to do" с аккаунтом Google Рекламы, в ваши поисковые кампании будут автоматически добавляться цены и изображения из фидов. Эта функция называется фидами туристических услуг в поисковых объявлениях.

Как взаимодействуют настройки на уровне клиента и кампании

По умолчанию кампании наследуют ссылки на фиды путешествий (наборы объектов TRAVEL_FEED) на уровне клиента через связи CustomerAssetSet. Чтобы переопределить настройки на уровне клиента для определенной кампании, добавьте TRAVEL_FEED в поле excluded_parent_asset_set_types кампании и управляйте ссылками на уровне кампании с помощью CampaignAssetSet.

• Наследовать фиды клиентов (по умолчанию). Оставьте CustomerAssetSet на уровне клиента связанным и убедитесь, что Campaign.excluded_parent_asset_set_types не содержит TRAVEL_FEED.
• Отключить на уровне клиента. Удалите связь на уровне клиента CustomerAssetSet и не добавляйте связь на уровне кампании CampaignAssetSet.
• Отключить для определенной кампании. Добавьте TRAVEL_FEED в Campaign.excluded_parent_asset_set_types и удалите все связи CampaignAssetSet на уровне кампании.
• Включить только одну кампанию. Удалите связь на уровне клиента, CustomerAssetSet а затем создайте связь на уровне кампанииCampaignAssetSet для нужной кампании.
• Использовать фиды на уровне кампании, в то время как другие кампании продолжают наследовать фиды. Добавьте TRAVEL_FEED в Campaign.excluded_parent_asset_set_types кампании и создайте для нее ссылку CampaignAssetSet на уровне кампании.

Как отказаться от фидов туристических услуг в поисковых объявлениях

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

Как отключить фиды путешествий на уровне клиента

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

1. Получите значения customer_asset_set.resource_name и asset_set.resource_name для всех ссылок CustomerAssetSet типа TRAVEL_FEED с помощью отчета customer_asset_set:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. Для каждого объекта customer_asset_set.resource_name создайте объект CustomerAssetSetOperation и задайте для remove значение customer_asset_set.resource_name, полученное на предыдущем шаге.

3. Отправьте запрос в CustomerAssetSetService.MutateCustomerAssetSets, используя созданные объекты CustomerAssetSetOperation.

Если вы хотите снова включить эту функцию на уровне клиента, выполните следующие действия:

1. Для каждого базового AssetSet (asset_set.resource_name), который вы хотите связать, создайте новый CustomerAssetSet, в котором asset_set соответствует asset_set.resource_name, а customer – названию ресурса вашего клиента.
2. Для каждого объекта CustomerAssetSet, созданного на предыдущем шаге, создайте объект CustomerAssetSetOperation, в котором для поля create задано значение CustomerAssetSet.
3. Отправьте запрос в CustomerAssetSetService.MutateCustomerAssetSets, используя созданные объекты CustomerAssetSetOperation.

Как отключить фиды путешествий на уровне кампании

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

1. Получите excluded_parent_asset_set_types с помощью отчета campaign:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. Создайте новый объект Campaign, в котором для excluded_parent_asset_set_types заданы предыдущие значения плюс TRAVEL_FEED, а для resource_name – название ресурса кампании.

3. Создайте CampaignOperation и задайте для update ранее созданные Campaign и update_mask.

4. Отправьте запрос в CampaignService.MutateCampaigns, используя CampaignOperation, созданный на предыдущем шаге.

Затем удалите все связи с фидами путешествий на уровне кампании:

1. Для кампании, которую вы хотите исключить, получите campaign_asset_set.resource_name и asset_set.resource_name для всех ссылок CampaignAssetSet типа TRAVEL_FEED, используя отчет campaign_asset_set.

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. Для каждого объекта campaign_asset_set.resource_name создайте объект CampaignAssetSetOperation и задайте для remove значение campaign_asset_set.resource_name, полученное на предыдущем шаге.

3. Отправьте запрос в CampaignAssetSetService.MutateCampaignAssetSets, используя созданные объекты CampaignAssetSetOperation.

Если вы хотите снова включить эту функцию на уровне кампании:

1. Для каждого базового объекта AssetSet (asset_set.resource_name), который вы хотите включить, создайте новый объект CampaignAssetSet, в котором для asset_set задано значение asset_set.resource_name, а для campaign – название ресурса кампании.
2. Для каждого объекта CampaignAssetSet, созданного на предыдущем шаге, создайте объект CampaignAssetSetOperation, в котором для поля create задано значение CampaignAssetSet.
3. Отправьте запрос в CampaignAssetSetService.MutateCampaignAssetSets, используя созданные объекты CampaignAssetSetOperation.

Как восстановить статус согласия на уровне клиента для кампании

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

1. Создайте новый объект Campaign с excluded_parent_asset_set_types без TRAVEL_FEED в списке и resource_name, заданным как название ресурса кампании.
2. Создайте CampaignOperation и задайте для update ранее созданные Campaign и update_mask.
3. Отправьте запрос в CampaignService.MutateCampaigns, используя CampaignOperation, созданный на предыдущем шаге.

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

Начиная с версии v25 Google Ads API, вы можете настраивать переопределения ставок за клик, назначенных вручную, для отдельных отелей в кампаниях в поисковой сети для туризма. Для этого используется ресурс AdGroupCriterion с типом критерия CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). Чтобы задать мультипликативные корректировки ставок на уровне группы объявлений для параметров маршрута путешествия с помощью AdGroupBidModifier, ознакомьтесь с разделом Корректировка ставок с помощью модификаторов.

Предварительные условия и требования к совместимости

Чтобы создавать критерии VERTICAL_ADS_ITEM_BID и управлять ими, должны выполняться следующие условия:

• Тип кампании: поисковые кампании для туризма (поисковые кампании AdvertisingChannelType.SEARCH с AI Max для поисковых кампаний, включенным через Campaign.ai_max_setting.enable_ai_max, и связанным набором объектов фида гостиниц TRAVEL_FEED; поддерживаются только фиды гостиниц).
• Стратегия назначения ставок: только назначение цены за клик вручную (BiddingStrategyType.MANUAL_CPC).
  • Не поддерживается в стратегиях автоматического или интеллектуального назначения ставок (например, "Максимум конверсий", "Максимальная ценность конверсии", "Целевая цена за конверсию" или "Целевая рентабельность инвестиций в рекламу").
• Только положительные критерии: для параметра negative должно быть задано значение false. Отрицательные ставки не поддерживаются.
• Обязательный идентификатор объекта и ставка. При создании критерия ставки для объекта необходимо указать entity_bid.item_code и cpc_bid_micros.

Схема и определения полей

• Ресурс: AdGroupCriterion (ad_group_criterion)
• Формат названия ресурса: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Перечисление типов критериев: CriterionType.VERTICAL_ADS_ITEM_BID
• Сообщение: EntityBid (ad_group_criterion.entity_bid)

Поддерживаемые сервисы и операции

Примеры кода и полезной нагрузки

В примерах ниже показано, как считывать, создавать, обновлять и удалять критерии VERTICAL_ADS_ITEM_BID.

Как получить ставки для объектов с помощью GAQL

Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream, чтобы запросить критерии VERTICAL_ADS_ITEM_BID:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

Как создать ставку для объекта

Отправьте операцию create в AdGroupCriterionService.MutateAdGroupCriteria.

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

Как изменить ставку для существующего объекта

Отправьте операцию update с updateMask в AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

Как удалить ставку для объекта

Отправьте операцию remove в AdGroupCriterionService.MutateAdGroupCriteria.

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

Правила проверки и обработка ошибок

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

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

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

Сегменты параметров маршрута

Вы также можете сегментировать отчеты об эффективности кампаний со связанными фидами путешествий по параметрам маршрута:

• 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).

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

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS