AppsFlyer Data Connector

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

 

Quick Details

Data Connector Technology API (AppsFlyer Pull API + Master 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:

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

If you do have the Master API:

  • Cohort data is available but 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: data for today and yesterday - pulled from the Pull API. Data for farther back - pulled from the Master API.

If you have access to the Master API, contact Singular Support to have your data connector configured appropriately.

Data Mapping

The data connector pulls the following fields from Appsflyer.

Note:

  • 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.

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