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

Если вы свяжете фиды товаров из категорий "Отели", "Жилье для отпуска" или "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).

Требования и совместимость

Чтобы создавать критерии 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