Acompanhar a posição e a performance dos anúncios

A API Google Ads oferece várias visualizações para analisar onde seus anúncios apareceram e como estão se saindo: managed_placement_view, group_placement_view, detail_placement_view e performance_max_placement_view. Cada visualização oferece uma perspectiva diferente dos dados de posicionamento.

Visualização da seleção manual de canais

• O que ele mostra: o recurso managed_placement_view fornece dados de performance agregados pelos canais que você está segmentando explicitamente (seleção manual de canais). Ela reflete a performance dos seus critérios de Placement.
• Equivalente na interface: Conteúdo > Canais
• Criador de consultas: Analisar no Criador de consultas

Exemplo de consulta

Para buscar métricas de performance de seleções manuais de canais nos últimos 30 dias:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.placement.url,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Visualização de posição do grupo

• O que ele mostra: o recurso group_placement_view mostra onde seus anúncios foram veiculados na Rede de Display e no YouTube, independentemente de os canais terem sido segmentados explicitamente ou descobertos automaticamente pelo sistema do Google. Isso inclui sites, canais ou vídeos do YouTube e apps.
• Equivalente na interface: Conteúdo > Onde os anúncios foram exibidos
• Criador de consultas: Analisar no Criador de consultas

Linha "Total: Outros"

Para acelerar a geração de relatórios, os recursos group_placement_view e detail_placement_view excluem posições individuais que não atendem a um limite mínimo de atividade de impressões ou interações.

• Na interface do Google Ads: a interface agrega canais que não atendem a esse limite de atividade em uma linha de resumo chamada Total: outros.
• Na API Google Ads: a API omite as posições que não atendem ao limite de atividade dos resultados do relatório e não retorna uma linha de resumo em que o campo group_placement_view.placement ou detail_placement_view.placement tem o valor "Other".

Como resultado, a soma das linhas de canais individuais nos recursos group_placement_view e detail_placement_view pode ser menor do que as métricas totais do grupo de anúncios ou da campanha. Para mais informações, consulte Sobre o relatório "Onde os anúncios foram exibidos". Para saber como os limites e os metadados ausentes afetam as comparações entre visualizações, consulte Diferenças de métricas entre as visualizações de canais e Linhas com detalhes de canais indisponíveis.

Opções de TargetingSetting

O comportamento e a utilidade do group_placement_view são influenciados pelo TargetingSetting da dimensão PLACEMENT no nível do grupo de anúncios. Essa configuração contém uma lista de target_restrictions, cada um com um campo booleano bid_only que determina se os anúncios serão veiculados apenas em canais segmentados ou também em outros canais. Consulte Sobre as configurações de "Segmentação" e "Observação".

• bid_only = false: esse valor corresponde a Segmentação na interface do Google Ads para canais. Se o grupo de anúncios estiver definido como "Segmentação", os anúncios serão exibidos apenas nos canais que você adicionou explicitamente como critérios. Você pode aplicar ajustes de lance a essas posições. Nesse cenário, group_placement_view reflete em grande parte managed_placement_view, mas ainda está sujeito a limites mínimos de atividade.
• bid_only = true: esse valor corresponde a Observação na interface do Google Ads para canais. Se o grupo de anúncios estiver definido como "Observação", seus anúncios poderão ser veiculados em qualquer canal qualificado na Rede de Display e no YouTube. Também é possível aplicar ajustes de lance a qualquer canal segmentado. Nesse caso, o group_placement_view é crucial para descobrir novos canais em que seus anúncios estão sendo veiculados, que você pode adicionar como seleção manual de canais ou exclusões.

Visualização detalhada de canais

• O que ele mostra: o recurso detail_placement_view oferece um detalhamento mais granular das posições, com detalhes além do nível do domínio ou do canal. Por exemplo, ele pode mostrar URLs específicos ou IDs de vídeos do YouTube em que seus anúncios apareceram.
• Equivalente na interface: equivale a selecionar linhas em Conteúdo > Onde os anúncios foram mostrados e clicar em Ver detalhes.
• Criador de consultas: Analisar no Criador de consultas
• Considerações importantes: assim como o recurso group_placement_view, essa visualização omite canais de baixa atividade que não atendem aos limites mínimos de atividade (consulte a seção Linha "Total: outros").

