AppsFlyer Data Connector

Follow
Avatar
Vaibhav Gupta
Updated

Learn how Singular pulls data from AppsFlyer and shows it in your reports.

 

Quick Details

Data Connector Technology API (AppsFlyer Pull API; Master API and Cohort API if available)
Data breakdown (segmentation)

The data is available in the following breakdowns:

  • App
  • Campaign
  • Country
  • Agency
  • Sub-Campaign ("Ad Set") - only available for Facebook campaigns
  • Creative ("Ad") - only available for Facebook campaigns
Time zone UTC by default, but can be changed in the AppsFlyer dashboard. Singular identifies the time zone and pulls the data properly
Currency USD by default, but can be changed per app in the AppsFlyer dashboard. Singular identifies the currency and pulls the data properly
Known Limitations/ Issues

If you don't have access to AppsFlyer's Master API: 

  • Harsh rate limit (if you have a large number of apps you may experience delays getting your daily data)

If you don't have access to AppsFlyer's Cohort API:

  • No cohort data or SKAdNetwork data.

If you have access to both:

  • Cohort data and SKAdNetwork data are available but usually delayed by two days. This is because the Master API does not provide data for the past two days. Therefore, Singular uses a combination of queries: we use the Pull API for today and yesterday, and the Master API for previous days. Singular checks with AppsFlyer, and if cohort data is available before two days have passed, Singular shows it to you.
  • Appsflyer's reporting API does not return non-generic event cohort data if you have SSO turned on in your Appsflyer account.

Note: The Cohort API is a premium feature that must be explicitly enabled by AppsFlyer. The Pull API and Master API are represented by the V1 auth token, while the Cohort API has a second auth token called the V2 token. If you have access to the Master API and Cohort API, add your tokens to the data connector in the Singular app.

Prerequisites

Appsflyer's reporting API Token. Reference this article on how to retrieve that. 

Data Mapping

Tips:

  • The revenue metric is only available for cohorts (see What are cohort metrics?).
  • The agency (partner) and sub ad network (channel) breakdowns are not available for cohorts. This means that if you run a report with agency or sub ad network breakdown, revenue data will not be available.
  • For descriptions of each field in Singular reporting, see the Singular Metrics and Dimensions Glossary.

Field in Singular UI Field in Singular API Field in AppsFlyer Pull API Field in AppsFlyer Master API Notes
Dimensions
Agency agency Agency/PMD (af_prt) af_prt Not available for cohort data
Country country_field Country geo  
Date date_field Date install_time  
Retargeting retention Conversion Type - Singular always pulls this from the Pull API
Source source Media Source (pid) pid  
Sub Ad Network adn_subadnetwork - af_channel Not available for cohort data
Sub Campaign ID sub_campaign_id Adset ID af_adset_id Only available for Facebook campaigns
Sub Campaign Name sub_campaign_name Adset Name af_adset Only available for Facebook campaigns
Tracker Campaign ID tracker_campaign_id Campaign ID af_c_id  
Tracker Campaign Name tracker_campaign_name Campaign c  
Tracker Creative ID tracker_creative_id Adgroup ID af_ad_id Only available for Facebook campaigns
Tracker Creative Name tracker_creative_name Adgroup Name af_ad Only available for Facebook campaigns
Dimensions
Revenue revenue - revenue Only available through Master API (see Issues/Limitations above). Only available for cohort data
Re-Engagements tracker_reengagements Conversions - Singular always pulls this from the Pull API
Tracker Clicks tracker_clicks Clicks clicks  
Tracker Installs tracker_installs Installs installs