Todas las solicitudes a AudienceInsightsService tienen un límite de frecuencia. Se permiten menos solicitudes
por día para generateAudienceCompositionInsights y
generateSuggestedTargetingInsights que para otros métodos de estadísticas de público. Consulta Cuotas de la API para obtener más detalles.
AudienceInsightsService te permite integrar los datos de las estadísticas de público de Google
en tus herramientas de planificación. Los datos ayudan a las agencias de medios y los planificadores de medios a comprender mejor a su público objetivo, incluidos los datos demográficos, los intereses y el comportamiento en línea.
Las estadísticas de público te ayudan a comprender un público, una categoría, un tema o una marca, ya que proporcionan una descripción general de alto nivel. Si analizas los comportamientos de los usuarios en torno a temas relacionados, puedes usar estas estadísticas de público para descubrir las asociaciones y percepciones que tienen los consumidores y, así, identificar nuevos segmentos de público.
La API admite tres casos de uso principales:
- Define mejor y descubre públicos: Comprende los intereses y comportamientos únicos de los consumidores para identificar públicos nuevos para una marca, desarrollar arquetipos de público ideal y definir mejor las estrategias de segmentación de público.
- Informa la planificación de campañas: Traduce los resultados de los datos en públicos objetivo de YouTube para planificar en función de ellos, estimar el alcance potencial de los públicos objetivo y medir la superposición entre los segmentos de público para maximizar el alcance de las campañas.
- Desarrolla mensajes creativos: Adapta los mensajes creativos a tu público objetivo en función de los temas y las afinidades con los que más interactúan.
Requisitos de elegibilidad
Para poder participar en AudienceInsightsService, los socios deben cumplir con las siguientes condiciones:
- Tener acceso existente o cumplir con los requisitos para acceder a Insights Finder
- Tener una herramienta de planificación o una interfaz de usuario que integre la API
- Usa la API para planificar medios o para otros casos de uso pertinentes.
- Completar una evaluación de preselección
- Sigue los requisitos de uso de datos y sométete a auditorías de datos periódicas.
- Acepta las condiciones del servicio de la API de Google Ads y la política de uso de datos asociada.
Comunícate con tu representante de Google para obtener más información.
Fechas aptas para las estadísticas de listas
Un flujo de trabajo típico comienza con la verificación de los meses del calendario y los períodos disponibles para el análisis. El método listInsightsEligibleDates devuelve un objeto ListInsightsEligibleDatesResponse, cuyo campo data_months enumera los meses (en formato YYYY-MM) para los que están disponibles los datos de estadísticas de público.
El campo last_thirty_days de la respuesta contiene el rango de fechas exacto que
generateAudienceCompositionInsights usa cuando no se establece data_month
en la solicitud.
Enumera los atributos de las estadísticas de público
Antes de consultar las métricas de composición o superposición de públicos, descubre los IDs de atributos válidos con listAudienceInsightsAttributes. Este método devuelve
un ListAudienceInsightsAttributesResponse que contiene los atributos
disponibles para las dimensiones solicitadas.
Por ejemplo, si se selecciona AFFINITY_USER_INTEREST como dimensión en la
solicitud, el método devuelve públicos afines admitidos, como "Aficionados a los deportes"
o "Amantes de la música". Otras dimensiones de intereses de los usuarios admitidas incluyen IN_MARKET_USER_INTEREST y LIFE_EVENT_USER_INTEREST. Puedes establecer varias
dimensiones en una sola solicitud. Para obtener una lista completa de las dimensiones admitidas, consulta
la referencia de campos de dimensions.
Cuando busques entidades del Gráfico de conocimiento (temas) con la dimensión KNOWLEDGE_GRAPH, debes proporcionar una consulta de cadena en el campo query_text (por ejemplo, "football and the World Cup").
De manera opcional, puedes incluir knowledge_graph_entity_search_options para
personalizar tu búsqueda de temas:
- Filtrar por capacidades: Usa
search_filterpara limitar las entidades recuperadas solo a aquellas que admiten capacidades específicas. Por ejemplo, puedes filtrar los temas admitidos como atributos de creador proporcionandoCREATOR_ATTRIBUTEen el campoentity_capability_filters. Se pueden proporcionar varias capacidades, que se combinan con la lógicaOR. - Recupera todos los atributos del creador: Establece
get_all_creator_attributesentruepara recuperar todas las entidades disponibles del Gráfico de conocimiento etiquetadas como atributos del creador. Cuando uses esta opción, debes seleccionar la dimensiónKNOWLEDGE_GRAPH,query_textdebe estar vacío y no puedes combinar esta opción con unsearch_filter.
Los atributos que devuelve este método de visibilidad se pueden usar como entradas para
otros métodos AudienceInsightsService.
Cada objeto AudienceInsightsAttributeMetadata en ListAudienceInsightsAttributesResponse proporciona una representación estructurada de un atributo de público junto con propiedades descriptivas y métricas de participación.
Incluye la definición principal del atributo, el nombre visible, el tipo de dimensión y el alcance de público estimado. Consulta la
referencia de AudienceInsightsAttributeMetadata para obtener las definiciones
de los campos.
Genera una definición de público
El método generateAudienceDefinition traduce una descripción de texto de formato libre de un público en sugerencias de atributos de público estructurados que puedes pasar a los métodos de estadísticas downstream.
Genera estadísticas de segmentación sugeridas
El método generateSuggestedTargetingInsights devuelve una colección de estadísticas de segmentación (como segmentos de público a los que se puede segmentar) que son relevantes para el público solicitado.
Puedes especificar el público solicitado como un InsightsAudienceDefinition estructurado o como una descripción de texto en InsightsAudienceDescription.
Mientras que generateAudienceCompositionInsights devuelve estadísticas para segmentos de atributos individuales, generateSuggestedTargetingInsights devuelve sugerencias agrupadas de segmentos de público de Google Ads a los que se puede segmentar. Este método ayuda a responder
preguntas como "Dame sugerencias de público objetivo para padres de
30 años que disfrutan de la pesca".
Genera métricas de sugerencias de segmentación
El método generateTargetingSuggestionMetrics devuelve un objeto GenerateTargetingSuggestionMetricsResponse, que contiene la población potencial de YouTube a la que se puede llegar para cada definición de público solicitada en GenerateTargetingSuggestionMetricsRequest.
Este método ayuda a responder preguntas como "¿A cuántos hombres mayores de 18 años interesados en acampar en Estados Unidos se puede llegar en YouTube?".
Genera estadísticas de composición del público
El método generateAudienceCompositionInsights devuelve un objeto GenerateAudienceCompositionInsightsResponse, que contiene una lista de atributos que representan el público de interés solicitado, junto con métricas de índice y porcentaje que comparan el porcentaje de público de cada atributo con una población de referencia.
Debes proporcionar un país de segmentación para el público. La lista de dimensiones admitidas
para recuperar estadísticas de composición se documenta en el campo dimensions
de GenerateAudienceCompositionInsightsRequest.
Este método ayuda a responder preguntas como "¿Cuáles son las principales afinidades que le interesan a mi público objetivo en comparación con la población general y qué tan probable es que interactúe con esas afinidades?".
Genera estadísticas de superposición de públicos
El método generateAudienceOverlapInsights devuelve un objeto GenerateAudienceOverlapInsightsResponse, que contiene una lista de atributos de público con estimaciones de la superposición entre su alcance potencial en YouTube y el de un atributo principal.
Debes proporcionar un país objetivo y un atributo principal. El rango de edad, el género, los segmentos afines y los segmentos en el mercado se admiten como dimensiones de público.
Este método ayuda a responder preguntas como "¿Cuál es el tamaño del público incremental cuando segmentamos nuestros anuncios para los aficionados a los deportes y los amantes de la música en Estados Unidos?".
Genera un informe de Insights Finder
El método generateInsightsFinderReport crea un informe guardado en Insights Finder según las entradas especificadas en GenerateInsightsFinderReportRequest y devuelve un GenerateInsightsFinderReportResponse que contiene un vínculo de acceso externo para abrir ese informe en la IU de Insights Finder.
Herramienta de seguimiento de errores de Google
Usa la Herramienta de seguimiento de errores de Google para hacer preguntas de asistencia, informar errores o enviar solicitudes de funciones. Google hace un seguimiento, prioriza y publica actualizaciones sobre tus solicitudes directamente en Issue Tracker. Para obtener más información, consulta Crea un error en la Herramienta de seguimiento de errores de Google.
Crea un problema con una de las siguientes plantillas de Issue Tracker:
- Haz una pregunta de asistencia general o envía comentarios sobre la documentación
- Cómo informar un error técnico
- Envía una solicitud de función de la API
Completa todos los campos de la plantilla con información detallada para que Google pueda reproducir y priorizar tu solicitud. Google podría cerrar los informes incompletos y pedirte que envíes un nuevo problema con los detalles faltantes.