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

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 sin regalías. Los socios que firmaron el acuerdo pueden usar las bibliotecas cliente de Google Ads estándares para explorar el contenido y los creadores 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 realizar el descubrimiento de creadores, buscar creadores relevantes 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 de 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 (AND/OR) 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 a partir de la versión 24.2 y se quitó por completo en la versión 25. En su lugar, los usuarios deben migrar al uso de search_topics.

  3. Estadísticas de creadores: Proporciona una lista de IDs de canales de YouTube en 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 él, y cuyo contenido se mira 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 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 un creador de Shorts activo
  • Oportunidades de asociación (a partir de la versión 23)

Para identificar si un creador cumple con los requisitos para participar en colaboraciones de contenido original de la marca, 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)

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). Toma 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 (AND/OR) 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 compatibles con 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.

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.

Si tu solicitud de tendencias usa search_topics, se 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 (por ejemplo, no es compatible con sub_country_locations).

Anterior
Estadísticas de público