Skip to main content

How to set up Lunio conversion tracking

This guide explains how to generate a Lunio conversion tracking script and install it on your website, either directly or via Google Tag Manager.

Lunio conversion tracking lets Lunio detect when someone completes a key action on your site, such as a purchase or form submission, so it can use that data to sharpen its invalid traffic detection and unlock additional exclusion capabilities. You will need to generate a script in your Lunio dashboard first, then install it using one of the methods below.


Before You Start

You will need:

  • Admin access to your Lunio dashboard

  • The Lunio mplat script already installed on your site. If you have not done this yet, follow the multiplatform tracking guide first

  • Access to your Google Tag Manager container or your website's source code, depending on your chosen install method

  • The Lunio Conversion Tracking .tpl file from your account manager, if you plan to use the GTM template method

⚠️ You must be an account admin in Lunio to access the Conversions section and generate scripts.


Step 1 — Generate your conversion script

  1. In your Lunio dashboard, go to System Settings, click Integrations in the sidebar, then select Conversions

  1. Click Create conversion and give your script a name for easy reference, such as the conversion type or the relevant domain

  2. Set the conversion type and choose whether you want the script to whitelist converting IPs or just track them

  3. Enable the Parameter option if you want to pass values on the conversion event, such as an Order ID

  1. Click Generate to confirm your settings and create the script, which will now appear in the Conversions table

  2. Click View in the Script column to access your script. If you are using the GTM template method, copy the Conversion ID shown in the script, for example fff4eea5-079d-44a2-b861-99285cba77b3


Step 2 — Install your script

Choose the method below that matches how your website is managed.

Method A: Google Tag Manager (Lunio template)

This is the recommended method if you use Google Tag Manager, as it uses Lunio's pre-configured tag template rather than a manual custom HTML tag.

Import the Lunio template

  1. In GTM, click Templates in the left hand menu

  2. Under Tag Templates, click New

  3. Click the three dot menu in the top right, then select Import

  4. Upload the .tpl file provided by your account manager and click Save to make the template available when creating tags

Create the conversion tag

  1. Go to Tags then click New

  2. Click Tag Configuration and select Lunio Conversion Tracking from the Custom section

  3. Paste your Conversion ID into the Conversion ID field. If your site is an ecommerce store and you have a data layer variable for order ID, map it to the Order ID field as well, as this helps Lunio match conversions to orders

Set your trigger

  1. Click Triggering in the tag setup, then click + to add a new trigger

  2. Set up a trigger that fires when a conversion is completed, for example a Page View trigger set to fire when the URL contains /order-confirmation

  3. Save the trigger

Test and publish

  1. Click Preview in GTM and enter your website URL, then complete a test conversion

  2. Check the GTM Preview panel confirms the Lunio Conversion Tracking tag shows as Fired, then close preview mode

  3. Click Submit, add a version name such as Added Lunio conversion tracking, then click Publish

Method B: Install directly on your website

Use this method if you are not using a tag manager. Note that if your site does not redirect users to a dedicated success page after a conversion, for example if you count button clicks as conversions, you will need to use Method A instead.

  1. Copy the full conversion tracking script from the View button in the Conversions table

  2. Navigate to the success page a user reaches after completing a conversion, such as a thank you page after a purchase or form submission

  3. Paste the script just before the </body> tag on that page

  4. Publish your changes to make them live


Step 3 — Verify your setup

Once the script is live, complete a real conversion on your website and then check System Settings > Integrations > Conversions in your Lunio dashboard to confirm data is being received. If nothing appears within a few minutes, check that the script or tag is firing correctly using your browser's developer tools or the GTM Preview panel.


💡 The GTM template method works with web (client side) GTM containers only. If you are using a server side GTM container, see the server side GTM setup guide instead.

If you run into any issues, please reach out to your account manager or email [email protected] and we will be happy to help.

Did this answer your question?