# 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\ --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sprinthub.com/topicos/integracao/integracao-google-ads-e-gmail/parametros-da-api-de-conversoes-do-google-google-ads-conversion-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.