Ativação No Google Ads¶
A Orbital Audience pode enviar parâmetros de audiência para uma tag do Google Ads quando o anunciante habilita Google Ads explicitamente no cadastro do site.
Essa integração é opcional. Se Google Ads estiver desabilitado, a tag da DMP mantém o fluxo normal de coleta e não carrega recursos do Google Ads.
O Que A Integração Envia¶
Quando habilitada, a Orbital Audience envia um evento do Google Ads chamado:
orbital_dmp_profile
O evento pode incluir parâmetros customizados orb_* que não estejam vazios, como:
| Parâmetro | Significado |
|---|---|
orb_profile |
Perfil principal de audiência disponível. |
orb_gender |
Sinal de gênero quando disponível. |
orb_age_range |
Faixa etária quando disponível. |
orb_income_segment |
Segmento de renda quando disponível. |
orb_education_level |
Escolaridade quando disponível. |
orb_buyer_profile |
Perfil de comprador. |
orb_general_profile |
Perfil geral. |
orb_primary_site_profile |
Perfil comportamental ou de site principal. |
orb_interest |
Interesses, unidos quando há múltiplos valores. |
orb_product |
Produtos quando disponíveis. |
orb_site_profiles |
Perfis de site. |
orb_subjects |
Assuntos de conteúdo. |
orb_source |
Fontes do sinal, como Navegg, Tail, UTM ou DMP. |
orb_topic |
Tópico atual ou inferido da página. |
orb_site_key |
Chave do site na Orbital. |
orb_utm_source |
Origem da campanha quando há criativo ou UTM. |
orb_utm_medium |
Mídia da campanha quando disponível. |
orb_utm_campaign |
Nome da campanha quando disponível. |
orb_utm_content |
Conteúdo da campanha quando disponível. |
orb_utm_term |
Termo da campanha quando disponível. |
Valores vazios não são enviados.
Encontrar O ID Do Google Ads¶
No Google Ads, o ID normalmente tem este formato:
AW-123456789
Onde encontrar:
- Abra o Google Ads.
- Vá em Tools.
- Abra Data Manager ou Audience Manager > Your data sources.
- Abra Google tag.
- Copie o Tag ID que começa com
AW-.
Não cole o snippet completo do Google tag na Orbital Audience. A DMP precisa apenas do ID AW-.
Habilitar Google Ads Na Orbital Audience¶
- Abra Sites.
- Selecione o site do anunciante.
- Clique em Edit.
- Encontre Google Ads.
- Habilite a integração.
- Cole o ID
AW-. - Salve o site.
Não é necessário trocar tags já instaladas. A tag Orbital instalada lê a configuração do site dinamicamente.
Validar A Tag¶
Use o Google Tag Assistant:
- Abra tagassistant.google.com.
- Conecte o site do anunciante.
- Navegue por páginas onde a tag da DMP roda.
- Confirme que o ID
AW-aparece. - Procure o evento
orbital_dmp_profile. - Inspecione os parâmetros do evento e confirme que existem valores
orb_*.
Também é possível validar pelo console do navegador:
window.OrbitalGoogleAdsAdapter
Isso deve retornar um objeto quando Google Ads estiver habilitado para o site.
Para inspecionar a fila de eventos:
window.dataLayer?.filter(item => JSON.stringify(item).includes('orbital_dmp_profile'))
Para confirmar o ID configurado:
window.dataLayer?.filter(item => JSON.stringify(item).includes('AW-123456789'))
Troque AW-123456789 pelo ID real do anunciante.
Criar Audiências No Google Ads¶
Depois que o Google Ads receber os parâmetros customizados, crie um segmento de visitantes do site:
- Abra o Google Ads.
- Vá em Tools.
- Abra Shared library > Audience manager.
- Clique em +.
- Escolha Website visitors.
- Escolha uma regra de visitantes do site.
- Clique em Refine action.
- Selecione um dos parâmetros customizados
orb_*. - Defina a condição e salve o segmento.
Exemplos de regras:
orb_interest contains Tecnologia
orb_general_profile equals Decision Makers
orb_utm_campaign contains black_friday
orb_source contains navegg
O Google Ads pode levar algumas horas para exibir novos parâmetros customizados no criador de audiências. Os segmentos também precisam ter volume mínimo de usuários ativos antes de ficarem elegíveis para uso em campanhas.
Solução De Problemas¶
| Sintoma | O que verificar |
|---|---|
ID AW- não aparece no Tag Assistant |
Confirme se Google Ads está habilitado no site e se o ID começa com AW-. |
window.OrbitalGoogleAdsAdapter está indefinido |
Confirme se o site foi salvo com Google Ads habilitado e se a versão da tag DMP foi atualizada. |
orbital_dmp_profile não aparece |
Navegue por algumas páginas e confirme se o endpoint de perfil da DMP retorna sinais de audiência. |
Campos orb_* ainda não aparecem no Google Ads |
Aguarde o processamento do Google Ads e confirme o evento no Tag Assistant. |
| Request de coleta da DMP falha | Verifique /api/collect/event na aba Network do navegador e revise o log do servidor da DMP. |
Notas De Privacidade¶
Não use dados pessoais crus em sinais da DMP ou parâmetros customizados do Google Ads. Mantenha os valores em rótulos de audiência, metadados de campanha, categorias comportamentais e outros atributos de segmentação não sensíveis aprovados pelo anunciante.