Facebook Platform Ads

Overview

Branch links can be used together with a variety of Facebook ads, allowing you to track ad performance on the Branch dashboard and to deep link new users from ad-driven installs directly to content the first time they open your app.

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
AwarenessBrand AwarenessCross-platform Display
AwarenessReachCross-platform Display
ConsiderationVideo ViewsCross-platform Display
ConsiderationLead GenerationCross-platform Display

Facebook Campaign Advert Format Support Table

Facebook Campaign TypePhotoVideoCarouselSlideshowCollectionDynamicCanvas
Brand Awareness✔︎✔︎✔︎✔︎✔︎
Reach✔︎✔︎✔︎✔︎✔︎
Video Views✔︎✔︎✔︎✔︎
Lead Generation✔︎✔︎✔︎✔︎

📘

Facebook Campaign Types

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

Setup

🚧

Prerequisites

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

📘

Enable 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 ManagementAds Partner Management

  2. Search for Facebook.

  3. Click Connect With Facebook

    Connect with FacebookConnect with Facebook

  4. Login to Facebook if you are not logged in

    LoginLogin

  5. Confirm that Branch can receive your public profile

    Public profilePublic profile

  6. Confirm that Branch can have permissions ads_read

    OAuth scopesOAuth 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 accountsChoose 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 identer app id

  2. Copy the app id

    find app idfind app id

  3. Paste the app id and press Save

    paste app idpaste 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.

    completecomplete

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

    Create Facebook Ad LinkCreate Facebook Ad Link

Create an Ad Link

  1. Create a Branch Ad link from the Partner Management page's Create Facebook Link button under the Facebook Partner and select Create Display Link or Create Display Link depending on your campaign type.
    imageimage
  2. Pick a Link Name for later reference.
  3. Configure the link the Ad Partner set to Facebook and the Ad Format set to Cross-Platform Display or Cross-platform Display.
    Create Ad LinkCreate Ad Link
  4. Under the Configure Options tab, navigate to the Redirects sub section and ensure that the iOS/Android and Desktop redirects are set to the desired destinations being promoted by the ad campaign.
    Create Ad LinkCreate Ad Link
  5. Under the Analytics Tags sub section additional tags can be set. It is recommended to fill in these fields as they can be used as filters in Branch's Ads Analytics view. To best connect your ad link with your Facebook Campaign, set the channel field to Facebook Ads and set the campaign field to the same ad campaign name used in Facebook Ads.
    Analytics TagsAnalytics Tags

🚧

Disabling Deepviews

In order for your campaign to run effectively, be sure to disable Deepviews. You can either disable Deepviews for your entire account or disable Deepviews for one link.

📘

Optional: Deep Link Data

You can use this configuration section to specify custom link parameters that will be deep linked into the app after install. These could include a coupon code or a page identifier to route the user. Visit the Deep Link Routing page to learn more.

Brand Awareness Campaign Setup

Configure an Ad

To set up Facebook Brand Awareness Campaigns, you will need to insert your Branch Ad Link as the Website destination for the created ad. Facebook's Ad guide for Brand Awareness Campaigns is available here{:target="_blank"}.

Create Your Campaign

  1. Navigate to https://www.facebook.com/ads/create while logged in to the account that owns your Facebook app.

  2. Select Brand Awareness as the campaign marketing objective.
    Campaign SelectionCampaign Selection

  3. Continue with campaign creation selecting the app to advertise, audience, placement, and budget. Then press continue to enter the Advert creation step.

  4. Now select an advertisement format and customize your ad

  5. Now add your Branch link to your advertisement

    • Select the Add a Website URL checkbox and copy your Branch Ad Link into the Website URL field.

    Deep Link PlacementDeep Link Placement

    • If you selected to add a full screen Canvas advertisement, add your Branch Ad link as the Destination URL for your canvas advertisement components
  6. Complete the rest of the ad campaign setup.

📘

Optional: Ad formats with Multiple Links

