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:
- Descoberta de criadores de conteúdo:encontre os principais criadores de conteúdo para um determinado conjunto de temas, dados demográficos, 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 sem royalties. Os parceiros assinados podem usar as bibliotecas de cliente do Google Ads padrão para conhecer 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.
- Use a API para explorar conteúdo e criadores do YouTube em busca de possíveis oportunidades de publicidade.
- Faça uma avaliação prévia 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 do criador 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.
- Descoberta de criadores de conteúdo:você pode fornecer uma lista de atributos do público-alvo, como idade, gênero e interesses. 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 inseridos.
- Insights da marca do criador de conteúdo:forneça 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
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 do canal (como idade, gênero e detalhamento dos interesses do usuário)
- Vídeos mais acessados
- Tipo de canal
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, gênero e interesses. A API retorna uma lista de insights de tendências para esses públicos-alvo.
- Tendências de temas:forneça uma lista de temas de conteúdo. A API retorna uma lista de insights em alta para esses tópicos.