Observação: o recurso detail_placement_view gera relatórios em um nível granular (URLs e IDs de vídeo individuais) e pode retornar dados de alta cardinalidade. Sempre filtre as consultas por períodos ou campanhas e grupos de anúncios específicos para evitar payloads grandes e tempos limite de consulta.

Diferenças de métricas entre as visualizações de canais

O limite mínimo de atividade é avaliado de forma independente em cada nível de granularidade:

• O recurso group_placement_view avalia o limite no domínio agregado, no app para dispositivos móveis ou no canal do YouTube.
• O recurso detail_placement_view avalia o limite separadamente para cada URL de página ou vídeo do YouTube.

O recurso detail_placement_view omite URLs de páginas individuais ou vídeos do YouTube que não atendem ao limite. Como resultado, somar as linhas de detail_placement_view para um domínio ou canal do YouTube (filtrado pelo campo detail_placement_view.group_placement_target_url) pode retornar menos impressões do que a linha de group_placement_view correspondente.

Linhas com Place Details indisponíveis

Uma consulta no recurso group_placement_view ou detail_placement_view pode retornar várias linhas no mesmo grupo de anúncios com campos placement, display_name e target_url não definidos e um valor resource_name idêntico (por exemplo, terminando em ~MTRf).

Esse comportamento ocorre pelos seguintes motivos:

• Agrupamento de posições internas: as duas visualizações agrupam as métricas de performance por um identificador de posição interna exclusivo, em vez de usar os campos de string resource_name ou placement.
• Metadados de canais indisponíveis: na interface do Google Ads, os canais sem metadados nas tabelas de consulta de back-end aparecem como Desconhecido, Canal não está mais disponível ou Vídeo não está mais disponível. Na API, cada identificador de posição distinto ainda retorna uma linha de métricas, com os campos placement, display_name e target_url não definidos.
• Nomes de recursos sintetizados: o sufixo {base64_placement} no campo resource_name é codificado em Base64 de {type_id}_{placement}, em que {type_id} é um identificador de tipo de posicionamento interno, em vez do número do tipo enumerado PlacementType. Quando o campo placement_type é WEBSITE (ID interno 14) e o campo placement não está definido, a string "14_" é codificada como MTRf (da mesma forma, MOBILE_APPLICATION codifica "55_" como NTVf, YOUTUBE_VIDEO codifica "89_" como ODlf e YOUTUBE_CHANNEL codifica "90_" como OTBf). Várias posições do mesmo tipo com metadados indisponíveis no mesmo grupo de anúncios compartilham o mesmo valor de resource_name ao informar linhas de métricas separadas.

Ao processar resultados de group_placement_view ou detail_placement_view no código do cliente, não elimine a duplicação de linhas apenas pelo campo resource_name, porque isso pode substituir métricas em diferentes canais com metadados indisponíveis. Para excluir linhas com metadados indisponíveis na Linguagem de Consulta do Google Ads, filtre o campo target_url ou display_name (por exemplo, WHERE detail_placement_view.target_url IS NOT NULL), porque os campos placement e resource_name não são filtráveis.

Visualização de canais de campanhas Performance Max

• O que ele mostra: o recurso performance_max_placement_view fornece dados de impressão (metrics.impressions) para canais em que os anúncios Performance Max foram veiculados. Na v24 e em versões mais recentes, é possível segmentar performance_max_placement_view por segments.ad_network_type (não compatível com a v23).
• Criador de consultas: Analisar no Criador de consultas

Qual visualização usar?

• Use o managed_placement_view para avaliar a performance das posições que você está segmentando e em que está lances.
• Use group_placement_view para entender o escopo completo de onde seus anúncios estão aparecendo, especialmente ao usar a configuração "Observação", para descobrir novas oportunidades de segmentação ou exclusões.
• Use detail_placement_view para ver os detalhes mais granulares sobre URLs ou vídeos específicos em que seus anúncios foram veiculados, geralmente usados depois de identificar um domínio ou canal de interesse no group_placement_view.
• Use performance_max_placement_view para inspecionar as impressões de canais em campanhas Performance Max.