How to Set Up UTM Tags and Campaign Parameters in Keitaro

When working with advertising traffic, it's important to transmit data about the campaign, ad, and traffic source. UTM tags and macros are used for this purpose, allowing you to link a user's click with a lead and conversion.

In this guide, we'll examine the complete parameter transmission path:

Ad → Keitaro → Landing Page → Form → CRM → Conversion

What Are Macros

A macro is a variable that is automatically replaced with a real value when a user clicks.

For example: {{campaign.name}}

After a user clicks, Keitaro will replace the macro with the actual name of the advertising campaign.

Ad System Macros and Keitaro Macros

Two types of macros are used in parameter transmission.

Ad System Macros

These macros are inserted by the advertising platform when a user clicks.

Examples:

{fbclid}
{campaign.id}
{adset.id}
{ad.id}

Keitaro Macros

These macros are processed by the tracker.

Examples:

{{campaign.name}}
{{campaign.id}}
{{adset.id}}
{{ad.id}}
{{placement}}
{{site_source_name}}

First, the advertising system inserts its values, after which Keitaro processes the parameters and passes them further.

Note: Before setting up parameter transmission, it is recommended to familiarize yourself with the standard macros of the traffic source you are working with. Each advertising platform uses its own macros to transmit campaign data, which are automatically inserted into the link when a user clicks.

Step 1. Setting Up Parameters in Keitaro Campaign

Open the desired campaign in Keitaro and go to the Parameters tab.

Here you set the parameters that will receive data from the advertising system.

Add the following parameters:

utm_campaign = {{campaign.name}}
utm_source = {{site_source_name}}
utm_placement = {{placement}}

campaign_id = {{campaign.id}}
adset_id = {{adset.id}}
ad_id = {{ad.id}}

adset_name = {{adset.name}}
ad_name = {{ad.name}}

These parameters allow you to transmit information about the advertising campaign, ad set, and specific ad.

Step 2. Adding Parameters to the Landing Page URL

After setting up the parameters, they need to be added to the landing page URL.

Example URL:

https://domain.com/?fbclid={fbclid}&utm_campaign={{campaign.name}}&utm_source={{site_source_name}}&utm_placement={{placement}}&campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}

When a user clicks on an ad:

the advertising system inserts its macros
Keitaro processes the parameters
data is transmitted to the landing page

Step 3. Passing Parameters to the Landing Page Form

To ensure parameters aren't lost after navigating to the landing page, they need to be saved in the form.

This is done through hidden fields.

Example:

<input type="hidden" name="subid" value="{subid}" />
<input type="hidden" name="source" value="{source}" />
<input type="hidden" name="creative_id" value="{creative_id}" />
<input type="hidden" name="ad_campaign_id" value="{ad_campaign_id}" />
<input type="hidden" name="pixel" value="{pixel}" />

These parameters save the click data and are sent along with the form.

Step 4. Processing Form Data

After the form is submitted, the data is sent to a handler file.

In this example, the file used is: send.php

It collects user data:

firstname lastname email phone userip useragent

Tracking parameters are also transmitted:

MPC_1 MPC_2 MPC_3 MPC_4 MPC_5 MPC_6 MPC_7

These parameters are used to transmit data to the CRM.

Step 5. Checking Parameters in the CRM

After submitting the form, the lead appears in the CRM.

In the lead card, you can see the Tracking Parameters section, where the transmitted parameters are displayed.

For example:

MPC 1 MPC 2 MPC 7

These are parameters that were transmitted from the landing page.

Step 6. Checking Conversion in Keitaro

The final step is to ensure that the conversion is recorded in the tracker.

Go to: Campaign → Conversions log

The log displays data:

Sub ID Email Phone IP User Agent

If an entry appears in the log — it means the parameter transmission is working correctly.

Data Transmission Scheme

Complete chain of parameter transmission from click to conversion:

Ad → Ad System Macros → Keitaro → Landing Page → Form → send.php → CRM → Conversions log

This allows you to link a user's click with a lead and conversion.