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 y las campañas de generación de demanda. Si quieres segmentar directamente segmentos de público en una campaña de Display, Búsqueda, video, hoteles o Shopping estándar, 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 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 admiten la adición de criterios de grupo de anuncios de público con AdGroupCriterion para segmentar públicos.

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 configurando use_audience_grouped como true cuando se crea el grupo de anuncios.

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

Crea un AdGroupCriterion

Crea un AdGroupCriterion y establece el audience campo en el nombre de 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 como 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 y de generación de demanda 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 AudienceError enum 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 manejarla 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 manejarla 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 se cree o actualice 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 manejarla 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 manejarla Usa un nombre único cuando crees un público.
Sugerencias de prevención Verifica si existen nombres de público 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 manejarla 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 manejarla 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.