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:extraia 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.
- 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 (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.
- 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
- Oportunidades de parceria (a partir da v23_2)
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 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)
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 (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.
- 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.