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 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: Obtén estadísticas sobre los creadores pertinentes que generan contenido sobre temas específicos.
  3. Estadísticas de creadores: Obtén 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 sobre tendencias: Obtén estadísticas sobre tendencias específicas, basadas en públicos o temas específicos.

El descubrimiento de creadores locales (encontrar creadores que viven en un país determinado o publican contenido desde allí, y que se ven 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. También puedes solicitar estadísticas de opinión sobre la marca para las estadísticas de tendencias basadas en temas 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 que firmaron el acuerdo pueden usar las bibliotecas cliente de Google Ads estándares para explorar los creadores y el contenido de YouTube. Para ser aptos, 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
  • Usa la API para explorar el contenido y los creadores de YouTube en busca de posibles oportunidades publicitarias.
  • Completa una evaluación previa para asegurarte de cumplir con los requisitos.
  • Cumplir con los requisitos de uso de datos y aceptar someterse a auditorías de datos periódicas
  • Firmar un acuerdo de licencia de datos que aplique legalmente los requisitos de uso de datos
  • Acepta 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 los creadores

Para generar estadísticas de creadores, envía una solicitud al método GenerateCreatorInsights. Este método tiene un límite de 5 consultas por segundo (QPS). Acepta diferentes tipos de entrada según si deseas descubrir creadores, buscar creadores relevantes por temas o obtener estadísticas sobre los 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 devuelve una lista de creadores cuyos públicos coinciden con esos atributos. También puedes proporcionar atributos de creador para filtrar a los creadores cuyo contenido coincida específicamente con los atributos de creador que ingresaste.

    Puedes recuperar los atributos de público disponibles con 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 entre 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 OR; 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 OR lógico. Luego, estos grupos se combinan con un operador AND lógico.

    Por ejemplo, para segmentar a 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 del usuario 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 demográficos, junto con audience_combinations.

  2. Estadísticas sobre los temas de los creadores: Proporciona una lista de temas de contenido con el campo search_topics. La API devuelve los 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 solo permite buscar un país.

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

    Nota: La opción search_brand dejó de estar disponible en la versión 24.2 y se quitó en la versión 25. En su lugar, usa search_topics.

  3. Estadísticas de creadores: Proporciona una lista de IDs o identificadores de canales de YouTube (a partir de la versión 25.2) o una combinación de ambos con el campo search_channels. La API devuelve estadísticas sobre esos canales específicos.

Datos complementarios y creadores locales

De forma predeterminada, solo se muestran los datos de las 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 completará el campo local_creator_insights en la respuesta con los creadores locales que dieron su consentimiento para compartir sus datos de ubicación.

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

  • Definición: Los "creadores locales" son aquellos que residen en el país seleccionado o publican contenido desde allí, y que se miran 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 compatibles de Knowledge Graph y sus capacidades con ListAudienceInsightsAttributes.

El método generateCreatorInsights devuelve 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. Este campo solo se completa si se solicitó LOCAL_CREATOR_DATA y el criterio utilizado fue search_topics.

Cada objeto YouTubeCreatorInsights contiene la siguiente información sobre un creador:

  • Nombre del creador
  • Canal de YouTube
  • Métricas totales de los creadores
  • Lista de estadísticas del canal de YouTube

El objeto YouTubeMetrics contiene las siguientes métricas:

  • Recuento de suscriptores
  • Cantidad de vistas
  • Número de videos
  • Ser creador activo de Shorts
  • Oportunidades de asociación (a partir de la versión 23)

Para identificar si un creador cumple con los requisitos para participar en asociaciones de contenido de marca original, consulta partnership_opportunities. Un creador cumple con los requisitos 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 el desglose de la edad, el género y 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 las búsquedas de tendencias de temas)
  • Indica si el creador dio su consentimiento para compartir métricas no públicas.

