Estadísticas para creadores de YouTube

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:

  1. 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.
  2. Estadísticas de marca de creadores: Recupera estadísticas sobre los creadores relacionadas con una marca específica.
  3. 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.
  4. 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.

  1. 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, como KNOWLEDGE_GRAPH para 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 con audience_attributes.

    Si bien audience_attributes es 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_combinations ofrece un control más detallado. Cada InsightsAudienceAttributeGroup dentro de audience_combinations combina 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 InsightsAudienceAttributeGroup en audience_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/014trl para 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 usar audience_combinations. Si usas audience_combinations, debes especificar estos atributos dentro de audience_combinations y no en audience_attributes. Sin embargo, puedes seguir usando audience_attributes para otros tipos de atributos, como los datos demográficos, junto con audience_combinations.

  2. 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.

  3. 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)

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.

  1. 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, como KNOWLEDGE_GRAPH para 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 con audience_attributes.

    Si bien audience_attributes es 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_combinations ofrece un control más detallado. Cada InsightsAudienceAttributeGroup dentro de audience_combinations combina 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 InsightsAudienceAttributeGroup en audience_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/014trl para 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 usar audience_combinations. Si usas audience_combinations, debes especificar estos atributos dentro de audience_combinations y no en audience_attributes. Sin embargo, puedes seguir usando audience_attributes para otros tipos de atributos, como los datos demográficos, junto con audience_combinations.

  2. 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.