What are the different macros/parameters that Unliche supports?

Last Updated On March 01, 2019
< Back

 

Unliche’s core tracking engine uses a combination of Campaign URLs, Affiliate tracking links, and date delivered via the integrated SDKs. These objects carry valuable information between your digital property and your campaign publishers (ad-inventories).

This explanation is covered into 2 separate sections each covering one of the key elements of the process to send and receive data.

 

Parameters & Values
With each click and conversion, crucial information passes via a combination of parameters andvalues.

parameter tells a server what information is being passed (like the offer ID or a mobile device ID etc.), and a value is the information itself. You can think of a parameter as a reserved word, and the value of that parameter is the definition of that word.

 

Macros
A macro is a special value that will later be replaced with another piece of information which is generated programatically by the respective tracking engine or dynamically passed thru by the app in which the Unliche SDK is integrated.

It is important to note that macros should always be enclosed by curly brackets ({}).

Let’s take an example to understand this concept:

Once you successfully define a campaign and allocate it to a partner, you receive a system generated tracking link like below:
https://t.unlc.co/camp_c?aff_id=2002&aid=3003&camp_id=1001&click_id=d75eb27b4868ded723ac284b39ca88

Here:
aff_id represents the partner id to whom this campaign is being allocated
aid represents the advertiser id
click_id represents the click id

Notice that the structure of a tracking link follows a pattern
&parameter=value

  • Information sent as parameters and values have a certain structure to them and they are always positioned after the question mark (?)
  • First, the parameter, then an equals sign (=), then the value.
  • You are not limited to pass only one macro in a URL. By separating the macros with ‘&’, multiple macros can be passed.

 

Flexibility by using “Macros”
The above link structure enables a very high level of flexibility wherein an advertiser can pass multiple values. In cases where  you don’t know the actual value you need to assign to a parameter for instance, things like click IDs that vary with each click, and affiliate IDs vary with each affiliate using your tracking links, one can use macros in place of specific values.

 

In Unliche, we allow a number of programmable macros to be used. The detailed list and their usage is elaborated in the table below:

Macro Definition Type Applicable to
{adv_id} This Define the Advertiser ID Click Mobile, Web
{lookback} This define the validity of the generated transaction id (Default: 30 Days) Click Mobile only
{camp_id} Refers to campaign ID Click Mobile, Web
{currency} Refers to campaign currency Click/Conversion Mobile, Web
{c_name} Refers to the name of each campaign Click/Conversion Mobile, Web
{camp_rev} Refers to campaign conversion revenue Click/Conversion Mobile, Web
{aff_cost} Attribution Date/Time Stamp Click/Conversion Mobile, Web
{attribution_time} Install Event Date/Time Stamp Conversion Mobile, Web
{install_event_time} Additional Affiliate Parameter 1 Conversion Mobile only
{aff_sub} Additional Affiliate Parameter 1 Click/Conversion Mobile, Web
{aff_sub2} Additional Affiliate Parameter 2 Click/Conversion Mobile, Web
{aff_sub3} Additional Affiliate Parameter 3 Click/Conversion Mobile, Web
{aff_sub4} Additional Affiliate Parameter 4 Click/Conversion Mobile, Web
{aff_sub5} Additional Affiliate Parameter 5 Click/Conversion Mobile, Web
{click_id} Parameter to receive transaction ID Click/Conversion Mobile, Web
{adv_sub} Additional Advertiser Parameter 1 Conversion Mobile, Web
{adv_sub2} Additional Advertiser Parameter 2 Conversion Mobile, Web
{adv_sub3} Additional Advertiser Parameter 3 Conversion Mobile, Web
{adv_sub4} Additional Advertiser Parameter 4 Conversion Mobile, Web
{adv_sub5} Additional Advertiser Parameter 5 Conversion Mobile, Web
{sub_aff_id} Additional parameter to pass sub publisher/affiliate ID Click/Conversion Mobile, Web
{event_id} Refers to event ID Click/Conversion Mobile, Web
{event_name} Refers to event name Click/Conversion Mobile, Web
{app_name} Refers to App Slug Name Click/Conversion Mobile, Web
{mtouch_id} Unique identifier to map user Click/Conversion Mobile, Web
{conversion_date_time}
Conversion Date/Time Stamp Conversion Mobile, Web
{re_eng_window} Define’s retargeting window (No of Days to check retargeting) Click Mobile
(Web – not yet available)
{retargetting} Refers to retargeting status Click Mobile
(Web – not yet available)
{session_ip} Session IP from Network Conversion Mobile, Web
{conversion_ip} Conversion IP from Network Conversion Mobile, Web
{http_referrer} Referrer domain from Network Conversion Mobile, Web
{session_expiry} Define’s the Web Session Expiry Click Web only

 

Important
Please note the macro’s type defines that the mentioned macro’s is only allowed in click/tracking url or conversion/affiliate url. Most of the macro’s are allowed at both the level.