Cómo crear y administrar públicos

Un Audience es una colección reutilizable de segmentos específicos , segmentación demográfica y exclusiones. La Segmentación por público es compatible con las campañas de máximo rendimiento, de generación de demanda y de aplicaciones. Si quieres segmentar directamente los segmentos de público objetivo en una campaña de Display, Búsqueda, video, hoteles o Standard Shopping, navega a Segmentos de público.

Cómo crear públicos

Crea y actualiza un público con el AudienceService. Cada Audience debe tener un nombre único. Este público reutilizable permite una combinación de varias dimensiones de público:

Cómo inspeccionar MutateAudienceResult para audience_id

Cuando se crea un público con AudienceService.MutateAudiences, cada operación devuelve un MutateAudienceResult. Puedes inspeccionar MutateAudienceResult para obtener el audience_id analizando el resource_name que se muestra o inspeccionando el objeto audience mutable cuando response_content_type se establece en MUTABLE_RESOURCE:

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

Puedes segmentar públicos a nivel del grupo de anuncios con criterios AudienceInfo estableciendo el audience campo en un AdGroupCriterion en el nombre del recurso de público.

Cómo recuperar públicos

Al igual que con otros recursos, puedes usar GoogleAdsService.SearchStream para recuperar atributos de los públicos.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Cómo segmentar públicos

Los públicos se pueden segmentar de varias maneras según el tipo de campaña.

Indicadores del grupo de recursos

Las campañas de máximo rendimiento usan un AssetGroupSignal para segmentar públicos. Consulta la guía de grupos de recursos para obtener información sobre cómo segmentar públicos con indicadores del grupo de recursos.

Criterio del grupo de anuncios

Las campañas de generación de demanda y de aplicaciones admiten la adición de un criterio de grupo de anuncios de público con AdGroupCriterion para segmentar públicos o proporcionar indicadores de público.

Para configurar la Segmentación por público, sigue estos pasos:

Habilita la Segmentación por público en el AdGroup

Debes habilitar la Segmentación por público en el AdGroup estableciendo use_audience_grouped en true cuando se crea el grupo de anuncios.

Esto te permite agregar AdGroupCriterion con públicos. Si este valor no se establece en true, fallará la solicitud posterior para segmentar el público.

Crea un AdGroupCriterion

Crea un AdGroupCriterion y establece el audience campo en el nombre del recurso del público que se creó anteriormente en esta guía.

Opcional: Habilita la Segmentación por público en la campaña

De manera opcional, puedes establecer use_audience_grouped en true cuando se crea la campaña. Con esta configuración, recibirás un error si intentas agregar criterios que excluyan segmentos y datos demográficos a nivel de la campaña.

Prácticas recomendadas

  • Usa públicos para crear personajes. Los públicos se usan mejor en las campañas de máximo rendimiento, de generación de demanda y de aplicaciones en las que deseas superponer varios segmentos y criterios demográficos para segmentar un personaje específico.
  • Usa segmentos de público para la segmentación directa. En el caso de las campañas de Display, Búsqueda, video, hoteles y Shopping estándar, o cuando solo necesitas segmentar un solo segmento (como una lista de remarketing), usa Segmentos de público en lugar de Públicos.

Errores comunes

Cuando se crea o actualiza un Audience, la API de Google Ads valida la solicitud y muestra errores del enum AudienceError si falla la validación.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Resumen No se encontró un segmento de público en la solicitud.
Causas habituales Se hace referencia a un ID de segmento que no existe o al que no se puede acceder.
Cómo manejar esta situación Asegúrate de que todos los IDs de segmento existan y sean accesibles antes de crear o actualizar un público.
Sugerencias de prevención Valida los IDs de segmento antes de incluirlos en un público.
DIMENSION_INVALID
Resumen Una dimensión de público no es válida.
Causas habituales Se incluye detailed_demographic en exclusion_dimension.
Cómo manejar esta situación Usa solo user_list para las exclusiones en exclusion_dimension.
Sugerencias de prevención Asegúrate de que solo se use user_list en exclusion_dimension cuando crees o actualices un público.
DUPLICATE_AUDIENCE_SEGMENT
Resumen El público contiene segmentos duplicados.
Causas habituales Se agrega el mismo segmento varias veces al mismo público.
Cómo manejar esta situación Quita los segmentos duplicados de la definición del público.
Sugerencias de prevención Asegúrate de que todos los segmentos de un público sean únicos.
NAME_ALREADY_IN_USE
Resumen El nombre del público ya está en uso.
Causas habituales Se intenta crear varios públicos con el mismo nombre.
Cómo manejar esta situación Usa un nombre único cuando crees un público.
Sugerencias de prevención Verifica si hay nombres de público existentes antes de crear uno nuevo.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Resumen El público contiene demasiadas dimensiones del mismo tipo.
Causas habituales Se incluyen varias dimensiones del mismo tipo (por ejemplo, varias dimensiones de edad) en un público.
Cómo manejar esta situación Asegúrate de que la definición del público contenga solo una dimensión de cada tipo.
Sugerencias de prevención Revisa la definición del público para asegurarte de que no se incluyan tipos de dimensiones duplicados.
TOO_MANY_SEGMENTS
Resumen El público contiene demasiados segmentos.
Causas habituales Se supera la cantidad máxima permitida de segmentos en un público.
Cómo manejar esta situación Reduce la cantidad de segmentos en la definición del público.
Sugerencias de prevención Consulta la documentación para conocer los límites de la cantidad de segmentos por público.