Insights para criadores de conteúdo do YouTube

Observação :esse recurso está na versão Beta e disponível apenas para desenvolvedores em uma lista de permissões.

Descubra e acesse insights sobre criadores de conteúdo do YouTube com o recurso de insights do criador de conteúdo. Isso pode ser útil para agências e anunciantes que querem encontrar criadores de conteúdo relevantes para o público-alvo deles.

A API tem quatro funções principais:

1. Descoberta de criadores de conteúdo:encontre criadores relevantes para um determinado conjunto de temas, dados demográficos, públicos-alvo ou atributos de criadores.
2. Insights sobre temas de criadores de conteúdo:receba insights sobre criadores de conteúdo relevantes que produzem conteúdo sobre temas específicos.
3. Insights para criadores de conteúdo:confira insights sobre canais específicos do YouTube, como contagem de inscritos e visualizações e informações demográficas do público.
4. Insights de tendências:receba insights sobre tendências específicas com base em públicos-alvo ou temas específicos.

A descoberta de criadores de conteúdo locais (encontrar criadores que moram ou postam de um determinado país e são assistidos nele) é compatível com a descoberta de criadores de conteúdo por tema ou insights em alta ao solicitar dados complementares. Você também pode pedir insights de sentimento da marca para insights de tendências com base em temas solicitando dados complementares.

Requisitos de qualificação

GenerateCreatorInsights é um componente particular da API Google Ads oferecido com uma licença de dados não exclusiva e sem royalties. Os parceiros que assinaram o contrato podem usar as bibliotecas de cliente do Google Ads padrão para pesquisar criadores de conteúdo e vídeos do YouTube. Para se qualificar, os parceiros precisam atender às seguintes condições:

• Ter uma ferramenta de planejamento ou interface do usuário que integre a API Google Ads.
• Use a API para pesquisar conteúdo e criadores de conteúdo do YouTube e encontrar possíveis oportunidades de publicidade.
• Faça uma avaliação de pré-seleção para garantir a qualificação.
• Seguir os requisitos de uso de dados e aceitar auditorias periódicas de dados.
• Assine um contrato de licenciamento de dados que imponha legalmente os requisitos de uso de dados.
• Aceite os Termos de Serviço da API Google Ads.

Entre em contato com o representante do Google para mais informações.

Gerar insights para criadores de conteúdo

Para gerar insights para criadores de conteúdo, envie uma solicitação ao método GenerateCreatorInsights. Esse método tem um limite de cinco consultas por segundo (QPS). Ele usa diferentes tipos de entrada, dependendo se você quer aumentar a descoberta de criadores, pesquisar criadores relevantes por temas ou receber insights sobre criadores. Você precisa informar os locais dos países de onde quer receber dados.

1. Descoberta de criadores de conteúdo:você pode fornecer uma lista de atributos do público-alvo, como idade, gênero e interesses do usuário (incluindo públicos-alvo de afinidade, no mercado e de eventos importantes). A API retorna uma lista de criadores de conteúdo cujos públicos-alvo correspondem a esses atributos. Você também pode fornecer atributos de criador de conteúdo para filtrar aqueles cujo conteúdo corresponda especificamente aos atributos inseridos.

   É possível recuperar os atributos de público-alvo disponíveis usando ListAudienceInsightsAttributes, fornecendo as dimensões para as quais você quer atributos, como KNOWLEDGE_GRAPH para temas de interesse.

   A partir da API Google Ads v23, é possível especificar relações complexas entre atributos de público-alvo usando audience_combinations. Com esse campo, é possível definir públicos-alvo com lógica booleana (E/OU) que não é possível com audience_attributes.

   Embora audience_attributes seja adequado para segmentação com base em uma lista de atributos unidos (combinados com OR), por exemplo, usuários interessados em "esportes" OU "viagens" OU ..., audience_combinations oferece um controle mais granular. Cada InsightsAudienceAttributeGroup em audience_combinations combina atributos com um OR lógico. Esses grupos são combinados com um AND lógico.

   Por exemplo, para segmentar um público-alvo interessado em ("Cuidados com a pele" OU "Cuidados com o cabelo") E também em "Cosméticos", use dois itens InsightsAudienceAttributeGroup em audience_combinations. "Cuidados com a pele", "Cuidados com o cabelo" e "Cosméticos" são temas de interesse representados por entidades do gráfico de conhecimento (por exemplo, /m/014trl para cosméticos). O primeiro grupo teria atributos de entidade do Mapa de informações para "Cuidados com a pele" e "Cuidados com o cabelo", e o segundo teria o atributo de entidade do Mapa de informações para "Cosméticos".

   Se você especificar entidades do Knowledge Graph, categorias de produtos e serviços ou interesses do usuário em audience_attributes, não será possível usar audience_combinations. Se você usa audience_combinations, especifique esses atributos em audience_combinations e não em audience_attributes. No entanto, ainda é possível usar audience_attributes para outros tipos de atributos, como dados demográficos, em conjunto com audience_combinations.

