At a glance: Learn about integrating Facebook Ads with AppsFlyer.
iOS 14 updates relating to Facebook
AppsFlyer confirms that our MMP integration with Facebook always implements the Advertiser Tracking Enabled flag. Meaning, no action is required of you in AppsFlyer. This information is provided pursuant to the Facebook app guidance iOS 14 checklist dated February 2021.
Related reading: SKAdNetwork interoperability with AppsFlyer. See this article for iOS 14 related campaign matters.
Facebook Ads setup guide
How long does it take to start attributing your Facebook mobile app ads with AppsFlyer?
If you already have the AppsFlyer 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 attribution. Just follow the step-by-step setup instructions below.
Facebook App ID
To create the Facebook App ID:
- In Facebook, go to your App Dashboard.
- Under Apps, click Create New App.
- Complete the name for your app, and enter a unique namespace.
To retrieve the Facebook App ID:
- In Facebook, open the Monetization Manager dashboard.
- Click the Property you want data from.
- Go to Placements > Manage Placement.
The Facebook App ID is the first part of the Placement ID.
AppsFlyer attributes data per App ID. The same Facebook App ID can be used for both your Android and iOS apps. Note that for iOS 14+, Facebook Ads limits ad accounts for one app per account.
Basic Facebook attribution setup
To start attributing Facebook campaigns with AppsFlyer, follow these steps:
- To activate the integration with Facebook Ads:
- Go to your apps in Facebook for developers.
- Select the app.
- To copy your app ID, click on it at the top of the screen.
- In AppsFlyer, go to Configuration > Integrated Partners.
- Select Facebook Ads from the partners list.
- In the Integration tab, turn on Activate partner.
Learn more about partner activation.
- Paste your app ID in the Facebook App ID field.
- Click Save Integration.
- [optional] To configure recommended settings:
- To match Facebook Ads' click-through lookback window, set it to 7 days.
(Note that there are some specific cases where the default is different). - To match Facebook Ads' view-through lookback window, set it to one day.
- To attribute users who reinstall the app during the re-attribution window, turn on Reinstall attribution.
You don't need to enable view-through attribution or configure lookback windows for reinstall attribution, as it takes its configuration from the install attribution settings. - To save the configuration, click Save Integration.
- To match Facebook Ads' click-through lookback window, set it to 7 days.
Still not seeing Facebook results on AppsFlyer? Refer to Facebook Ads integration troubleshooting.
Advanced Facebook attribution setup
With basic attribution already set up for Facebook, it's time for some quick advanced attribution setup.
User-level data
Important!
Effective October 29th, 2021, only aggregate reporting from Facebook Ads will be available to advertisers. This change applies to all advertisers, operating systems, and MMPs. It relates to the device-level data for all iOS and Android users, regardless of ATT consent status or ads personalization. See the news bulletin for more details.
By default, you are not able to access your user-level data coming from Facebook Ads.
To get user-level data from Facebook Ads and access it in AppsFlyer:
- Go to Facebook Ads partner page > Integration tab and click to accept Facebook's Terms of Service.
- Log in to your Facebook Ads account.
- Select the relevant app.
- Click Accept.
This allows AppsFlyer to collect and enable you access to your Facebook users' raw data.
Note
Effective April 22, 2020, Facebook introduced enhanced data privacy measures to protect people using their services. As such, Facebook no longer provides advertisers with view-through attribution data at the device level. Starting from the effective date, view-through conversions and the associated in-app events are displayed under the restricted media source. The associated attribution fields in user-level sources such as raw data reports, Push API messages, Pull API reports, are not populated.
Cost, clicks, and impressions data
Enabling the Facebook Cost feature gets you the cost data for your Facebook campaigns, adsets, ads, and channel levels. It also gets you the aggregated clicks and impressions data for them. See the ad network cost integration table for full details on the supported dimensions, metrics, and features. Note: Cost data requires an Xpend subscription.
To enable the cost API:
- 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 permission to run all the campaigns in Facebook Business Manager.
- Go to the Cost tab.
- Turn on Get Cost, Clicks and Impressions Data.
- Click the Facebook Login button.
- When prompted, allow AppsFlyer to access your Facebook campaign data.
Note: In the first data sync after integration, AppsFlyer receives Facebook cost data up to 3 days retroactively. In subsequent syncs, AppsFlyer receives data from the last 3 days.
Read more about how Facebook defines clicks and views.
To delete a connected Facebook account: In the actions column, hover over an account and click Delete connection.
Notes
- If you are already logged into Facebook, when you click the Facebook Login button, the Facebook window immediately opens and closes. This is regular behavior.
- 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.
Cost data sync status
View your cost API status and the last time AppsFlyer managed to pull matching cost data in either the cost (and ad revenue) integration status dashboard, or in the individual ad network dashboard.
Facebook allows you to sync several accounts for pulling cost data. For each synced account, AppsFlyer shows the status of cost integration and the last time AppsFlyer managed to pull matching cost data.
Learn more about enriching your Facebook information with cost, clicks and impressions data.
In-app events mapping
To map in-app events:
- Turn on In-App Event Postbacks.
When enabling the Facebook in-app events mapping for an app for the first time, all the af_XXX events from the SDK are automatically mapped to Facebook's predefined event list. This automatic mapping saves you time and decreases mapping mistakes significantly. - 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. You can also type the event name, click Create custom, and map normally. Read more about custom event mapping.Partner Event Identifier Select the most suitable predefined Facebook event tag for your event. You can also send Facebook CUSTOM events. Sending option Select the sending option for the event:
- This partner only for events coming only from users attributed to Facebook Ads.
- All media sources, including organic to have your entire user base available to be reported to Facebook Ads.
Send Revenue - No values & no revenue: sends only the event itself without the event value.
- Values & no revenue: sends all the parameters excluding the revenue value.
- Values & revenue: sends all the event parameters, including the revenue value (if exists in the event).
- To add an SDK event to the list, click Add Event.
Limitations regarding event names:
- Length limitation of event names: 2-40 characters
- The following characters are not allowed:
- Colon (:)
- Period (.)
- Non-Latin (English) character sets: As of January 12, 2020, Facebook rejects Chinese characters. AppsFlyer has not tested other character sets and you should use these only after verifying with Facebook if they support these character sets in postbacks.
- Event names are case-sensitive. To avoid discrepancies, make sure you use the correct case in the event names for all media sources and app versions.
Learn more about Facebook Ads in-app event mapping.
Retargeting attribution
AppsFlyer retargeting attribution for Facebook lets advertisers attribute an existing user's engagement with a Facebook ad, and measure the quality of the user, post engagement, using the AppsFlyer reports.
It should be used only if you are actively running campaigns targeted at your own users in Facebook.
- Enable re-targeting in app settings page.
- On Facebook Ads partner page, turn on Re-engagement attribution.
- Set the Re-engagement click-through lookback window.
The re-engagement lookback window is the period of time, starting from ad click, during which the app must be launched for the click to be recorded as a re-engagement.
Select a lookback window in hours or days, and set the slider to the desired value. - Set the Re-engagement window.
This is the period when the user's in-app events are attributed to the retargeting media source, as primary source.
You can set the value in days (1-90), hours (up to 23), or even lifetime. The default is 30 days.
Learn more about AppsFlyer retargeting attribution.
Learn more about deep linking users from SRNs such as Facebook.
Comply with California consumer privacy act (CCPA)
Complying with CCPA privacy regulations limits the data coming from Facebook users based in California, USA.
To enable compliance with CCPA: Turn on Limit Facebook use of users' personal information (CCPA) in the Integration tab.
Learn more about CCPA compliance.
Ad revenue recording
If your app uses Facebook Audience Network Ad Revenue for ad monetization, you can record 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 recording Facebook Audience Network Ad Revenue:
- On the Ad Revenue tab, set Get Ad Revenue Data to ON.
- Select the type of aggregated ad revenue data you want to receive: Attributed revenue and/or Aggregated monetization revenue:
- Attributed Revenue: Revenue based on the user acquisition source.
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 theaf_app_openedevent. In this case, ad revenue is attributed for every app open performed by the user. - Aggregated monetization revenue: Revenue based on the ad source.
- Attributed Revenue: Revenue based on the user acquisition source.
- The Ad Revenue Event is displayed. It is a read-only field presenting the new ad revenue event called [source event]_monetized (for example, Ad_Watched_Monetized as displayed above). The ad revenue event is presented in the dashboard as an additional event.
- Click Connect to Facebook to enable collection of Facebook Audience Network Ad Revenue on Facebook. Log in with your Facebook credentials to authorize Facebook Audience Network Ad Revenue.
- Enter the Audience Network App ID (Facebook App ID). Get this from Facebook Audience Network (FAN).
- Get the Facebook App ID.
- Copy the ID to the Audience Network App ID field in AppsFlyer.
- Click Save ad revenue.
Note
If you use MoPub to mediate Facebook, and have a MoPub SDK integration, as well as a direct Facebook integration, AppsFlyer filters out Facebook ad revenue data from Mopub and uses the data from Facebook.
Permissions
Enable Facebook Ads to perform various actions and to access your data according to the available permissions.
Learn more about granting permissions to integrated partners.
Facebook in-app events mapping
Advertisers map their in-app events, SDK or S2S, to Facebook predefined events. Advertisers can also send Facebook postbacks about each app launch or any known app uninstall.
This enables advertisers to utilize Facebook advanced optimization capabilities, as well as build Custom and Lookalike Audience segments.
Predefined events mapping
Facebook offers a wide range of events that are already predefined and can be mapped to.
Find here the list of rich in-app events, that can be sent to Facebook with additional parameters providing extra information about the quality of events.
Note that there's no predefined event for sending uninstalls to Facebook Ads. To send uninstalls, use a custom event.
Below is the list of other predefined Facebook events that don't have additional parameters:
| Facebook event identifier |
Description |
Recommended AppsFlyer SDK name |
|---|---|---|
| Donate |
The donation of funds to your organization or cause. |
af_donate |
| Schedule |
The booking of an appointment to visit one of your locations. |
af_schedule |
| SubmitApplication |
The submission of an application for a product, service or program you offer, such as a credit card, educational program, or job. |
af_submit_application |
| FindLocation |
When a person finds one of your locations via web or app, with an intention to visit. For example, searching for a product and finding it at one of your local stores. |
af_find_location |
| Contact |
A telephone or SMS, email, chat or other type of contact between a customer and your business. |
af_contact |
| CustomizeProduct |
The customization of products through a configuration tool or other application your business owns. |
af_customize_product |
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.
On Facebook Ads Manager they are aggregated and displayed as "Custom events".
Automatic parameter mapping with the custom event
Through the AppsFlyer deep integration with Facebook, many of the AppsFlyer standard SDK event parameters are automatically mapped to Facebook's predefined 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.
Note
Automatic parameter mapping can differ between CUSTOM and predefined events.
For predefined events, af_price is mapped to _valueToSum in some cases (for example, fb_mobile_add_to_cart). In other cases, af_revenue is mapped to _valueToSum (for example, in fb_mobile_purchase).
For events mapped to CUSTOM, af_price is always mapped to fb_price, and af_revenue to _valueToSum.
The following table details all the AppsFlyer event parameters, which when mapped through the CUSTOM event to Facebook, are automatically mapped to Facebook 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
The following limits apply to events you send to Facebook Ads:
- Maximum number of parameters: 25.
- Length of event names and parameters: 2–40.
- Maximum parameter length: 100 characters.
- Characters permitted: Alphanumeric characters, underscores, hyphens, or spaces. Don't use non-Latin (English) characters. Using non-Latin letters results in inconsistent results.
Considerations regarding in-app event naming:
- Event names on AppsFlyer can be named the same as Facebook event names (for example, 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. - To perform in-app events postback mapping with Facebook, get events data from all sources, including organic.
Important!
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.
If the event value contains parameters that are not mapped to valid Facebook parameters (see the table above), these parameters are not sent to Facebook.
AppsFlyer SDK vs. Facebook SDK
Your app may already have the Facebook SDK integrated into it, before the AppsFlyer SDK. Even if not, you may wonder whether you really need Facebook SDK in addition to AppsFlyer SDK. And if you do, can the two co-exist without duplicate reporting?
Who needs Facebook's SDK?
Your app does not require the Facebook SDK for the following:
- User acquisition: Generally, the AppsFlyer SDK takes care of all mobile user acquisition attribution purposes of your Facebook users, including engagements, installs, sessions, and post-install events.
- Deep linking: To open the app when the link is clicked and deep link users to a specific page or activity in the app, you can use OneLink, without the Facebook SDK. However, you need a URI scheme configured to open the app (Universal Links and Android App Links do not work). Facebook scrapes the OneLink URL, and uses it to create a Facebook App Link that opens the app, and deep links the user.
Your app requires the Facebook SDK in addition to the AppsFlyer SDK for the following:
- Deferred deep linking:
- Dynamic Product Ads campaigns data: You can only get data for Dynamic Product Ads from the Facebook SDK.
- Other Facebook features: You may need Facebook SDK for reasons unrelated to attribution such as authentication, ad monetization, social sharing, user invites, etc.
Note
The above information and recommendations regarding deep linking and deferred deep linking are based on thorough testing we conducted using Facebook’s available demo/preview tools, which uses a different mechanism than live ads.
Avoiding duplicates with Facebook SDK
Facebook requires AppsFlyer to report about installs and in-app events from ALL users, including organic users. If you have both SDKs in your app, install and in-app events are reported to Facebook SDK, and then via postbacks to Facebook servers through AppsFlyer. How can you avoid this duplicate reporting?
- Installs
Facebook de-duplicates app installs. If both Facebook SDK and AppsFlyer report on a new user installing a mobile app, Facebook knows to count this install only once. - In-app events
Facebook does not de-duplicate in-app events, which are reported from both its SDK methods as well as from another source, i.e. AppsFlyer. This means that, unless taken care of, Facebook may report double revenue and other events, falsely.
Use either of these possible methods to avoid duplicate in-app event reporting in Facebook:
- Don't configure events in the Facebook SDK
- Disable the Facebook in-app events mapping from AppsFlyer
Facebook channels
With Facebook you can see data broken down not only by campaigns, ad sets and ads, but also by Facebook channels (called Placements on Facebook).
- 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 attribute 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.
Note that for iOS 14 users, only one agency can run campaigns for a specific ad account. See more about Facebook Ads and AppsFLyer SKAdNetwork interoperability.
For more details about agencies and Facebook install attribution please go here.
In addition, agencies can't alter Facebook lookback windows and retargeting control. Rather, they need to ask the advertiser to perform these changes if they're needed.
Besides, agencies cannot modify any in-app event postbacks sent to Facebook. The reason for that is Facebook's requirement to receive information about all installs, including those that are not attributed to it (and therefore may not be brought by the agency).
The image below shows all settings that need to be configured by the advertiser for the agency to be able to manage its Facebook campaigns:
Attribution for 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, for example, Baidu.
However, you can advertise and record 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 Traffic or Conversions campaign on Facebook, with mobile attribution enabled, which sends leads to a landing page.
- The landing page should include a Download App button, which directly links to the out-of-store market where the APK exists.
- The lead clicks on the button and is redirected to the out-of-store market. After completing the installation AppsFlyer attributes the user to Facebook, via its MMP API.
Note
The same solution applies to apps in Google Play and the App store, which require a landing page prior to the redirection to the market.
For specific instructions on attribution for apps in Amazon on Facebook, click here.
Facebook spend
AppsFlyer gets spend (including clicks and impressions) data from Facebook campaigns, if one or more installs occurred during the previous 3 days.
If a Facebook campaign engages with multiple platforms (Android, iOS, desktop, etc) the cost in the Dashboard is platform-specific and is calculated by Facebook.
Getting Facebook cost including clicks and impressions.
Facebook cost FAQs
I can't see old Facebook cost data in the AppsFlyer dashboard
Upon performing the first Facebook admin login described above AppsFlyer receives Facebook cost data up to 3 days retroactively for existing campaigns. Cost data from beforehand isn't available.
In subsequent syncs, AppsFlyer also receives data from the last 3 days. This means that cost, clicks, and impressions data is collected for all campaigns, which have at least 1 conversion during the last 3 days.
Cost data was fine for a few months, but it stopped displaying
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.
I clicked on my Facebook ad 5 minutes ago. Why don't I see the click in AppsFlyer?
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.
Are there raw clicks data from Facebook?
As AppsFlyer gets only aggregated click and impression data from Facebook, the entire set of raw clicks and impressions is not available. The only raw clicks and impressions available in raw reports are those that resulted in installs.
Are there limitations of Facebook cost data by geo?
If you filter by Geo on AppsFlyer's dashboard, you can see the summary and breakdown of the Facebook cost data.
This data is available only for "Mobile App Install Campaigns" on Facebook.
In addition, the cost by Geo data is only available for single platform campaigns. This means campaigns that have an Android targeted ad set, and an iOS targeted ad set, cannot have Geo specific cost data. To get the full cost data, dedicate a campaign to each platform.
What are the limitations of Facebook cost data in Master API?
Facebook doesn’t support grouping of cost data by Geo and Channel simultaneously in Master API reports.
To create a report with complete cost data, group it by only one of these dimensions.
The total cost doesn't match
There are differences between Facebook and AppsFlyer attribution models. These differences may lead to discrepancies with Facebook cost data:
- Facebook 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 non-mobile campaigns: in 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 3 days - AppsFlyer syncs the cost only for campaigns that had installs/conversions in the past 3 days. If Facebook cost was just set, campaigns which were inactive for more than 3 days beforehand will not show cost.
Although the total cost is identical, the eCPI AppsFlyer calculates is different from the cost calculated by Facebook. why?
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.
Why is there cost data for only some of the campaigns?
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 in 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.
Is Facebook cost data displayed for retargeting campaigns?
Cost and ROI data for retargeting campaigns can be found in the unified view of Cohort reports.
Why does the Facebook cost configuration window close before login
If you are 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.
What's the problem with Facebook cost for apps in the Amazon app store?
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.
Can I halt the Facebook cost sync?
What should you do if you want to switch the Facebook ad account, but have already linked the Facebook cost via AppsFlyer with your old ad account?
The solution is to disconnect the ad account via Facebook. No action should be taken on AppsFlyer.
- On Facebook navigate to Settings >> Business Integration.
- On the Active tab, remove the AppsFlyer integration.
- Navigate to AppsFlyer dashboard and connect the cost with the new ad account.
Facebook cost examples
An advertiser runs campaigns using Facebook Ads. In AppsFlyer the advertiser sees the following:
The cost information is provided by Facebook to AppsFlyer. The number of installs is calculated by AppsFlyer using AppsFlyer attribution rules. As a result, the eCPI calculated by Facebook and AppsFlyer usually differs.
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 dashboards.
While we work closely with Facebook to minimize these discrepancies, advertisers should be aware of the following causes for them.
Detect a discrepancy between AppsFlyer and Facebook
Compare events listed in Facebook Event Manager to those in AppsFlyer reports. If the number of events varies significantly, there may be a discrepancy.
Differences in attribution models
| Cause | AppsFlyer | |
|---|---|---|
|
Click attribution lookback window |
7 days (Note that there are some specific cases where the default is different). |
1-30 days. Make sure to set to 7 days with Facebook. |
|
View-through attribution lookback window |
1 day (Note that there are some specific cases where the default is different). |
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, for example, iOS/Android/desktop. |
AppsFlyer attributes single devices, which perform both the engagement and the install |
|
Different time zones |
Facebook Ads default reporting time zone is PST. Make sure to change it in Facebook Ads Manager to match the app time zone defined in the app settings in AppsFlyer. |
AppsFlyer's default app time zone is UTC+0. You can change the time zone set for the app in the app settings page to match the time zone defined in Facebook Ads Manager. |
Click-through and view-through attribution
AppsFlyer supports both click-through and view-through attribution. To minimize discrepancies between Facebook Ads and AppsFlyer, make sure that both the Click-Through and View-Through Lookback windows are consistent with the default ones defined by Facebook Ads.
Facebook Ads' default click-through lookback window is defined to 7 days. Although there are some specific cases where the default is different, it is recommended to set the click-through lookback window in AppsFlyer to 7 days to cover all Facebook Ads' default options.
To compare the click-through and view-through attribution windows on Facebook with those on AppsFlyer, visit Facebook. We recommend configuring the attribution windows on AppsFlyer according to Facebook values as they are shown in the following screenshot:
Example
Suppose that the Facebook click lookback window is configured on AppsFlyer to 1 day for your app com.greatapp, while on Facebook it has the default value of 7 days. Users that click on Greatapp's ad on Facebook, but launch the app for the first time after 2-7 days are attributed as organic users on AppsFlyer, while Facebook self-reports these users.
Restricted media discrepancies
In some conversion scenarios, an ad network won’t share user-level data. In the AppsFlyer platform, aggregated data reports function as usual, but the conversions listed in raw data reports will be attributed to a restricted media source.
Facebook Ads doesn’t send user-level data for View-through attribution (VTA) conversions. As a result, AppsFlyer might not attribute conversion-assisting impressions to Facebook Ads.
Example
- User sees a Facebook ad for AwesomeApp. Then, later, they see and click on a GreatAdNetwork ad for AwesomeApp and install it.
- Facebook Ads claims the conversion since it occurred within their VTA window.
- AppsFlyer attributes the conversion to GreatAdNetwork as they had the last engagement before install.
- AppsFlyer won’t consider Facebook Ads as a conversion-assisting network since Facebook Ads VTA is restricted.
In-app events differences
The differences between platforms may also be present with post-install events (for example, 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. |
|
Self-attribution |
Facebook always attributes events to its own campaigns that drove them, while AppsFlyer attributes these events to the acquisition source. |
In installs and events, which Facebook incorrectly self-attributes are indicated as assists in AppsFlyer. |
| Different life time definition | The users life time on Facebook is up to 7 days, meaning FB doesn't show events if they take place more than 7 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 7 days 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 Revenue | AppsFlyer gets the revenue from the SDK originated events, but they are not sent to Facebook. | Make sure the Send Revenue boxes of the in-app events are always checked, for example, 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 the AppsFlyer 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:
No IDFA collection
As stated in the SDK Integration Guide - iOS, you must add the AdSupport.framework to your project for IDFA collection to take place. Check the Installation Raw Data report to see if the IDFA column is indeed empty or not. It is recommended to enable your app to collect IDFA in the case of iOS apps and GAID in the case of Android apps.
Starting iOS 14.5 you'll have to display the Apple ATT prompt and get user consent before you can collect IDFA.
Note: SKAdNetwork attribution isn't impacted by the availability of IDFA. However, make sure that you enable the iOS 14 Campaign toggle in Facebook while setting up iOS 14 campaigns.
Wrong Facebook App ID
On the Facebook Ads dashboard verify the app ID is correct and matches the value in the app store.
Note - you can also use Facebook's Graph API to validate your Facebook App ID.
App status on Facebook
The app must be defined on Facebook as Live rather than In development for attribution to work.
Wrong type of Facebook campaign
Facebook app install
Correct set-up - attribution works.
Incorrect set-up - attribution fails.
Facebook FAQs
I don't see Facebook campaign clicks in AppsFlyer's dashboard
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.
Can I stop cost data sync?
To stop cost data sync with Facebook, remove AppsFlyer from your Business Integration in your Facebook account.
Can AppsFlyer show the campaign level and ad groups?
Is Facebook data shown in real-time?
When can I see a new campaign's data on AppsFlyer?
To see data from new ads, ad sets and campaigns on Facebook they must generate at least one install.
For example, a new ad has generated 100 clicks with no installs, and is not shown on the AppsFlyer dashboard and data. Another ad only has 1 click and 1 install, but is displayed on AppsFlyer.
How can I get more installs from Facebook?
How? Read here.
Do you make Facebook raw data available to agencies?
I don't see Facebook raw data in the installation and in-app events reports
By default, Facebook does not allow the distribution of user-level data. Advertisers who want to get this raw data via AppsFlyer can sign Facebook Data Usage Terms for Advanced Mobile App Measurement.
Once an advertiser agrees to Facebook Data Usage Terms, the data doesn't appear immediately. After the advertiser agrees to Facebook Data Usage Terms, at least one install from Facebook must take place for the data to appear on AppsFlyer. Anybody with access to the Facebook ad account can do the following:
- Go to the Facebook setup window on AppsFlyer.
- Click on Terms of service.
- Continue on Facebook and agree to the terms of service.
OR go directly to Facebook here.
Once agreed, and at least one install takes place after accepting Facebook Data Usage Terms, historical Facebook raw data appears in AppsFlyer.
Are there specific columns for Facebook in AppsFlyer's performance reports?
Yes. The performance reports have static column structures in any combination of selected media sources, which present information down to the campaign level.
However, when you download performance reports ONLY for Facebook Ads, AppsFlyer adds 4 columns to them, which present information down to the single ad level! The added columns are Adset Name, Adset ID, Adgroup (i.e. single ad) Name and Adgroup ID.
Can I work with Facebook FMPs and measure performance with AppsFlyer?
For details about setting up attribution with FMPs, click here.
What should I do when I receive the following warning?
- Verify the App ID in Facebook and check if you have any geo or age restrictions on their Facebook App ID.
- If attribution 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.
What happens with different lookback windows than on Facebook?
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 windows end, do not get attributed to Facebook.
Therefore, to minimize discrepancies, the recommendation is to configure the Facebook lookback windows in AppsFlyer to 7 day clicks and 1 day views.
What are the Facebook API parameters?
| Conversion data | AppsFlyer raw data | |
|---|---|---|
| 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 |
How long do you keep Facebook’s user-level data?
Past aggregate data remains the same.
This is relevant for all Facebook channels (Facebook app, Instagram, Messenger, and AudienceNetwork).
Can I use OneLink with the Facebook mobile app install objective?
Facebook has various advertising objectives to choose from when you run ads for an app: App installs, traffic, and conversions.
For most objectives, like traffic or conversions, OneLink links or other third-party links are accepted. However, for the app install objective, Facebook only accepts Facebook App Links for deep linking.