URL syntax
What is the URL?
A Uniform Resource Locator (URL), also known as web address is a reference to a web resource that specifies its location on a computer network and a mechanism for retrieving it.
The general form of this syntax is as follows:
<protocol>://<hostname>/<pathname>?<query>
The elements of this syntax are as follows:
- <protocol> Hypertext Transfer Protocol (https/http)
- <hostname> An Internet host: by default RedTrack.io uses the service domain rdtk.io. You can change it manually to your custom tracking domain and/or select default.
- <pathname> A resource location path. This is usually a full directory path. For example, if on a device there is a directory called “project” and within it, a subdirectory called “external” containing a text file called “new_plan.txt”, the URL path “project/externa/new_plan.txt” would refer to that resource.
Note! The slash before the <url-path> is required, and while it is technically not considered part of the path, it serves the purpose of “acting” like the slash denoting the root directory in many file systems. Also, the <url-path> may end in a slash, which means that the path refers specifically to a directory.
- <query> An optional query or other information to be passed to the server when the resource is accessed. In our case, it is an additional parameter(s) for the tracking containing RedTrack and network macros: sub1={sub1}. These macros should be united with “=”. If there are several parameters, they need to be separated with “&” symbol: sub1={sub1}&country={country}. Is not an obligatory parameter and can be skipped if its usage is not required.
Important: this part should be obligatorily divided from the previous part of the URL with “?” symbol – that means that the main link part is ended and additional parameters will be applied further.
The scheme below illustrates this common syntax and its elements using an example the https URL:
- <hash> – placeholders for unique parameters. For example #s2# in postback settings for MaxBounty network:
We advise passing RedTrack {clickid} to a relevant affiliate network macro to enable conversion tracking when creating a new Offer.
Offer template is the following:
http://advertiser.com/offer/index.html?partner_macro={clickid}
Postback template looks the following way:
http://your.dedicated.tracking.domain.com/postback?clickid={partner_macro}
Where partner_macro from the offer template equals {partner_macro} from a postback template.
RedTrack parameters
Affiliate Networks integration
| Parameter | Description |
| {clickid} | Your Click ID Macro |
| {sum} | Offer Payout |
Traffic channels integration
| Parameter | Description |
| {ref_id} | RefID Macro (for receiving clicks from your traffic channel) |
| {imp_id} | ImpID Macro |
| {impcost} | Impression cost |
| {cost} | Click cost |
| {offer_payout} | Offer Payout Macro for a postback |
Common parameters
These are the parameters you can use for your own purpose for a traffic channel, affiliate network, or a Lander the way you need it:
| Parameter | Description |
| {os} | OS Macro |
| {browser} | Browser Macro |
| {sourceid} | TrafficSource ID |
| {country} | Country Macro |
| {city} | City Macro |
| {lpkeyua} | LP Key Macro |
| {campaignid} | CampaignID Macro |
| {isp} | ISP Macro |
| {region} | Region |
| {ip} | IP address |
| {useragent} | user agent |
| {brand} | device brand |
| {model} | device model |
| {prelanderid} | Prelander ID |
| {prelandername} | Prelander name |
| {landerid} | Lander ID |
| {landername} | Lander name |
| {offerid} | offer ID |
| {offername} | offer name |
| {browserversion} | browser version |
| {osversion} | OS version |
| {countryname} | full Country name |
| {connectiontype} | connection type |
| {referrerdomain} | referrer domain |
| {clicktime} | click time |
| {campaignname} | campaign name |
| {trafficsourcename} | traffic source name |
| {postbackid} | conversion ID |
| {domain} | passes domain to the lander |
Traffic channel -> RedTrack -> Affiliate Network
| {sub1} | |
| {sub2} | |
| {sub3} | |
| {sub4} | |
| {sub5} | |
| {sub6} | |
| {sub7} | |
| {sub8} | |
| {sub9} | |
| {sub10} | |
| {sub11} | |
| {sub12} | |
| {sub13} | |
| {sub14} | |
| {sub15} | |
| {sub16} | |
| {sub17} | |
| {sub18} | |
| {sub19} | |
| {sub20} |
Affiliate Network -> RedTrack -> Traffic channel
| {psub1} | |
| {psub2} | |
| {psub3} | |
| {psub4} | |
| {psub5} | |
| {psub6} | |
| {psub7} | |
| {psub8} | |
| {psub9} | |
| {psub10} | |
| {psub11} | |
| {psub12} | |
| {psub13} | |
| {psub14} | |
| {psub15} | |
| {psub16} | |
| {psub17} | |
| {psub18} | |
| {psub19} | |
| {psub20} |