Some ad formats such as Carousel format can handle multiple deep links. To have link performance data on each image or component of the advertisement, create multiple Branch Ad links to be used in each part of the multiple link advertisement format. This format is useful if you want to drive customers to different content pieces or products.

Reach Campaign Setup

Configure an Ad

To set up Facebook Reach Campaigns, you will need to insert your Branch Ad Link as the Website destination for the created ad. Facebook's Ad guide for Reach Campaigns is available here{:target="_blank"}.

Create Your Campaign

  1. Navigate to https://www.facebook.com/ads/create while logged in to the account that owns your Facebook app.

  2. Select Reach as the campaign marketing objective.
    Campaign SelectionCampaign Selection

  3. Continue with campaign creation selecting the app to advertise, audience, placement, and budget. Then press continue to enter the Advert creation step.

  4. Now select an advertisement format and customize your ad

  5. Now add your Branch link to your advertisement

    • Select the Add a Website URL checkbox and copy your Branch Ad Link into the Website URL field.

    Deep Link PlacementDeep Link Placement

    • If you selected to add a full screen Canvas advertisement, add your Branch Ad link as the Destination URL for your canvas advertisement components
  6. Complete the rest of the ad campaign setup.

📘

Optional: Ad formats with Multiple Links

Some ad formats such as Carousel format can handle multiple deep links. To have link performance data on each image or component of the advertisement, create multiple Branch Ad links to be used in each part of the multiple link advertisement format. This format is useful if you want to drive customers to different content pieces or products.

Video Views Campaign Setup

Configure an Ad

To set up Facebook Video Views Campaigns, you will need to insert your Branch Ad Link as the Website destination for the created ad. Facebook's Ad guide for Video Views Campaigns is available here.

Create Your Campaign

  1. Navigate to https://www.facebook.com/ads/create while logged in to the account that owns your Facebook app.

  2. Select Video Views as the campaign marketing objective.
    Campaign SelectionCampaign Selection

  3. Continue with campaign creation selecting the app to advertise, audience, placement, and budget. Then press continue to enter the Advert creation step.

  4. Now select an advertisement format and customize your ad

  5. Now add your Branch link to your advertisement

    • Select the Add a Website URL checkbox and copy your Branch Ad Link into the Website URL field.

    Deep Link PlacementDeep Link Placement

    • If you selected to add a full screen Canvas advertisement, add your Branch Ad link as the Destination URL for your canvas advertisement components
  6. Complete the rest of the ad campaign setup.

📘

Optional: Ad formats with Multiple Links

Some ad formats such as Carousel format can handle multiple deep links. To have link performance data on each image or component of the advertisement, create multiple Branch Ad links to be used in each part of the multiple link advertisement format. This format is useful if you want to drive customers to different content pieces or products.

Lead Generation Campaign Setup

Configure an Ad

To set up Facebook Lead Generation Campaigns, you will need to insert your Branch Ad Link as the Website destination for the created ad. After users fill out the lead form, they'll be directed to your website or app after through the Branch Ad link. Facebook's Ad guide for Lead Generation Campaigns is available here{:target="_blank"}.

Create Your Campaign

  1. Navigate to https://www.facebook.com/ads/create while logged in to the account that owns your Facebook app.
  2. Select Lead Generation as the campaign marketing objective.
    Campaign SelectionCampaign Selection
  3. Continue with campaign creation selecting the app to advertise, audience, placement, and budget. Then press continue to enter the Advert creation step.
  4. Now select an advertisement format and customize your ad
  5. Enter the Lead form creation portal and setup your form.
  6. On the final "Thank you" screen, locate and paste your Branch Ad Link into the Website link field.
    Campaign SelectionCampaign Selection
  7. Complete the rest of the ad campaign setup.

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 GraphExample 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 TableExample 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.

Troubleshooting

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.

Updated 5 months ago



Facebook Platform Ads


Suggested Edits are limited on API Reference Pages

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