2. Insights de temas dos criadores:forneça uma lista de temas de conteúdo usando o campo search_topics. A API retorna criadores de conteúdo relevantes que produzem conteúdo sobre os temas especificados. Os dados extraídos são baseados no país especificado em country_locations. Essa opção permite pesquisar apenas um país.

   As entidades compatíveis no campo SearchTopics precisam ser marcadas com a capacidade CONTENT_TRENDING_INSIGHTS ou CREATOR_TOPIC_INSIGHTS. Use o método ListAudienceInsightsAttributes para extrair os recursos de entidade compatíveis.

   Observação: a opção search_brand foi descontinuada na v24.2 e removida na v25. Use search_topics em vez disso.

3. Insights para criadores de conteúdo:forneça uma lista de IDs ou identificadores de canais do YouTube (a partir da v25.2) ou uma combinação dos dois usando o campo search_channels. A API retorna insights sobre esses canais específicos.

Dados complementares e criadores de conteúdo locais

Por padrão, somente os dados principais de insights são retornados. É possível solicitar recursos opcionais e dados adicionais na resposta definindo o campo repetido supplemental_data.

Por exemplo, é possível solicitar dados de criadores de conteúdo locais adicionando o valor de enumeração LOCAL_CREATOR_DATA ao campo supplemental_data. Se você estiver procurando criadores de conteúdo usando search_topics e o tema for uma entidade do Mapa de informações marcada com a capacidade CREATOR_TOPIC_INSIGHTS, a API vai preencher o campo local_creator_insights na resposta com criadores de conteúdo locais que consentiram em compartilhar os dados de local.

Confira as seguintes especificações para a Descoberta de Criadores local:

• Definição: "criadores de conteúdo locais" são aqueles que estão baseados ou postam do país selecionado e são assistidos nele.
• Restrição:a descoberta de criadores de conteúdo locais não é compatível quando sub_country_locations é definido na solicitação.
• Capacidades:é possível recuperar a lista de entidades do Mapa de informações compatíveis e suas capacidades usando ListAudienceInsightsAttributes.

O método generateCreatorInsights retorna um objeto GenerateCreatorInsightsResponse. Esse objeto contém os seguintes campos:

• creator_insights: uma lista de objetos YouTubeCreatorInsights que correspondem aos seus critérios principais.
• local_creator_insights: uma lista de objetos YouTubeCreatorInsights para criadores de conteúdo locais. Isso só será preenchido se LOCAL_CREATOR_DATA tiver sido solicitado e o critério usado for search_topics.

Cada objeto YouTubeCreatorInsights contém as seguintes informações sobre um criador de conteúdo:

• Nome do criador de conteúdo
• Canal do YouTube
• Total de métricas do criador de conteúdo
• Lista de insights do canal do YouTube

O objeto YouTubeMetrics contém as seguintes métricas:

• Contagem de inscritos
• Número de visualizações
• Contagem de vídeos
• É um criador de Shorts ativo
• Oportunidades de parceria (a partir da v23)

Para identificar se um criador de conteúdo atende aos requisitos para parcerias de conteúdo de marca original, confira partnership_opportunities; um criador de conteúdo atende aos requisitos se a lista contiver o valor CREATOR_PARTNERSHIPS.

O objeto YouTubeChannelInsights contém as seguintes informações sobre um canal do YouTube:

• Nome do canal
• ID do canal
• URL do canal
• A descrição do canal.
• Métricas do canal
• Atributos do público-alvo do canal (como idade, gênero e detalhamento dos interesses do usuário)
• Vídeos mais acessados
• Tipo de canal
• Idiomas associados ao conteúdo do canal
• Pontuação de relevância (somente para pesquisas de tendências de tópicos)
• Se o criador de conteúdo deu consentimento para compartilhar métricas não públicas

Gerar insights de tendências

Para gerar insights de tendências, envie uma solicitação ao método GenerateTrendingInsights. Esse método tem um limite de cinco consultas por segundo (QPS). Ele usa dois tipos de entrada, dependendo se você quer receber tendências de público-alvo ou de tema. Você precisa informar o país específico de onde quer receber as tendências.

