> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/integracoes/integracao-google-ads-e-gmail/parametros-da-api-de-conversoes-do-google-google-ads-conversion-api.md). # 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: * 🔗 Google Ads API – Categorias de ações de conversão\ * 🔗 Google Ads API - Variáveis de conversão personalizadas\