Controles y filtrado de inventario para anuncios verticales

Los anuncios verticales proporcionan funciones especializadas para las campañas de Búsqueda habilitadas para IA Max para campañas de Búsqueda que están vinculadas a un feed vertical, como hoteles. Puedes controlar qué formatos de anuncios verticales se publican a nivel del grupo de anuncios y qué entidades del feed se segmentan con las reglas de grupos de artículos de anuncios verticales.

Descripción general

En esta guía, se abordan dos funciones principales para administrar anuncios verticales:

1. Controles de formato: Habilita o inhabilita formatos de anuncios específicos (anuncios de texto, vínculos para reservar y anuncios de promoción verticales) a nivel del grupo de anuncios.
2. Administración de artículos de anuncios verticales: Filtra y segmenta el inventario específico de tu feed vertical vinculado (antes llamado feed de viajes) con un sistema basado en reglas que incluye SharedSet y SharedCriterion.

Requisitos previos

Antes de implementar estas funciones, asegúrate de que tu campaña cumpla con los siguientes requisitos:

• Tipo de campaña: Debe ser una campaña de Búsqueda.
• Feed vertical: Se debe vincular un feed de datos verticales activo a nivel del cliente o de la campaña. Consulta Cómo vincular feeds de datos verticales a nivel de la campaña para vincular un feed a nivel de la campaña. La vinculación de un feed de datos verticales activa los Feeds de viajes en anuncios de búsqueda (TFSA) y habilita los controles de anuncios verticales para la campaña.
• IA Max para campañas de Búsqueda: El parámetro de configuración de IA Max para campañas de Búsqueda debe estar habilitado en la campaña.

Cómo vincular feeds de datos verticales a nivel de la campaña

Para activar los Feeds de viajes en anuncios de búsqueda (TFSA) y habilitar los controles de anuncios verticales en tu campaña, puedes vincular tu conjunto de recursos de feed de datos verticales a nivel de la campaña con los siguientes pasos. Como alternativa, para habilitar estas funciones para todas las campañas de tu cuenta, puedes vincular el feed a nivel del cliente siguiendo las instrucciones de vinculación a nivel del cliente en la guía de Feeds de viajes en anuncios de búsqueda.

1. Crea un objeto CampaignAssetSet y establece asset_set en el nombre del recurso de tu conjunto de recursos de feed vertical y campaign en el nombre del recurso de tu campaña.
2. Crea un CampaignAssetSetOperation con create establecido en el CampaignAssetSet.
3. Envía la operación con CampaignAssetSetService.MutateCampaignAssetSets.

Para obtener más detalles sobre la administración de feeds de viajes a gran escala, consulta la documentación de Feeds de viajes en anuncios de búsqueda.

Controles de formato del grupo de anuncios

Puedes configurar qué formatos de anuncios verticales están activos para un grupo de anuncios específico. Esto se administra a través del vertical_ads_format_setting (VerticalAdsFormatSetting) campo en el AdGroup recurso.

Formatos disponibles

• Anuncios de texto (disable_text_ads): Están habilitados de forma predeterminada. Se pueden inhabilitar.
• Vínculos para reservar (enable_booking_links): Requiere habilitación. Solo es compatible con los feeds verticales HOTELS y THINGS_TO_DO.
• Anuncios de promoción verticales (enable_vertical_promotion_ads): Requiere habilitación.

Reglas de validación

• No puedes inhabilitar los tres formatos simultáneamente para un solo grupo de anuncios.
• enable_booking_links solo se puede establecer en true cuando el feed vertical activo de la campaña es HOTELS o THINGS_TO_DO.
• Estos parámetros de configuración solo se aplican a los tipos de grupos de anuncios SEARCH_STANDARD y SEARCH_DYNAMIC_ADS.

Ejemplo: Actualiza la configuración de formato

En el siguiente ejemplo de Java, se muestra cómo inhabilitar los anuncios de texto y habilitar los anuncios de promoción verticales para un grupo de anuncios existente:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

Administración de elementos de anuncios verticales

Para segmentar un subconjunto específico de tu inventario de feeds, como "Hoteles en Boston" o "Excluir hoteles de 1 estrella", debes usar las reglas de grupos de artículos de anuncios verticales.

Cómo funciona el modelo de datos

El modelo de datos usa un enfoque de criterios compartidos:

1. SharedSet: Crea un SharedSet con el tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Agrega reglas (criterios) a este conjunto. Cada regla especifica una dimensión, como Ciudad o Clase de hotel, y un valor. También puedes crear criterios negativos para excluir artículos.
3. AdGroupCriterion: Vincula el SharedSet a tu AdGroup con un AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensiones compatibles

Puedes filtrar entidades en función de las siguientes dimensiones en SharedCriterion (VerticalAdsItemGroupRuleInfo), según el SharedSet's vertical_ads_item_vertical_type:

