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 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 los grupos de artículos de anuncios verticales.

Descripción general

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

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.
Administración de elementos de anuncios verticales: Filtra y segmenta el inventario específico de tu feed vertical vinculado (anteriormente llamado feed de viajes) con un sistema basado en reglas que incluye SharedSet andSharedCriterion`.

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 la campaña.
IA Max: El parámetro de configuración "IA Max" debe estar habilitado en la campaña.

Controles de formato del grupo de anuncios

Ahora 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 en el recurso AdGroup.

Formatos disponibles

Anuncios de texto: Están habilitados de forma predeterminada. Se puede inhabilitar.
Vínculos para reservar: Se requiere la aceptación.
Anuncios de promoción verticales: Se requiere habilitar la opción.

Reglas de validación

No puedes inhabilitar los tres formatos de forma simultánea para un solo grupo de anuncios.
Estos parámetros de configuración solo se aplican a los tipos de grupos de anuncios STANDARD y SEARCH_DYNAMIC_ADS.

Ejemplo: Actualiza la configuración de formato

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

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .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 un subconjunto específico de tu inventario de feeds, como "Hoteles en Boston" o "Excluir hoteles de 1 estrella", debes usar reglas de grupo de artículos de anuncios verticales.

Cómo funciona el modelo de datos

El modelo de datos utiliza un enfoque de criterios compartidos:

SharedSet: Crea un SharedSet con el tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
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 elementos.
AdGroupCriterion: Vincula el SharedSet a tu AdGroup con un objeto AdGroupCriterion.

Dimensiones compatibles

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

item_code: ID de la ficha específica.
city_criterion_id, region_criterion_id, country_criterion_id: Son constantes de segmentación geográfica.
brand_text: Nombre de la marca.
hotel_class: Calificación por estrellas (de 1 a 5).
vertical_ads_item_category: Es la categoría, como CONCERT.

Ejemplo de código: Cómo crear y vincular reglas

En este ejemplo, se crea una regla para incluir elementos en "Boston" o "San Francisco" y excluir hoteles de "1 estrella" y "2 estrellas".

Python

# 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_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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

Puedes recuperar las métricas de rendimiento de los anuncios verticales con los métodos GoogleAdsService.SearchStream o GoogleAdsService.Search. En el caso de la API de Google Ads, la versión 23 agrega segmentos específicos para generar informes detallados.

Nuevos segmentos

segments.vertical_ads_listing_city: Es la ciudad asociada a la ficha.
segments.vertical_ads_vertical_type: Es el tipo de vertical, como hotel o automóvil de alquiler.

Consulta de GAQL de ejemplo

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Manejo de errores

Estos son errores comunes que puedes encontrar cuando configuras anuncios verticales.

Código de error	Causa	Acción recomendada
`INVALID_VERTICAL_ADS_FORMAT_SETTING`	Los tres formatos de anuncios (texto, vínculo para reservar y promoción) se inhabilitaron de forma simultánea.	Asegúrate de que al menos un formato esté habilitado (establecido como verdadero) en `VerticalAdsFormatSetting`.
`VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...`	La campaña no tiene habilitada la IA Max o no tiene un feed vertical activo.	Habilita IA Max en la configuración de la campaña y asegúrate de que se haya vinculado un feed vertical válido.
`VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST`	No existe el nombre del recurso SharedSet proporcionado en AdGroupCriterion.	Verifica que el nombre del recurso shared_set coincida con un conjunto creado.
`VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...`	El tipo de criterio utilizado no es compatible con la vertical específica, como la clase de hotel para el alquiler de automóviles.	Verifica que la dimensión `vertical_ads_item_group_rule` coincida con tu tipo de vertical.