Facebook Ads Overview



Branch links can be used together with Facebook ads, allowing you to track ad-driven installs on the Branch dashboard and deep link those new users directly to content the first time they open your app. Refer to Facebook's Ad Guide to learn more.

Facebook's Ad Platform supports numerous campaign types and a shared set of advertisement formats. To help you navigate Facebook's Advertisement Platform we created this guide detailing how to use Branch links in all major Facebook ad types.

Campaign Support

This documentation supports the following Facebook Ad Campaigns:

Facebook Campaign CategoryCampaign Type/ObjectiveLink users toBranch Documentation LinkBranch Ad Format
AwarenessBrand AwarenessWeblinkCross-platform Display
AwarenessReachWeblinkCross-platform Display
ConsiderationTrafficWeb or ApplinkCross-platform Display
ConsiderationApp InstallsApplinkApp Only: Installs
ConsiderationVideo ViewsWeblinkCross-platform Display
ConsiderationLead GenerationWeb xlinkCross-platform Display
ConversionConversionsWeb or ApplinkCross-platform Display

[x] Facebook has indicated that links are not supported in all placements.

Data Mapping between Branch and Facebook

Event Names


Standard vs Custom Events

Please follow the Tracking Commerce, Content, Lifecycle and Custom Events guide when implementing event tracking in the Branch SDK. When tracking any of the Facebook events that are mapped to the Branch custom event, use the event name from the table below; e.g. branch.logevent('AdClick').

Facebook Event NameBranch Event Name

Campaign/Ad Data

Branch DataFacebook Data


Branch Key-Value PairFacebook MMP Key-Value PairFacebook event(s) supported
event_data.revenue_valueToSumfb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_initiated_checkout, fb_mobile_purchase, fb_mobile_spent_credits, fb_mobile_content_view
event_data.currencyfb_currencyfb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_initiated_checkout, fb_mobile_purchase, fb_mobile_content_view
content_items (array)fb_content (array)fb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_tutorial_completion, fb_mobile_initiated_checkout, fb_mobile_purchase, fb_mobile_rate, fb_mobile_spent_credits, fb_mobile_content_view
content_items[0].$skufb_content_idfb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_tutorial_completion, fb_mobile_initiated_checkout, fb_mobile_purchase, fb_mobile_rate, fb_mobile_spent_credits, fb_mobile_content_view
content_items[0].$product_categoryfb_content_typefb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_initiated_checkout, fb_mobile_purchase, fb_mobile_rate, fb_mobile_search, fb_mobile_spent_credits, fb_mobile_content_view
content_items[0].$quantityfb_num_itemsfb_mobile_initiated_checkout, fb_mobile_purchase
custom_data.fb_successfb_successfb_mobile_add_payment_info, fb_mobile_tutorial_completion, fb_mobile_search

Currently Facebook appears to only support sending one fb_content_id (etc) per event, whereas Branch allows you to send many. To provide as much functionality as possible, we choose the first content_item and search it for key-value pairs that can be sent to Facebook.

Viewing Facebook Data

You can see analytics on impressions, clicks, installs, opens and conversion events on various pages of the Branch Dashboard.


Reporting Discrepancies

Facebook's Advanced Mobile Measurement Agreement

If you have signed Facebook's "Advanced Mobile Measurement" agreement ("Data Use Terms for Advanced Mobile App Measurement"), then you can get device level data out via:


Agreement not Signed

If you have not signed this agreement, any event attributed to a Facebook ad will look like an organic event when accessed via Webhooks, the Daily Export API, and CSV Exports.

Data Limitations


Data Limitations

  • We can no longer show non-aggregated view-through data via Branch Dashboard and Exports, and this data will appear as "undisclosed" in exports. View-through data will only be provided at an aggregated level through our reporting interfaces or through Facebook’s reporting interfaces and APIs.
  • We cannot send device-level Facebook attribution data to third parties.
  • We cannot send events attributed to Facebook via Data Integrations. Please instead consider analyzing this data in-house (using Webhooks, the Daily Export API, or CSV Exports), or using the Branch Dashboard for all of your analytics and attribution needs.
  • This data is also not returned in the deep link session initialization callback within the app. If you have analytics needs that are not met by the Branch Dashboard, please contact us and include "Facebook MMP + Feature Request" in the subject.
Branch featureFacebook data included
Dashboard visualizationsPre-aggregated analytics
Query APIPre-aggregated analytics
LiveviewDevice-level analytics x
Daily Export APIDevice-level analytics x
CSV ExportsDevice-level analytics x
WebhooksDevice-level analytics x
Data IntegrationsNot supported

[x] You must have signed Facebook's "Advanced Mobile Measurement" agreement ("Data Use Terms for Advanced Mobile App Measurement") to view this data.

Here is the page where you can see which ad accounts have signed the AMM agreement:


Facebook Limited Data Use

On July 1st, Facebook introduced a new Limited Data Use (LDU) feature to support customer compliance with the California Consumer Privacy Act (CCPA). This feature enables you to limit how Facebook uses the data of California users collected by you or by third parties on your behalf.

If the Limited Data Use feature is enabled, Facebook has indicated it will process such data in accordance with their role as a “service provider” under the CCPA, with respect to personal information from residents in California; i.e. Facebook will limit use of that data subject to their State-Specific Terms.

By default, Branch’s Facebook integration has the Limited Data Use feature enabled. This means that Branch sends Facebook the LDU flag as enabled with your Branch conversion data by default. Therefore, conversion metrics (e.g installs or other down funnel events) for California users will not be available in your reporting. NOTE: You will still see aggregate click, impression, and cost data for users in California.

However, Branch has provided a customer-controlled toggle in the event you desire to disable the Limited Data Use feature in your dashboard configuration. We recommend that you consult with your legal counsel to understand any implications of disabling the Limited Data Use feature for the Facebook integration as they pertain to CCPA or other state specific data protection laws, and to determine whether disabling the Limited Data Use feature will meet your needs.

To disable the Limited Data Use feature:

  1. In the left-hand navigation panel under Channels & Links, click on Ads and then click Partner Management.

  2. Find and select Facebook using the Ad Partners search feature.

  3. On the Ad Partner settings: Facebook page, click on the Events Config tab.

  4. On the Event Config tab, scroll down to the bottom and deselect Limited Data Use (LDU) Flag.

  5. Click Save.


We also have a document with FAQs and Advanced Options for Facebook Ads. We recommend starting with one of the guides above, then jumping into the FAQ and Advanced Options when you have questions or need to troubleshoot.

Updated 5 months ago

Facebook Ads Overview

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.