Push APIs - Installation and Conversion Notification APIs

  • Advertisers
  • Developers

push-api-1-1.svg

Introduction

You can sync your attribution and marketing analytics data with your internal data platforms using Push API.

Push API enables advertisers to receive raw data messages via an HTTP request from AppsFlyer to any endpoint. A push API message can be sent upon every successful installation, in-app event or retargeting event, whether organic or not.

Messages are sent in near real-time, meaning that usually they are sent within a few seconds of the performed action, but may take up to two minutes.

The data is sent, by default, via an http POST or GET method and is JSON formatted. 

For the complete list of fields and message examples click here.

For field descriptions please read this.

 Tip

By selecting Retargeting + In-app events all events following a user's re-engagement are sent. However, to send the initial re-engagement event itself read here.

Who Should Use Push API?

  1. Advertisers who need accurate attribution data sent to their servers in near real time 
    Combine your users' data with detailed AppsFlyer's attribution data as it happens, especially for analytics and segmentation purposes. [If you base your app's flow on the attribution data in real time, i.e. within 5 seconds of first app open, it is better to use AppsFlyer's conversion data API instead]

  2. Advertisers with complex data bases 
    If you need your data to be sent to different data bases in your system to collect install/in-app event/organic/non-organic data, Push API can do this with a simple 2 minute configuration saving you precious developing resources.

  3. Advertisers working with external data collection platforms
    With Push API you can send any install or event data to external systems by simply supplying their endpoint URL

 Note

The Push API is an AppsFlyer premium feature, which can be purchased as part of the API Access package. The package is available for free to advanced account tiers.
Please contact your CSM or AppsFlyer's support if you require more details. 

Push API Configuration

To configure your push API preferences follow the following steps:

1. On the dashboard, from the left hand menu under Integration select API Access

api_access_link.png

2. Scroll down to the Push API section and click Add Postback.

3. Choose the data you are interested to send. 
You can configure up to 4 different postbacks for organic and non-organic installs and in-app events. If you enable retargeting attribution in app settings, you can configure up to 6 different postbacks.  

push_api.png

 Note

Push API only supports the use of port 80 and 443.

4. Enter the endpoint's URL to receive these postbacks.

5. Click Save.

After you save the changes, upon every conversion the data is sent to your endpoint's URL in the format provided in this document.

 Note

Additional fields may be added to the JSON structure from time to time without prior notice. Please Follow this article to get informed of any API changes.

Currently API key parameters are not supported as part of the push API.

 Warning

If the receiving client fails to collect the push message correctly it can't be resent. In case your client has some down time and loses push messages, you can always fill out the gaps using pull API.

IP Whitelisting

We recommend to whitelist AppsFlyer's IPs in your internal networks / platforms in order to successfully receive the Push API calls from AppsFlyer.

Visit the following link for the updated list of AppsFlyer's IPs.

TLS Support

AppsFlyer's Push API supports the following TLS versions
  • 1.0
  • 1.1
  • TLS v1.0 
Handshake fails if the target endpoint supports only TLS v1.2 (ensure your endpoints support the earlier versions too).

Push API Structure

The Push API supports in-app events data in addition to installation data, both for organic and non-organic installs. It also sends retargeting campaign data, showing re-attributions and re-engagements.

Supported Fields

The table below shows all the available fields via Push API for organic or non-organic events.

Y - the field exists with a real or "null" value

N - the field doesn't exist or has a "null" value 

