Feeds de viajes en anuncios de búsqueda

Con tus feeds de productos de hoteles, alquileres de vacaciones o actividades 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 de feeds de viajes (TRAVEL_FEED conjuntos de recursos) del nivel del cliente a través de las CustomerAssetSet asociaciones. 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 del cliente (opción predeterminada): Mantén vinculado el CustomerAssetSet a nivel del cliente y asegúrate de que Campaign.excluded_parent_asset_set_types no contenga TRAVEL_FEED.
• Inhabilitar a nivel del cliente: Quita la asociación 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 todas las asociaciones CampaignAssetSet a nivel de la campaña.
• Habilitar solo una campaña específica: Quita la asociación CustomerAssetSet a nivel del cliente y, luego, crea un vínculo CampaignAssetSet a nivel de la campaña para esa campaña.
• Usar feeds específicos de la campaña mientras otras campañas siguen heredando: Agrega TRAVEL_FEED a Campaign.excluded_parent_asset_set_types de la campaña y crea un vínculo CampaignAssetSet a nivel de la campaña para ella.

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

Si prefieres no usar esta función, puedes usar 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 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 CustomerAssetSet vínculos cuyo tipo sea TRAVEL_FEED con el customer_asset_set informe:

   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, haz lo siguiente:

1. Para cada AssetSet subyacente (asset_set.resource_name) que quieras vincular, crea un CustomerAssetSet nuevo con asset_set establecido en el 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 el 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 anuncios de búsqueda a nivel de la campaña, primero debes excluir el estado de habilitación heredado del nivel del cliente:

1. Recupera excluded_parent_asset_set_types con el campaign informe:

   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 establece update en el Campaign creado anteriormente y update_mask según corresponda.

4. Envía una solicitud a CampaignService.MutateCampaigns con el CampaignOperation creado en el paso anterior.

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

1. Para la campaña que deseas inhabilitar, 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, haz lo siguiente:

1. Para cada AssetSet subyacente (asset_set.resource_name) que quieras habilitar, crea un CampaignAssetSet nuevo con asset_set establecido en el 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 el CampaignAssetSet.
3. Envía una solicitud a CampaignAssetSetService.MutateCampaignAssetSets con los objetos CampaignAssetSetOperation creados.

Cómo restablecer 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 la 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 establece update en el Campaign creado anteriormente y update_mask según corresponda.
3. Envía una solicitud a CampaignService.MutateCampaigns con el CampaignOperation creado en el paso anterior.

Ofertas de CPC manuales por entidad

A partir de la API de Google Ads v25, 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 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 IA Max para campañas de Búsqueda habilitada Campaign.ai_max_setting.enable_ai_max y un feed de hoteles asociado [TRAVEL_FEED conjunto de recursos]; solo se admiten feeds de hoteles).
• Estrategia de ofertas: Solo CPC manual (BiddingStrategyType.MANUAL_CPC).
  • No se admite en estrategias de Ofertas inteligentes ni automáticas (como Maximizar conversiones, Maximizar valor de conversión, CPA objetivo o ROAS objetivo).
• Solo criterios positivos: negative debe establecerse en false. No se admiten ofertas de entidades negativas.
• Identificador y oferta de entidad obligatorios: entity_bid.item_code y cpc_bid_micros son obligatorios cuando se crea un criterio de oferta de entidad.

Definiciones de esquema y campos

• Recurso: AdGroupCriterion (ad_group_criterion)
• Formato del nombre del recurso: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enumeración del 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 VERTICAL_ADS_ITEM_BID.

Cómo leer ofertas de entidades con GAQL

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

Cómo crear 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"
        }
      }
    }
  ]
}

Cómo actualizar el importe de una oferta de 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 remove operación 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, como recuperar 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 dimensiones de itinerario

También puedes segmentar los informes de rendimiento de las campañas con feeds de viajes vinculados por dimensiones de 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 las 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