Facebook - Attribution Tracking

Setting Up Facebook Install Attribution Tracking

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 Setup Facebook Attribution Tracking for an Application

1. Install the Singular SDK

Facebook Mobile App Install tracking is available for iOS and Android. Get the latest Singular SDK and then read the SDK integration guides.

  • iOS integration - Integrating the Singular iOS SDK will enable Singular to track installs from Facebook Mobile App Install Ads. Once you have the Singular iOS SDK, Facebook attribution tracking will be integrated automatically.
  • Android Integration - Integrating the Singular Android SDK will enable Facebook attribution tracking only after you include your Facebook App ID.


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:

  • Enter your Facebook App ID

    ** 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. 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. Please note, it can take up to two days after accepting the agreement.


5. Send Event Postbacks to Facebook (Optional)

Singular supports sending event notifications to Facebook with all of Facebook's requirements.


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.


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.

 Singular click-through tracking utilizes the 28 day Facebook click window. Click-through tracking is default enabled in Singular Attribution if Facebook tracking is enabled.


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


Tracker Campaign Name

Campaign Name


Tracker Campaign ID

Campaign ID


Tracker AdGroup Name

AdSet Name


Tracker AdGroup ID

AdSet ID


Tracker Creative ID




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.

 For questions and additional information, please contact support@singular.net

Have more questions? Submit a request


Please sign in to leave a comment.