Creating Links Manually

This is technical documentation to be used by publishers who require advanced programmatic link generation. These methods will not ensure that your links are valid, nor that they are tracked properly.

We highly recommend using the “Create Link” modal when generating tracking links to ensure you deploy valid, tested, and active links!

Where possible Partners should use the KMP “Create Link” buttons found throughout the platform to generate their links. For specialized use cases, however, Partners can dynamically generate tracking links. Here is an example of a Partner Tracking Link:

CODE

https://track.revoffers.com/aff_c?offer_id=55&aff_id=66&url_id=777&sub1=foobar

Generating your own tracking links might result in links that do not work. Always ensure your source/destination parameters are valid and match your account before you deploy your links.

URL Parameters

Reference the table below for the most commonly-used parameters. You can also reference this page by Tune or this other page on Sub IDs and Macros to read more on how tracking links work.

Parameter	Purpose
Source/Destination Parameters Determines whether traffic is approved and where to redirect the user.
`offer_id` (required)	Selects what Program you are promoting.
`aff_id` (required)	Identifies what Traffic Source generated this click. If the Program requires approval, then this Traffic Source must already be approved to run traffic to the selected Program.
`url_id`	If defined, changes the destination to a custom Landing Page instead of the default Landing Page for the Program. Do not define `url_id` and `url` in the same URL.
`url`	If defined, redirects the user to a specific “deep link”. Deep Links are only supported by certain advertisers, and Deep Links should contain Katalys Tracking parameters to track appropriately; therefore, we recommend generating Deep Links using the “Create Link” widget in KMP.
Metadata Parameters Stores values for reporting, analysis, and debugging traffic.
`sub1`, `sub2`, `sub3`, `sub4`, `sub5`	Arbitrary parameter storage used for reporting. Values may appear sanitized and trimmed, so we recommend adhering to these guidelines when sending data: Prefer values that are lowercase. Do not include leading/trailing whitespace, or avoid whitespace entirely if possible. Do not use special characters.
`source`	Tertiary arbitrary field that works the same as a standard “Sub ID” field. This field is typically used to record a campaign or page designation.
`aff_click_id`	When defined, will override the “Transaction ID” value. Only used in specialized cases.