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

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