Partner Tracking
There are several methods to track unique conversions, but click ID (or unique ID) tracking is the most widely used in the MarTech industry—and it's the method Swaarm MMP leverages.
How partner tracking works?
A user surfs the partner Ad, which has been served in an app or on the web
The user clicks on the Ad and is redirected to the Swaarm MMP
Swaarm MMP stores the partner click ID (unique ID to track the conversion) and forwards the user to the corresponding app page (web, Google Play Store or Apple AppStore or any other appstore)
The user converts/installs the app
Swaarm MMP loads the server postback url of the corresponding partner with their respective click ID to notify partner of a successful conversion
Click Parameters Supported by Swaarm for Partner Tracking Links
The following parameters are available from the Swaarm MMP to use in the partner tracking URL. In any partner tracking link offer_id
and pub_id
parameters are mandatory to use in order to redirect a successful click. The parameter pub_click_id
is mandatory to pass back the successful conversion to the partner. There are many other following parameters that can be used for partner tracking URL.
Parameter | Description | Example |
offer_id | Offer ID generated by Swaarm tracker | 12345 |
pub_id | Partner ID generated by Swaarm tracker | 1234 |
pub_click_id | click ID (Unique ID) sent by partners in order to track conversions | 0a81ad386f991aef1c191dfd60cc |
pub_sub_id | Partner sub ID
| abc123 |
pub_sub_sub_id | Partner sub sub ID | abc123_def |
placement | Partner Placement name/ID | abc_game123 |
app | Partner APP name/ID | coolgame_app |
app_store_id | App store id of Ad placement | 343204456 |
site | Partner Site ID | abc_game123 |
creative | Partner creative name/ID | coolgame_320×50 |
idfa | iOS Advertising ID | 4D6F-1226–9C60–0050E4C04654 |
gaid | Android Advertising ID | GR56-1886–9D60–005776FC0465 |
user_ip | IP of the user device | 102.109.100.2 |
user_ua | User-agent of the user device | Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1 |
user_language | Language of the user device (ISO codes are followed) | EN |
unique1 | Partner unique value1 | 0a81ad386f991aef1c191dfd60cc_0a81ad386f991ae |
unique2 | Partner unique value2 | 0a81ad386f991aef1c191dfd60cc_0a81ad386f991ae |
unique3 | Partner unique value3 | aef1c191dfd60cc_0a81ad386f991ae |
lp_id | Swaarm Landing Page ID | 65432 |
pea_chain | non-unique token generated by Swaarm platform | e6UKM7lLUwlwAWXUyNO25TCY |
user_model | Device model number of the user device | e.g. GM-9621 |
user_make | Device manufacturer name of the user device | e.g. Samsung |
user_os | Operating System of the user device | Android |
user_os_version | OS version of the user device | 9.2.2 |
Sample Partner Tracking URL:
https://yourcompanytrackingdomain/click?offer_id=32&pub_id=1&pub_sub_id=ADD_PARTNER_SUB_ID_HERE&pub_click_id=ADD_CLICK_ID_HERE&app=PASS_APP_HERE&creative=PASS_CREATIVE_HERE
Postback Macros Supported by Swaarm for Partners
The following table contains Swaarm supported exclusive set of macros that can be used to send raw data and information via real-time callbacks (or postbacks) to the partners in their parameters.
Macro Name |
Description |
Example | Availability in Privacy-Enabled Conversion |
#{id} | Swaarm Unique Postback ID (no user info provided) | Ne_tpNr2ZAAAAAF-spRETwAAAU8AAA9oAAAAXA | Yes |
#{click.publisher.clickId} | Partner click ID | ff49c078-3512-11e9-a602-114519a709ee_98_1212087_cpi | No |
#{click.publisher.id} | Partner ID | 1235 | Yes |
#{click.publisher.subId} | Partner sub ID | 10762_6eae4874d9c3 | Yes |
#{click.publisher.subSubId} | Partner sub sub ID | 10762_6eae4874d9c3_abc | No |
#{payout.theyGetInDollars} | TheyGet in dollars, the amount we pay to the partner per conversion | 1.7 | Yes |
#{payout.theyGetInDollarsExact} | TheyGet in dollars, the amount we pay to the partner per conversion with up to 12 digits precision | 1.701234 | Yes |
#{payout.theyGetInCents} | TheyGet in cents, the amount we pay to the partner per conversion | 170 | Yes |
#{payout.theyGetInCentsExact} | TheyGet in cents, the amount we pay to the partner per conversion with up to 12 digits precision | 170.1234 | Yes |
#{click.device.idfa} | IDFA | 4D6F-1226–9C60–0050E4C04654 | No |
#{click.device.gaid} | GAID | 4R45-1226–D565–0050E4C04654 | No |
#{click.publisher.site} | Partner site ID | abc_game123 | No |
#{click.publisher.app} | Partner APP name/ID | coolgame_app | No |
#{click.publisher.appId} | Partner APP ID | 343204456 | No |
#{click.publisher.creative} | Partner creative name/ID | coolgame_320×50 | No |
#{click.publisher.unique1} | Additional unique ID 1 | 0a81ad386f991aef1c191dfd60cc_0a81ad386f991ae | No |
#{click.publisher.unique2} | Additional unique ID 2 | 0a81ad386f991aef1c191dfd60cc_0a81ad386f991ee | No |
#{click.publisher.unique3} | Additional unique ID 3 | 0a81ad386f991aef1c191dfd60cc_0a81ad386f991dd | No |
#{click.time} | User clicking time tracked by Swaarm, if not available for Privacy enabled postback, click time from Advertiser postback parameter will be passed | 2 019-06-04T21:00:56 | Yes |
#{click.unixTime} | Click time in unix Timestamp format | 1576857465 | Yes |
#{time} | Postback event time | 2019-06-27 14:44:47.854 | Yes |
#{dateTime.conversionTimestamp} | Postback time in Timestamp format | 16456875856 | Yes |
#{offer.offerId} | Swaarm network Offer ID | 12345 | Yes |
#{offer.eventTypeId} | Swaarm Offer event type ID | 1234 | Yes |
#{click.user.connection.ip} | User IP | 102.192.135.251 | No |
#{click.user.device.ua} | User Device User-agent | Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1 | No |
#{click.user.device.language} | User Device Language | EN (ISO codes are followed in tracking link) | No |
#{user.connection.isp} | User Internet/Cellular Connectivity Service Provider | Verizon Internet | No |
#{click.user.geo.country} | User country info | US | No |
#{click.user.device.os} | User device OS Name | iOS | No |
#{eventType.name} | Swaarm Event type name | Registration (for Default - empty string) | Yes |
#{status.state} | Postback status | APPROVED / REJECTED | Yes |
#{peaChain} | Pea Chain value passed by the partner | e6UKM7lLUwlwAWXUyNO25TCY | Yes |
Sample Partner Postback URL
http://partnerpostbackdomain/postback?clickid=#{click.publisher.clickId}&payout=#{payout.theyGetInDollars}&event_id=#{offer.eventTypeId}&unique_id=#{click.publisher.unique1}