> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/network/offers/tracking-url-macros.md).

# Tracking URL Macros

Correct use of tokens leads to uninterrupted Tracking flow if the Macros are not correctly configured in the Offer18 URL in that case, data didn't get exchanged between the user and his client.

#### Tokens are to be used in the Offer URL for the purpose of exchanging click information with the Advertiser. <a href="#tokens-to-be-used-in-offer-url-for-the-purpose-of-exchange-click-information-with-advertisers." id="tokens-to-be-used-in-offer-url-for-the-purpose-of-exchange-click-information-with-advertisers."></a>

<table data-header-hidden data-full-width="false" data-search="false"><thead><tr><th width="231.11113706259766"></th><th width="150"></th><th width="289.2776203966006"></th></tr></thead><tbody><tr><td><strong>Macro Name</strong></td><td><strong>Token</strong></td><td><strong>Description (when to use)</strong></td></tr><tr><td>TID</td><td>{tid}</td><td>This is the Platform's unique Click ID Macro</td></tr><tr><td>Affiliate ID</td><td>{aff_id}</td><td>To pass Affiliate id in the Offer URL</td></tr><tr><td>Sub Affiliate ID</td><td>{sub_aff_id}</td><td>To pass Sub-Affiliate id in the Offer URL</td></tr><tr><td>Click IP Address</td><td>{ip}</td><td>To pass the IP address in the Offer URL</td></tr><tr><td>Offer ID of Offer</td><td>{offerid}</td><td>To pass Offer ID in the Offer URL</td></tr><tr><td>Offer Name of the Offer</td><td>{offername}</td><td>To pass Offer name in the Offer URL</td></tr><tr><td>Device User Agent <br>(url encoded)</td><td>{useragent}</td><td>To pass Device user agent in the Offer URL</td></tr><tr><td>Device User Agent <br>(raw format)</td><td>{raw_useragent}</td><td>To pass Raw Device user agent </td></tr><tr><td>Advertiser's ID</td><td>{adv_id}</td><td>To pass Advertiser account ID (Advertiser data)</td></tr><tr><td>Country Code (2-digit)</td><td>{country}</td><td>To pass Country name in the Offer URL</td></tr><tr><td>Exact Click Time</td><td>{timestamp}</td><td>To pass click time in unix Timestamp format</td></tr><tr><td>Device ID (Affiliate Data)</td><td>{deviceid}</td><td>To pass device id in the Offer URL <br>(If received from Affiliates in Affiliate Tracking link)</td></tr><tr><td>Source (Affiliate Data)</td><td>{source}</td><td>To pass source data in the Offer URL <br>(If received from Affiliates in Affiliate Tracking link)</td></tr><tr><td>Google Advertising ID (Affiliate Data)</td><td>{googleaid}</td><td>To pass google id in the Offer URL <br>(If received from Affiliates in Affiliate Tracking link)</td></tr><tr><td>Android Device ID (Affiliate Data)</td><td>{androidid}</td><td>To pass android id in the Offer URL <br>(If received from Affiliates in Affiliate Tracking link)</td></tr><tr><td>IOS Device ID</td><td>{iosidfa}</td><td>To pass IDFA in the Offer URL<br>(If received from Affiliates in Affiliate Tracking link)</td></tr><tr><td>Operating System</td><td>{os}</td><td>To pass Operating system details in the Offer URL</td></tr><tr><td>Operating System Versions</td><td>{os_ver}</td><td>To pass Operating system version details in the Offer URL</td></tr><tr><td>random</td><td>{random}</td><td>To pass the random value in the Offer URL</td></tr></tbody></table>

#### Addition Macros to pass more information in Advertiser URL  <a href="#in-addition-to-all-above-if-offer18-users-wants-to-pass-more-information-in-advertiser-url-then-belo" id="in-addition-to-all-above-if-offer18-users-wants-to-pass-more-information-in-advertiser-url-then-belo"></a>

<table data-header-hidden data-full-width="false" data-search="false"><thead><tr><th width="241.21645009417534"></th><th width="150"></th><th width="300.24582898931294"></th></tr></thead><tbody><tr><td><strong>Macro Name</strong></td><td><strong>Token</strong></td><td><strong>Description</strong> </td></tr><tr><td>Affiliate Sub1</td><td>{aff_sub1}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub2</td><td>{aff_sub2}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub3</td><td>{aff_sub3}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub4</td><td>{aff_sub4}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub5</td><td>{aff_sub5}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub6</td><td>{aff_sub6}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub</td><td>{aff_sub7}</td><td>Use in the Offer URL for Probabilistic tracking</td></tr><tr><td>Affiliate Sub8</td><td>{aff_sub8}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub9</td><td>{aff_sub9}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr><tr><td>Affiliate Sub10</td><td>{aff_sub10}</td><td>Additional Data to receive from Affiliate and pass in the Offer URL</td></tr></tbody></table>

***

#### **Dynamic Tokens for Offer URL**

Below is the list of dynamic tokens used to pass values into the offer URL. These values will not be stored in reports.

<table data-search="false"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Macro Name</strong></td><td><strong>Token</strong></td><td><strong>Description</strong> </td></tr><tr><td>First Name</td><td>{t_first_name}</td><td>Dynamic token to pass first name in the Offer URL</td></tr><tr><td>Last Name</td><td>{t_last_name}</td><td>Dynamic token to pass last name in the Offer URL</td></tr><tr><td>Email</td><td>{t_email}</td><td>Dynamic token to pass email in the Offer URL</td></tr><tr><td>Contact Number</td><td>{t_phone}</td><td>Dynamic token to pass contact number in the Offer URL</td></tr><tr><td>Address</td><td>{t_address}</td><td>Dynamic token to pass address in the Offer URL</td></tr><tr><td>Dynamic sub values</td><td>{t_sub1} to {t_sub10}</td><td>Dynamic tokens to pass additional values in the Offer URL</td></tr></tbody></table>