• item_code: Es el ID de ficha específico (compatible con todos los tipos verticales).
• city_criterion_id, region_criterion_id, country_criterion_id: Son los nombres de recursos de la constante de región geográfica de segmentación (geoTargetConstants/{id}; compatible con todos los tipos verticales, excepto FLIGHTS).
• hotel_class: Es la calificación por estrellas de 1 a 5 (solo HOTELS).
• user_rating (a partir de v24): Es la calificación de los usuarios redondeada de 1 a 5 (solo THINGS_TO_DO).
• venue, event_participant_display_name (a partir de v24): Son los filtros de nombre visible del lugar y del participante del evento (solo EVENTS).

Ejemplo de código: Crea y vincula reglas

En este ejemplo de Python, se crea una regla para incluir artículos en "Boston" o "San Francisco" y excluir hoteles de "1 estrella" y "2 estrellas":

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

Ofertas de CPC manuales por entidad

A partir de v25, para las campañas de Búsqueda para viajes (campañas de Búsqueda con IA Max para campañas de Búsqueda habilitada y un feed de hoteles vinculado) que usan la estrategia de ofertas de CPC manual (BiddingStrategyType.MANUAL_CPC), puedes establecer anulaciones de ofertas de CPC manuales (cpc_bid_micros) para artículos individuales del feed de hoteles con el criterio EntityBid (ad_group_criterion.entity_bid) con CriterionType.VERTICAL_ADS_ITEM_BID y entity_bid.item_code.

Los criterios negativos (negative = true), las campañas que no son de Búsqueda y las estrategias de Ofertas inteligentes o automáticas no son compatibles con VERTICAL_ADS_ITEM_BID y muestran ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Las métricas de rendimiento no se propagan en los criterios VERTICAL_ADS_ITEM_BID. Para obtener detalles completos del esquema, consultas de GAQL y ejemplos de cargas útiles de mutación, consulta Ofertas de CPC manuales por entidad en la guía de Feeds de viajes en anuncios de búsqueda.

Informes de rendimiento

Puedes recuperar las métricas de rendimiento de los anuncios verticales con los GoogleAdsService.SearchStream o GoogleAdsService.Search métodos.

Segmentos de anuncios verticales

• segments.vertical_ads_hotel_class: Es un valor entero (de 1 a 5 estrellas) que especifica la calificación de clase de una ficha de hotel.
• segments.vertical_ads_listing: Es el identificador de una ficha de anuncio vertical específica.
• segments.vertical_ads_listing_brand: Es la marca asociada con una ficha de anuncio vertical.
• segments.vertical_ads_listing_city: Es la ciudad asociada con la ficha.
• segments.vertical_ads_listing_country: Es el país asociado con la ficha.
• segments.vertical_ads_listing_region: Es la región asociada con la ficha.
• segments.vertical_ads_partner_account: Es la cuenta de socio dentro de un Partner Center (por ejemplo, Hotel Center) que proporciona datos del feed de inventario.
• segments.vertical_ads_vertical: Es el tipo vertical, como hotel o alquiler de auto.
• segments.vertical_ads_event_participant_display_names: Son los nombres visibles de los participantes en una ficha de evento, como artistas, oradores o equipos.
• segments.vertical_ads_listing_user_rating (a partir de v24): Es un valor entero (de 1 a 5) que especifica la calificación de los usuarios de la ficha de anuncio vertical.
• segments.vertical_ads_listing_venue (a partir de v24): Es el nombre del lugar para la ficha de anuncio vertical (por ejemplo, un lugar de conciertos).
• segments.vertical_ads_price_tier (a partir de v25): Es el bucket de competitividad de precios relativos para las fichas de hoteles.
• segments.vertical_ads_rate_rule_id (a partir de v25): Es el identificador de cadena que corresponde a las reglas de tarifas privadas o condicionales aplicadas a la oferta o la impresión.
• segments.vertical_ads_rate_type (a partir de v25): Es la categorización del tipo de tarifa pública, privada o condicional.

Segmentos de dimensiones de itinerario

A partir de v25, para los anuncios verticales vinculados a feeds de viajes y alojamiento, puedes segmentar los informes de rendimiento con las 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).

Métricas de anuncios verticales

A partir de v25, puedes recuperar las siguientes métricas de anuncios verticales:

• metrics.vertical_ads_potential_impressions: Son las impresiones potenciales que representan las impresiones aptas totales con límite de vistas disponibles en el contexto de la consulta.
• metrics.vertical_ads_average_booking_value_micros: Es la tarifa diaria promedio ponderada por clics en micros, incluidos los impuestos y las tarifas, durante la duración total de la estadía.
• metrics.vertical_ads_price_difference_percentage: Es el delta porcentual que compara el precio ofrecido por el anunciante con el precio competitivo más bajo para la misma propiedad.

Consultas de GAQL de ejemplo

Esta consulta recupera las métricas competitivas y de reserva de los anuncios verticales segmentadas por ciudad de la ficha, nivel de precios y tipo de tarifa:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Esta consulta segmenta las métricas de rendimiento estándar por dimensiones de reserva de itinerario:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Manejo de errores

Estos son errores comunes que pueden surgir cuando configuras anuncios verticales: