---
title: "PipeRun Integration"
description: "Learn how to connect OneClick Tracking to PipeRun CRM to record as conversions the opportunities that reach the pipeline stages you choose."
---

> Learn how to set up OneClick Tracking on PipeRun CRM.

**OneClick Tracking** records as conversions the opportunities in your PipeRun that reach the pipeline stages you choose, and links each one to the Meta ad that brought the customer. Your campaigns' CPA and ROAS then reflect your sales team's real sales.

---

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

## Before you start: the UTMs in PipeRun

PipeRun has no field of its own for UTMs. For OneClick to know which ad each opportunity came from, the UTMs must be in **opportunity custom fields** with these names:

- `utm_source`
- `utm_medium`
- `utm_campaign`
- `utm_content`
- `utm_term`

Create these fields in PipeRun and have your website's form, or the tool that creates the opportunities, fill them in. An opportunity without UTMs stays in your PipeRun as usual, but does not become a tracked conversion, because there is no ad to attribute it to.

---

## How to Plug OneClick Tracking into PipeRun

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 "Lead Generation" product type and click Continue.

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

6. Paste the PipeRun **API token** and click Connect.
   a. In PipeRun, open **Meus dados** (My data), or the **Integrações** (Integrations) screen, and copy the token shown below your photo.
   b. Use a **manager user's** token: only a manager can reach the automatic actions you will create in step 11.

7. Choose **which stages count as a conversion**.
   a. OneClick lists your account's pipelines and the stages of each one.
   b. Tick the stages that are a real conversion for your business (for example, "Meeting scheduled" or "Closing").

8. 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)

   8.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)

9. Add the **UTM Passthrough Script** to all your sales pages, so the UTMs are automatically carried into the card of each lead generated.
   a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.

10. 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)

11. 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)

11. Copy the **Webhook URL** generated by OneClick and create, in PipeRun, the automatic action that sends the opportunities:

    11.1. Hover over your avatar in the top-right corner and click **Ajustes e configurações** (Settings). In the **Ferramentas** (Tools) column, click **Ações automáticas** (Automatic actions), then **+ Adicionar ação** (Add action).

    11.2. Name the action (for example, "OneClick Tracking"). Under the trigger question, choose the opportunity entering the stage. Under the action type, choose **Webhook - Envio de oportunidade para URL** (send opportunity to URL).

    11.3. Under **Neste Funil** (In this pipeline) and **Nesta etapa do funil** (In this stage), choose one of the stages you ticked in step 7. Click **Próximo** (Next).

    11.4. In the **URL** field, paste OneClick's Webhook URL. Leave **Tipo de envio** (Send type) as **Padrão** (Default). Click **Salvar** (Save).

    11.5. Repeat steps 11.1 to 11.4 for **each stage** you ticked in step 7: in PipeRun, each automatic action applies to one stage.

    :::caution[Keep the Default send type]
    OneClick reads the default keys PipeRun sends. With the **Avançado** (Advanced) send type, the key names change and the opportunities are no longer recognized.
    :::

---

## Important Notes

- Each stage you chose counts **once per opportunity**: the same opportunity moved into the same stage again does not create a duplicate conversion. If you choose several stages, an opportunity that goes through all of them counts once in each.
- **Lost** opportunities, and those in the trash, never count as a conversion.
- The recorded value is the opportunity's products and services value plus one month of its recurring value (MRR).
- PipeRun does not run automatic actions on imports or bulk actions: an opportunity imported straight into the stage is not sent.
- If you change the token in PipeRun, reconnect the integration in OneClick with the new token.

---

## 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)