1. Tendências de público-alvo:você pode fornecer uma lista de atributos de público-alvo, como idade, gênero e interesses do usuário (incluindo públicos-alvo de afinidade, no mercado e de eventos importantes). A API retorna uma lista de insights de tendências para esses públicos-alvo, incluindo métricas como a mudança percentual no valor da tendência durante o período de comparação.

   É possível recuperar os atributos de público-alvo disponíveis usando ListAudienceInsightsAttributes, fornecendo as dimensões para as quais você quer atributos, como KNOWLEDGE_GRAPH para temas de interesse.

   A partir da API Google Ads v23, é possível especificar relações complexas de atributos de público-alvo usando audience_combinations. Com esse campo, é possível definir públicos-alvo com lógica booleana (E/OU), o que não é possível com audience_attributes.

   Embora audience_attributes seja adequado para segmentação com base em uma lista de atributos unidos (combinados com OR), por exemplo, usuários interessados em "esportes" OU "viagens" OU ..., audience_combinations oferece um controle mais granular. Cada InsightsAudienceAttributeGroup em audience_combinations combina atributos com um OR lógico. Esses grupos são combinados com um AND lógico.

   Por exemplo, para segmentar um público-alvo interessado em ("Cuidados com a pele" OU "Cuidados com o cabelo") E também em "Cosméticos", use dois itens InsightsAudienceAttributeGroup em audience_combinations. "Cuidados com a pele", "Cuidados com o cabelo" e "Cosméticos" são temas de interesse representados por entidades do gráfico de conhecimento (por exemplo, /m/014trl para cosméticos). O primeiro grupo teria atributos de entidade do Mapa de informações para "Cuidados com a pele" e "Cuidados com o cabelo", e o segundo teria o atributo de entidade do Mapa de informações para "Cosméticos".

   Se você especificar entidades do Knowledge Graph, categorias de produtos e serviços ou interesses do usuário em audience_attributes, não será possível usar audience_combinations. Se você usa audience_combinations, especifique esses atributos em audience_combinations e não em audience_attributes. No entanto, ainda é possível usar audience_attributes para outros tipos de atributos, como dados demográficos, em conjunto com audience_combinations.

   Os atributos KNOWLEDGE_GRAPH terão uma ou mais tags InsightsKnowledgeGraphEntityCapabilities. Os atributos compatíveis com os insights em alta têm tags relevantes nos metadados de resposta.

   Os desenvolvedores com acesso a ContentCreatorInsightsService também terão acesso automático a AudienceInsightsService.ListAudienceInsightsAttributes. Outros endpoints em AudienceInsightsService exigem um processo independente de lista de permissões.

   Mais documentação sobre ListAudienceInsightsAttributes pode ser encontrada no guia de insights sobre público-alvo.

2. Tendências de temas:forneça uma lista de temas de conteúdo. A API retorna uma lista de insights em alta para esses temas, incluindo métricas como a mudança percentual no valor da tendência durante o período de comparação. Você também pode pedir insights de sentimento da marca para temas de marca solicitando dados complementares.

Dados complementares, criadores de conteúdo locais e sentimento da marca

Assim como na geração de insights para criadores de conteúdo, você pode solicitar recursos opcionais nos insights em alta definindo o campo repetido supplemental_data como LOCAL_CREATOR_DATA ou BRAND_SENTIMENT_DATA.

Se a solicitação de conteúdo em alta usar search_topics, definir supplemental_data como LOCAL_CREATOR_DATA vai preencher o campo related_local_creators nos objetos TrendInsight retornados com criadores de conteúdo locais relacionados ao tema solicitado que consentiram em compartilhar os dados de localização. A descoberta de criadores de conteúdo locais está sujeita à mesma definição e restrições (como incompatibilidade com sub_country_locations).

Se a solicitação de tendências usar search_topics, definir supplemental_data como BRAND_SENTIMENT_DATA vai preencher o campo brand_sentiment_insights nos objetos TrendInsight retornados quando o tópico da entidade do Mapa de informações solicitado tiver a capacidade BRAND. Um tema de marca é uma entidade marcada com a capacidade BRAND. É possível recuperar os recursos de entidade compatíveis usando o método ListAudienceInsightsAttributes.

Para medir o sentimento da marca, usamos modelos de IA (com tecnologia do Gemini) para analisar o conteúdo de vídeo do YouTube relacionado à marca, categorizando o sentimento como positivo, negativo ou neutro. Apenas o conteúdo do vídeo é analisado. Os comentários dos usuários não são incluídos.

Metadados de insights em alta

O método GenerateTrendingInsights retorna uma lista de objetos TrendInsight, cada um contendo:

• trend_attribute: o AudienceInsightsAttributeMetadata principal da tendência.
• trend_metrics: as métricas da tendência, como a mudança percentual no período de comparação.
• trend_data_points: pontos de dados históricos da tendência. Preenchido apenas para tendências que usam search_topics.
• related_videos: uma lista de objetos AudienceInsightsAttributeMetadata para vídeos em alta associados ao tema da tendência. Preenchido apenas para tendências que usam search_topics. Para esses atributos, o YouTubeVideoAttributeMetadata aninhado é preenchido, contendo metadados no nível do vídeo (como URL do vídeo, URL da miniatura e contagens de visualizações ou curtidas) e metadados no nível do canal (como ID do canal, nome e URL do canal).
• brand_sentiment_insights: uma lista de objetos BrandSentimentInsight para a tendência. Só é preenchido quando a solicitação de tendência usa search_topics, o tópico da entidade do Mapa de informações tem a capacidade BRAND e BRAND_SENTIMENT_DATA é solicitado em supplemental_data. Cada objeto BrandSentimentInsight contém:
  • month: o mês que o sentimento da marca representa no formato YYYY-MM.
  • has_insufficient_data: se há dados insuficientes para calcular o sentimento da marca.
  • sentiment_distributions: distribuição de sentimento entre positivo, negativo e neutro, calculada como a proporção de visualizações de vídeos que correspondem à marca com cada sentimento.
  • sentiment_summaries: resumos gerados por IA sobre o que foi positivo e negativo no conteúdo relacionado à marca, além de exemplos de vídeos para cada sentimento. Os resumos são gerados apenas para sentimentos positivos e negativos, não neutros.