AudienceInsightsService permite que os usuários integrem dados de insights sobre público-alvo do Google às ferramentas próprias. Os dados permitem que agências de mídia e planejadores de mídia entendam melhor o público-alvo, incluindo dados demográficos, interesses e comportamento on-line.
Os insights sobre público-alvo permitem que os usuários entendam rapidamente um público-alvo, uma categoria, um tópico ou uma marca, fornecendo uma visão geral de alto nível. Ao analisar os comportamentos dos usuários em temas relacionados, os clientes podem usar esses insights sobre público-alvo para esclarecer as associações e as percepções dos consumidores e chegar a novos insights sobre os públicos-alvo.
A API tem três casos de uso principais:
Refinar e descobrir públicos-alvo:entenda os interesses e comportamentos exclusivos dos consumidores para identificar novos públicos-alvo para a marca, desenvolver personas de público-alvo e refinar as estratégias de segmentação de público-alvo.
Informar o planejamento da campanha:traduza as saídas de dados em públicos-alvo do YouTube para planejar. Permite que os clientes identifiquem o alcance potencial dos públicos-alvo para ajudar a planejar campanhas de mídia. Permite que os clientes meçam a sobreposição entre os segmentos de público-alvo para maximizar o alcance potencial das campanhas.
Desenvolver mensagens criativas:personalize mensagens criativas para seu público-alvo depois de saber o que mais importa para ele.
Requisitos de qualificação
Para se qualificar para AudienceInsightsService, os parceiros precisam atender às
seguintes condições:
- Ter acesso ou qualificação para o Insights Finder.
- Ter uma ferramenta de planejamento ou interface do usuário que integre a API.
- Usar a API para fins de planejamento de mídia ou para outros casos de uso relevantes.
- Concluir uma avaliação de pré-seleçã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 sobre a composição do público-alvo
O método generateAudienceCompositionInsights retorna um
GenerateAudienceCompositionInsightsResponse, que contém uma lista de
atributos que representam o público-alvo de interesse solicitado, com métricas que
comparam a participação de cada atributo no público-alvo com a participação em um público-alvo de referência.
É necessário fornecer um país de destino para o público-alvo. A lista de dimensões compatíveis para recuperar insights de composição é enumerada na descrição do campo dimensions
de GenerateAudienceCompositionInsightsRequest.
Esse método pode ajudar a responder perguntas como "Quais são as principais afinidades do meu público-alvo em comparação com a população geral e qual a probabilidade de interesse nessas afinidades em comparação com a população geral?"
Gerar insights sobre a sobreposição de público-alvo
O método generateAudienceOverlapInsights retorna um
GenerateAudienceOverlapInsightsResponse que contém uma lista de
atributos de público-alvo com estimativas da sobreposição entre o alcance potencial do
YouTube e o de um determinado atributo principal.
É necessário fornecer um país de destino e um atributo principal. Faixa etária, gênero, segmentos de afinidade e segmentos no mercado são aceitos como dimensões de público-alvo.
Esse método pode ajudar a responder perguntas como "Qual é o tamanho do público-alvo incremental quando segmentamos fãs de esportes e amantes de música nos Estados Unidos?"
Gerar definição de público-alvo
O generateAudienceDefinition método retorna sugestões de atributos de público-alvo
com base em uma descrição do público-alvo.
Gerar relatório do Insights Finder
O método generateInsightsFinderReport cria um relatório salvo no
Insights Finder com base nas entradas especificadas no
GenerateInsightsFinderReportRequest e retorna um
GenerateInsightsFinderReportResponse que contém um
link acessível externamente para abrir esse relatório na interface do usuário do Insights Finder.
Gerar insights de segmentação sugeridos
O método generateSuggestedTargetingInsights retorna uma coleção de
insights de segmentação (por exemplo, públicos-alvo segmentáveis) relevantes para o público-alvo solicitado
.
O público-alvo solicitado pode estar no formato estruturado
InsightsAudienceDefinition ou como uma descrição de texto
InsightsAudienceDescription.
O método generateAudienceCompositionInsights retorna insights para
segmentos de atributos individuais relevantes, enquanto o
generateSuggestedTargetingInsights retorna sugestões e insights de
segmentos de público-alvo do Google segmentáveis.
Esse método ajuda a responder perguntas como "Quais são as sugestões de público-alvo segmentáveis para pais na faixa dos 30 anos que gostam de pescar?"
Gerar métricas de sugestão de segmentação
O generateTargetingSuggestionMetrics método retorna um
GenerateTargetingSuggestionMetricsResponse , que contém a
população potencial do YouTube que pode ser alcançada para cada definição de público-alvo
solicitada no GenerateTargetingSuggestionMetricsRequest.
Esse método pode ajudar a responder perguntas como "Quantos homens com mais de 18 anos interessados em acampamento nos Estados Unidos podem ser alcançados no YouTube?"
Listar atributos de insights sobre público-alvo
O listAudienceInsightsAttributes método retorna um
ListAudienceInsightsAttributesResponse que contém a lista de
atributos disponíveis para as dimensões solicitadas.
Por exemplo, se "Afinidade" for selecionada como uma dimensão na solicitação, ela retornará uma lista de públicos-alvo de afinidade compatíveis, como "fãs de esportes" ou "amantes de música". Outras dimensões de interesse do usuário compatíveis incluem "No mercado" e "Evento importante". É possível definir várias dimensões para uma única solicitação. Para uma lista completa de dimensões compatíveis, acesse a documentação de referência.
Ao pesquisar entidades do Mapa de informações (tópicos) usando a
KNOWLEDGE_GRAPH dimensão, é necessário fornecer uma consulta de string no campo
query_text (por exemplo, "football and the World Cup").
Também é possível incluir knowledge_graph_entity_search_options para personalizar a pesquisa de tópicos:
- Filtrar por recursos:use search_filter para restringir as
entidades recuperadas apenas àquelas que oferecem suporte a recursos específicos. Por
exemplo, é possível filtrar tópicos com suporte como atributos de criador de conteúdo fornecendo CREATOR_ATTRIBUTE no campo entity_capability_filters. Vários recursos podem ser fornecidos e são combinados com a lógica
OR. - Recuperar todos os atributos do criador de conteúdo: defina get_all_creator_attributes
como
truepara receber um despejo completo de todas as entidades do Mapa de informações disponíveis marcadas como atributos do criador de conteúdo. Ao usar essa opção, a dimensãoKNOWLEDGE_GRAPHprecisa ser selecionada, a solicitaçãoquery_textprecisa estar vazia e não é possível combinar essa opção com umsearch_filter.
Os atributos retornados por esse recurso de capacidade de descoberta podem ser usados como entradas
para outros AudienceInsightsService recursos.
Cada AudienceInsightsAttributeMetadata
objeto retornado no ListAudienceInsightsAttributesResponse fornece uma
representação estruturada de um atributo de público-alvo, além de propriedades descritivas
e métricas de engajamento. Ele inclui a definição principal do atributo, informações de exibição fáceis de usar, tipo de dimensão e alcance de público-alvo estimado. Para definições mais detalhadas de cada campo disponível, consulte
a AudienceInsightsAttributeMetadata documentação
de referência.
Listar datas qualificadas para insights
O listInsightsEligibleDates método retorna um
ListInsightsEligibleDatesResponse , que contém uma lista de meses no
formato "AAAA-MM", para os quais os dados de insights sobre público-alvo estão disponíveis.
A resposta também contém as datas reais que representam os "últimos 30 dias" que
serão usados para o método generateAudienceCompositionInsights, quando o
date_month não estiver definido na solicitação.