Insights sobre público-alvo

Todas as solicitações para AudienceInsightsService têm limitação de taxa. Menos solicitações são permitidas por dia para generateAudienceCompositionInsights e generateSuggestedTargetingInsights do que para outros métodos de insights sobre público-alvo. Consulte as cotas da API para mais detalhes.

Com o AudienceInsightsService, é possível integrar os dados de insights sobre público-alvo do Google às suas ferramentas de planejamento. Os dados ajudam as agências de mídia e os planejadores de mídia a entender melhor o público-alvo, incluindo informações demográficas, interesses e comportamento on-line.

Os insights sobre público-alvo ajudam você a entender um público-alvo, uma categoria, um tópico ou uma marca com uma visão geral de alto nível. Ao analisar os comportamentos dos usuários em temas relacionados, você pode usar esses insights sobre público-alvo para descobrir as associações e as percepções dos consumidores e identificar novos segmentos de público-alvo.

A API é compatível com três casos de uso principais:

  • Refinar e descobrir públicos-alvo: entenda os interesses e comportamentos únicos dos consumidores para identificar novos públicos-alvo para uma marca, desenvolver perfis de público-alvo e refinar estratégias de segmentação de público-alvo.
  • Informar o planejamento da campanha: transforme os dados em públicos-alvo do YouTube para planejar, estimar o alcance potencial dos públicos-alvo segmentados e medir a sobreposição entre os segmentos de público-alvo para maximizar o alcance da campanha.
  • Desenvolva mensagens do anúncio: adapte as mensagens do anúncio ao seu público-alvo com base nos temas e afinidades com que ele mais interage.

Requisitos de qualificação

Para se qualificar para o AudienceInsightsService, os parceiros precisam atender às seguintes condições:

  • Ter acesso ou qualificação para acessar o Insights Finder.
  • Ter uma ferramenta de planejamento ou interface do usuário que integre a API.
  • Use a API para planejamento de mídia ou outros casos de uso relevantes.
  • Conclua uma avaliação de triagem.
  • Seguir os requisitos de uso de dados e passar por auditorias periódicas de dados.
  • Aceite os Termos de Serviço da API Google Ads e a política de uso de dados associada.

Entre em contato com o representante do Google para mais informações.

Listar datas qualificadas para insights

Um fluxo de trabalho típico começa com a verificação de quais meses do calendário e períodos estão disponíveis para análise. O método listInsightsEligibleDates retorna um ListInsightsEligibleDatesResponse, cujo campo data_months lista os meses (no formato YYYY-MM) em que os dados de insights sobre público-alvo estão disponíveis.

O campo last_thirty_days da resposta contém o período exato que o generateAudienceCompositionInsights usa quando data_month não está definido na solicitação.

Listar atributos de insights sobre público-alvo

Antes de consultar as métricas de composição ou sobreposição de público-alvo, descubra os IDs de atributo válidos usando listAudienceInsightsAttributes. Esse método retorna um ListAudienceInsightsAttributesResponse que contém os atributos disponíveis para as dimensões solicitadas.

Por exemplo, se AFFINITY_USER_INTEREST for selecionado como uma dimensão na solicitação, o método vai retornar 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 IN_MARKET_USER_INTEREST e LIFE_EVENT_USER_INTEREST. É possível definir várias dimensões em uma única solicitação. Para uma lista completa de dimensões compatíveis, consulte a referência de campo dimensions.

Ao pesquisar entidades do Mapa de informações (tópicos) usando a dimensão KNOWLEDGE_GRAPH, é necessário fornecer uma consulta de string no campo query_text (por exemplo, "football and the World Cup").

Se quiser, inclua knowledge_graph_entity_search_options para personalizar sua 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 os temas aceitos como atributos do 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: defina get_all_creator_attributes como true para recuperar todas as entidades do Mapa de Informações disponíveis marcadas como atributos do criador. Ao usar essa opção, a dimensão KNOWLEDGE_GRAPH precisa ser selecionada, query_text precisa estar vazio e não é possível combinar essa opção com um search_filter.

Os atributos retornados por esse método de detecção do dispositivo podem ser usados como entradas para outros métodos AudienceInsightsService.

Cada objeto AudienceInsightsAttributeMetadata em ListAudienceInsightsAttributesResponse fornece uma representação estruturada de um atributo de público-alvo com propriedades descritivas e métricas de engajamento. Ele inclui a definição principal do atributo, o nome de exibição, o tipo de dimensão e o alcance estimado de público-alvo. Consulte a referência de AudienceInsightsAttributeMetadata para ver as definições de campo.

Gerar definição do público-alvo

O método generateAudienceDefinition traduz uma descrição de texto livre de um público-alvo em sugestões estruturadas de atributos de público-alvo que podem ser transmitidas para métodos de insight downstream.

Gerar insights de segmentação sugerida

O método generateSuggestedTargetingInsights retorna uma coleção de insights de segmentação (como segmentos de público-alvo segmentáveis) que são relevantes para o público-alvo solicitado.

É possível especificar o público-alvo solicitado como um InsightsAudienceDefinition estruturado ou como uma descrição de texto em InsightsAudienceDescription.

Enquanto generateAudienceCompositionInsights retorna insights para segmentos de atributos individuais, generateSuggestedTargetingInsights retorna sugestões agrupadas de segmentos de público-alvo do Google Ads que podem ser segmentados. Esse método ajuda a responder a perguntas como "Dê sugestões de público-alvo segmentável para pais na faixa dos 30 anos que gostam de pescar".

Gerar métricas de sugestão de segmentação

O método generateTargetingSuggestionMetrics 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 em GenerateTargetingSuggestionMetricsRequest.

Esse método ajuda a responder a perguntas como "Quantos homens com mais de 18 anos interessados em acampar nos Estados Unidos podem ser alcançados no YouTube?"

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, além de métricas de índice e parcela que comparam a parcela de cada atributo do público-alvo com uma população de referência.

É necessário informar um país de destino para o público-alvo. A lista de dimensões compatíveis para recuperar insights de composição está documentada no campo dimensions de GenerateAudienceCompositionInsightsRequest.

Esse método ajuda a responder perguntas como "Quais são as principais afinidades em que meu público-alvo está interessado em comparação com a população geral e qual é a probabilidade de ele se envolver com essas afinidades?"

Gerar insights de 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 no YouTube e o de um atributo principal.

Você precisa 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 ajuda a responder a perguntas como "Qual é o tamanho do público incremental quando segmentamos fãs de esportes e amantes de música nos Estados Unidos?"

Gerar relatório do Insights Finder

O método generateInsightsFinderReport cria um relatório salvo no Insights Finder com base nas entradas especificadas em GenerateInsightsFinderReportRequest e retorna um GenerateInsightsFinderReportResponse que contém um link acessível externamente para abrir esse relatório na interface do Insights Finder.

Issue Tracker do Google

Use o Issue Tracker do Google para fazer perguntas de suporte, informar bugs ou enviar solicitações de recursos. O Google rastreia, prioriza e publica atualizações sobre suas solicitações diretamente no Issue Tracker. Para mais informações, consulte Criar um problema no Issue Tracker do Google.

Crie um problema usando um dos seguintes modelos do Issue Tracker:

Preencha todos os campos do modelo com informações detalhadas para que o Google possa reproduzir e priorizar sua solicitação. O Google pode encerrar relatórios incompletos e pedir que você envie um novo problema com os detalhes que faltam.