---
title: "TMB Integration"
description: "Learn how to connect OneClick Tracking to TMB via webhook to track real conversions of digital products sold in boleto installments in your Meta Ads campaigns."
---

> Learn how to set up OneClick Tracking on TMB.

**OneClick Tracking** is a feature for Meta Ads advertisers who sell digital products in boleto installments through TMB (Tem Mais no Boleto). It provides immediate, accurate conversion tracking.

This solution **corrects wrong attributions made by Meta**, delivering **real data based on UTMs** and enabling safer scaling decisions.

**With OneClick Tracking you see the volume of real conversions per period right in your Ads Manager, making for a quick, clear audit without dashboards that are a hassle to keep up to date.**

Using the sales webhook from your TMB account, OneClick takes UTM data into account, as well as Meta's data, without duplicating conversions.

Note: **OneClick Tracking** removes the need for extra tracking tools!

---

:::tip[You can connect several platforms at the same time]
OneClick Tracking lets you connect **more than one platform to the same ad account** at the same time (for example, Hotmart and Eduzz together). Each platform has its own integration — with its own Webhook link or access credential — and they coexist without competing with each other; just repeat the **"New Integration"** steps for each one you want to connect.

Each sale is attributed to the right campaign by its **UTM**, not by the platform. So if one campaign sells through one platform and other campaigns sell through another, each conversion is automatically linked to the campaign it came from, regardless of which platform generated the sale. The recommended setup is **each campaign serving a single platform** — avoid having the same campaign sell on two platforms at once.
:::

## How to Connect OneClick Tracking to TMB

1. Log in to your OneClick Ads account.
2. Go to the "OneClick Tracking" tab, available in the left sidebar of [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card](../../../../../public/oneclick-tracking/common/image-1.png)

3. Click "New Integration".

4. Select the "Digital products" product type and click Continue.

5. Select the "TMB" platform and click Continue.

6. Copy the Webhook URL generated by OneClick and register it in TMB by following the steps below:
   a. Each ad account gets a unique, automatically generated link.
   b. This link is what connects your account to TMB and tracks conversions by UTM.

   6.1. In the TMB dashboard, click the **Produtos** (Products) menu and then **Integrações** (Integrations). Select the product and open **Webhook Vendas** (Sales Webhook). (You can also get there through **Produtos** ➡ the product's **Mais Opções** (More Options) ➡ **Integrações** ➡ **Webhook Vendas**.)

   6.2. In **URL**, paste the tracking URL provided by OneClick.

   6.3. Leave the **Chave** (Key) and **Valor** (Value) fields blank: OneClick does not use header authentication.

   6.4. Check the **Status** field to turn the integration on, and save.

   6.5. Repeat the setup for every product you advertise.

   :::note[TMB allows up to 3 sales webhook URLs]
   If you already use the sales webhook with another tool, add the OneClick URL as an additional URL — there is no need to remove the existing ones.
   :::

   :::tip[Check the deliveries in the interaction history]
   Below the webhook settings, the **"Histórico de interações"** (Interaction history) tab shows every delivery TMB sent and whether it went through. You can also resend an event from there.
   :::

7. Copy the UTM Script generated in OneClick Tracking.

   ![The UTM parameters step of OneClick Tracking, with the parameter to copy](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

   ![The URL parameters field of an ad in Meta Ads Manager](../../../../../public/oneclick-tracking/common/image-3.png)

8. Add the **UTM Passthrough Script** to all your sales pages, so the UTMs are carried through to the final checkout page:
   a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.
   b. The script must also be present on the TMB checkout page or on the landing page right before the checkout.

9. Set the Attribution Mode.
   - [Watch this video](https://www.youtube.com/watch?v=JgWkvv4ZNLY) to understand each model.
   - Click Continue.

   ![The Attribution Mode step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

10. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

:::caution[Campaign renaming depends on processed conversions]
The naming set here **will only be applied to the campaign name in Ads Manager once there is at least 1 processed conversion**. Receiving raw webhook data from the integrated platform is not enough — the system must have structured the conversion and attributed it to a campaign. If the webhook is arriving but the campaign name hasn't changed yet, wait for the first conversion to be recorded.
:::

![The Campaign Naming step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Analysis periods and the Naming Convention preview](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Done!

Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

![Campaigns with the OneClick Tracking prefix in Ads Manager](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Important Notes

- The conversion is recorded when the order is **effected** (efetivado), that is, when the customer pays the **down-payment boleto**. Cancelled orders are received and do not generate a conversion.
- OneClick Tracking records the sale at the order's **principal value** (the product price, without the installment plan's interest or administration fee), in Brazilian reais.
- The UTM passing script **must be present** on the TMB checkout page or on the landing page right before the checkout to make sure the UTM parameters are captured correctly.
- Only campaigns created after the setup will have access to the "Maximum Period" data. This **does not affect** OneClick Ads optimization on older campaigns in any way.
- Keep at least one ad identifier (`ad.id`) in the UTM parameters — it's what lets OneClick Tracking link the conversion to the right campaign, ad set and ad.
