Search specific term/phrase surrounded by double quotes. e.g. “deep linking”
Exclude records that contain a specific term prefixed with a minus. e.g. Android -Firebase

Facebook Dynamic Ads


Branch links can be used in conjunction with Facebook's dynamic advertisements. Dynamic remarketing campaigns on desktop have been proven to deliver 16x return on ad spend. Now you can easily set up Facebook Dynamic Ads on mobile to drive incredible results.

Note: This documentation applies for Ad placements across Facebook and the Audience Network.

This documentation supports the following Facebook Ad Campaign types:

Facebook Campaign CategoryCampaign Type/ObjectiveBranch Ad Format
ConversionProduct Catalogue SalesCross-platform Product Links

Facebook Campaign Advert Format Support Table

Facebook Campaign TypePhotoVideoCarouselSlideshowCollectionDynamicCanvas
Product Catalogue Sales✔︎✔︎


Facebook Campaign Types

Looking for other Facebook Ad campaign types? Please check out our Facebook Ads Overview guide.



  • To track installs from Facebook Ads you should integrate the Branch SDK into your app.
  • To use Branch links in Facebook App Install Ads ensure you have Universal Links set up on iOS or App Links enabled on Android to ensure correct routing behavior. For setup, checkout Universal and App Links.
  • If you want to deep link from your ads directly to content, you should configure deep link routing.
  • Create Branch Links for Product Feeds to create your Facebook Dynamic Ad compatible deep links.
  • Ads is a premium product priced on Monthly Active Users. Sign up for the Ads product to enable this functionality.

Enable Facebook as an Ad Partner (for measurement)


Enabling Facebook as an Ad Partner

Completing this section -- Enable Facebook as an Ad Partner -- will result in Branch sending app events to Facebook in order to attribute them back to ad campaigns. This does not enable deep linking for the ad. Further work below is required for deep linking.

If you haven't enabled Facebook as an Ad Partner on the Branch dashboard follow this section to do so. Advanced options for sending events can be found here.

  1. Navigate to the Partner Management tab.

    Ads Partner Management

  2. Search for Facebook.

  3. Click Connect With Facebook

  4. Login to Facebook if you are not logged in


  5. Confirm that Branch can receive your public profile

    Public profile

  6. Confirm that Branch can have permissions ads_read

    OAuth scopes

    ads_read is used to surface impressions and clicks on the Branch Dashboard.

  7. Select the ad accounts for which you want to run app install ads or app engagement ads

    Choose ad accounts


Ad Account FAQ

If you are having trouble finding or selecting the ad account(s) for which you want to run ads, please visit our FAQ.

  1. Click to select a Facebook app id for which you want to run Facebook ads

    enter app id

  2. Copy the app id

    find app id

  3. Paste the app id and press Save

    paste app id

  4. Facebook is now enabled as an ad partner!

    Note that if you have different attribution windows between Facebook and Branch, those will be highlighted. The warning has a link to the docs on how to align these attribution windows.


  5. Finally, to create a Facebook Ads link click the Create Facebook Link button in the top right hand corner.

    Create Facebook Ad Link


Create a Deep Linked Ad Feed

Branch makes it easy for you to create and manage feeds with Facebook-compatible deep links.

  1. Create a Branch Deep Linked Ad Feed from the Partner Management page's Create Ad Link button under the Facebook Partner and select Create Product Link
  2. Enter a Deep Linked Feed Name.
  3. Enter a already set up feed source or upload a new source.
  4. Configure the feed with the Ad Partner set to Facebook, and the Ad Format set to Product.
    Ad Link Setup
  5. On the next section, select any keys from your feed that you'd like to include in the deep linked data contained in the generated links.
  6. If you used a Feed Source hosted on a URL (recommended), you will see two options for accessing your feed. We recommend selecting “Schedule Refresh.” If you select this option, Branch will host a URL for your Deep Linked Feed that will update itself from your Feed Source URL at regular intervals.
  7. Download the feed data or copy the deep linked feed URL (for hosted feeds) to be used in your Ad Campaign.

Upload your feed to Facebook

To set up a Facebook Product Catalogue campaign, you will need to first create your campaign and use a Branch link as the Deep Link URL for the advertisements. Facebook Dynamic Ads information is available here{:target="_blank"}.


Feed Sources

Branch accepts Feed Sources that are compatible with Facebook’s feed format. Please use Facebook’s Product Feed Debug Tool to test and debug your Product Feed format.

While Branch requires you have at least a column for the field link in your Feed Source containing the link to the merchant's site where the item can be bought, Facebook requires several more fields. Please make sure you've included all of these fields in your product feed.

The largest file size accepted by the tool is 50MB. Please contact our support team if you need to upload a larger file

  1. Navigate to your Facebook Ads Manager.
  2. In the top left hand corner, click into the menu, select All tools, and select Product Catalogues.
    Facebook Product Catalogues
  3. From the drop down menu click "Create new catalog...", name it (remember this name, you'll need it later) and select "Products sold online".
  4. Now that you have a product catalog, you can add a new feed. Click "Add Product Feed."
    Add New Feed
  5. If you have a Hosted Deep Linked Feed (recommended), select the option "Scheduled recurring uploads." Paste your Branch-provided URL into the Feed URL text field.
    Feed URL option
    Feed URL settings
  6. If you've created a Deep Linked Feed CSV file to upload, select the option "Single upload: Upload a single file feed now." Select the Deep Linked Feed URL or CSV file you would like to upload to Facebook, and click "Upload".
    Feed Uploaded
  7. Wait for the upload to complete successfully. If you'd like to create a "Product set" (a subset of products in your catalog for use in specific ad sets) you can do that now.

Setting up App Events and the Facebook Pixel

Facebook requires you to report events about your users interacting with your content, for example: viewing, adding to cart, and purchasing. To add the Facebook Pixel to your website, and event tracking using the Branch SDK (which forwards to Facebook) to your app, follow these instructions:

Use the "Product events" tab in your Product Catalog view to ensure that Facebook is registering the events against your Product Catalog items correctly.

Creating a Dynamic Ad Campaign

  1. Navigate to while logged in to the account that owns your Facebook app.
  2. Choose Product Catalog Sales. Select the Product Catalog to which you uploaded your Deep Linked Feed.
    Feed Uploaded
  3. Select the targeting, bid, budget and placements that you'd like.
  4. Select your desired ad format and launch your campaign. The Branch deep linked feed will be automatically set up in your Facebook product catalogue ads.


Driving Installs with Dynamic Ads

By default, Facebook sends customers without the app to your mobile website. To drive installs, you can send customers without your app the app store by adding a web_should_fallback column to your Feed Source and setting each row to false. Then, after you've created your campaign, edit the ad within your ad set. Under Creative set your App link destination to Deep link, app store backup.

View Your Data

The Ads Analytics Page on the Branch dashboard provides an interactive time series graph and table to view the performance of your Ad campaigns.

Example Ads Analytics Graph

The table shows summary data on the performance of each Ad campaign. On the right top side of the table you can find a download button to retrieve the chart's content as a CSV file.

Example Ads Table


Interacting with your data

Breakdown and compare aspects of your Ad campaigns' performance by using the Compare by + button to add a parameter to split the data displayed data by.

Then use the and + button to refine the data displayed to gain deeper insight into the performance of your Ad campaigns.


We now have a dedicated FAQ page for Facebook app ads. If you are having any issues with app ads, please review the FAQ.

If you are having issues with web-only ads, you can check out the FAQ.

What’s Next