O que é a Data Manager API?
A Data Manager API é uma API unificada criada pelo Google para ajudar anunciantes a conectar e gerenciar dados primários em todos os produtos de publicidade do Google. Com ela, é possível enviar dados para destinos como o Google Ads com uma única chamada de API.
Disponível para todos os usuários desde outubro de 2025, ela representa um avanço significativo para quem deseja centralizar o rastreamento de conversões e audiências.
Casos de uso
- Combinar conversões offline (loja física, telefone) com interações de anúncios online
- Criar e atualizar automaticamente listas de audiência Customer Match
- Implementar rastreamento de conversões server-side com maior controle de dados
- Enriquecer dados de campanha usando informações do CRM ou banco de dados
Vantagens da Data Manager API
- Segmentação de audiência aprimorada com análise de dados primários
- Visibilidade completa da performance dos anúncios via dados de conversão offline
- Criação de segmentos detalhados de audiência para inclusão/exclusão em campanhas
- Transferência segura de dados com hash de informações de identificação pessoal
Pré-requisitos
- Container sGTM configurado e em execução
- Transferência de dados configurada do container web para o servidor
- Método de autenticação selecionado: conexão Stape ou credenciais Google próprias
Usuários da UE devem revisar o DPA (Data Processing Agreement) da Stape antes de configurar a conexão.
Como configurar a Data Manager API
Usando a conexão Stape
- Faça login na conta Stape e acesse a aba Connections
- Clique em 'Sign in' ao lado de Data Manager API
- Autentique com a conta Google que possui acesso ao Google Ads
Usando credenciais Google próprias (Service Account)
- Habilite a Data Manager API na biblioteca do Google Cloud Platform
- Crie uma Service Account no projeto GCP
- Adicione a role 'Service Account Token Creator' nas permissões IAM
- Gere e baixe o arquivo JSON da chave
- Conecte a Service Account ao container usando o JSON
- Conceda acesso ao Google Ads ou DV360
Configurando a tag Google Conversion Events
- Adicione o template 'Google Conversion Events by Stape' ao workspace do sGTM
- Crie uma nova tag e selecione o tipo de template
- Configure: Product, Operating Customer ID, Customer ID, Conversion Event ID
- Defina o formato de codificação de dados de usuário (HEX ou BASE64)
- Adicione pelo menos um identificador de usuário (email, telefone, etc.)
- Configure o trigger e teste no modo Preview do GTM
Erros comuns e como resolvê-los
- Termos não aceitos: Aceite os Termos de Serviço do Google para Enhanced Conversions
- Enhanced conversions para leads não ativadas: Ative em Goals > Settings > Customer goals
- Nível de acesso inadequado: A conta precisa de acesso Standard ou Admin
- transaction_id ausente: Inclua o transaction_id em todos os eventos de compra
- Formato de consentimento incorreto: Use CONSENT_GRANTED, CONSENT_DENIED ou CONSENT_STATUS_UNSPECIFIED
Perguntas frequentes
A Data Manager API substitui o rastreamento de conversões padrão?
Não substitui, mas complementa. Ela adiciona uma camada server-side que melhora a precisão, especialmente onde bloqueadores e restrições de cookies afetam o rastreamento convencional.
Qual é a diferença entre Data Manager API e Conversions API?
A Data Manager API é uma interface unificada que pode alimentar múltiplos produtos Google (Ads, DV360), enquanto a Conversions API é específica para o Google Ads. A Data Manager simplifica a gestão ao centralizar tudo em um ponto.
Preciso de conta Stape para usar a Data Manager API?
Não é obrigatório. Você pode usar suas próprias credenciais Google (Service Account). A Stape oferece uma conexão simplificada, mas ambas as opções funcionam.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
