Get conversion data using AppsFlyer SDK

At a glance: The platform provides conversion data of first-time installs, re-engagements and re-attributions (reinstalls). Use conversion data to identify the media source driving the install and the install type.

Learn how to identify and distinguish different conversion scenarios.

Use conversion data to:

  • Customize the user experience
  • Send users to specific activities
  • Serve them with customized content

Use get conversion data API primarily for deferred deep linking, as it is a low latency, low accuracy method of getting conversion data. For higher accuracy, higher latency data use Push API.

Due to the accuracy/latency tradeoff, conversion data for the same device IDs might differ across APIs.

Get conversion data

Conversion data is made available in the platform using any of the following:

  • Raw-data reports:
  • Push API:
  • The AppsFlyer SDK returns conversion data using the following:
    • onConversionDataSuccess: User Acquisition (UA) and re-attribution conversions
      • Android: onConversionDataSuccess
        Note: Starting from SDK V5, the conversion data method name is onConversionDataSuccess. For SDK versions lower than 5.0.0, the method name is onInstallConversionDataLoaded.
      • iOS: onConversionDataSuccess
        Note: Starting from SDK V5, the conversion data method name is onConversionDataSuccess. For SDK versions lower than 5.0.0, the method name is onConversionDataReceived
      • Unity: loadConversionData
    • onAppOpenAttribution: For re-engagement conversions

Conversion data payload attributes

Attributes in the table that follows always exist, irrespective of the conversion origin.

Attributes always available
Payload attribute name Raw-data field name Remarks
media_source Media source

Attributed publisher. Equivalent to pid in attribution links

install_time Install time  
click_time Attributed touch time Time that a click or impression occurred in UTC
is_first_launch N/A true, false
af_status

Raw-data is divided into separate reports: organic, non-organic

"Organic", "Non-organic"
af_siteid Site ID  
adgroup_id Ad ID  
adset Adset  
adset_id Adset ID  
agency Partner null, or agency name (for campaigns run by agencies)
campaign Campaign  
campaign_id Campaign ID  
http_referrer HTTP Referrer  
retargeting_conversion_type Retargeting Conversion Type "none", or retargeting_conversion_type
af_sub[n] (n=1—5) Sub Param [n] (n=1–5)  

The attributes in the table that follows are available in some cases, depending on how the SRN populates the individual event. 

Attributes available in some cases
Payload attribute name Raw-data field name Remarks
af_channel Channel

SRNs populating this parameter:

  • Facebook
  • Google 
  • Snapchat
  • Twitter
  • Applovin

Example: Facebook—Instagram, Google—YouTube 

orig_cost  

Note (1)

costs_cents_USD  

Note (1)

af_cpi  

Note (1)

Note

(1) Cost attributes are populated with values shared by the ad network. In order for the ad network to share cost with AppsFlyer, you must enable cost integration in the integrated partners page. Some SRNs support cost-sharing in bulk. In this case, event-level cost attributes return as 0. 

Additional attributes

See raw-data fields dictionary for additional information.

The following sections contain various user conversion scenarios and their corresponding conversion data payloads:

Was this article helpful?