Descubre y recupera estadísticas sobre los creadores de YouTube con la función de estadísticas de creadores. Esto puede ser útil para las agencias y los anunciantes que desean encontrar creadores que sean relevantes para su público objetivo.
La API tiene cuatro funciones principales:
- Descubrimiento de creadores: Encuentra a los creadores más populares para un conjunto determinado de temas, datos demográficos, públicos o atributos de creadores.
- Estadísticas de marca de creadores: Recupera estadísticas sobre los creadores relacionadas con una marca específica.
- Estadísticas de creadores: Recupera estadísticas sobre canales de YouTube específicos, como la cantidad de suscriptores, la cantidad de vistas y los datos demográficos del público.
- Estadísticas de tendencias: Recupera estadísticas sobre tendencias específicas, según públicos o temas específicos.
Requisitos de elegibilidad
ContentCreatorInsightsService.GenerateCreatorInsights
es un componente privado de la API de Google Ads que se ofrece con una licencia de datos no exclusiva y sin regalías. Los socios firmados pueden usar las bibliotecas cliente estándar de
Google Ads para explorar el contenido y los creadores de YouTube.
Para ser elegibles, los socios deben cumplir con las siguientes condiciones:
- Tener una herramienta de planificación o una interfaz de usuario que integre la API de Google Ads.
- Usar la API para explorar el contenido y los creadores de YouTube en busca de posibles oportunidades publicitarias.
- Completar una evaluación previa para garantizar la elegibilidad.
- Cumplir con los requisitos de uso de datos y estar dispuesto a someterse a auditorías de datos periódicas.
- Firmar un acuerdo de licencia de datos que aplique legalmente los requisitos de uso de datos.
- Aceptar las Condiciones del Servicio de la API de Google Ads.
Comunícate con tu representante de Google para obtener más información.
Genera estadísticas de creadores
Para generar estadísticas de creadores, envía una solicitud al
ContentCreatorInsightsService.GenerateCreatorInsights
método. Este método tiene un límite de 5 consultas por segundo (CPS) y toma tres tipos de entrada según si deseas realizar el descubrimiento de creadores, obtener estadísticas de marca de creadores o estadísticas de creadores. Debes proporcionar las ubicaciones de los países de los que deseas obtener datos.
Descubrimiento de creadores: Puedes proporcionar una lista de atributos del público, como la edad, el género y los intereses de los usuarios (incluidos los públicos afines, en el mercado y por acontecimientos). La API muestra una lista de creadores cuyos públicos coinciden con esos atributos. También puedes proporcionar atributos de creadores para filtrar a los creadores cuyo contenido coincida específicamente con los atributos de creadores que ingresaste.
Puedes recuperar los atributos del público disponibles con
AudienceInsightsService.ListAudienceInsightsAttributes, para ello, proporciona las dimensiones para las que deseas obtener atributos, comoKNOWLEDGE_GRAPHpara los temas de interés.A partir de la versión 23 de la API de Google Ads, puedes especificar relaciones complejas de atributos del público con
audience_combinations. Este campo te permite definir públicos con lógica booleana (Y/O) que no es posible conaudience_attributes.Si bien
audience_attributeses adecuado para la segmentación basada en una lista de atributos unidos (combinados con O) (p.ej., usuarios interesados en "deportes" O "viajes" O ...),audience_combinationsofrece un control más detallado. CadaInsightsAudienceAttributeGroupdentro deaudience_combinationscombina atributos con un operador lógico OR. Luego, estos grupos se combinan con un operador lógico AND.Por ejemplo, para segmentar un público interesado en ("cuidado de la piel" O "cuidado del cabello") Y también en "cosméticos", usarías dos elementos
InsightsAudienceAttributeGroupenaudience_combinations. "Cuidado de la piel", "cuidado del cabello" y "cosméticos" son temas de interés, representados por entidades del gráfico de conocimiento (por ejemplo,/m/014trlpara cosméticos). El primer grupo contendría atributos de entidades del gráfico de conocimiento para "cuidado de la piel" y "cuidado del cabello", y el segundo grupo contendría el atributo de entidad del gráfico de conocimiento para "cosméticos".Ten en cuenta que, si especificas entidades del gráfico de conocimiento, categorías de productos y servicios o intereses de los usuarios en
audience_attributes, no puedes usaraudience_combinations. Si usasaudience_combinations, debes especificar estos atributos dentro deaudience_combinationsy no enaudience_attributes. Sin embargo, puedes seguir usandoaudience_attributespara otros tipos de atributos, como los datos demográficos, junto conaudience_combinations.Estadísticas de marca de creadores: Proporciona una marca para buscar a los creadores más populares. La API muestra estadísticas sobre los canales coincidentes.
Estadísticas de creadores: Proporciona una lista de IDs de canales de YouTube. La API muestra estadísticas sobre esos canales específicos.
El método generateCreatorInsights muestra un objeto GenerateCreatorInsightsResponse. Este objeto contiene una lista de objetos YouTubeCreatorInsights. Cada objeto YouTubeCreatorInsights contiene la siguiente información sobre un creador:
- Nombre del creador
- Canal de YouTube
- Métricas totales del creador
- Lista de estadísticas del canal de YouTube
El YouTubeMetrics objeto contiene las
siguientes métricas:
- Recuento de suscriptores
- Cantidad de vistas
- Número de videos
- Es un creador activo de Shorts
- Oportunidades de asociación (a partir de la versión 23)
El objeto YouTubeChannelInsights contiene la siguiente información sobre un canal de YouTube:
- Nombre del canal
- ID del canal
- URL del canal
- Descripción del canal
- Métricas del canal
Atributos del público del canal (como la edad, el género y los intereses de los usuarios
desglosados)
Videos más exitosos
Tipo de canal
Idiomas asociados con el contenido del canal
Puntuación de relevancia (solo para búsquedas de tendencias de temas)
Genera estadísticas de tendencias
Para generar estadísticas de tendencias, envía una solicitud al
ContentCreatorInsightsService.GenerateTrendingInsights
método. Este método tiene un límite de 5 consultas por segundo (CPS) y toma dos tipos de entrada según si deseas obtener tendencias del público o tendencias de temas.
Debes proporcionar la ubicación específica del país del que deseas obtener tendencias.
Tendencias del público: Puedes proporcionar una lista de atributos del público, como la edad, el género y los intereses de los usuarios (incluidos los públicos afines, en el mercado y por acontecimientos). La API muestra una lista de estadísticas de tendencias para esos públicos, incluidas métricas como el cambio porcentual en el valor de la tendencia durante el período de comparación.
Puedes recuperar los atributos del público disponibles con
AudienceInsightsService.ListAudienceInsightsAttributes, para ello, proporciona las dimensiones para las que deseas obtener atributos, comoKNOWLEDGE_GRAPHpara los temas de interés.A partir de la versión 23 de la API de Google Ads, puedes especificar relaciones complejas de atributos del público con
audience_combinations. Este campo te permite definir públicos con lógica booleana (Y/O) que no es posible conaudience_attributes.Si bien
audience_attributeses adecuado para la segmentación basada en una lista de atributos unidos (combinados con O) (p.ej., usuarios interesados en "deportes" O "viajes" O ...),audience_combinationsofrece un control más detallado. CadaInsightsAudienceAttributeGroupdentro deaudience_combinationscombina atributos con un operador lógico OR. Luego, estos grupos se combinan con un operador lógico AND.Por ejemplo, para segmentar un público interesado en ("cuidado de la piel" O "cuidado del cabello") Y también en "cosméticos", usarías dos elementos
InsightsAudienceAttributeGroupenaudience_combinations. "Cuidado de la piel", "cuidado del cabello" y "cosméticos" son temas de interés, representados por entidades del gráfico de conocimiento (por ejemplo,/m/014trlpara cosméticos). El primer grupo contendría atributos de entidades del gráfico de conocimiento para "cuidado de la piel" y "cuidado del cabello", y el segundo grupo contendría el atributo de entidad del gráfico de conocimiento para "cosméticos".Ten en cuenta que, si especificas entidades del gráfico de conocimiento, categorías de productos y servicios o intereses de los usuarios en
audience_attributes, no puedes usaraudience_combinations. Si usasaudience_combinations, debes especificar estos atributos dentro deaudience_combinationsy no enaudience_attributes. Sin embargo, puedes seguir usandoaudience_attributespara otros tipos de atributos, como los datos demográficos, junto conaudience_combinations.Tendencias de temas: Proporciona una lista de temas de contenido. La API muestra una lista de estadísticas de tendencias para esos temas, incluidas métricas como el cambio porcentual en el valor de la tendencia durante el período de comparación.