Insights para criadores de conteúdo do YouTube

Descubra e acesse 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 relevantes para um determinado conjunto de temas, dados demográficos, públicos-alvo ou atributos de criadores.
  2. Insights de temas para 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:receba insights sobre canais específicos do YouTube, como contagem de inscritos, contagem de visualizações e dados demográficos 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 estão em um determinado país ou postam de lá e são assistidos nesse país) é compatível ao usar a descoberta de criadores de conteúdo com base em temas ou insights em alta solicitando dados complementares.

Requisitos de qualificação

O GenerateCreatorInsights é um componente particular da API Google Ads oferecido com uma licença de dados não exclusiva e livre de 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 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.
  • Use a API para conhecer o conteúdo e os criadores 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 capacidade de descoberta de criadores de conteúdo, pesquisar criadores relevantes por temas ou receber insights sobre eles. 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 de 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 Mapa de informações (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 grupo 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ê usar 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 para criadores de conteúdo: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 recuperar recursos de entidade compatíveis.

    Observação: a opção search_brand foi descontinuada a partir da v24.2 e será removida completamente na versão v25. Os usuários precisam começar a usar search_topics.

  3. Insights para criadores de conteúdo:forneça uma lista de IDs de canais do YouTube 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 buscando criadores usando search_topics e o assunto for uma entidade do Mapa de informações marcada com a capability CREATOR_TOPIC_INSIGHTS, a API vai preencher o campo local_creator_insights na resposta com criadores 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 criadores de conteúdo que estão no país selecionado ou postam de lá 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 é definido na solicitação.
  • Recursos:é possível recuperar a lista de entidades do Mapa de informações compatíveis e os recursos 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. 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, verifique 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 temas)

Para gerar insights de tendências, envie uma solicitação ao método GenerateTrendingInsights. 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 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 em alta 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.

    Os atributos KNOWLEDGE_GRAPH terão uma ou mais tags InsightsKnowledgeGraphEntityCapabilities. Os atributos compatíveis com os insights em alta terão 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 público-alvo:você pode fornecer uma lista de atributos de público-alvo, como idade, sexo e interesses do usuário (incluindo públicos-alvo de afinidade, no mercado e de eventos importantes). A API retorna uma lista de insights em alta 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 extrair os atributos de público-alvo disponíveis usando o método 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) 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 Mapa de informações (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 grupo 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ê usar 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.

  3. Tendências de temas:forneça uma lista de temas de conteúdo. A API retorna uma lista de insights em alta sobre 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 para criadores de conteúdo, é possível solicitar recursos opcionais nos insights em alta definindo o campo repetido supplemental_data como LOCAL_CREATOR_DATA.

Se a solicitação de tendências usar search_topics, o campo related_local_creators será preenchido 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).

Anterior
Insights sobre público-alvo