Field Non-Organic Install FB Install TW Install Organic Install Non-Organic In-App FB In-App TW In-App Organic In-App
attributed_touch_type Y Y Y N Y Y Y N
attributed_touch_time Y Y Y N Y Y Y N
event_type Y Y Y Y Y Y Y Y
attribution_type
(Organic or Regular)
Y Y Y Y Y Y Y Y
click_time Y Y Y Y Y Y Y Y
download_time Y Y Y Y Y Y Y Y
install_time Y Y Y Y Y Y Y Y
media_source Y Y Y Y Y Y Y Y
agency Y Y Y Y Y Y Y Y
af_channel Y Y Y N Y Y Y N
af_keywords Y Y Y  iOS: Y
And: N
Y Y Y N
campaign Y Y Y Y Y Y Y Y
af_c_id Y Y Y N Y Y Y N
af_adset Y Y Y N Y Y Y N
af_adset_id Y Y Y N Y Y Y N
af_ad Y Y Y N Y Y Y N
af_ad_id Y Y Y N Y Y Y N
fb_campaign_name Y Y Y Y Y Y Y Y
fb_campaign_id Y Y Y Y Y Y Y Y
fb_adset_name Y Y Y Y Y Y Y Y
fb_adset_id Y Y Y Y Y Y Y Y
fb_adgroup_name Y Y Y Y Y Y Y Y
fb_adgroup_id Y Y Y Y Y Y Y Y
af_ad_type Y Y Y N Y Y Y N
af_siteid Y Y Y Y Y Y Y Y
af_sub1 Y Y Y Y Y Y Y Y
af_sub2 Y Y Y Y Y Y Y Y
af_sub3 Y Y Y Y Y Y Y Y
af_sub4 Y Y Y Y Y Y Y Y
af_sub5 Y Y Y Y Y Y Y Y
http_referrer Y Y Y Y Y Y Y Y
click_url Y Y Y Y Y Y Y Y
af_cost_model Y N N N Y Y Y N
af_cost_value Y N N N Y Y Y N
af_cost_currency Y N N N Y Y Y N
cost_per_install Y N N Y Y Y Y Y
is_retargeting Y Y Y Y Y Y Y Y
re_targeting_conversion
_type
Y Y Y Y Y Y Y Y
country_code Y Y Y Y Y Y Y Y
city Y Y Y Y Y Y Y Y
ip Y Y Y Y Y Y Y Y
wifi Y Y Y Y Y Y Y Y
mac Y Y Y Y Y Y Y Y
operator Y Y Y Y Y Y Y Y
carrier Y Y Y Y Y Y Y Y
language Y Y Y Y Y Y Y Y
appsflyer_device_id Y Y Y Y Y Y Y Y
advertising_id Y Y Y Y Y Y Y Y
android_id Y Y Y Y Y Y Y Y
customer_user_id Y Y Y Y Y Y Y Y
imei Y Y Y Y Y Y Y Y
idfa Y Y Y Y Y Y Y Y
platform Y Y Y Y Y Y Y Y
device_brand Y Y Y Y Y Y Y Y
device_model Y Y Y Y Y Y Y Y
os_version Y Y Y Y Y Y Y Y
app_version Y Y Y Y Y Y Y Y
sdk_version Y Y Y Y Y Y Y Y
app_id Y Y Y Y Y Y Y Y
app_name Y Y Y Y Y Y Y Y
bundle_id Y Y Y Y Y Y Y Y
event_time Y Y Y Y Y Y Y Y
event_name Y Y Y Y Y Y Y Y
event_value Y Y Y Y Y Y Y Y
currency Y Y Y Y Y Y Y Y

download_time_selected
_timezone

Y Y Y Y Y Y Y Y
click_time_selected
_timezone
Y Y Y Y Y Y Y Y
install_time_selected
_timezone
Y Y Y Y Y Y Y Y
event_time_selected
_timezone
Y Y Y Y Y Y Y Y
selected_currency Y Y Y Y Y Y Y Y
revenue_in_selected
_currency
N N N N Y Y Y Y
cost_in_selected_currency Y Y Y Y N N N N

Push API Specific Parameters

Some Push API parameters are called differently than in the V5 reports. There are also several parameters that exist on Push API, but not on other V5 sources. You can find them in the table below. 

