Insights para criadores de conteúdo do YouTube

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

A API tem quatro funções principais:

  1. Descoberta de criadores de conteúdo:encontre criadores de conteúdo relevantes para um determinado conjunto de temas, dados demográficos, públicos-alvo ou atributos de criadores.
  2. Insights de temas de criadores de conteúdo:receba insights sobre criadores de conteúdo relevantes que produzem conteúdo sobre temas especificados.
  3. Insights de criadores de conteúdo:receba insights sobre canais específicos do YouTube, como contagem de inscritos, contagem de visualizações e dados demográficos do público-alvo.
  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 de conteúdo que estão ou postam conteúdo de um determinado país e são assistidos nesse país) é compatível ao usar a descoberta de criadores de conteúdo com base em temas ou insights de tendências 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 isenta de royalties. Parceiros assinados podem usar as bibliotecas de cliente padrão da API Google Ads para explorar criadores de conteúdo e conteúdo do YouTube. Para se qualificar, os parceiros precisam atender às seguintes condições:

  • Ter uma ferramenta de planejamento ou interface do usuário que vai integrar a API Google Ads.
  • Usar a API para explorar conteúdo e criadores de conteúdo do YouTube em busca de possíveis oportunidades de publicidade.
  • Concluir uma avaliação de pré-seleção para garantir a qualificação.
  • Seguir os requisitos de uso de dados e estar disposto a passar por auditorias de dados periódicas.
  • Assinar um contrato de licenciamento de dados que aplique legalmente os requisitos de uso de dados.
  • Aceitar os Termos de Serviço da API Google Ads.

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

Gerar insights de criadores de conteúdo

Para gerar insights de criadores de conteúdo, envie uma solicitação ao GenerateCreatorInsights método. Esse método tem um limite de 5 consultas por segundo (QPS). Ele usa diferentes tipos de entrada, dependendo se você quer fazer a descoberta de criadores de conteúdo, pesquisar criadores de conteúdo relevantes por temas ou receber insights de criadores de conteúdo. 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 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 criadores de conteúdo cujos públicos-alvo correspondem a esses atributos. Você também pode fornecer atributos de criadores de conteúdo para filtrar criadores de conteúdo cujo conteúdo corresponda especificamente aos atributos de criadores de conteúdo 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 versão 23 da API Google Ads, é possível especificar relações complexas de atributos de público-alvo usando audience_combinations. Esse campo permite definir públicos-alvo com lógica booleana (AND/OR) 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", você usaria 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 Mapa de informações (por exemplo, /m/014trl para Cosméticos). O primeiro grupo conteria atributos de entidade do Mapa de informações para "Cuidados com a pele" e "Cuidados com o cabelo", e o segundo grupo conteria o atributo de entidade do Mapa de informações para "Cosméticos".

    Se você especificar entidades do Mapa de informações, categorias de produtos e serviços ou interesses do usuário em audience_attributes, não será possível usar audience_combinations. Se você usar audience_combinations, será necessário especificar 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 de criadores de conteúdo: forneça uma lista de temas de conteúdo usando o search_topics campo. A API retorna criadores de conteúdo relevantes que produzem conteúdo sobre os temas especificados. Os dados recebidos 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 ListAudienceInsightsAttributes método para recuperar as capacidades de entidades compatíveis.

    Observação: a opção search_brand foi descontinuada na versão 24.2 e removida na versão 25. Use search_topics.

  3. Insights de criadores de conteúdo: forneça uma lista de IDs de canais do YouTube usando o search_channels campo. A API retorna insights sobre esses canais específicos.

Dados complementares e criadores de conteúdo locais

Por padrão, apenas 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 pesquisando 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 localização.

Confira as especificações a seguir para a descoberta de criadores de conteúdo locais:

  • Definição : "criadores de conteúdo locais" são criadores de conteúdo que estão ou postam conteúdo do país selecionado e são assistidos nesse país.
  • Restrição: a descoberta de criadores de conteúdo locais não é compatível quando sub_country_locations está definido na solicitação.
  • Capacidades: é possível recuperar a lista de entidades do Mapa de informações compatíveis e as capacidades delas 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. Esse campo só será preenchido se LOCAL_CREATOR_DATA tiver sido solicitado e os critérios usados forem 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 YouTubeMetrics objeto contém as seguintes métricas:

  • Contagem de inscritos
  • Contagem de visualizações
  • Contagem de vídeos
  • É um criador de conteúdo ativo de Shorts
  • Oportunidades de parceria (a partir da versão 23)

Para identificar se um criador de conteúdo se qualifica para parcerias de conteúdo de marca original, verifique partnership_opportunities; um criador de conteúdo se qualifica 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 de 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 temas)
  • Se o criador de conteúdo consentiu em compartilhar métricas não públicas

Para gerar insights de tendências, envie uma solicitação ao GenerateTrendingInsights método. Esse método tem um limite de 5 consultas por segundo (QPS). Ele usa dois tipos de entrada, dependendo se você quer receber tendências de público-alvo ou tendências de temas. Você precisa informar o local específico do país de onde quer receber 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 versão 23 da API Google Ads, é possível especificar relações complexas de atributos de público-alvo usando audience_combinations. Esse campo permite definir públicos-alvo com lógica booleana (AND/OR) 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", você usaria 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 Mapa de informações (por exemplo, /m/014trl para Cosméticos). O primeiro grupo conteria atributos de entidade do Mapa de informações para "Cuidados com a pele" e "Cuidados com o cabelo", e o segundo grupo conteria o atributo de entidade do Mapa de informações para "Cosméticos".

    Se você especificar entidades do Mapa de informações, categorias de produtos e serviços ou interesses do usuário em audience_attributes, não será possível usar audience_combinations. Se você usar audience_combinations, será necessário especificar 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.

    KNOWLEDGE_GRAPH atributos terão uma ou mais InsightsKnowledgeGraphEntityCapabilities tags. Os atributos compatíveis com insights de tendências terão tags relevantes nos metadados de resposta.

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

    A documentação adicional 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 de tendências para esses temas, incluindo métricas como a mudança percentual no valor da tendência durante o período de comparação.

Assim como na geração de insights de criadores de conteúdo, é possível solicitar recursos opcionais em insights de tendências definindo o campo repetido supplemental_data como LOCAL_CREATOR_DATA.

Se a solicitação de tendências usar search_topics, isso vai preencher o related_local_creators campo 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 ser incompatível com sub_country_locations).

O GenerateTrendingInsights método retorna uma lista de TrendInsight objetos, 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 para a tendência. Preenchido apenas para tendências que usam search_topics.
  • related_videos: uma lista de AudienceInsightsAttributeMetadata objetos 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, que contém 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).
Anterior
Insights sobre público-alvo