Estadísticas de los 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 creadores pertinentes para un conjunto determinado de temas, datos demográficos, públicos o atributos de creadores.
  2. Estadísticas de temas de creadores: Recupera estadísticas sobre creadores pertinentes que generan contenido sobre temas especificados.
  3. Estadísticas de creadores: Recupera estadísticas sobre canales de YouTube específicos, como el recuento de suscriptores, el recuento 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.

El descubrimiento de creadores locales (encontrar creadores que se encuentren en un país determinado o publiquen contenido desde allí y que se vean en ese país) se admite cuando se usa el descubrimiento de creadores basado en temas o las estadísticas de tendencias solicitando datos complementarios.

Requisitos de elegibilidad

GenerateCreatorInsights es un componente privado de la API de Google Ads que se ofrece con una licencia de datos no exclusiva y libre de 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 GenerateCreatorInsights método. Este método tiene un límite de 5 consultas por segundo (QPS). Acepta diferentes tipos de entrada según si deseas realizar el descubrimiento de creadores, buscar creadores pertinentes por temas o obtener 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 ListAudienceInsightsAttributes, para ello, proporciona las dimensiones para las que deseas atributos, como KNOWLEDGE_GRAPH para 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 temas de creadores: Proporciona una lista de temas de contenido con el campo search_topics. La API muestra creadores pertinentes que generan contenido sobre los temas especificados. Los datos recuperados se basan en el país especificado en country_locations. Ten en cuenta que esta opción permite buscar solo un país.

    Las entidades admitidas en el campo SearchTopics deben etiquetarse con la capacidad CONTENT_TRENDING_INSIGHTS o CREATOR_TOPIC_INSIGHTS. Usa el ListAudienceInsightsAttributes método para recuperar las capacidades de entidades admitidas.

    Nota: La opción search_brand dejó de estar disponible a partir de la versión 24.2 y se quitó por completo en la versión 25. Los usuarios deben cambiar a search_topics en su lugar.

  3. Estadísticas de creadores: Proporciona una lista de IDs de canales de YouTube con el search_channels campo. La API muestra estadísticas sobre esos canales específicos.

Datos complementarios y creadores locales

De forma predeterminada, solo se muestran los datos de estadísticas principales. Puedes solicitar funciones opcionales y datos adicionales en tu respuesta configurando el campo repetido supplemental_data.

Por ejemplo, puedes solicitar datos de creadores locales agregando el valor de enumeración LOCAL_CREATOR_DATA al campo supplemental_data. Si buscas creadores con search_topics (y el tema es una entidad del Gráfico de conocimiento etiquetada con la capacidad CREATOR_TOPIC_INSIGHTS), la API propagará el campo local_creator_insights en la respuesta con los creadores locales que hayan aceptado compartir sus datos de ubicación.

Ten en cuenta las siguientes especificaciones para el descubrimiento de creadores locales:

  • Definición: Los "creadores locales" son creadores que se encuentran en el país seleccionado o publican contenido desde allí y que se ven en ese país.
  • Restricción: El descubrimiento de creadores locales no se admite cuando se establece sub_country_locations en la solicitud.
  • Capacidades: Puedes recuperar la lista de entidades del Gráfico de conocimiento admitidas y sus capacidades conListAudienceInsightsAttributes.

El método generateCreatorInsights muestra un objeto GenerateCreatorInsightsResponse. Este objeto contiene los siguientes campos:

  • creator_insights: Es una lista de objetos YouTubeCreatorInsights que coinciden con tus criterios principales.
  • local_creator_insights: Es una lista de objetos YouTubeCreatorInsights para creadores locales. Solo se propaga si se solicitó LOCAL_CREATOR_DATA y el criterio usado fue search_topics.

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
  • Recuento de vistas
  • Número de videos
  • Es un creador activo de Shorts
  • Oportunidades de asociación (a partir de la versión 23)

Para identificar si un creador es apto para las asociaciones de contenido de marca original, consulta partnership_opportunities; un creador es apto si la lista contiene el valor CREATOR_PARTNERSHIPS.

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 el desglose de los intereses de los usuarios)
  • 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 GenerateTrendingInsights método. Este método tiene un límite de 5 consultas por segundo (QPS). Acepta 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 ListAudienceInsightsAttributes, para ello, proporciona las dimensiones para las que deseas atributos, como KNOWLEDGE_GRAPH para temas de interés.

    Los atributos KNOWLEDGE_GRAPH tendrán una o más InsightsKnowledgeGraphEntityCapabilities etiquetas. Los atributos admitidos para las estadísticas de tendencias tendrán etiquetas pertinentes en sus metadatos de respuesta.

    Ten en cuenta que los desarrolladores con acceso a ContentCreatorInsightsService también tendrán acceso automático a AudienceInsightsService.ListAudienceInsightsAttributes. Otros extremos en AudienceInsightsService requieren un proceso independiente de lista de entidades permitidas.

    Puedes encontrar documentación adicional sobre ListAudienceInsightsAttributes en la guía de Estadísticas de público.

  2. 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 el ListAudienceInsightsAttributes método, para ello, proporciona las dimensiones para las que deseas atributos, como KNOWLEDGE_GRAPH para 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.

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

Al igual que cuando generas estadísticas de creadores, puedes solicitar funciones opcionales en las estadísticas de tendencias configurando el campo repetido supplemental_data como LOCAL_CREATOR_DATA.

Si tu solicitud de tendencias usa search_topics, se propagará el related_local_creators campo en los objetos TrendInsight que se muestran con los creadores locales relacionados para el tema solicitado que hayan aceptado compartir sus datos de ubicación. El descubrimiento de creadores locales está sujeto a la misma definición y restricciones (como ser incompatible con sub_country_locations).

Anterior
Estadísticas de público