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 el de 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 vertical) a nivel del grupo de anuncios.
2. Administración de elementos de anuncios verticales: Filtra y segmenta inventario específico de tu feed vertical vinculado (antes llamado 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 vertical 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. Si vinculas un feed de datos vertical, se activarán los feeds de viajes en los anuncios de búsqueda (TFSA) y se habilitarán 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 vertical a nivel de la campaña siguiendo estos pasos. Como alternativa, para habilitar estas funciones en 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 que se indican en la guía de feeds de viajes en anuncios de búsqueda.

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

Para obtener más detalles sobre cómo administrar los 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 campo vertical_ads_format_setting (VerticalAdsFormatSetting) en el recurso AdGroup.

Formatos disponibles

• Anuncios de texto (disable_text_ads): Están habilitados de forma predeterminada. Se puede inhabilitar.
• Vínculos para reservar (enable_booking_links): Se requiere habilitación. Solo se admite para los feeds verticales de HOTELS y THINGS_TO_DO.
• Anuncios de promoción verticales (enable_vertical_promotion_ads): Se 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.
• Esta configuración solo se aplica 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 vertical 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 tus anuncios para un subconjunto específico de tu inventario del feed, 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 Categoría del hotel, y un valor. También puedes crear criterios negativos para excluir elementos.
3. AdGroupCriterion: Vincula el SharedSet a tu AdGroup con un AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensiones compatibles

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

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

Ejemplo de código: Crea y vincula reglas

En este ejemplo de Python, se crea una regla para incluir elementos 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, en 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 elementos 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 automáticas o inteligentes no son compatibles con VERTICAL_ADS_ITEM_BID y devuelven ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Las métricas de rendimiento no se propagan en los criterios de VERTICAL_ADS_ITEM_BID. Para obtener detalles completos del esquema, consultas de GAQL y ejemplos de mutación de cargas útiles, consulta Ofertas de CPC manuales por entidad en la guía de Feeds de viajes en anuncios de búsqueda. Si deseas establecer ajustes multiplicativos de la oferta del grupo de anuncios en las dimensiones del itinerario de viaje para los anuncios de hotel con AdGroupBidModifier, consulta Ajusta las ofertas con modificadores de ofertas.

Informes de rendimiento

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

Segmentos de anuncios verticales

• segments.vertical_ads_hotel_class: Es un valor entero (de 1 a 5 estrellas) que especifica la calificación de la categoría 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 Centro de socios (por ejemplo, Hotel Center) que proporciona datos del feed de inventario.
• segments.vertical_ads_vertical: Es el tipo de vertical, como hotel o auto de alquiler.
• 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 (comienza en v24): Es un valor entero (del 1 al 5) que especifica la calificación de los usuarios de la ficha de anuncios verticales.
• segments.vertical_ads_listing_venue (a partir de v24): Es el nombre del lugar para la ficha de anuncios verticales (por ejemplo, un lugar de conciertos).
• segments.vertical_ads_price_tier (a partir del v25): Es el grupo 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 correspondiente a las reglas de tarifas privadas o condicionales que se aplican a la oferta o 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 itinerarios

A partir de v25, para los anuncios verticales vinculados a feeds de viajes y alojamientos, puedes segmentar los informes de rendimiento con las dimensiones del itinerario:

• segments.advance_booking_window: Es el período de reserva anticipada para el itinerario en días.
• segments.length_of_booking: Es la duración de la reserva para el 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 en que comienza la reserva.
• segments.user_set_dates: Indica si se seleccionaron 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 el total de impresiones aptas 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 microunidades, incluidos los impuestos y las tarifas, durante la duración total de la estadía.
• metrics.vertical_ads_price_difference_percentage: Es la diferencia porcentual que compara el precio ofrecido por el anunciante con el precio más bajo de la competencia para la misma propiedad.

Consultas de GAQL de ejemplo

Esta consulta recupera las métricas de competitividad y reservas 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 según las 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 puedes encontrar cuando configuras anuncios verticales: