Introduction
How long does it take to start tracking your Facebook mobile app ads with AppsFlyer?
If you already have AppsFlyer's SDK integrated in your app, and already have defined your app on Facebook, the answer is less than a minute!
You don't need to implement Facebook Login or integrate your app with Facebook's SDK for mobile tracking. Just follow the step-by-step setup instructions below.
Facebook App ID
But first, if you still haven't defined your app on Facebook, follow these instructions to create the Facebook app ID:
- Visit Facebook's App Dashboard
- Click Create New App under Apps
- Complete the name for your app, and also a unique namespace
Basic Facebook Tracking Setup
To start tracking Facebook campaigns with AppsFlyer, follow these steps:
- When you define your mobile app on Facebook you get its Facebook App ID.
Copy your Facebook App ID and head to your app's dashboard on AppsFlyer.
- Click on Integrated Partners link on the left bar.
- Search for Facebook and click on its logo to open the Facebook setup page.
- On the Integration tab click inside the Facebook App ID box and paste.
- We recommend the Click-Through Attribution Lookback window remains set to 28 days to match with Facebook.
- We recommend the View-Through Attribution Lookback window remains set to 1 day, again, to match with Facebook.
- Press Save & Close.
Congratulations! You have completed basic tracking for Facebook mobile campaigns with AppsFlyer!
(Still not seeing Facebook results on AppsFlyer? Click here)
Warning
Your app MUST collect IDFA or GAID or all your Facebook installs are attributed as organic. For further information refer to the SDK Integrations Guides for either iOS or Android.
Advanced Facebook Tracking Setup
With basic tracking already set up for Facebook, it's time for some quick advanced tracking setup.
User-level data
By default Facebook does not release raw user-level data.
On the Integration tab (or here) click to accept Facebook's Terms of Service. This allows AppsFlyer to collect and enable you access to your Facebook users' raw data.
In-App Events Mapping
- Toggle In-App Event Postbacks to ON
- The Sending Option for all SDK defined events is Events attributed to any partner or organic, i.e., your entire user base is available to be reported to Facebook.
- Click Add Event to add an SDK Event to the list
- Fill in the following parameters:
| Parameter Name | Description |
|---|---|
| SDK Event Name | The name of the event, as received by AppsFlyer either from the SDK integrated in your app, or from server to server events. Tip - don't see the event you want in the list? Make sure to activate the event on a device with a non-organic installation and recheck. |
| Partner Event Identifier | Select the most suitable pre-defined Facebook event tag for your event. You can also send Facebook CUSTOM events. |
| Send Revenue | When unchecked - AppsFlyer sends all the parameters of the rich in-app event to the partner, except for the revenue parameter, which is contained in the af_revenue parameter. When checked - AppsFlyer sends all the parameters including the revenue value (if exists in the event). |
For more information about mapping in-app events with Facebook go here.
Retargeting Attribution
AppsFlyer's retargeting attribution for Facebook enables advertisers to attribute an additional engagement of a user with an ad on Facebook, and measure the quality of the user, post engagement, using the AppsFlyer reports.
Cost, Clicks and Impressions Data
Enabling the Facebook Cost feature not only gets you the cost data for your Facebook campaigns, adsets, ads and channel levels. It also gets you the full aggregated clicks and impressions data for them.
- Make sure you are logged into the Facebook user account, which is enabled to handle the account's campaigns on Facebook. The user signing-in must have permissions to run all the campaigns in Facebook Business Manager
- Go to the Data Enrichment tab
- Click the Facebook Login button
- When prompted, allow AppsFlyer to access your Facebook campaign data
Note
If you have several users with permissions to Facebook, the best practice is to perform the Facebook login for all of them, to avoid getting partial data.
For more information about enriching your Facebook information with cost, clicks and impressions data, click here.
Ad Revenue Tracking
If your app uses Facebook Audience Network Ad Revenue for ad monetization, you can track your revenues from Facebook on AppsFlyer. This, with or without in-app purchase revenue data, gives you a complete picture of your user revenues.
To start tracking Facebook Audience Network Ad Revenue:
- On the Data Enrichment tab set Get Ad Revenue Data to ON
- Set the Event Source, which is the event representing your ad revenue model in the best possible way. For example, if your revenue is based on impressions, it is recommended to send AppsFlyer an ad viewed event. The best event can be configured for each monetization platform separately. However, it is also possible to use the
af_app_openedevent. In this case, ad revenue is attributed for every app open performed by the user. - The Ad Revenue Event is displayed. It is a read-only field presenting the new ad revenue event called [source event]_monetized (e.g. Ad_Watched_Monetized as displayed above). The ad revenue event is presented in the dashboard as an additional event.
- Click Facebook Ad Revenue to enable collection of Facebook Audience Network Ad Revenue on Facebook. Login with your Facebook credentials to authorize Facebook Audience Network Ad Revenue.
- Click Save & Close.
Important!
Since May 3rd, following changes to Facebook’s Reporting API, we have been unable to retrieve Audience Network revenue statistics. We are currently working closely with Facebook to find a solution.
Facebook In-App Events Mapping
Advertisers can easily map their in-app events, SDK or S2S, to Facebook's pre-defined events.
This enables advertisers to utilize Facebook’s advanced optimization capabilities, as well as build Custom and Lookalike Audience segments.
Custom In-App Events Mapping
AppsFlyer allows you to map any custom in-app event to send to Facebook, by using the CUSTOM Facebook Event Identifier option.
The event name and the event value (including the event parameters) configured in the SDK are forwarded to Facebook, as is.
Warning
To use Facebook optimization capabilities such as App Event Optimization, Value-Based Optimization, and Dynamic Product Ads, it is crucial to map SDK events to the corresponding Partner Event Identifier.
Events mapped to “CUSTOM” are not available for optimization.
For more information about Rich In App Events and their required parameters see here.
Automatic Parameter Mapping with the CUSTOM Event
Through AppsFlyer's deep integration with Facebook, many of AppsFlyer’s standard SDK event parameters are automatically mapped to Facebook's pre-defined parameters. For example, the af_revenue parameter is converted to the valueToSum parameter in Facebook, which allows you to send a revenue per event that can be measured and optimized towards on Facebook.
The following table details all the AppsFlyer event parameters, which when mapped through the CUSTOM event to Facebook, are automatically mapped to Facebook's parameters.
| AppsFlyer Parameter | Facebook Parameter |
|---|---|
| af_city | fb_city |
| af_class | fb_travel_class |
| af_content_id | fb_content_id |
| af_content_list | fb_content_id |
| af_content_type | fb_content_type |
| af_country | fb_country |
| af_currency | fb_currency |
| af_date_a | fb_checkin_date |
| af_date_b | fb_checkout_date |
| af_departing_arrival_date | fb_departing_arrival_date |
| af_departing_departure_date | fb_departing_departure_date |
| af_description | fb_description |
| af_destination_a | fb_origin_airport |
| af_destination_b | fb_destination_airport |
| af_destination_list | fb_destination_ids |
| af_hotel_score | fb_hotel_score |
| af_level | fb_level |
| af_max_rating_value | fb_max_rating_value |
| af_num_adults | fb_num_adults |
| af_num_children | fb_num_children |
| af_num_infants | fb_num_infants |
| af_order_id | fb_order_id |
| af_payment_info_available | fb_payment_info_available |
| af_preferred_neighborhoods | fb_preferred_neighborhoods |
| af_preferred_num_stops | fb_preferred_num_stops |
| af_preferred_price_range | fb_preferred_price_range |
| af_preferred_star_ratings | fb_preferred_star_ratings |
| af_price | fb_price |
| af_quantity | fb_num_items |
| af_region | fb_region |
| af_registration_method | fb_registration_method |
| af_returning_arrival_date | fb_returning_arrival_date |
| af_returning_departure_date | fb_returning_departure_date |
| af_revenue | _valueToSum |
| af_search_string | fb_search_string |
| af_success | fb_success |
| af_suggested_destinations | fb_suggested_destinations |
| af_suggested_hotels | fb_suggested_hotels |
| af_travel_end | fb_travel_end |
| af_travel_start | fb_travel_start |
| af_user_score | fb_user_score |
Event and Parameter Limitations
There are several limitations Facebook imposes on the sent events data:
- An event can have up to 25 parameters.
- Event names and parameter names must be between 2 and 40 characters, and must consist of only alphanumeric characters, underscores, hyphens or spaces.
- The length of each parameter value can be no more than 100 characters.
- Event names on AppsFlyer can be named the same as Facebook event names (i.e. fb_price), however, these should not be sent as CUSTOM events to Facebook. To keep on the safe side refrain from naming events the same as Facebook event names.
Warning
With the exception of the above parameters, AppsFlyer sends the CUSTOM events data as is to Facebook. It is the responsibility of the app owner to verify the events data is on par with Facebook's requirements.
Facebook Channels
With Facebook you can see data broken down not only by campaigns, ad sets and ads, but also by Facebook channels.
- Facebook channel - users from the Facebook app
- Instagram - users from the Instagram app
- Messenger - users from the Facebook Messenger app
- AudienceNetwork - users from other apps that belong to or are affiliated with Facebook
Use this data to compare the quality of users that you get from the different channels of Facebook.
Facebook and Agencies
Agencies and FMPs can run and track Facebook campaigns on behalf of advertisers on AppsFlyer, or even alongside the advertisers' own Facebook campaigns. In order for the agency campaigns to be attributed to the agency, the campaign name MUST begin with the agency's name.
For more details about agencies and Facebook install tracking please go here.
In addition, agencies can't alter the Facebook look back windows and retargeting toggle. Rather, they need to ask the advertiser to perform these changes if they're needed.
Tracking Facebook for Out-of-Store Android Apps
Facebook doesn't allow creating mobile apps install campaigns for Android apps that are in out-of-store markets, e.g. Baidu.
However, you can advertise and track installs for out-of-store apps on Facebook following these instructions:
- The developer has to prepare a separate APK for each out of store market you use to advertise your app on. More details here.
- Create a "Link click" campaign on Facebook, which sends leads to a landing page.
- The landing page includes a "Download App" button, which has a custom tracking link
behind it. The link MUST include the landing page redirection parameter,af_r. - The lead clicks on the button and is redirected to the out-of-store market. After completing the installation the lead becomes an attributed user.
Note
Since it's not possible to extract the lead's device ID from the landing page on mobile web, AppsFlyer uses fingerprinting as the attribution method.
For specific instructions on tracking apps in Amazon on Facebook click here.
Facebook Cost
Getting Facebook cost (including clicks and impressions) data is super-easy to set up, but questions about it frequently arise.
Below you can find the most common questions and examples explaining the Facebook cost feature.
Warning
Once you set Facebook cost do not change the name of any running Facebook campaign, ad set or single ad as it may cause serious discrepancies or missing cost data.
Facebook Cost FAQs
Upon performing the first Facebook admin login described above AppsFlyer receives Facebook's cost data up to 90 days retroactively for existing campaigns. Cost data from beforehand isn't available.
This cost, clicks and impressions data is collected for all campaigns, which had at least 1 conversion during the last 90 days prior to the initial admin login.
Facebook may reset this permission to get the cost data every few months. If you notice the cost data stopped appearing on the dashboard please repeat the Facebook admin login steps again.
If the Facebook admin user changes their Facebook password the login steps must be repeated as well.
AppsFlyer gets aggregated clicks, impressions and cost data from Facebook periodically every few hours. Therefore, it may take a few hours before these actions are displayed on AppsFlyer's dashboard.
As AppsFlyer gets only aggregated click and impression data from Facebook, the entire set of raw clicks and impressions are not available. The only raw clicks and impressions available in raw reports are those that resulted in installs.
If you filter by Geo location on AppsFlyer's dashboard the summary of the cost data is available, however the data is not available for any specific countries.
There are several inherent differences in Facebook and AppsFlyer's attribution models, which may lead to discrepancies with Facebook cost data:
- Facebook's cross-device attribution - this might sometimes cause issues where a campaign for one platform (iOS/Android) shows an install with its cost for another platform.
- Facebook's non-mobile campaigns - on these campaigns, like Facebook's link click campaigns, desktop users may eventually install mobile apps. For these cross-device campaigns, AppsFlyer does not show cost. However, if the link click was performed by the same device that installed the app, cost data is received.
For example, a Facebook user clicks on an ad leading to the advertiser's landing page on a desktop computer. A week later the same Facebook user installs the advertiser's iOS app on an iPhone device. While the install is attributed and displayed on AppsFlyer's dashboard, the cost of this cross-platform install is not. - Campaigns with 0 results in the last 7 days - AppsFlyer syncs the cost only for campaigns that had installs/conversions in the past 7 days. If Facebook cost was just set, campaigns which were inactive for more than 7 days beforehand will not show cost.
The Cost Per Install is calculated by dividing the total cost with the number of installs. Since AppsFlyer counts installs differently from Facebook the eCPI will usually differ between the two.
Even if there are several Facebook users with permissions to run campaigns in the Facebook Business Manager, only one of them is required to perform the Facebook login described above.
However, if this user does not have access on Facebook to some of the running campaigns, the result is campaigns that are displayed on AppsFlyer's dashboard, but lack the cost, clicks and impression data.
Currently Facebook cost data is only displayed in the Overview dashboard for user acquisition campaigns, and not for retargeting campaigns in the Retargeting dashboard.
If you are is signed in to Facebook on the same browser that you are performing the configuration, the window automatically connects to Facebook using those credentials and if access has already been granted to AppsFlyer's app, then there is nothing to do and the window closes.
In contrast with AppsFlyer's data, Facebook doesn't tell apart cost data of Android apps and Amazon apps (which are Android based).
Therefore, the cost data of Amazon users may be attributed to campaigns targeting other Android users instead of the original Amazon campaigns.
Facebook Cost Examples
Mr A Flyer is an advertiser.
He is running two separate campaigns on Facebook Mobile App Installs during the period March 27 – April 3.
Campaign A: UK_Female_30:
Cost: $1000 (total spend of the campaign, as provided by Facebook)
eCPI: $1,000 / 400 (total number of installs generated by the campaign) = $2.5
Campaign B: US_Male_30:
Cost: $500
eCPI: $500 / 100 (total number of installs generated by the campaign) = $5
In the table above, Mr Flyer’s Facebook campaign cost is calculated per campaign.
In the aggregated performance report (presented by default), you can see the information provided by AppsFlyer at a higher level (total of all Facebook campaigns):
According to the table above, Mr Flyer’s total Facebook campaign cost is calculated as follows:
All Facebook campaigns:
Total cost: $1,000 + $500 = $1,500 (total spend of the campaigns, as provided by Facebook)
Total installs: 400 + 100 = 500
eCPI: $1,500 / 500 = $3 (eCPI is calculated for each campaign / Adset / Ad at the end of each day).
Facebook Discrepancies with AppsFlyer
As any two major players in the mobile user acquisition eco-system, AppsFlyer and Facebook differ in their attribution models. This may cause discrepancies to occur between Facebook and AppsFlyer's dashboards.
While we work closely with Facebook to minimize these discrepancies, advertisers should be aware of the following causes for them.
Differences in Attribution Models
| Cause | AppsFlyer | |
|---|---|---|
|
Click Attribution Lookback Window |
7 days by default, but can be configured to be 1-30 days |
|
|
View-Through Attribution Lookback Window |
1 day |
1 day by default, but can be configured to be 1-48 hours (keep this default value) |
|
Install Record Date |
Facebook records new installs on the Click/View Time. |
AppsFlyer records new installs on installation time (the very first launch of the app) |
|
Multi-Channel Source |
Facebook self-attributes installs regardless of other media sources |
AppsFlyer uses last click attribution (more information about AppsFlyer attribution available here) |
|
Cross-device Attribution |
Facebook attributes its users that click and install on different devices, e.g. iOS/Android/desktop |
AppsFlyer attributes single devices, which perform both the engagement and the install |
Click-Through and View-Through Attribution
AppsFlyer supports both Click-Through and View-Through attribution. To minimize discrepancies between the Facebook and AppsFlyer platforms, ensure both the Click-Through and View-Through Lookback windows are the same.
To compare the click-through and view-through attribution windows on Facebook with those on AppsFlyer, visit Facebook. We recommend to configure the attribution windows on AppsFlyer according to Facebook's values as they are shown in the following screenshot:
Example
Suppose that Facebook's click lookback window is configured on AppsFlyer to 7 days for your app com.greatapp, while on Facebook it has the default value of 28 days. Users that click on greatapp's ad on Facebook, but launch the app for the first time after 8-28 days are attributed as organic users on AppsFlyer, while Facebook self-reports these users.
In-App Events Differences
The differences between platforms may also be present with post-install events (e.g. in-app purchases), that are displayed on Facebook and on AppsFlyer. The following table describes the most common reasons for these differences and advised on how to minimize them:
| Cause | Description | AppsFlyer's Tip |
|---|---|---|
|
Installations discrepancies |
Events that are performed by users that are attributed on one platform, but not on the other, are also under discrepancy by default. |
Minimize the installation discrepancies according to this article to lower in-app events discrepancies as well. |
| Different life time definition | The users life time on Facebook is up to 28 days, meaning FB doesn't show events if they take place more than 28 days after the ad click. Facebook users life time on AppsFlyer is up to 180 days. |
When assessing the value of users from Facebook campaigns from more than 1 month ago use AppsFlyer's data to get the broader picture. |
| Unmapped events | AppsFlyer gets SDK originated events, but they are not mapped to Facebook, and therefore aren't sent. | Make sure to map with Facebook all the in-app events that signify users' quality (see capture below). |
| Unsent value | AppsFlyer gets revenue or other event values from the SDK originated events, but they are not sent to Facebook. | Make sure the Send Value boxes of the in-app events are always checked, e.g. the purchase event in the capture below. |
| Missing event values on Facebook | AppsFlyer sends parameters and values to Facebook as part of the events mapping, if they have the correct structures. | Build your SDK in-app events according to AppsFlyer's recommended structures to fully map the event values with Facebook. |
Installs from Re-Engagement Campaigns in My UA Dashboard?
A re-engagement campaign can cause users to open an already installed app(re-engagement). Alternately, when AppsFlyer recognizes a previous install of the app existed on the same device, AppsFlyer may refer to that conversion as a re-attribution.
If, on a re-engagement campaign, Facebook targets new users or users that have installed the app for the first time after more than the set re-attribution window following the original installation, these users are recorded as new user acquisition installs on AppsFlyer, which belong to a re-engagement campaigns on Facebook.
On the other hand, installs that take place within the set re-attribution window following the original installation, are considered as re-attributions and appear on the retargeting page of AppsFlyer, while they may be appearing as new installs by Facebook.
Note
While Facebook shows all installs of a retargeting campaign in the same place, on the AppsFlyer dashboard, installs are divided between the Overview page (new installs) and the Retargeting page (re-attribution and re-engagements).
Cross-Device Attribution
Facebook reports on cross-device attribution. This could sometimes cause issues where a campaign for one platform (iOS/Android) shows installs on another platform.
Example
Linda clicks on a mobile ad of GreatApp on Facebook using her Android phone. Facebook records the click done by Linda under the original Android targeted campaign "Android Females". Linda decides to install GreatApp on her home iPad. Upon first launch, AppsFlyer asks Facebook for the origin of this iOS install, and Facebook answers with the campaign "Android Females".
Validation Rules and Protect360
If you use AppsFlyer's Validation Rules, results may differ between AppsFlyer and Facebook when there are rejected installs that originally come from Facebook. In these cases Facebook self-reports installs to itself, while AppsFlyer rejects the same installs.
Similarly, if you use AppsFlyer's anti-fraud solution, Protect360, there may be installs since Facebook self-reports, while AppsFlyer rejects.
Example
Jeff, the UA manager of GreatApp, creates a campaign called SPNA, which targets only Spanish speakers in North America. To verify this Jeff defines a validation rule, that accepts users from Canada and the US only.
When a Facebook user from Spain clicks and installs, Facebook self-reports the install, while AppsFlyer rejects the install that doesn't pass the validation rule.
Facebook Integration Troubleshooting
If you have completed the basic integration and still not seeing results from Facebook on AppsFlyer's dashboard, first verify that you have new installs from Facebook since the integration.
If so, please consult the main reasons below for solving this issue:
As stated in the SDK Integration Guide - iOS, you must add the AdSupport.framework to your project for IDFA collection to take place. Although in most cases attribution still works with finger-printing, IDFA collection is mandatory for working with Facebook. Check the Installation Raw Data report to see if the IDFA column is indeed empty or not.
Android installs work on Facebook even without GAID collection, but it is highly recommended to have it implemented too.
Even if the reply is not an error there is still the possibility the user confused the Facebook App IDs for the iOS and Android apps.
When setting up the Facebook app install campaign you can select the app from a drop-down list or paste the full store URL to the app. While both work on Facebook, the second method fails AppsFlyer's attribution.
Correct set-up - attribution works.
Incorrect set-up - attribution fails.
Facebook FAQs
By default Facebook sends only the conversion and engagement data. However, you can easily also start getting clicks, impressions and cost data for your Facebook campaigns.
1. Go to Facebook's setup window on AppsFlyer
2. Click on Terms of service (highlighted in blue in the capture below)
3. Continue on Facebook and agree to the terms of service
OR go directly to Facebook here.
Once agreed, historical Facebook RAW data are available in AppsFlyer.
If you do use both SDKs make sure NOT to pass to Facebook's SDK any in-app events sent to AppsFlyer, to avoid double reporting on Facebook.
- Verify the App ID in Facebook and check if you have any geo or age restrictions on their Facebook App ID.
- If the tracking is already working, this indicates that app is already publicly available in the Facebook Developer Portal and you can you can safely ignore this error message.
Configuring these windows to be shorter on AppsFlyer, decreases Facebook attribution on AppsFlyer.
On the other hand, configuring them longer on AppsFlyer has no effect, as installs taking part after Facebook's windows end, do not get attributed to Facebook.