To unlock conversion-related features and enhance the conversion data signals used in Lunio’s IVT detection, we strongly recommend implementing Lunio's conversion tracking.
You can do this in two ways:
Add Lunio's javascript snippet to your website (learn more about that here)
Integrate the Lunio Conversion API.
What is the Lunio Conversion API?
The Lunio Conversion API allows you to send conversion events directly from your server to Lunio.
You can find the technical documentation here—your developers will need this to implement the API.
How it works
When you send conversion events via the Lunio Conversion API, Lunio receives and processes the event data directly from your server. The API supports sending key parameters such as user identifiers, and custom metadata. Lunio uses this data to accurately attribute conversions and detect invalid traffic, integrating Conversion API events with click data.
Why use the Conversion API?
Sending conversion events to Lunio provides a more complete picture of user interactions and lets use tailor our models to your data—giving you even better protection. Using the API offers specific benefits versus the Javascript approach:
Greater data control: You can pass detailed conversion parameters securely without relying solely on client-side scripts. This keeps security teams happy.
Improved reliability: Events sent from your server are less likely to be blocked or lost should users have adblocks or javascript blocking installed
Protect performance: Avoid extra Javascript on your checkout pages to keep them as light as possible.
Send Lunio custom data: Use meta_parameters to tell us more about a conversion. For instance, attribute order IDs or add a conversion value to enable more detailed and accurate analysis.
Getting started with Lunio Conversion API
You'll need to collaborate with your development team to integrate Lunio's Conversion API. Here are the steps involved:
In your Lunio account, create a conversion configuration for each conversion event to be tracked. This is done via System Overview > Integrations > Conversions in the Lunio dashboard.
Access API credentials: Located under System Overview > Integrations > Conversions in your Lunio account.
Integrate API calls: Your development team need to implement server-side code to send conversion events following the API specification (see the Lunio Conversion API docs).
Include parameters [optional]: Pass relevant parameters such as conversion ID, user info, and campaign details to enrich event data. Share your requirements with your development team and your Lunio CSM.
Test and monitor: Verify events are responding correctly (see the Lunio Conversion API docs).
Definitions of the variables
YOUR_TOKEN: Replace this with your Conversion API Token from the Lunio dashboard.config_id:The ID of the conversion event you created in the Lunio dashboard.user_ip: The IP address where the conversion occurred.url: The URL of the page where the conversion took place.user_agent: The browser user-agent string of the user making the conversion.meta_data: (Optional) Use this to pass a key-value pair with extra info like order ID, campaign name, etc.