> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.vturb.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Tracking Conversions - N8N

# Tracking Your Sales with N8N
 
This article explains how to configure VTurb conversion tracking and integrate this functionality with the N8N automation platform.
 
This article is for those who use a sales platform **without direct integration with VTurb**. If your platform is already available on our list of integrations, use its specific article instead — the setup is simpler and you do not need N8N.
 
The integration flow works as follows: **VTurb → Checkout → Sales Platform → N8N → VTurb**. VTurb generates a tracking parameter, your sales platform keeps this parameter throughout the purchase, and N8N sends the sale data back to VTurb.
 
### Configure conversion tracking in VTurb
 
Go to **Conversions → Conversion Tracking** and look for your sales platform. If it has not been registered yet, click **Add platform**.
 
Enter the **Platform Name** and select **N8N** as the integration tool. Then click **Add platform**.
 
![Platform addition screen](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_13nd1j8.png =583xauto)
 
In the **Parameters** step, select a tracking parameter that is not being used by your traffic sources.
 
![Tracking parameter selection](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_opjnll.png =991xauto)
 
|| If you choose a parameter that is already being used in your ads, VTurb may overwrite its value.
 
Then click the **Webhook URL** field to copy the URL generated by VTurb.
 
![Webhook URL](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_1628fvh.png =1052xauto)
 
### Import the template into N8N
 
To make the setup easier, we provide a ready-made workflow with the necessary modules. [Download the workflow template](https://drive.google.com/file/d/15aUfKTl6nl4QXoPBhtZep7bKqPV9Xf3I/view?usp=sharing).
 
In N8N, create a new workflow, click the three-dot menu next to the workflow name, and go to **Import → From file**. Select the file you just downloaded.
 
![Importing the template into N8N](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_1havu2n.png =1167xauto)
 
The imported workflow already contains the two modules required to perform the integration.
 
### Configure your sales platform webhook
 
Open the **Send conversion to VTurb** module and, in the **URL** field, paste the webhook URL you copied from VTurb.
 
![Send conversion to VTurb module](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_434r18.gif)
 
In the upper-right corner, click **Publish** to activate the workflow. Then open the **Sales platform webhook** module and copy the **Production URL**.
 
![Webhook Production URL](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_1fbgroc.gif)
 
|| Always use the **Production URL**. The Test URL only works while the workflow is running in test mode.
 
Go to your sales platform's webhook settings, paste the N8N Production URL, and select only the **approved purchase** event. This prevents pending orders, cancellations, or refunds from being counted as conversions. Then save the configuration.
 
### Map the sales data in N8N
 
Now let's verify that the platform is correctly sending the sales data to N8N.
 
Make a test purchase through your own page: play the video, click the purchase button, and complete the purchase. When the checkout opens, check the address bar — the tracking parameter selected earlier should appear in the URL with a value starting with `v3_`.
 
|| If the parameter does not appear in the checkout, stop here: this adjustment needs to be made on your page, and continuing with the N8N setup will not solve the problem. Contact our team through Chat for assistance.
 
After the test purchase is sent, go to **Executions** in N8N and open the execution corresponding to the purchase. On the left side, locate the data sent by your sales platform.
 
Open the **Send conversion to VTurb** module and replace the fields marked as `SUBSTITUIR` with the data received through the webhook.
 
![Received data and VTurb fields](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_893qi2.png =901xauto)

In the GIF below, we show how to locate the data received by the webhook and insert it into the corresponding fields of the JSON:

![Filling in the variables in the N8N JSON module](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_7i7gaq.gif)
 
Each sales platform uses different names for the same data, so the mapping must be done based on the execution of your own test purchase:
 
| Field | What to enter |
| ---- |
| `conversion_key` | The tracking parameter selected earlier. The value must start with `v3_`. |
| `order_amount_cents` | The sale amount in cents. Example: if the platform sends `97.00`, enter `9700`. |
| `currency` | The sale currency using the three-letter code, such as `BRL`, `USD`, or `EUR`. |
| `product_name` | The name of the product sold. |
| `order_created_at` | The date and time when the payment was approved. |
 
The `category` and `order_ip` fields are already filled in the template and do not need to be changed.
 
| Each payment platform has variables with different names. Do not follow a ready-made example from another platform — use the data received in the execution of your own test purchase to identify the correct fields.
 
After filling in the fields, save the workflow, rerun the test execution, and check whether the conversion was successfully sent to VTurb.
 
If you get stuck at this step, copy the data displayed in the N8N execution and contact our team through Chat — we can help identify which fields should be used.
 
## Integration completed ✅
 
Your N8N integration has been successfully configured. From now on, conversions from your sales can be recorded within VTurb. In the conversion tracking panel, the integration status should change from **Waiting for 1st sale** to **Integrated**.
 
| If you use pop-ups on your page, an additional configuration may be required to ensure that the tracking parameters are sent correctly. Contact our team through Chat for guidance.
 
If you have any questions or need support during the process, our team is available to help.