Available Macros on AppsFlyer's Postbacks

AppsFlyer Attribution Postback Macros

When mobile users install or perform in-app events AppsFlyer sends postbacks to the originating networks or to other endpoints, which may include a wide array of macros.

Below you can find the full list of AppsFlyer's supported macros.

Installs and In-App Events Macros

Macro Device/App Specific Info Macros

(idfa)

iOS unique identifier.
Also available as: (sha1-idfa)

(advertiserId)

Android GAID unique identifier.
Also available as: (sha1-advertiserId)

(android-id)

Android ID unique identifier.
Also available as: (sha1-android-id)

(app-id)

Name of the app id Android or iOS

(wifi)

Type of data connection used by the user on conversion ("TRUE" or "FALSE")

(install-unix-ts)

Time of install (first app open)in UNIX

(click-ts)

Click or impression time on AppsFlyer tracking link

(campaign)

Campaign name as sent in AppsFlyer tracking link (c=)

(country-code)

Two-character country code on conversion

(city)

City of user device recorded on conversion

(device-brand)

Device brand of user device recorded on conversion

(carrier)

Service provider for the device (such as "AT&T")

(ip)

IP of the user device recorded on conversion

(device-model)

Model of the user device recorded on conversion

(language)

Name of the language used on the user device recorded on conversion

(appsflyer-device-id)

AppsFlyer unique identifier recorded on conversion

(sdk-version)

AppsFlyer SDK version

(app-version-name)

App version setup by app developer in the app's code

(user-agent)

The User-Agent format (e.g. "Mozilla/5.0 (iPad)"

(vendorId)

ID for vendors such as IDFV for iOS

(os-version)

The version name of the Operating System

(app-name)

The name of the application

(match-type)

The attribution match type (e.g DeviceID, Referrer, Fingerprint)


In-App Events Only Macros

Macro Description

(event-name)

Name of the event triggered from the app

(monetary)

Event value in USD

(orig-monetary)

Event value in original currency as configured in application

(currency)

Event Currency code

(timestamp)

The time of the in-app event

(event-value)

Enhanced rich in app event includes the entire JSON values 
of each in app event (encode) - example where (event-name) is af_purchase:
&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

Encoded Values

Postbacks may need to contain irregular characters, which are not alpha-numerical. To accurately transfer these values via the postbacks AppsFlyer URL-encodes non alpha-numerical values in postbacks. 

If you wish to decode an encoded postback, or encode a decoded postback, you can use any free encoding web service, such as this.

Sample Postbacks

General Install Postback Examples

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

General In-App Event Postback Examples

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&
install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&
json=(event-value)

Rich In-App Event Postback Example

Event Parameters:

Event Name: af_revenue
Event Revenue: 120.00
Event Currency: USD
Event Value: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A
Was this article helpful?
3 out of 3 found this helpful

Comments

0 comments

Please sign in to leave a comment.