Insights dos criadores de conteúdo do YouTube

Descubra e busque 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 relevantes para o público-alvo.

A API tem quatro funções principais:

  1. Descoberta de criadores:encontre os principais criadores de conteúdo para um determinado conjunto de temas, dados demográficos, públicos-alvo ou atributos de criadores.
  2. Insights de marca do criador:busque insights sobre criadores relacionados a uma marca específica.
  3. Insights do criador:busque insights sobre canais específicos do YouTube, como a contagem de inscritos, a contagem de visualizações e os dados demográficos do público-alvo.
  4. Insights de tendências:busque insights sobre tendências específicas, com base em públicos-alvo ou temas específicos.

Requisitos de qualificação

ContentCreatorInsightsService.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 integre 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 do criador

Para gerar insights do criador, envie uma solicitação ao ContentCreatorInsightsService.GenerateCreatorInsights método. Esse método tem um limite de cinco consultas por segundo (QPS) e aceita três tipos de entrada, dependendo se você quer fazer a descoberta de criadores, insights de marca do criador ou insights do criador. Você precisa informar os locais do país de onde quer receber dados.

  1. Descoberta de criadores: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 para filtrar aqueles cujo conteúdo corresponde especificamente aos atributos de criadores inseridos.

    É possível recuperar os atributos de público-alvo disponíveis usando AudienceInsightsService.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 (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", 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".

    Observe que, 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 marca do criador:forneça uma marca para pesquisar os principais criadores de conteúdo. A API retorna insights sobre canais correspondentes.

  3. Insights do criador:forneça uma lista de IDs de canais do YouTube. A API retorna insights sobre esses canais específicos.

O método generateCreatorInsights retorna um objeto GenerateCreatorInsightsResponse. Esse objeto contém uma lista de objetos YouTubeCreatorInsights. Cada objeto YouTubeCreatorInsights contém as seguintes informações sobre um criador de conteúdo:

  • Nome do criador de conteúdo
  • Canal do YouTube
  • Métricas totais do criador
  • 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 do 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
  • Na descrição do canal
  • Métricas do canal

  • Atributos do público-alvo do canal (como idade, gênero e interesse do usuário

    detalhamento)

  • 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)

Para gerar insights de tendências, envie uma solicitação ao ContentCreatorInsightsService.GenerateTrendingInsights método. Esse método tem um limite de cinco consultas por segundo (QPS) e aceita 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 AudienceInsightsService.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 (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", 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".

    Observe que, 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. 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.

Anterior
Insights sobre público-alvo