Feeds de viajes en anuncios de búsqueda

Con tus feeds de productos de Hoteles, Alquileres de vacaciones o Cosas para hacer vinculados a tu cuenta de Google Ads, Google Ads enriquece automáticamente las campañas de Búsqueda existentes con precios e imágenes extraídos de tus feeds. Esta función se conoce como Feeds de viajes en anuncios de búsqueda.

Cómo interactúan la configuración del cliente y la configuración de la campaña

De forma predeterminada, las campañas heredan los vínculos del feed de viajes (conjuntos de recursos TRAVEL_FEED) del nivel del cliente a través de las asociaciones de CustomerAssetSet. Para anular la configuración a nivel del cliente para una campaña específica, debes agregar TRAVEL_FEED al campo excluded_parent_asset_set_types de la campaña y administrar los vínculos específicos de la campaña con CampaignAssetSet.

• Heredar feeds de clientes (predeterminado): Conserva el vínculo de CustomerAssetSet a nivel del cliente y asegúrate de que Campaign.excluded_parent_asset_set_types no contenga TRAVEL_FEED.
• Inhabilita la opción a nivel del cliente: Quita la asociación de CustomerAssetSet a nivel del cliente y no vincules un CampaignAssetSet a nivel de la campaña.
• Inhabilitar una campaña específica: Agrega TRAVEL_FEED a Campaign.excluded_parent_asset_set_types y quita las asociaciones de CampaignAssetSet a nivel de la campaña.
• Habilita la vinculación solo para una campaña específica: Quita la asociación de CustomerAssetSet a nivel de la cuenta y, luego, crea un vínculo de CampaignAssetSet a nivel de la campaña para esa campaña.
• Usa feeds específicos de la campaña mientras otras campañas siguen heredando: Agrega TRAVEL_FEED al Campaign.excluded_parent_asset_set_types de la campaña y crea un vínculo de CampaignAssetSet a nivel de la campaña para él.

Cómo inhabilitar los feeds de viajes en los anuncios de búsqueda

Si prefieres no usar esta función, puedes utilizar la API de Google Ads para inhabilitar los Feeds de viajes en anuncios de búsqueda a nivel del cliente y de la campaña.

Inhabilitación a nivel del cliente

Para inhabilitar los Feeds de viajes en los anuncios de búsqueda a nivel del cliente, haz lo siguiente:

1. Recupera customer_asset_set.resource_name y asset_set.resource_name para todos los vínculos CustomerAssetSet cuyo tipo sea TRAVEL_FEED con el informe 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. Para cada customer_asset_set.resource_name, crea un CustomerAssetSetOperation y establece remove en el customer_asset_set.resource_name recuperado en el paso anterior.

3. Envía una solicitud a CustomerAssetSetService.MutateCustomerAssetSets con los objetos CustomerAssetSetOperation creados.

Si quieres volver a habilitar esta función a nivel del cliente, sigue estos pasos:

1. Para cada AssetSet (asset_set.resource_name) subyacente que desees vincular, crea un nuevo CustomerAssetSet con asset_set establecido en asset_set.resource_name y customer establecido en el nombre del recurso de tu cliente.
2. Para cada CustomerAssetSet creado en el paso anterior, crea un CustomerAssetSetOperation con create establecido en CustomerAssetSet.
3. Envía una solicitud a CustomerAssetSetService.MutateCustomerAssetSets con los objetos CustomerAssetSetOperation creados.

Inhabilitación a nivel de la campaña

Para inhabilitar los Feeds de viajes en los anuncios de búsqueda a nivel de la campaña, primero debes excluir el estado de habilitación heredado a nivel del cliente:

1. Recupera excluded_parent_asset_set_types con el informe campaign:

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

2. Crea un objeto Campaign nuevo con excluded_parent_asset_set_types establecido en los valores anteriores más TRAVEL_FEED y resource_name establecido en el nombre del recurso de tu campaña.

3. Crea un CampaignOperation y configura update en el Campaign creado anteriormente y update_mask según corresponda.

4. Envía una solicitud a CampaignService.MutateCampaigns con el objeto CampaignOperation que creaste en el paso anterior.

Luego, quita las asociaciones de feeds de viajes a nivel de la campaña:

1. Para la campaña en la que deseas inhabilitar la participación, recupera campaign_asset_set.resource_name y asset_set.resource_name para todos los vínculos CampaignAssetSet cuyo tipo sea TRAVEL_FEED con el informe 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. Para cada campaign_asset_set.resource_name, crea un CampaignAssetSetOperation y establece remove en el campaign_asset_set.resource_name recuperado en el paso anterior.

