Skip to content

TMB Integration

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!


  1. Log in to your OneClick Ads account.

  2. Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

    The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card

  3. Click "New Integration".

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

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

  1. 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.

  1. Copy the UTM Script generated in OneClick Tracking.

    The UTM parameters step of OneClick Tracking, with the parameter to copy

    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

  1. 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.
  1. Set the Attribution Mode.

    The Attribution Mode step of OneClick Tracking

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

The Campaign Naming step of OneClick Tracking Analysis periods and the Naming Convention preview


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


  • 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.