Swaarm Integration with an Advertiser using Affise:
To integrate your Swaarm network with Affise, you need to update the Affise tracking link provided by the advertiser with the corresponding Swaarm macros and implement the link in the offer details page. On the other hand, you need to share your postback link with your advertiser with the parameters supported by Swaarm.
Attribution Link Template (Affise):
In the Affise tracking link URL, you need to pass {id} macro to pass your own click ID. You can pass the click ID value using one of the free sub-account parameters: &sub1 - &sub8.
Click/Tracking Link-Template (with privacy-enabled/Probabilistic functionality):
https://yournetwork.g2afse.com/click?pid=1234&offer_id=1234&sub1={id}&sub2={publisher.id}_{publisher.subId}&sub3={publisher.app}&sub8={pea.chain}_, |
In the following articles, you will get additional macros supported by Swaarm and the tracking parameters supported by Affise for the tracking URL which you can use to pass the required information.
Global Postback (Default & Event) for Affise Advertisers:
Swaarm supports one single postback to track default, post-install events, and probabilistic conversions. No need to setup multiple postbacks for any Affise Advertisers.
Here is the sample Global Postback link for Affise Advertisers:
https://yournetwork.com/postback?click_id={sub1}&event_id={goal}&sale_amount={sum}&pea_chain={sub8} |
You can add additional macros based on your Advertiser's requirements. Additional parameters and macros supported by Swaarm can be found in the following link:
Swaarm Integration with a Publisher using Affise
In order for the publisher to receive the clicks/impressions and attribute postbacks accordingly, you need to use the corresponding parameters and macros in tracking links and the postback links.
Offer Tracking Links for Publishers
For click and impressions both, there is some basic information, for example, publisher click ID, publisher ID, publisher subID etc. But some additional parameters are also needed, for example, ext_offer_id and ext_publisher_id when the click-id attribution is not possible.
The ext_offer_id the parameter is supposed to hold the ID of the publisher's offer as defined in Affise. For ext_publisher_id this is supposed to hold the Affise partner's publisher ID.
Here is an example tracking link:
http://yournetwork.trckswrm.com?offer_id=123&pub_id=23&ext_offer_id={offer_id}&ext_pub_id={pid}&pub_sub_id={pid}&pub_click_id={click_id}&idfa=[Publisher_idfa_macro]&gaid=[Publisher_gaid_macro]
Publisher Postback links
There are two Global Postbacks are needed to integrate Affise publishers on Swaarm.
General Global postback for click/impression ID attribution
This postback needs to be placed to send the conversions that are attributed based on click/impression ID. We highly recommend adding eventType.Id and payout.theyGetInDollars macros in order to avoid any further discrepancies with publishers
Here is an example Publisher postback link for General attribution:
https://publisher.affise.com/postback?clickid=#{click.publisher.clickId}&goal=#{offer.eventTypeId}&sum=#{payout.theyGetInDollars}
Some related articles might help,
Global Postback for Privacy-enabled/Probabilistic Attribution
The information that was received in the click/impression should be passed back via a postback. Since we are not allowed to send any unique ID back in such attribution, we can send #{ext.offerId} and #{ext.publisherId} macros to get attributed based on a probabilistic model. To ensure no duplicate counting occurs, you should also send the postback ID using the #{id} macro.
Here is an example postback link for Probabilistic attribution:
https://publisher.affise.com/probattribution?action_id=#{id}&goal=#{offer.eventTypeId}&offer_id=#{ext.offerId}&pid=#{ext.publisherId}&sum=#{payout.theyGetInDollars}
Note: The event ID macro (#{offer.eventTypeId}) will be replaced by #{eventType.advertiserEventTypeId} for only migrated clients who have been transferred from any other tracking platform other than Swaarm.
You can add additional macros based on your publisher's requirements. Additional parameters and macros supported by Swaarm and Affise can be found in the following link:
> Affise Postback URL Parameters
If you have any more questions about this integration, please don't hesitate to contact our Technical Client Service Team via email (support@swaarm.com).