Server to Server (S2S) Postback Integration (English)

This guide explains how to set up server to server (S2S) postback integration with Appier. If your are a Mobile Measurement Partner (MMP) or an advertiser that is capable of performing event attribution, then this document is relevant for you.

The two main goals in S2S integration are as follows:

1. Design impression and click trackers that utilize Appier macros to deliver data to your system.

2. Design a postback URL meant for Appier. Postbacks provide event information pertaining to attribution and the contextual properties of the relevant app and user behavior.

Macros which Appier supports Please reference the table below. These macros are the values that Appier can supply to you via the impression and click trackers.

Name (* denotes required value)	Description	Macro Value (for your Click Tracker)
Click ID*	Appier click ID Note: This value can be up to 400 bytes. Please make sure your system can accommodate this.	${short_id}
Apple IDFA	Apple iOS IDFA Note: This value is not always sent, as it depends on the publisher/RTB exchange used. If it is a hard requirement every tracking link requires IDFA for a particular offer, please let us know	${idfa_upper}
Google Advertising ID	Android Google AID Note: Appier uses same macro for IDFA and Google AID. The correct value is replaced accordingly. Note: This value is not always sent, as it depends on the publisher/RTB exchange used. If it is a hard requirement every tracking link requires IDFA for a particular offer, please let us know.	${idfa_lower}
Publisher ID	Encrypted value of the publisher that served Ad	${partner_id}
Channel ID	Encrypted value of the app/site/channel of the publisher that served the ad Note: this value may or may not be passed depending on publisher.	${channel_id}

Note: partner and channel id will be given in the format as ${partner_id}_${channel_id}, please make sure your system can support this format.

Tracking link Example http://yourtrackerdomain.com/?click_id=${short_id}&ios_idfa=${idfa_upper}&source=${partner_id}_${channel_id}

Postback URL

Name (* denotes required value)	Description	Postback Parameter
Click ID*	Appier click ID	asi
Apple IDFA	Apple iOS IDFA Note: In postback sent to Appier, it is okay to have multiple idfa, since same parameter is used for GAID and IDFA. Please see postback example below	idfa
Google Advertising ID	Android Google AID Note: In postback sent to Appier, it is okay to have multiple idfa, since same parameter is used for GAID and IDFA. Please see postback example below.	idfa
IP	Device IP Note: Please make sure it is the device IP, NOT the Tracking service or other IP.	ip
Carrier	User carrier	carrier
Revenue	Purchase revenue	x_rv
Currency	Purchase currency	appier_cu
OS	Device OS e.g. Android or iOS	os
iOSアプリID	iOSアプリID	ios_app_id
Android Package Name	Android app package name	android_package_name
Action ID*	Event id Note: a。システムが複数のイベントのポストバッキングをサポートできる場合は、各イベントを判別できるように、動的マクロをAppierに提供してください。例：{event_id}例：オープンイベント：「open」、購入イベント：「purchase」 a。できない場合は、action_id=Majorとしてハードコーディングしてください	action_id

Postback URL Example Note: Please fill in the correct macro you system uses corresponding to the definition above. https://post0.track.appier.net/limit?asi={click_id}&idfa={ios_idfa}&action_id={event_id}&carrier={carrier}&os={platform}&x_rv={revenue}&appier_cu={currency}&ios_app_id={app_id}

Once you have a postback URL designed that fits your purposes and capabilities, please provide this URL to your Appier contact window.

Note on providing non-attributed postbacks In order to provide the best optimization possible for your campaign, we encourage clients to send non-attributed events to Appier. This provides Appier with user behavioral data, and it allows Appier AI to analyze, identify, and target users that have similar behaviors and interests.

In order to send non-attributed data, please send the same postback URL to Appier, except do not include any click-level data (since the event is not attributed to Appier, there is no applicable value for the click ID). Following the postback URL example above, if a purchase event occurs that is not attributed to Appier, please send: https://post0.track.appier.net/limit?asi=&idfa={ios_idfa}&action_id={event_id}&carrier={carrier}&os={platform}&x_rv={revenue}&appier_cu={currency}&ios_app_id={app_id}

For integration questions, please reach out to the Technical Solutions team at: [email protected]