---
title: "BW Commerce Integration"
description: "Learn how to connect OneClick Tracking to BW Commerce to track e-commerce sales conversions in your Meta Ads campaigns based on UTMs."
---

> Learn how to set up OneClick Tracking on BW Commerce.

**OneClick Tracking** is a feature for Meta Ads advertisers who use BW Commerce as their e-commerce platform. It provides immediate, accurate conversion tracking.

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

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 Plug OneClick Tracking into BW Commerce

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 "E-commerce" product type and click Continue.

5. Select the "BW Commerce" platform and click Continue.

6. Enter your **BW Commerce store address** and the **BW Commerce API Token**, and click **Connect BW Commerce**. With these two pieces of information, OneClick creates the webhook in your store automatically — you don't need to configure anything inside BW Commerce.

:::note[Why the store address is needed]
BW Commerce serves each store at its own API address. So, besides the token, OneClick needs to know which store is yours.

All of these formats work:

- `sualoja.com.br`
- `https://www.sualoja.com.br/`
- `sualoja.api.bwcommerce.com.br`

In all three cases OneClick will access your store at `https://sualoja.api.bwcommerce.com.br`. **Check that the store name in this address is the same one shown in the BW Commerce dashboard** — if your store uses a custom domain that differs from its name on the platform, enter the address shown in the dashboard.
:::

## How to get the BW Commerce API Token

6.1. Log in to your **BW Commerce** account.

6.2. In the admin dashboard, go to **"Configurações > Integrações"** (Settings > Integrations) and generate an API token. BW Commerce's official step-by-step is at [Como criar e obter o token da API para integração](https://ajuda.bwcommerce.com.br/artigo/como-criar-e-obter-o-token-da-api-para-integracao-) (How to create and get the API token for integration).

6.3. Copy the token and paste it into the **"BW Commerce API Token"** field in OneClick Tracking.

:::tip[The token is stored securely]
The token is stored encrypted on OneClick's side and **never goes back to the browser**. When you re-edit the integration, the field appears empty — leave it empty to keep the current token, or paste a new one to replace it.

The store address, since it isn't secret, appears filled in when you re-edit. If you need to **change the address**, paste the API token again along with the new address.
:::

6.4. When you click **Finish** at the end of the setup, OneClick registers the **"Alteração de status de pedido"** (order status change) webhook in your store — this is the event BW Commerce fires whenever an order changes status (including when it is paid/approved), and it's the one OneClick Tracking uses to identify a confirmed conversion. If you had already connected this store before, the existing webhook is **updated**, not duplicated.

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.

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

- **Automatic webhook:** the **"Alteração de status de pedido"** (order status change) webhook is created by OneClick with the token you provided. It is not necessary — nor recommended — to manually create a webhook in the BW Commerce dashboard pointing to the same URL: two webhooks would deliver the same order twice.
- **Revoked token:** if you revoke or regenerate the token in BW Commerce, tracking stops working. Re-edit the integration in OneClick Tracking and paste the new token.
- **Conversion source:** BW Commerce does not send `utm_*` fields in the order. The UTMs are read from the **order's origin URL**, which is the URL through which the customer reached the store — that's why the UTM Passthrough Script is required.
- **UTMs in ads:** The UTMs must be present in the ad URLs and passed through to the checkout page via the UTM Passthrough Script for tracking to work correctly.
- **Availability:** This integration is being rolled out gradually and may not be visible to every account.
