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 los 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 elementos de anuncios verticales: Filtra y segmenta el 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. Vincular 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: Se debe habilitar el parámetro de configuración de IA Max para campañas de Búsqueda en la campaña.

Vincula 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 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 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 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 sobre los 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.
• 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.
• 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 en 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(
        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 de feeds, como "Hoteles en Boston" o "Excluir hoteles de 1 estrella", debes usar reglas del grupo de artículos de anuncios verticales.

Cómo funciona el modelo de datos

El modelo de datos utiliza 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 de hotel, y un valor. También puedes crear criterios negativos para excluir elementos.
3. AdGroupCriterion: Vincula el objeto SharedSet a tu objeto AdGroup con un objeto AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensiones compatibles

Puedes filtrar entidades según las siguientes dimensiones en SharedCriterion (VerticalAdsItemGroupRuleInfo):

• item_code: ID de la ficha específica.
• city_criterion_id, region_criterion_id, country_criterion_id: Son los nombres de recursos de la constante de segmentación geográfica (geoTargetConstants/{id}).
• hotel_class: Calificación por estrellas (de 1 a 5).
• user_rating, venue, event_participant_display_name (a partir del v24): Filtros de calificación de eventos y fichas verticales, lugar y nombre del participante

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 los 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...

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: Valor entero (de 1 a 5 estrellas) que especifica la calificación de la clase para 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 a una ficha de anuncio vertical.
• segments.vertical_ads_listing_city: Es la ciudad asociada a la ficha.
• segments.vertical_ads_listing_country: Es el país asociado a 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 alquiler de automóvil.
• segments.vertical_ads_event_participant_display_names (a partir del v24): Son los nombres visibles de los participantes en una lista de eventos, como artistas, oradores o equipos.
• segments.vertical_ads_listing_user_rating (a partir del v24): Es un valor entero (de 1 a 5) que especifica la calificación de los usuarios de la ficha de anuncios verticales.
• segments.vertical_ads_listing_venue (a partir del 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 bucket de competitividad relativa del precio 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 que se aplican a la oferta o la impresión.
• segments.vertical_ads_rate_type (a partir del v25): Categorización del tipo de tarifa pública, privada o condicional.

Segmentos de la dimensión del itinerario

A partir del v25, en el caso de 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 fechas especificadas por el usuario (USER_SELECTED o DEFAULT_SELECTION).

Métricas de anuncios verticales

A partir del v25, puedes recuperar las siguientes métricas de los 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 búsqueda.
• metrics.vertical_ads_average_booking_value_micros: Es el promedio ponderado por clics de la tarifa diaria en micros, incluidos los impuestos y las comisiones, durante la duración total de la estadía.
• metrics.vertical_ads_price_difference_percentage: Es el delta porcentual que compara el precio ofrecido del anunciante con el precio competitivo más bajo para la misma propiedad.

Consulta de GAQL de ejemplo

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.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Manejo de errores

Estos son algunos errores comunes que puedes encontrar cuando configuras anuncios verticales: