Ctrlk
Site SprintHub
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

Parâmetros da API de Conversões do Google (Google Ads Conversion API)

Introdução

A API de Conversões do Google, também conhecida como Google Ads Conversion API, é uma forma mais segura e confiável de enviar eventos de conversão diretamente do servidor para o Google Ads. Diferente do acompanhamento tradicional via pixel (tag), essa integração reduz perdas de dados causadas por bloqueadores de anúncios, restrições de cookies e políticas de privacidade dos navegadores.

Com a API, as conversões são enviadas de forma server-side, garantindo maior precisão na mensuração e melhor otimização das campanhas.

Para que serve a API de Conversões do Google?

A API de Conversões permite:

  • 📊 Medir conversões com maior precisão

  • 🔒 Reduzir impactos de bloqueadores de anúncios e cookies

  • 🚀 Melhorar a otimização e o aprendizado das campanhas

  • 🔁 Enviar eventos online e offline (ex: vendas, leads, pagamentos)

  • 📈 Aumentar a confiabilidade dos dados de atribuição

Diferença entre Tag do Google e API de Conversões

Tag do Google (Client-side)
API de Conversões (Server-side)

Executada no navegador

Executada no servidor

Pode ser bloqueada

Não sofre bloqueios do browser

Depende de cookies

Menor dependência de cookies

Pode perder eventos

Maior taxa de entrega

💡 O uso combinado da Tag + API de Conversões é a melhor prática recomendada pelo Google.

Principais eventos enviados

Os eventos mais comuns enviados via API incluem:

  • Lead (cadastro / formulário enviado)

  • Purchase (compra finalizada)

  • AddToCart (adicionar ao carrinho)

  • BeginCheckout (início de checkout)

  • Conversões offline

Cada evento pode conter parâmetros como:

  • Valor da conversão

  • Moeda

  • ID do evento

  • Dados de atribuição

Como funciona a integração (visão geral)

  1. O usuário realiza uma ação (ex: envio de formulário)

  2. O sistema registra o evento

  3. O evento é enviado do servidor para a API do Google Ads

  4. O Google processa e atribui a conversão à campanha

Requisitos para usar a API de Conversões do Google

Para utilizar a API, é necessário:

  • Conta ativa no Google Ads

  • Conversões configuradas no Google Ads

  • Acesso administrativo à conta

  • Geração de credenciais (token/chave de API)

  • Consentimento adequado do usuário, conforme LGPD

Boas práticas recomendadas

  • ✅ Utilizar deduplicação de eventos (ID do evento)

  • ✅ Enviar o máximo de parâmetros possíveis

  • ✅ Combinar Tag do Google + API

  • ✅ Garantir conformidade com LGPD e políticas do Google

  • ✅ Monitorar status das conversões no Google Ads

Erros comuns e cuidados

  • ❌ Conversões duplicadas por falta de deduplicação

  • ❌ Token inválido ou sem permissão

  • ❌ Evento não configurado no Google Ads

  • ❌ Envio de dados fora do padrão exigido

Benefícios para sua operação

Ao utilizar a API de Conversões do Google, sua empresa ganha:

  • Dados mais confiáveis

  • Melhor performance das campanhas

  • Menos dependência de cookies

  • Maior controle sobre eventos e atribuição

Categorias de ações de conversão na API do Google Ads

Ao configurar a API de Conversões do Google, é fundamental escolher corretamente a categoria da ação de conversão (ConversionActionType). Essas categorias determinam como o Google Ads interpreta, atribui e otimiza cada evento.

Abaixo estão as principais categorias suportadas pela API, conforme a documentação oficial do Google.

Conversões off-line

Utilizadas para acompanhar conversões que acontecem fora do ambiente digital, como vendas presenciais ou contatos por telefone.

Tipo (API)
Origem no Google Ads
Descrição

UPLOAD_CLICKS

Conversões de cliques / Leads

Importação de conversões off-line baseadas em cliques

UPLOAD_CALLS

Conversões de chamadas

Importação de conversões de chamadas telefônicas

STORE_SALES

Vendas na loja

Importação de vendas físicas

Conversões on-line (Site)

Permitem rastrear ações realizadas diretamente no site, como compras, formulários e cliques.

Tipo (API)
Origem no Google Ads
Descrição

WEBPAGE

Site / GA4

Conversões por carregamento de página

WEBPAGE_ONCLICK

Site / GA4

Conversões por clique em elementos

CLICK_TO_CALL

Cliques no telefone

Cliques em número de telefone em dispositivos móveis

⚠️ As conversões de site exigem a global_site_tag e o event_snippet, além do correto mapeamento do evento.

Conversões de aplicativos

Usadas para mensurar instalações e ações dentro de aplicativos móveis.

Tipo (API)
Origem no Google Ads

GOOGLE_PLAY_DOWNLOAD

Instalações via Google Play

GOOGLE_PLAY_IN_APP_PURCHASE

Compras dentro do app

💡 Para conversões de instalação, a categoria deve ser definida como DOWNLOAD.

Conversões de ligações telefônicas

Indicadas para empresas que recebem leads ou vendas por telefone.

Tipo (API)
Origem no Google Ads
Descrição

AD_CALL

Chamadas de anúncios

Chamadas geradas diretamente dos anúncios

WEBSITE_CALL

Chamadas do site

Chamadas originadas de números exibidos no site

CLICK_TO_CALL

Clique para ligar

Apenas o clique no número (sem rastrear a chamada)

Conversões otimizadas

As conversões otimizadas complementam os dados enviados, utilizando informações próprias do negócio (como e-mail ou telefone) de forma segura e criptografada.

Tipo (API)
Uso

UPLOAD_CLICKS

Conversões otimizadas para leads

WEBPAGE

Conversões otimizadas para web

Essas conversões ajudam o Google a melhorar a atribuição e o desempenho das campanhas.

Integrações com Google Analytics (GA4)

Conversões importadas do GA4 utilizam tipos específicos:

  • GOOGLE_ANALYTICS_4_CUSTOM

  • GOOGLE_ANALYTICS_4_PURCHASE

Essas conversões podem ser habilitadas, categorizadas e usadas para lances diretamente no Google Ads, respeitando as limitações da API.

Boas práticas na escolha da categoria

  • ✅ Escolha a categoria correta conforme a origem da conversão

  • ✅ Evite misturar conversões on-line e off-line

  • ✅ Utilize conversões otimizadas sempre que possível

  • ✅ Garanta deduplicação entre Tag e API

  • ✅ Respeite as diretrizes de privacidade (LGPD)

Variáveis de conversão personalizadas

As variáveis de conversão personalizadas permitem associar informações adicionais às conversões importadas via API do Google Ads, funcionando como tags que enriquecem os dados enviados. Com elas, é possível criar relatórios mais detalhados e segmentados no Google Ads.

Para que servem?

Elas são usadas para adicionar atributos extras a uma conversão, como status, categoria, origem ou qualquer informação relevante para o negócio.

Exemplo prático: Ao importar uma conversão de compra de um produto, como um chapéu azul novo, é possível associar tags como:

  • color: blue

  • status: new

Como funcionam as variáveis personalizadas

  1. Cada variável personalizada corresponde a uma tag

  2. É possível criar quantas variáveis forem necessárias

  3. Essas variáveis são vinculadas às conversões no momento da importação

Os campos obrigatórios de uma variável personalizada (ConversionCustomVariable) são:

  • name: identifica a variável (deve ser único)

  • tag: nome da tag que será usada na conversão (ex: color, status)

⚠️ Consulte as limitações dos campos diretamente na documentação oficial do Google Ads.

Criação e gerenciamento

O gerenciamento das variáveis de conversão personalizadas é feito por meio do ConversionCustomVariableService.

Para criar novas variáveis:

  • Utilize o método MutateConversionCustomVariables

  • Envie uma ou mais ConversionCustomVariableOperation

  • Em cada operação, defina o campo create com os dados da variável

Após a criação, a variável pode ficar nos status:

  • ENABLED (ativa)

  • ACTIVATION_NEEDED (necessita ativação)

O status pode ser verificado na resposta da API.

Uso das variáveis na importação de conversões

Ao importar uma conversão (como ClickConversion), utilize o campo custom_variables para informar todas as variáveis criadas.

Cada variável deve conter:

  • conversion_custom_variable: nome do recurso da variável criada

  • value: valor que será associado à conversão (ex: blue, new)

Esses dados passam a ficar disponíveis para segmentação e relatórios avançados no Google Ads.

Conclusão

A correta definição das categorias de ações de conversão é essencial para que a API de Conversões do Google funcione de forma eficiente. Quando bem configuradas, elas garantem dados mais confiáveis, melhor atribuição e campanhas mais performáticas dentro do Google Ads.

Sempre que possível, utilize a API em conjunto com a Tag do Google e mantenha suas ações de conversão alinhadas à estratégia do seu negócio.

Referência oficial

Este artigo foi elaborado com base na documentação oficial do Google Ads:

AnteriorCriando Conversões no Google Ads para enviar via SprintHubPróximoIntegrações - Outlook

Atualizado

Isto foi útil?