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:
- Facilidade de descoberta de criadores:encontre os principais criadores para um determinado conjunto de temas, informações demográficas, públicos-alvo ou atributos de criadores.
- Insights de marca do criador de conteúdo:extrai insights sobre criadores relacionados a uma marca específica.
- Insights para criadores de conteúdo:receba insights sobre canais específicos do YouTube, como contagem de inscritos e visualizações e dados demográficos do público.
- Insights de tendências:receba 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 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 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 explorar o conteúdo e os criadores do YouTube e encontrar possíveis oportunidades de publicidade.
- Conclua 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 aplique 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
ContentCreatorInsightsService.GenerateCreatorInsights. Esse método tem um limite de cinco consultas por segundo (QPS) e usa três tipos de entrada, dependendo se você quer fazer a descoberta de criadores, insights de marca de criadores ou receber insights de criadores. Você precisa informar os locais dos países de onde quer receber dados.
Facilidade de 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 criadores 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
AudienceInsightsService.ListAudienceInsightsAttributes, fornecendo as dimensões para as quais você quer atributos, comoKNOWLEDGE_GRAPHpara 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 comaudience_attributes.Embora
audience_attributesseja 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_combinationsoferece um controle mais granular. CadaInsightsAudienceAttributeGroupemaudience_combinationscombina 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
InsightsAudienceAttributeGroupemaudience_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/014trlpara 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 Mapa de informações, categorias de produtos e serviços ou interesses do usuário em
audience_attributes, não será possível usaraudience_combinations. Se você usaraudience_combinations, especifique esses atributos emaudience_combinationse não emaudience_attributes. No entanto, ainda é possível usaraudience_attributespara outros tipos de atributos, como dados demográficos, em conjunto comaudience_combinations.Insights da marca do criador de conteúdo:informe uma marca para pesquisar os principais criadores. A API retorna insights sobre canais correspondentes.
Insights para criadores de conteúdo: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
- 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)
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)
Gerar insights de tendências
Para gerar insights de tendências, envie uma solicitação ao método
ContentCreatorInsightsService.GenerateTrendingInsights. Esse método tem um limite de cinco consultas por segundo (QPS) e 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.
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 recuperar os atributos de público-alvo disponíveis usando
AudienceInsightsService.ListAudienceInsightsAttributes, fornecendo as dimensões para as quais você quer atributos, comoKNOWLEDGE_GRAPHpara 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 comaudience_attributes.Embora
audience_attributesseja 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_combinationsoferece um controle mais granular. CadaInsightsAudienceAttributeGroupemaudience_combinationscombina 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
InsightsAudienceAttributeGroupemaudience_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/014trlpara 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 Mapa de informações, categorias de produtos e serviços ou interesses do usuário em
audience_attributes, não será possível usaraudience_combinations. Se você usaraudience_combinations, especifique esses atributos emaudience_combinationse não emaudience_attributes. No entanto, ainda é possível usaraudience_attributespara outros tipos de atributos, como dados demográficos, em conjunto comaudience_combinations.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.