This article is also available in:

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

In the Parameters step, select a tracking parameter that is not being used by your traffic sources.

Tracking parameter selection

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

Import the template into N8N

To make the setup easier, we provide a ready-made workflow with the necessary modules. Download the workflow template.

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

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

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

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

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

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.

Updated on: 09/17/2026

Was this article helpful?

Thank you!