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 se admite en las campañas de máximo rendimiento, de generación de demanda y de aplicaciones. Si deseas segmentar tus anuncios para segmentos de público directamente en una campaña de Display, de Búsqueda, de video, de hoteles o de Shopping estándar, consulta Segmentos de público.

Cómo crear públicos

Crea y actualiza un público con AudienceService. Cada Audience debe tener un nombre único. Este público reutilizable permite combinar varias dimensiones de público:

• Segmentos de público
  • Segmentos de listas de usuarios
  • Segmentos afines o en el mercado
  • Segmentos de acontecimientos personales
  • Segmentos demográficos detallados
  • Segmentos de público personalizados (CustomAudienceSegment)
• Edad: AgeDimension
• Género: GenderDimension
• Ingreso familiar: HouseholdIncomeDimension
• Estado parental: ParentalStatusDimension

Nota: Solo se puede usar UserListSegment (un wrapper para un UserList al que se hace referencia dentro de un Audience) en un exclusion_dimension.

Inspecciona MutateAudienceResult para obtener el audience_id

Cuando creas 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, y puedes inspeccionar los campos mutables (como name) en el objeto audience que se muestra cuando response_content_type se establece en MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

Recupera 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

Públicos objetivo

Se puede segmentar el público de varias maneras según el tipo de campaña.

Indicadores del grupo de recursos

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

Criterio del grupo de anuncios

Las campañas de generación de demanda y de aplicaciones admiten agregar un criterio de grupo de anuncios de público con AdGroupCriterion para segmentar los públicos o proporcionar indicadores de público. Puedes segmentar tus anuncios para públicos objetivo a nivel del grupo de anuncios con los criterios de AudienceInfo en AdGroupCriterion.audience. Para ello, establece el campo AudienceInfo.audience (ad_group_criterion.audience.audience) en el nombre del recurso del público.

Sigue estos pasos para configurar la segmentación por público:

Habilita la segmentación por público en AdGroup

Debes habilitar la segmentación por público en AdGroup configurando use_audience_grouped como true cuando se cree el grupo de anuncios. Este parámetro de configuración no se puede cambiar después de crear el grupo de anuncios.

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

Crea un AdGroupCriterion

Crea un AdGroupCriterion y establece el campo AudienceInfo.audience en AdGroupCriterion.audience con el nombre del recurso del público creado en Crea públicos.

Opcional: Habilita la segmentación por público en Campaign

De manera opcional, puedes establecer use_audience_grouped en true cuando se crea la campaña. Con este parámetro de 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 los públicos para crear perfiles de clientes. Los públicos se utilizan mejor en las campañas de máximo rendimiento, de generación de demanda y de aplicaciones en las que deseas aplicar capas de varios segmentos y criterios demográficos para segmentar tus anuncios para un tipo de persona específico.
• Utiliza 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 necesites segmentar tus anuncios para un único segmento (como una lista de remarketing), utiliza 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 devuelve errores de la enumeración AudienceError si la validación falla.

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 Incluye detailed_demographic en exclusion_dimension. Cómo manejar esta situación Solo usa 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 Agregar 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 intentó 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 ya existen nombres de públicos antes de crear uno nuevo.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE	Resumen El público contiene demasiadas dimensiones del mismo tipo. Causas habituales Incluir 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.