Conversion data use scenarios

Introduction

AppsFlyer provides conversion data for first-time installs and re-targeting conversions. The conversion data contains certain fields that you can use to identify which media source drives the install and what type of install it is.

Knowing what media source and what campaigns your users come from helps you customize the user experience. You can send users to specific activities and serve them with customized content based on data from the conversion payload.

This article lists various conversion scenarios. A sample conversion data payload is presented for each scenario. Examine the samples to learn how to identify and distinguish between conversion scenarios.

 Note

The Get Conversion Data API should be used for deferred deep linking purposes only.

For attribution data collection it is the least accurate method, as it is required to determine attribution in a few seconds, which is not always possible.

For the best attribution data collection results, we recommend using Push API. 

Obtaining conversion data

There are three ways to get conversion data:

  1. The AppsFlyer SDK returns the payload through two dedicated methods:
    • conversionData - for User Acquisition (UA) and re-attribution conversions
      • Android -  onConversionDataSuccess - see method reference
        Note: Starting SDK V5, onConversionDataSuccess is the name of the method for getting conversion data. If you are using an SDK version lower than 5.0.0, the name of the method is onInstallConversionDataLoaded . We recommend that you upgrade to SDK 5.0.0. To learn more, click here.
      • iOS -  onConversionDataSuccess - see method reference
        Note: Starting SDK V5, onConversionDataSuccess is the name of the method for getting conversion data. If you are using an SDK version lower than 5.0.0, the name of the method is onConversionDataReceived. We recommend that you upgrade to SDK 5.0.0. To learn more, click here.
      • Unity -  loadConversionData - see method reference
    • onAppOpenAttribution - for re-engagement conversions
  2. Raw Data Reports:
  3. Push API:

  Important!

This article focuses on the conversion data payload that comes from the SDK.

Payload fields

Default fields

The payload contains default fields that always appear in it. For regular ad networks where an attribution Link is used, if the campaign and media_source fields are not specified in the attribution link, their value in the payload is "None".

  Example

{ 
    "adgroup": null,
    "campaign": "awesome_campaign",
    "media_source": "super_media_source",
    "retargeting_conversion_type": "none",
    "adset_id": null,
    "campaign_id": 1234,
    "iscache": true,
    "install_time": "2019-11-11 15:00:59.828",
    "adgroup_id": null,
    "af_sub5": null,
    "click_time": "2019-11-11 15:00:35.102",
    "agency": null,
    "cost_cents_USD": "0",
    "advertising_id": "215***-****-****-****-*******",
    "adset": null,
    "af_sub3": null,
    "af_siteid": null,
    "http_referrer": null,
    "orig_cost": "0.0",
    "af_sub4": null,
    "af_cpi": null,
    "af_sub1": "promo",
    "af_click_lookback": "7d",
    "af_sub2": null,
    "af_status": "Non-organic"
}

The payload above is the basic conversion data payload.

  Important!

When cost data is not available, the fields orig_cost , costs_cents_USD , and af_cpi have the value of 0.

For these fields to be populated with values, the ad network needs to share cost data with AppsFlyer. In order for the ad network to share costs with AppsFlyer, you need to enable this option. See the list of ad networks that support cost sharing.

However, some networks that do support cost sharing send cost data in bulk . In such cases, the fields appear in the payload but their value is 0.

Additional fields

You can add any parameter that you wish to the attribution link. AppsFlyer parses these parameters and adds them to the payload. For your convenience, you can use parameters from a predefined list.

Conversion data mapping to raw data reports and Facebook parameters

If you want to match the values of conversion data parameters across AppsFlyer and Facebook reports, use the table below:

Conversion data AppsFlyer raw data Facebook
campaign campaign campaign_group_name
campaign_id Campaign ID campaign_group_id
adgroup Ad adgroup_name
adgroup_id Ad ID adgroup_id
adset Adset campaign_name
adset_id Adset ID campaign_id
ad_id AD ID ad_id
agency Partner N/A
is_fb Media Source is_fb
af_channel Channel publisher_platform

Click time field

The click_time field indicates the time (in UTC) of engagement, whether a click or impression.

Install time field

The install_time field indicates the time (in UTC) when the user first launches the app after installing it.

AF Status Field

The af_status field indicates whether the install comes from an organic source or a paid source like a media source.

The next sections demonstrate various conversion scenarios and their corresponding conversion data payload:

  1. User Acquisition
  2. Retargeting
Was this article helpful?
1 out of 1 found this helpful