Status: disponível com implantação assistida.
A integração usa uma identidade autorizada pela Audt para consultar os ativos de mídia aprovados. O cliente não precisa criar nem compartilhar um token de desenvolvedor, um projeto Google Cloud ou credenciais pessoais.
Separe:
- IDs das contas anunciantes;
- conta administradora, quando a concessão ocorrer por MCC;
- moedas e fusos de cada conta;
- campanhas e período histórico em escopo;
- ações de conversão que devem ser preservadas;
- responsável com permissão para conceder e revogar acesso.
Conceda à identidade informada pela Audt acesso de leitura diretamente na conta anunciante ou por uma conta administradora vinculada. O nível exato é confirmado no onboarding e não deve permitir criação ou alteração de campanhas.
O contrato mínimo atual opera em nível diário de campanha.
| Conceito lógico | Obrigatório | Observação |
|---|---|---|
date |
Sim | Data na convenção da conta, com fuso documentado |
account_id |
Sim | ID da conta anunciante |
campaign_id e campaign_name |
Sim | Preserve o ID da plataforma mesmo quando o nome mudar |
currency |
Sim no contrato | Deve ser confirmada; não converta sem taxa e regra aprovadas |
spend |
Sim | Custo no nível e moeda informados |
impressions e clicks |
Sim | Métricas de entrega |
campaign_status |
Recomendado | Estado da campanha no período |
device |
Recomendado | Disponível quando o relatório adotado permite |
| conversão, valor e tipo | Condicional | Dependem das ações e da janela escolhidas |
extracted_at |
Sim no produto publicado | Momento da coleta para rastreabilidade |
Ad group, anúncio, criativo, placement, produto promovido e URL de destino são extensões de escopo. Não os trate como disponíveis até que a granularidade, o histórico e o volume tenham sido aprovados.
Preserve, para cada métrica de conversão:
- ação de conversão;
- janela aplicável;
- regra e data de competência;
- valor e moeda;
- origem nativa do número.
Conversões fracionárias podem ocorrer em modelos de atribuição. Não arredonde antes da camada de apresentação.
- Envie os IDs e a hierarquia de contas.
- A Audt fornece a identidade que receberá acesso.
- O administrador concede leitura nos ativos acordados.
- A Audt executa uma coleta controlada do período de amostra.
- As partes validam gasto, impressões e cliques contra a interface do provedor.
- Conversões e valores são aceitos separadamente, com a janela registrada.
- A frequência recorrente é habilitada conforme o acordo do projeto.
- soma de gasto por dia e conta;
- cobertura de campanhas ativas e pausadas;
- moeda e fuso corretos;
- IDs estáveis mesmo após renomeação;
- ausência de duplicidade no grão publicado;
- tratamento de dados atrasados e reprocessamento;
- diferenças de conversão explicadas pela janela ou ação selecionada.
Revogue o acesso na conta ou no MCC quando a integração terminar. Avise a Audt ao alterar hierarquia, moeda, fuso, ações de conversão ou conta administradora.
Consulte as referências oficiais sobre modelos de acesso ↗ e vinculação de conta administradora ↗.