3. Envía una solicitud a CampaignAssetSetService.MutateCampaignAssetSets con los objetos CampaignAssetSetOperation creados.

Si quieres volver a habilitar esta función a nivel de la campaña, sigue estos pasos:

1. Para cada AssetSet (asset_set.resource_name) subyacente en la que deseas habilitar la participación, crea un nuevo CampaignAssetSet con asset_set establecido en asset_set.resource_name y campaign establecido en el nombre del recurso de tu campaña.
2. Para cada CampaignAssetSet creado en el paso anterior, crea un CampaignAssetSetOperation con create establecido en CampaignAssetSet.
3. Envía una solicitud a CampaignAssetSetService.MutateCampaignAssetSets con los objetos CampaignAssetSetOperation creados.

Restablece el estado de habilitación a nivel del cliente para una campaña

Para que el estado de habilitación de una campaña vuelva a heredar el parámetro de configuración a nivel del cliente, sigue estos pasos:

1. Crea un objeto Campaign nuevo con excluded_parent_asset_set_types sin TRAVEL_FEED en la lista y resource_name establecido en el nombre del recurso de tu campaña.
2. Crea un CampaignOperation y configura update en el Campaign creado anteriormente y update_mask según corresponda.
3. Envía una solicitud a CampaignService.MutateCampaigns con el objeto CampaignOperation que creaste en el paso anterior.

Ofertas de CPC manuales por entidad

A partir de la versión v25 de la API de Google Ads, puedes configurar anulaciones de ofertas de CPC manuales por entidad para hoteles en las campañas de Búsqueda para viajes con el recurso AdGroupCriterion con el tipo de criterio CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

Requisitos previos y de compatibilidad

Para crear y administrar criterios de VERTICAL_ADS_ITEM_BID, se deben cumplir las siguientes condiciones:

• Tipo de campaña: Campañas de Búsqueda para viajes (campañas de Búsqueda, AdvertisingChannelType.SEARCH, con la IA Max para campañas de Búsqueda habilitada Campaign.ai_max_setting.enable_ai_max y un feed de hoteles asociado [conjunto de recursos de TRAVEL_FEED]; solo se admiten feeds de hoteles).
• Estrategia de ofertas: CPC manual (solo BiddingStrategyType.MANUAL_CPC)
  • No se admite en las estrategias de Ofertas inteligentes ni automatizadas (como Maximizar conversiones, Maximizar valor de conversión, CPA objetivo o ROAS objetivo).
• Solo criterios positivos: negative debe establecerse en false. No se admiten las ofertas de entidades negativas.
• Identificador y oferta de la entidad obligatorios: entity_bid.item_code y cpc_bid_micros son obligatorios cuando se crea un criterio de oferta de entidad.

Definiciones de esquemas y campos

• Recurso: AdGroupCriterion (ad_group_criterion)
• Formato del nombre del recurso: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enumeración de tipo de criterio: CriterionType.VERTICAL_ADS_ITEM_BID
• Mensaje: EntityBid (ad_group_criterion.entity_bid)

Servicios y operaciones compatibles

Ejemplos de código y cargas útiles

En los siguientes ejemplos, se muestra cómo leer, crear, actualizar y quitar criterios de VERTICAL_ADS_ITEM_BID.

Cómo leer las ofertas de entidades con GAQL

Usa GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar criterios de 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'

Crea una oferta de entidad

Envía una operación create a AdGroupCriterionService.MutateAdGroupCriteria:

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

Actualiza el importe de la oferta de una entidad existente

Envía una operación update con un updateMask a AdGroupCriterionService.MutateAdGroupCriteria:

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

Cómo quitar una oferta de entidad

Envía una operación remove a AdGroupCriterionService.MutateAdGroupCriteria:

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

Reglas de validación y manejo de errores

Informes de rendimiento

Puedes usar ClickType.TRAVEL_ASSETS para identificar los datos de rendimiento de los anuncios publicados como Feeds de viajes en anuncios de búsqueda, por ejemplo, para recuperar los datos de rendimiento de los anuncios en todas tus campañas:

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

Segmentos de la dimensión del itinerario

También puedes segmentar los informes de rendimiento de las campañas con feeds de viajes vinculados según las dimensiones del itinerario:

• segments.advance_booking_window: Es el período de reserva anticipada del itinerario en días.
• segments.length_of_booking: Es la duración de la reserva del itinerario en días.
• segments.start_date: Es la fecha de inicio de la reserva con el formato yyyy-MM-dd.
• segments.start_day_of_week: Es el día de la semana de inicio de la reserva.
• segments.user_set_dates: Indica si se seleccionaron fechas especificadas por el usuario (USER_SELECTED o DEFAULT_SELECTION).

Consulta de muestra

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