---
title: "Integração Pagar.me"
description: "Aprenda a conectar o OneClick Tracking ao Pagar.me via webhook para rastrear os pedidos pagos da sua loja nas suas campanhas Meta Ads."
---

> Aprenda a configurar o OneClick Tracking no Pagar.me.

O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que recebem os pagamentos da sua loja ou do seu site pelo Pagar.me. Ele oferece um rastreamento de conversões imediato e preciso.

Essa solução **corrige atribuições erradas feitas pela Meta**, entregando **dados reais baseados nas UTMs** e permitindo decisões de escala mais seguras.

**Com o OneClick Tracking você visualiza no seu gerenciador o volume de conversões reais por período, facilitando uma auditoria rápida e clara, sem a necessidade de dashboards complicados de serem mantidos atualizados.**

A partir do webhook de pedidos do Pagar.me, o OneClick considera as UTMs que o seu site grava no pedido, bem como os dados da Meta, sem duplicar conversões.

:::caution[As UTMs precisam ser gravadas no pedido]
O Pagar.me é um gateway de pagamento: ele não vê a página em que o cliente chegou. Por isso, **o seu site precisa gravar as UTMs no campo `metadata` do pedido** ao criá-lo pela API do Pagar.me (passo 8). Sem isso, a venda chega ao OneClick, mas não pode ser atribuída a um anúncio.
:::

---

:::tip[Você pode conectar várias plataformas ao mesmo tempo]
O OneClick Tracking permite conectar **mais de uma plataforma na mesma conta de anúncios** ao mesmo tempo (por exemplo, Hotmart e Eduzz juntas). Cada plataforma tem a sua própria integração — com o seu próprio link de Webhook ou credencial de acesso — e elas convivem sem competir entre si; basta repetir o passo a passo de **"Nova Integração"** para cada uma que você quiser conectar.

A atribuição de cada venda à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha vende por uma plataforma e outras campanhas vendem por outra, cada conversão é ligada automaticamente à campanha de origem, independentemente de qual plataforma originou a venda. O cenário recomendado é **cada campanha atender a uma única plataforma** — evite uma mesma campanha vendendo em duas plataformas ao mesmo tempo.
:::

## Como Plugar o OneClick Tracking no Pagar.me

1. Acesse sua conta OneClick Ads.
2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![Aba OneClick Tracking no menu lateral do OneClick Ads, com o cartão Nova Integração](../../../../../public/oneclick-tracking/common/image-1.png)

3. Clique em "Nova Integração".

4. Selecione o tipo de produto "E-commerce" e clique em Continuar.

5. Selecione a plataforma "Pagar.me" e clique em Continuar.

6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a no Pagar.me seguindo o passo-a-passo abaixo:
   a. Cada conta de anúncios terá um link único gerado automaticamente.
   b. Esse link é o que conecta sua conta ao Pagar.me e rastreia as conversões por UTM.

   6.1. Acesse o **Dashboard** do Pagar.me e abra **Configurações → Webhooks**.

   6.2. Crie um novo webhook e, no campo de **URL**, cole a URL de rastreamento fornecida pelo OneClick.

   6.3. Nos eventos, marque **`order.paid`** (pedido pago). É esse o evento que gera a conversão.

   6.4. Salve o webhook.

   :::note[Os demais eventos podem ficar marcados sem problema]
   O OneClick Tracking registra **apenas pedidos pagos**. Eventos como `order.canceled`, `order.payment_failed`, `charge.paid` ou `invoice.paid` são recebidos sem gerar uma conversão nova nem duplicar vendas.
   :::

7. Copie o Script de UTM gerado dentro do OneClick Tracking.

   ![Etapa de parâmetros UTM do OneClick Tracking, com o parâmetro para copiar](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo:

   ![Campo Parâmetros de URL de um anúncio no gerenciador de anúncios da Meta](../../../../../public/oneclick-tracking/common/image-3.png)

8. Grave as UTMs no pedido do Pagar.me:
   a. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página de checkout. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, diretamente no header do seu site.
   b. No checkout, ao criar o pedido pela API do Pagar.me, envie as UTMs da URL no objeto `metadata` do pedido, com estes nomes: `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` e `utm_term` (os parâmetros `src` e `sck` também são lidos). Por exemplo: `"metadata": { "utm_source": "facebook", "utm_campaign": "120210000000000", "utm_content": "120210000000001" }`.
   c. Se o seu checkout é feito por uma plataforma que usa o Pagar.me por baixo, confira se ela já tem uma integração própria no OneClick Tracking: ela é o caminho mais simples.

9. Defina o Modo de Atribuição.
   - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo.
   - Clique em Continuar.

   ![Etapa de Modo de Atribuição do OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

10. Defina a Nomenclatura que suas campanhas, conjuntos de anúncios e anúncios receberão dentro do seu gerenciador de anúncios e clique em avançar.

:::caution[A renomeação da campanha depende de conversões processadas]
A nomenclatura configurada aqui **somente será aplicada ao nome da campanha no gerenciador de anúncios quando houver pelo menos 1 conversão processada**. Receber dados brutos do webhook da plataforma integrada não é suficiente — o sistema precisa ter estruturado e atribuído a conversão a uma campanha. Se o webhook está chegando mas o nome da campanha ainda não foi alterado, aguarde a primeira conversão ser registrada.
:::

![Etapa de Nomenclatura de Campanha do OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Períodos de análise e prévia da Nomenclatura](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Pronto!

Aguarde pelo menos 24 horas para que a configuração esteja vigente e todas as suas campanhas (as que receberem conversões) passarão a registrar as conversões dentro do próprio gerenciador de anúncios.

![Campanhas com o prefixo do OneClick Tracking no gerenciador de anúncios](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Notas Importantes

- O OneClick Tracking registra o **valor total do pedido** (frete incluso), na moeda do pedido (Real).
- Cada pedido é registrado **uma única vez**, pelo identificador do pedido no Pagar.me, mesmo que o webhook seja reenviado.
- Assinaturas (faturas e renovações) não são registradas por esta integração.
- Só campanhas criadas após a configuração terão acesso ao dado de "Período Máximo". Isso **não prejudica** de nenhum modo a otimização do OneClick Ads em campanhas mais antigas.
- Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. Se o pedido não trouxer as UTMs em `metadata`, a venda não pode ser atribuída.
