Cómo crear y administrar públicos

Un objeto Audience es una colección reutilizable de segmentos enfocados, 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 campañas de Display, Búsqueda, video, hoteles o Shopping estándar directamente para los segmentos de público, 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 del público:

Inspecciona MutateAudienceResult para ver audience_id

Cuando creas un público con AudienceService.MutateAudiences, cada operación devuelve un MutateAudienceResult. Puedes inspeccionar MutateAudienceResult para obtener audience_id analizando el resource_name devuelto, y puedes inspeccionar campos mutables (como name) en el objeto audience devuelto 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 públicos.

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

Públicos objetivo

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 utilizan un AssetGroupSignal para segmentar públicos. Consulta la guía sobre los indicadores del grupo de recursos para obtener información sobre cómo segmentar tus anuncios para públicos específicos con estos indicadores.

Criterio del grupo de anuncios

Las campañas de generación de demanda y de aplicaciones admiten la adición de un criterio del grupo de anuncios de público con AdGroupCriterion para segmentar públicos o proporcionar indicadores de público. Puedes segmentar tus anuncios para públicos a nivel del grupo de anuncios con 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 estableciendo use_audience_grouped en 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 configura el campo AudienceInfo.audience en AdGroupCriterion.audience con el nombre del recurso del público creado en Crear públicos.

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

De forma opcional, puedes establecer use_audience_grouped en true cuando se cree la campaña. Con este parámetro de configuración, recibirás un error si intentas agregar criterios que excluirían segmentos y datos demográficos a nivel de la campaña.

Prácticas recomendadas

  • Utiliza públicos para crear arquetipos. 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 combinar varios segmentos y criterios demográficos para segmentar a un arquetipo 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 necesitas segmentar para un solo segmento (como una lista de remarketing), utiliza Segmentos de público en lugar de Públicos.

Errores comunes

Cuando se crea o actualiza un objeto Audience, la API de Google Ads valida la solicitud y devuelve 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 del 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 Intentaste 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 superó 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 en la cantidad de segmentos por público.