Facebook Partner Integration

This article describes how to configure attribution settings for Facebook. To learn how to set up Facebook as a data connector, see the Facebook Data Connector guide. For troubleshooting your reports, see Troubleshooting Facebook Data Discrepancies.


With Facebook Mobile App Install Ads, you can launch advertisements on Facebook's Audience Network and target relevant groups of people at the right time and place. Singular is a Facebook Mobile Measurement Partner that allows app publishers to track ad download referrals that come from Facebook.

With Singular, you can track both click-through and view-through performance for your Facebook campaigns. Once a download has been verified by Singular, you can also track subsequent user engagement and monetization of these users in your mobile app.

Singular's Facebook campaign tracking integration also includes Instagram tracking. Once your Facebook tracking integration is set up with the below steps, Instagram conversions will be tracked within Singular as well.

To set up Facebook attribution tracking for an application:

  1. Prerequisites:

    Make sure your app is integrated with Singular via the Singular SDK or a S2S integration. For more information, see iOS integration, Android Integration, S2S Integration.

    Accept Facebook’s Advanced Mobile Measurement Agreement: To agree to Facebook's Advanced Mobile Measurement Agreement, or check your status with this agreement, click here.
  2. Set up Facebook mobile app install ads:
  3. Add Facebook App ID to your Singular Account:
    • Retrieve your Facebook App ID from your Facebook App Dashboard.


    • Navigate to the Partner Configuration page of your Singular Account.
    • Search for “Facebook” in the partner search box:


    • Confirm you have signed the Facebook Advanced Mobile Measurement agreement in your Facebook Ad Accounts.  This allows Singular to share Facebook data with any of your connected BI tools.


    • Enter your Facebook App ID


      Tip: You can add multiple Facebook App IDs by separating them with a with a comma, for example:


    • View-through tracking is enabled by default but can be disabled if needed by deselecting:


    • Save the integration.

      Note: By saving the Facebook integration configuration here, Singular is automatically tracking installs and sessions to Facebook. This corresponds to the mobile_app_install and fb_mobile_activate_app events. You do not need to configure these events separately in step 5.

  4. Send Event Postbacks to Facebook (Optional): Singular supports sending event notifications to Facebook with all of Facebook's requirements.image5.png

    • First, select enable sending in-app events to Facebook by selecting All.
    • Next, map your In-app events:

      • Select the event name on the left field, according to the name used in the SDK, and map the name to one of Facebook predefined conversion events.
      • Check the Send value checkbox if relevant (for example, revenues). If not checked, only counts of the event will be sent.

See also: Using the Facebook SDK and Singular SDK/S2S in the Same App

Facebook In-app Event Requirements

Some Facebook in-app events require certain arguments to be passed in order to be processed by Facebook. Please see the below required arguments for Facebook in-app events

Facebook Event Name Required Argument(s) Supported Values
AdClick ad_type ad_type - "banner","interstitial","rewarded_video","native"
AdImpression ad_type ad_type - "banner","interstitial","rewarded_video","native"

For example, if you are sending an SDK event called "Click" and would like to map it to the Facebook Event Name "AdClick", ensure that "ad_type" is being sent in the "Click" event like below:

Android Example:

Singular.event("Click", "ad_type", "banner");

iOS Example:

[Singular eventWithArgs:@"Click", @"ad_type", @"banner", nil];

Tracking Facebook Mobile App Installs in Singular

After completing the steps above to enable Facebook Attribution Tracking, you can see the results of your Facebook's Audience Network campaigns in your Singular Reporting. Each install attributed to a Facebook Mobile App Install Ad will automatically be reported based on the Campaign Name, Ad Set, and Ad Group Name created in Facebook's Platform.

Attributions from ads within Facebook's App will be reported with the Publisher Facebook. Attributions from Instagram will show Instagram as their publisher. Attributions from Partner Mobile Apps on Facebook's Audience Network will show Audience Network as their publisher:

About Click-Through Tracking

As with all click attribution, Facebook click-through attribution refers to the ability to credit an ad campaign for an install if an individual has clicked on an ad prior to that install. When a user clicks an ad, installs the app, and later launches the app, it’s assumed that the click led to the download, and that installation is attributed to that specific ad. Click–through attribution is always given credit for an install if there are clicks that have occurred in the attribution window. If there are no clicks, then view-through tracking is applied.

About View-Through Tracking

View-through refers to the ability to credit an ad campaign for an install even if no one has clicked on an ad. The idea behind view-through is that it makes a causal contribution to driving an install even if the viewer does not click the ad.

Singular is pleased to offer view-through tracking for Facebook. By tracking Facebook view-through as part of your app attribution and measurement, you will be able to make smarter decisions about campaigns, creative executions and more. With Facebook view-through, the last ad impression is credited with an install if there are no ad clicks to which you can attribute that install. View-through is an increasingly becoming an invaluable measurement metric for evaluating and optimizing campaigns. View-through attribution & reporting will not affect your media costs for Facebook CPM or CPC campaigns. Rather, view-through measurement gives you another valuable tool to improve your decision-making and optimization.

Singular view-through tracking utilizes the Facebook 1 day view window. Note that view-through attribution is enabled by default.

Reporting on Facebook Installs

Singular reporting for Facebook attributions utilize the values as named in your Facebook campaigns.

Facebook values are mapped to Singular reporting dimensions as follows:

Singular Value Facebook Value Example
Tracker Campaign Name Campaign Name “MyCampaign”
Tracker Campaign ID Campaign ID 12345678
Tracker AdGroup Name AdSet Name “MyAdGroup”
Tracker AdGroup ID AdSet ID 98123747
Tracker Creative ID Ad ID 123192873

When running a Facebook report, Singular will also match the SDK data with the marketing data provided by Facebook Ads API, including:

  • Spend by Campaign
  • Spend by Creative, including the image or video
  • Account ID

Frequently Asked Questions (FAQ)

How does Singular track Facebook installs?

As a Facebook Mobile Measurement Partner, Singular has a unique line of communication with Facebook that enables attribution tracking. After the download of an application with Singular's SDK and Facebook Attribution Tracking enabled, Singular receives information about which installs originated from Facebook.

Are communications between Singular and Facebook secure?

Singular uses all the necessary security measures required by Facebook to ensure communications between Singular and Facebook are secure. We also comply with all of the privacy policies set forth by Facebook to protect your data.

I'm still not seeing Facebook attributed installs, where can I get help?

If you've followed the setup steps, but still aren't seeing Facebook attributed installs after performing your test, please contact Singular's Support Team for additional help. Please provide your account name, the applicable application, and your Facebook App ID in your initial email to help ensure a quick resolution.

Was this article helpful?
0 out of 0 found this helpful