Push API Field Name V5 Field Name Description
fb_campaign_name N/A Facebook campaign name*
fb_campaign_id N/A Facebook campaign ID number*
fb_adset_name N/A Facebook ad set name*
fb_adset_id N/A Facebook ad set ID number*
fb_adgroup_name N/A Facebook ad group name*
fb_adgroup_id N/A Facebook ad group ID*
event_type N/A install/in-app-event
attribution_type N/A Organic or Regular(non-organic)
click_time attributed_touch_time Attributed touch time
download_time N/A Timestamp of the device install time in UTC timezone (right after the download finishes)
agency  af_prt Name of the attributed agency 
cost_per_install af_cost_value Cost in original currency
re_targeting_conversion_type retargeting_conversion_type Re-engagement / Re-attribution
appsflyer_device_id appsflyer_id Unique app installation identifier per device 
currency af_cost_currency USD
selected_currency N/A Currency specified in the event or for the app in the dashboard
revenue_in_selected_currency event_revenue_currency Revenue in the currency selected for the app in the dashboard
cost_in_selected_currency af_cost_value Cost in the currency selected for the app in the dashboard
download_time_selected_timezone N/A Time of download in the time zone selected for the app
click_time_selected_timezone attributed_touch_time Time of the ad click in the time zone selected for the app
install_time_selected_timezone install_time Time of the first app launch in the time zone selected for the app
event_time_selected_timezone event_time Time of the event occurrence in the time zone selected for the app
device_name N/A Name of the device as entered by the user - always appears as Null.

* All the "Facebook" parameters, such as fb_campaign_name, fb_campaign_id or fb_adgroup_id, only get values when the user is attributed to Facebook.

Push API Examples

Below you can find examples of Push API messages sent on various Android and iOS related scenarios for your reference.

Organic Install

Android iOS
{
    "mac": "null",
    "af_sub1": "null",
    "customer_user_id": "null",
    "bundle_id": "com.appsflyer.sampleapp",
    "app_version": "1.0",
    "city": "London",
    "fb_campaign_id": "null",
    "device_model": "Nexus 5s",
    "selected_currency": "GBP",
    "app_name": "com.appsflyer.sampleapp",
    "install_time_selected_timezone": "2018-12-10 13:03:29.048+0000",
    "wifi": "false",
    "install_time": "2018-12-10 13:03:29",
    "operator": "Android",
    "fb_adgroup_id": "null",
    "currency": "null",
    "attributed_touch_type": "null",
    "re_targeting_conversion_type": "null",
    "attributed_touch_time": "null",
    "click_time_selected_timezone": "null",
    "is_retargeting": "false",
    "country_code": "UK",
    "event_type": "install",
    "appsflyer_device_id": "1544447000267-7591600316524850138",
    "http_referrer": "null",
    "af_sub5": "null",
    "fb_campaign_name": "null",
    "click_url": "null",
    "media_source": "Organic",
    "campaign": "null",
    "af_keywords": "null",
    "cost_in_selected_currency": "null",
    "event_value": "null",
    "ip": "1.1.1.1",
    "event_time": "2018-12-10 13:03:29",
    "click_time": "null",
    "af_sub4": "null",
    "imei": "null",
    "fb_adgroup_name": "null",
    "af_sub2": "null",
    "attribution_type": "organic",
    "android_id": "null",
    "fb_adset_id": "null",
    "agency": "null",
    "fb_adset_name": "null",
    "cost_per_install": "null",
    "device_brand": "google",
    "download_time": "2018-12-10 13:03:15",
    "af_siteid": "null",
    "language": "English",
    "app_id": "com.appsflyer.sampleapp",
    "carrier": "Android",
    "event_name": "null",
    "advertising_id": "92dd7aa9-8f6c-4f13-bc21-11a8c817120b",
    "os_version": "8.1.0",
    "platform": "android",
    "af_sub3": "null",
    "download_time_selected_timezone": "2018-12-10 13:03:15.000+0000",
    "sdk_version": "v4.8.15",
    "event_time_selected_timezone": "2018-12-10 13:03:29.048+0000"
    }
    

Non-Organic Install