Para generar estadísticas de tendencias, envía una solicitud al método GenerateTrendingInsights. Este método tiene un límite de 5 consultas por segundo (QPS). Se requieren dos tipos de entrada, según si deseas obtener tendencias de público o tendencias de temas. Debes proporcionar la ubicación específica del país del que deseas obtener las tendencias.

  1. Tendencias del público: Puedes proporcionar una lista de atributos del público, como edad, género e intereses del usuario (incluidos los públicos afines, en el mercado y por acontecimientos). La API devuelve 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 de público disponibles con 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 entre 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 OR; 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 OR lógico. Luego, estos grupos se combinan con un operador AND lógico.

    Por ejemplo, para segmentar a 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 del usuario 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 demográficos, junto con audience_combinations.

    Los atributos KNOWLEDGE_GRAPH tendrán una o más etiquetas InsightsKnowledgeGraphEntityCapabilities. Los atributos admitidos para las estadísticas de tendencias tendrán etiquetas relevantes 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 de lista de entidades permitidas independiente.

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

  2. Tendencias de temas: Proporciona una lista de temas de contenido. La API devuelve 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. También puedes solicitar estadísticas sobre el sentimiento de la marca para los temas de la marca solicitando datos complementarios.

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 en LOCAL_CREATOR_DATA o BRAND_SENTIMENT_DATA.

Si tu solicitud de tendencias usa search_topics, establecer supplemental_data en LOCAL_CREATOR_DATA completará el campo related_local_creators en los objetos TrendInsight devueltos con los creadores locales relacionados con el tema solicitado que dieron su consentimiento para compartir sus datos de ubicación. El descubrimiento de creadores locales está sujeto a la misma definición y restricciones (como la incompatibilidad con sub_country_locations).

Si tu solicitud de tendencias usa search_topics, establecer supplemental_data en BRAND_SENTIMENT_DATA propagará el campo brand_sentiment_insights en los objetos TrendInsight devueltos cuando el tema de la entidad del Gráfico de conocimiento solicitada tenga la capacidad BRAND. Un tema de marca es una entidad etiquetada con la capacidad BRAND. Puedes recuperar las capacidades de entidades compatibles con el método ListAudienceInsightsAttributes.

Para medir la opinión sobre la marca, se usan modelos de IA (con tecnología de Gemini) para analizar el contenido de los videos de YouTube relacionados con la marca y categorizar la opinión como positiva, negativa o neutral. Solo se analiza el contenido de video en sí; no se incluyen los comentarios de los usuarios.

El método GenerateTrendingInsights devuelve una lista de objetos TrendInsight, cada uno de los cuales contiene lo siguiente:

  • trend_attribute: Es el AudienceInsightsAttributeMetadata principal de la tendencia.
  • trend_metrics: Son las métricas de la tendencia, como el cambio porcentual durante el período de comparación.
  • trend_data_points: Son los puntos de datos históricos de la tendencia. Solo se completa para las tendencias que usan search_topics.
  • related_videos: Es una lista de objetos AudienceInsightsAttributeMetadata para los videos populares asociados con el tema de la tendencia. Solo se completa para las tendencias que usan search_topics. En el caso de estos atributos, se completa el YouTubeVideoAttributeMetadata anidado, que contiene metadatos a nivel del video (como la URL del video, la URL de la miniatura y los recuentos de vistas o Me gusta) y metadatos a nivel del canal (como el ID del canal, el nombre y la URL del canal).
  • brand_sentiment_insights: Es una lista de objetos BrandSentimentInsight para la tendencia. Solo se completa cuando la solicitud de tendencias usa search_topics, el tema de la entidad del gráfico de conocimiento tiene la capacidad BRAND y se solicita BRAND_SENTIMENT_DATA en supplemental_data. Cada objeto BrandSentimentInsight contiene lo siguiente:
    • month: Es el mes que representa el sentimiento de la marca en formato YYYY-MM.
    • has_insufficient_data: Indica si no hay suficientes datos para calcular el sentimiento de la marca.
    • sentiment_distributions: Distribución de la opinión entre positiva, negativa y neutral, calculada como la proporción de vistas de los videos que corresponden a la marca con cada opinión.
    • sentiment_summaries: Resúmenes generados por IA sobre lo positivo y lo negativo del contenido relacionado con la marca, junto con videos de ejemplo para cada opinión. Los resúmenes solo se generan para opiniones positivas y negativas, no para las neutras.
Anterior
Estadísticas de público
Siguiente
Comparativas de YouTube