AFL UTM Tracker Documentation

  1. Home
  2. Docs
  3. AFL UTM Tracker Documentation
  4. Developer
  5. Server-side Merge Tags

Server-side Merge Tags

With our AFL UTM Tracker plugin, you will have access to Server-side Merge Tags where our plugin will replace the merge tag with the respective values at the server-side during form submission.

Server-side Merge Tags vs Javascript Merge Tags

This is different compared to our Javascript Merge Tags. Javascript Merge Tags is when the merge tags are replaced on the client-side browser before form submission.

Where the Merge Tags can be used?

  • Form hidden field value
  • Form email notification

Please refer to the individual form documentation.

Supported Plugins:

  • Contact Form 7
  • Fluent Forms
  • Gravity Forms
  • Ninja Forms

Benefits of Server-side Merge Tags vs Javascript Merge Tags

  • Does not require Javascript to manipulate the HTML DOM.
  • Has access to Conversion Lag value.

List of Merge Tags

Attribution Data (afl_wc_utm:attribution_name)

Session

Conversion Type:
afl_wc_utm:conversion_type

Conversion Lag (X days Y hours):
afl_wc_utm:conversion_lag_human

Conversion Lag (seconds):
afl_wc_utm:conversion_lag

Conversion Date:
afl_wc_utm:conversion_date_local
afl_wc_utm:conversion_date_utc

Conversion Timestamp:
afl_wc_utm:conversion_ts

First Visit Date:
afl_wc_utm:sess_visit_date_local
afl_wc_utm:sess_visit_date_utc
afl_wc_utm:sess_visit

First Landing Page URL:
afl_wc_utm:sess_landing

First Landing Page URL (without query parameters):
afl_wc_utm:sess_landing_clean

First Website Referer URL:
afl_wc_utm:sess_referer

First Touch UTM

URL:
afl_wc_utm:utm_1st_url

URL without any query parameters:
afl_wc_utm:utm_1st_url_clean

Visit Date:
afl_wc_utm:utm_1st_visit_date_local
afl_wc_utm:utm_1st_visit_date_utc

Visit Timestamp:
afl_wc_utm:utm_1st_visit

Parameters:
afl_wc_utm:utm_source_1st
afl_wc_utm:utm_medium_1st
afl_wc_utm:utm_campaign_1st
afl_wc_utm:utm_term_1st
afl_wc_utm:utm_content_1st

Last Touch UTM

URL:
afl_wc_utm:utm_url

URL without any query parameters:
afl_wc_utm:utm_url_clean

Visit Date:
afl_wc_utm:utm_visit_date_local
afl_wc_utm:utm_visit_date_utc

Visit Timestamp:
afl_wc_utm:utm_visit

Parameters:
afl_wc_utm:utm_source
afl_wc_utm:utm_medium
afl_wc_utm:utm_campaign
afl_wc_utm:utm_term
afl_wc_utm:utm_content

Click Identifiers

For other click identifiers, replace the word gclid with the respective click identifier name.

URL:
afl_wc_utm:gclid_url

URL without any query parameters:
afl_wc_utm:gclid_url_clean

Click Identifier Value:
afl_wc_utm:gclid_value

Visit Date:
afl_wc_utm:gclid_visit_date_local
afl_wc_utm:gclid_visit_date_utc

Visit Timestamp:
afl_wc_utm:gclid_visit

Filters

A pipe “|” character is placed after the attribution name. Then a filter name is added to manipulate the value.

Extract Custom Parameter from URL (param:param_name)

This feature requires AFL UTM Tracker version 2.31.0.

NOTE: The previous plugin version uses the --extract_param: filter. Please use the new syntax as below.
Extract matchtype parameter from the First Touch UTM URL
afl_wc_utm:utm_1st_url|param:matchtype

Extract matchtype parameter from the Last Touch UTM URL
afl_wc_utm:utm_url|param:matchtype

Extract ref parameter from the First Landing Page URL
afl_wc_utm:sess_landing|param:ref

Set a Default Value (default:enter_a_value)

This feature requires AFL UTM Tracker version 2.31.0.

Set the default value to none when matchtype is blank
afl_wc_utm:utm_url|param:matchtype|default:none

Set the default value to none when Last Touch utm_campaign is blank
afl_wc_utm:utm_campaign|default:none

URL filters (url:part_name)

This feature requires AFL UTM Tracker version 2.31.0.

URL without query parameters
afl_wc_utm:utm_url|url:clean

Other supported part name according to Javascript spec
afl_wc_utm:utm_url|url:hash
afl_wc_utm:utm_url|url:host
afl_wc_utm:utm_url|url:hostname
afl_wc_utm:utm_url|url:href
afl_wc_utm:utm_url|url:origin
afl_wc_utm:utm_url|url:pathname
afl_wc_utm:utm_url|url:protocol
afl_wc_utm:utm_url|url:search

Reference: https://developer.mozilla.org/en-US/docs/Web/API/URL/URL

Using Multiple Merge Tags

You can use multiple merge tags in a single hidden field by enclosing each merge tag with an open and close curly brackets.

This feature requires AFL UTM Tracker version 2.31.0.

Curly Brackets Usage

Most forms can support multiple curly bracket.

Last UTM Source / Last UTM Medium (e.g google/cpc)
{afl_wc_utm:utm_source}/{afl_wc_utm:utm_medium}

Square Brackets Usage

In plugin like Ninja Forms, you cannot use multiple curly brackets in the Default Value field, so you must use the square brackets instead like below:

Last UTM Source / Last UTM Medium (e.g google/cpc)
[afl_wc_utm:utm_source]/[afl_wc_utm:utm_medium]