Android iOS
{
"mac": "null", "af_sub1": "null", "customer_user_id": "null", "bundle_id": "com.appsflyer.sampleapp", "af_cost_value": "null", "app_version": "1.0", "city": "London", "fb_campaign_id": "null", "device_model": "Nexus 5s", "af_cost_model": "null", "af_c_id": "null", "selected_currency": "GBP", "app_name": "com.appsflyer.sampleapp", "install_time_selected_timezone": "2018-12-10 12:29:26.387+0000", "wifi": "true", "install_time": "2018-12-10 12:29:26", "operator": "Android", "fb_adgroup_id": "null", "currency": "null", "attributed_touch_type": "click", "af_adset_id": "null", "re_targeting_conversion_type": "null", "attributed_touch_time": "2018-12-10 12:28:22", "click_time_selected_timezone": "2018-12-10 12:28:22.177+0000", "is_retargeting": "false", "country_code": "UK", "event_type": "install", "appsflyer_device_id": "1544444957458-8234073705122860323", "http_referrer": "", "af_sub5": "null", "fb_campaign_name": "null", "click_url": "https://app.appsflyer.com/com.appsflyer.sampleapp?pid=test_media_int&c=Test&advertising_id=d1f66885-158e-47ea-aa21-62b8aea937f8", "media_source": "test_media_int", "campaign": "Test", "af_keywords": "null", "cost_in_selected_currency": "null", "event_value": "null", "ip": "1.1.1.1", "event_time": "2018-12-10 12:29:26", "click_time": "2018-12-10 12:28:22", "af_sub4": "null", "imei": "null", "fb_adgroup_name": "null", "af_sub2": "null", "attribution_type": "regular", "android_id": "null", "af_adset": "null", "fb_adset_id": "null", "af_ad": "null", "agency": "null", "fb_adset_name": "null", "cost_per_install": "null", "af_channel": "null", "af_cost_currency": "null", "device_brand": "google", "download_time": "2018-12-10 12:29:14", "af_siteid": "null", "language": "English", "app_id": "com.appsflyer.sampleapp", "af_ad_type": "null", "carrier": "Android", "event_name": "null", "advertising_id": "d1f66885-158e-47ea-aa21-62b8aea937f8", "os_version": "8.1.0", "platform": "android", "af_sub3": "null", "download_time_selected_timezone": "2018-12-10 12:29:14.000+0000", "af_ad_id": "null", "sdk_version": "v4.8.15", "event_time_selected_timezone": "2018-12-10 12:29:26.387+0000 }

Organic In-App Event

Android iOS
{
    "mac": "null",
    "af_sub1": "null",
    "customer_user_id": "null",
    "bundle_id": "com.appsflyer.sampleapp",
    "app_version": "1.0",
    "city": "London",
    "fb_campaign_id": "null",
    "device_model": "Nexus 5s",
    "selected_currency": "GBP",
    "app_name": "com.appsflyer.sampleapp",
    "install_time_selected_timezone": "2018-12-10 13:03:29.048+0000",
    "wifi": "false",
    "install_time": "2018-12-10 13:03:29",
    "operator": "Android",
    "fb_adgroup_id": "null",
    "currency": "GBP",
    "attributed_touch_type": "null",
    "re_targeting_conversion_type": "null",
    "attributed_touch_time": "null",
    "click_time_selected_timezone": "null",
    "revenue_in_selected_currency": "1234.67",
    "is_retargeting": "false",
    "country_code": "UK",
    "event_type": "in-app-event",
    "appsflyer_device_id": "1544447000267-7591600316524850138",
    "http_referrer": "null",
    "af_sub5": "null",
    "fb_campaign_name": "null",
    "click_url": "null",
    "media_source": "Organic",
    "campaign": "null",
    "af_keywords": "null",
    "event_value":{
        "af_content_id":"298270",
        "af_date_b":"08-07-2017",
        "af_customer_user_id":"3f83****-****-****-****-*******",
        "af_revenue":"140.25,
        "af_price":"140.25",
        "af_currency":"GBP"
    },
    "ip": "1.1.1.1",
    "event_time": "2018-12-10 13:04:11",
    "click_time": "null",
    "af_sub4": "null",
    "imei": "null",
    "fb_adgroup_name": "null",
    "af_sub2": "null",
    "attribution_type": "organic",
    "android_id": "null",
    "fb_adset_id": "null",
    "agency": "null",
    "fb_adset_name": "null",
    "cost_per_install": "null",
    "device_brand": "google",
    "download_time": "2018-12-10 13:03:15",
    "af_siteid": "null",
    "language": "English",
    "app_id": "com.appsflyer.sampleapp",
    "carrier": "Android",
    "event_name": "af_purchase",
    "advertising_id": "92dd7aa9-8f6c-4f13-bc21-11a8c817120b",
    "os_version": "8.1.0",
    "platform": "android",
    "af_sub3": "null",
    "download_time_selected_timezone": "2018-12-10 13:03:15.000+0000",
    "sdk_version": "v4.8.15",
    "event_time_selected_timezone": "2018-12-10 13:04:11.849+0000
}
    

Non-Organic In-App Event

Android iOS
{
    "mac": "null",
    "af_sub1": "null",
    "customer_user_id": "null",
    "bundle_id": "com.appsflyer.sampleapp",
    "af_cost_value": "null",
    "app_version": "1.0",
    "city": "New York",
    "fb_campaign_id": "null",
    "device_model": "Nexus 5s",
    "af_cost_model": "null",
    "af_c_id": "null",
    "selected_currency": "GBP",
    "app_name": "com.appsflyer.sampleapp",
    "install_time_selected_timezone": "2018-12-10 12:29:26.387+0000",
    "wifi": "true",
    "install_time": "2018-12-10 12:29:26",
    "operator": "Android",
    "fb_adgroup_id": "null",
    "currency": "GBP",
    "attributed_touch_type": "click",
    "af_adset_id": "null",
    "re_targeting_conversion_type": "null",
    "attributed_touch_time": "2018-12-10 12:28:22",
    "click_time_selected_timezone": "2018-12-10 12:28:22.177+0000",
    "revenue_in_selected_currency": "1234.67",
    "is_retargeting": "false",
    "country_code": "US",
    "event_type": "in-app-event",
    "appsflyer_device_id": "1544444957458-8234073705122860323",
    "http_referrer": "",
    "af_sub5": "null",
    "fb_campaign_name": "null",
    "click_url": "https://app.appsflyer.com/com.appsflyer.sampleapp?pid=test_media_int&c=Test&advertising_id=d1f66885-158e-47ea-aa21-62b8aea937f8",
    "media_source": "test_media_int",
    "campaign": "Test",
    "af_keywords": "null",
    "event_value": {
        "af_content_id":"298270",
        "af_date_b":"08-07-2017",
        "af_customer_user_id":"3f834809-5b7e-4eef-acd7-*******",
        "af_revenue":"140.25",
        "af_price":"140.25",

    },
    "ip": "1.1.1.1",
    "event_time": "2018-12-10 12:29:36",
    "click_time": "2018-12-10 12:28:22",
    "af_sub4": "null",
    "imei": "null",
    "fb_adgroup_name": "null",
    "af_sub2": "null",
    "attribution_type": "regular",
    "android_id": "null",
    "af_adset": "null",
    "fb_adset_id": "null",
    "af_ad": "null",
    "agency": "null",
    "fb_adset_name": "null",
    "cost_per_install": "null",
    "af_channel": "null",
    "af_cost_currency": "null",
    "device_brand": "google",
    "download_time": "2018-12-10 12:29:14",
    "af_siteid": "null",
    "language": "English",
    "app_id": "com.appsflyer.sampleapp",
    "af_ad_type": "null",
    "carrier": "Android",
    "event_name": "af_purchase",
    "advertising_id": "d1f66885-158e-47ea-aa21-62b8aea937f8",
    "os_version": "8.1.0",
    "platform": "android",
    "af_sub3": "null",
    "download_time_selected_timezone": "2018-12-10 12:29:14.000+0000",
    "af_ad_id": "null",
    "sdk_version": "v4.8.15",
    "event_time_selected_timezone": "2018-12-10 12:29:36.866+0000"
}
    

Re-Attribution

Android iOS
{
    "mac": null,
    "af_sub1": null,
    "customer_user_id": null,
    "bundle_id": "com.appsflyer.sampleapp",
    "af_cost_value": null,
    "app_version": "1.0",
    "city": "New York",
    "fb_campaign_id": null,
    "device_model": "Mi 4i",
    "af_cost_model": null,
    "af_c_id": null,
    "selected_currency": "GBP",
    "app_name": "com.appsflyer.sampleapp",
    "install_time_selected_timezone": "2018-12-11 06:06:39.133+0000",
    "wifi": true,
    "install_time": "2018-12-11 06:06:39",
    "operator": "",
    "fb_adgroup_id": null,
    "currency": null,
    "attributed_touch_type": "click",
    "af_adset_id": null,
    "re_targeting_conversion_type": "re-attribution",
    "attributed_touch_time": "2018-12-11 06:01:47",
    "click_time_selected_timezone": "2018-12-11 06:01:47.707+0000",
    "is_retargeting": true,
    "country_code": "US",
    "event_type": "install",
    "appsflyer_device_id": "1544508394386-1519328529373075073",
    "af_sub5": null,
    "fb_campaign_name": null,
    "click_url": "https://app.appsflyer.com/com.appsflyer.sampleapp?pid=test_media_int&c=ret_campaign&is_retargeting=true&advertising_id=cee63a2a-9cf8-40ec-b526-7af7c0da0b9b",
    "media_source": "test_media_int",
    "campaign": "ret_campaign",
    "af_keywords": null,
    "cost_in_selected_currency": null,
    "event_value": null,
    "ip": "1.1.1.1",
    "event_time": "2018-12-11 06:06:39",
    "click_time": "2018-12-11 06:01:47",
    "af_sub4": null,
    "imei": null,
    "fb_adgroup_name": null,
    "af_sub2": null,
    "attribution_type": "regular",
    "android_id": null,
    "af_adset": null,
    "fb_adset_id": null,
    "af_ad": null,
    "agency": null,
    "fb_adset_name": null,
    "cost_per_install": null,
    "af_channel": null,
    "af_cost_currency": null,
    "device_brand": "Xiaomi",
    "download_time": "2018-12-11 06:06:31",
    "af_siteid": null,
    "language": "English",
    "app_id": "com.appsflyer.sampleapp",
    "af_ad_type": null,
    "carrier": "",
    "event_name": null,
    "advertising_id": "cee63a2a-9cf8-40ec-b526-7af7c0da0b9b",
    "os_version": "5.0.2",
    "platform": "android",
    "af_sub3": null,
    "download_time_selected_timezone": "2018-12-11 06:06:31.000+0000",
    "af_ad_id": null,
    "sdk_version": "v4.8.15",
    "event_time_selected_timezone": "2018-12-11 06:06:39.133+0000"
}

Re-Attribution In-App Events

Android iOS
{
    "mac": null,
    "af_sub1": null,
    "customer_user_id": null,
    "bundle_id": "com.appsflyer.sampleapp",
    "af_cost_value": null,
    "app_version": "1.0",
    "city": "London",
    "fb_campaign_id": null,
    "device_model": "Mi 4i",
    "af_cost_model": null,
    "af_c_id": null,
    "selected_currency": "GBP",
    "app_name": "com.appsflyer.sampleapp",
    "install_time_selected_timezone": "2018-12-11 06:06:39.133+0000",
    "wifi": true,
    "install_time": "2018-12-11 06:06:39",
    "operator": "",
    "fb_adgroup_id": null,
    "currency": "GBP",
    "attributed_touch_type": "click",
    "af_adset_id": null,
    "re_targeting_conversion_type": "re-attribution",
    "attributed_touch_time": "2018-12-11 06:01:47",
    "click_time_selected_timezone": "2018-12-11 06:01:47.707+0000",
    "revenue_in_selected_currency": 1234.67,
    "is_retargeting": true,
    "country_code": "UK",
    "event_type": "in-app-event",
    "appsflyer_device_id": "1544508394386-1519328529373075073",
    "af_sub5": null,
    "fb_campaign_name": null,
    "click_url": "https://app.appsflyer.com/com.appsflyer.sampleapp?pid=test_media_int&c=ret_campaign&is_retargeting=true&advertising_id=cee63a2a-9cf8-40ec-b526-7af7c0da0b9b",
    "media_source": "test_media_int",
    "campaign": "ret_campaign",
    "af_keywords": null,
    "event_value": 
        {
            "af_revenue":1234.67,
            "af_currency":"GBP",
            "af_content_id":"123",
            "af_content":"shoes"
        } ,
    "ip": "1.1.1.1",
    "event_time": "2018-12-11 06:07:46",
    "click_time": "2018-12-11 06:01:47",
    "af_sub4": null,
    "imei": null,
    "fb_adgroup_name": null,
    "af_sub2": null,
    "attribution_type": "regular",
    "android_id": null,
    "af_adset": null,
    "fb_adset_id": null,
    "af_ad": null,
    "agency": null,
    "fb_adset_name": null,
    "cost_per_install": null,
    "af_channel": null,
    "af_cost_currency": null,
    "device_brand": "Xiaomi",
    "download_time": "2018-12-11 06:06:31",
    "af_siteid": null,
    "language": "English",
    "app_id": "com.appsflyer.sampleapp",
    "af_ad_type": null,
    "carrier": "",
    "event_name": "Decimal_5",
    "advertising_id": "cee63a2a-9cf8-40ec-b526-7af7c0da0b9b",
    "os_version": "5.0.2",
    "platform": "android",
    "af_sub3": null,
    "download_time_selected_timezone": "2018-12-11 06:06:31.000+0000",
    "af_ad_id": null,
    "sdk_version": "v4.8.15",
    "event_time_selected_timezone": "2018-12-11 06:07:46.129+0000"
}
 

Are Retargeting Events Duplicated?

Usually, yes.

If the Retargeting in-app events box is checked, then all in-app events occurring during the re-engagement window of a retargeted user are sent with the attribution details of the retargeting network.

Simultaneously, a non-organic or an organic event is being pushed as well, if the respective in-app events box is checked. This message has the attribution details of the original media source.

 Example

Bruce installs greatapp and is attributed to awesome_network. Later, Bruce re-engages with greatapp's retargeting campaign on retar-network and performs a purchase event. The event is sent twice with the following details:
1. As a non-organic event:
Media source: awesome_network 
is_retargeting: false 
re_targeting_conversion_type:   (no value)

2. As a retargeting event:
Media source: retar_network 
is_retargeting: true 
re_targeting_conversion_type: re-engagement

How to Count Re-engagements?

Push API can automatically send re-attribution events in real time, if the Retargeting installs box is checked. You can check the Retargeting in-app events box to get by push all in-app events occurring during the re-engagement window.

However, the initial act of the re-engagement, where existing users launch the app after clicking a link, is not reported automatically.

Whenever deep linking occurs for an existing user, the onAppOpenAttribution method is called. Therefore, if you need to know when re-engagements occur, send an event from the onAppOpenAttribution method, signifying a deep linking re-engagement event.

Click here to see the recommended structure of the "re-engage" event.

What is the Supported API Security?

All Push API messages are sent using secure crypted https connections.

For more details go here

Where is the Pushed Facebook Data?

By default Facebook does not release raw user-level data, unless you accept Facebook's Terms of Service.
By doing so, you enable the sending of user-level data of installs coming from Facebook, via Push API (and to other raw data resources, as well).

Was this article helpful?
8 out of 13 found this helpful