Audience Network

Facebook Login integration with Audience Network Reporting API V2

Updated: Jun 30, 2026
Copy for LLM
Facebook Login is a new way of allowing access to Audience Network Reporting API data. This approach will be replacing the old copy-pasting system user token from Monetisation Manager interface. This approach is a more secure way of giving access to your data, due to the risk of Monetisation Manager token getting exposed outside of the business.
This document focuses on providing guidance for direct reporting API integrations, Mobile Measurement, Mediation and other Facebook partners that are working on accessing Reporting API data on behalf of publishers.

I’m using third-party to get Reporting API data

If you are using the existing partner (Mobile Measurement or Mediation Partner), there’s no additional coding work required from you. Make sure that your partner integrates Facebook Login flow. You will have to click on the “Login with FB” option and select the properties that you want to give access to with the token that you will generate.
If you select ALL properties, the token will provide access to all the properties under the Business as long as the user that created the token has access to the property in the Business Manager.

I’m a partner accessing Reporting API on behalf of Publishers

If you are a Mobile Measurement or Mediation Partner, you will need to integrate the Facebook Login flow into your system by following the Direct API integration with UI interface section. This will enable you to access Reporting API data for your publishers.

Permissions

If you need to use the Reporting API directly, you’ll firstly need to create a Facebook app and obtain required permissions. Your app will need read_audience_network_insights permission to access Audience Network Reporting API data. In order to get this permission for your app, the business needs to be onboarded to Audience Network⁠.
  • Once onboarded in the Monetization Manager⁠, go to the Facebook Developers page and start creating new business application. We recommend having an app specific for Reporting API tokens. App creation Use cases step with Advertise on your app with Meta Audience Network selected
  • Select your Business in the next step. A business must be selected to gain access to the Reporting API: App creation Business step prompting to connect a business portfolio, with Example Business selected
Your application is now onboarded to Audience Network and can use the read_audience_network_insights permission. If you can’t see the read_audience_network_insights make sure that the app is linked to a Business that has access to your Monetization Manager Business account. If not, create a new app.
The way you approach accessing the Reporting API will vary depending on the type of integration that you have. Please follow the instructions that apply for your case:

Direct API integration without UI interface

If you have a custom (direct) Reporting API integration without any frontend/UI interface and you use it to query the data for your business only, you can use the following instructions to get access to Reporting API.

Create user token through Graph API Explorer

  1. Follow instructions on obtaining read_audience_network_insights permission
  2. Go to Graph API explorer
  3. Select your app
    4. Graph API Explorer with the Meta App dropdown highlighted to select your app
  4. Select read_audience_network_insights permission (can be found under Permissions > Events Group Pages)
    5. Graph API Explorer Permissions panel with read_audience_network_insights added
  5. Select Get User Access Token / Get Token
    6. Graph API Explorer User or Page dropdown open showing the Get User Access Token option
  6. Finally, click on "Generate Access Token". A pop-up will appear.
  7. Follow the instructions to give the permission to all current and future Properties to the generated token.
    8. Login dialog asking to opt in to all current and future Properties for the Reporting API app
You can now access Audience Network Reporting API data for a short time with this token instead of the one from Monetisation Manager.Disclaimer: this token will expire in 2 hours, you’ll need to turn it into the Long-Lived access token using the instructions below.

Turn this token into the Long-Lived access token

  1. Go to Access Token Debugger
  2. Insert your token and press "Debug"
  3. Scroll all the way to the bottom of the table that contains all the token information, click on the button "Extend Access token"
    4. Access Token Debugger token info table with the Extend Access Token button highlighted
  4. Copy the resulting token
    5. Resulting long-lived access token with its expiry date shown below the Debugger
You can now access Audience Network Reporting API data with this token.Disclaimer: You should only use this token to query your own data.

Direct API integration with UI interface

The following guide is useful for publishers and partners with their own UI interface on which Facebook Login for Business can be placed. This guide is useful for publishers willing to access their own data, as well as partners who would like to access other publishers monetization data with their permission.
  • On Developers portal, select your newly created business app from previous steps
  • Add a new “Facebook Login” product to this app App Dashboard Facebook Login for Business Quickstart with iOS, Android, Web, and Other platform options
  • Select “Web” option and follow the integration steps Facebook Login Quickstart with the Web tab selected showing the setup step list
  • Insert website URL where you’ll show your Facebook Login experience. Make sure it supports HTTPS protocol Web Quickstart Tell Us about Your Website step with a Site URL field to enter and save
  • At the end of the integration steps, you’ll be provided with the example code to integrate Facebook Login at your site. You can copy this code, however, using the newly accessed “read_audience_network_insights” permission instead of the suggested scoped permissions. With the updated permission your button code should look like this:
<fb:login-button
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>
  • Make sure you enable JavaScript SDK in the Facebook Login on the product settings page for your app Add the Facebook Login Button Quickstart step showing example fb:login-button and callback code
  • Now, users can go through the Facebook Login flow on your page to generate access token
  • The access token will be returned as a part of the argument passed to the statusChangeCallback JavaScript method from previous steps. Browser console showing the authResponse object with access token returned after successful login
  • By default, this token will expire in about 2 hours
  • Developers can request to extend this token to the Long-Lived access tokens without additional user interaction.
    • Long Live tokens are refreshed once per day, when a Reporting API request is made to Facebook’s servers. If no requests are made, the token will expire after about 60 days and the person will have to generate a new token.
  • Keep in mind that the data available through this token is heavily dependent on who is passing through this Facebook Login flow and what data they agree to share. So, if the business employee is passing through this flow, then the resulting access token will have the same permissions as this employee.

Troubleshooting

Error Message What it Means Action / how to solve
Reading insights of a Page, business, app, domain or event source group not owned by the querying user or application
For Facebook Login token, it means that either the app issuing token doesn’t have sufficient permissions (read_audience_network_insights) or a user themself doesn’t have permission to view certain properties. This can happen because:
  • The user that generated the token has not been given access to the Business Manager.
  • The user that has created the token hasn’t been given access to all the properties queried.
The Business admin needs to provide access to all the properties to the user that wants to generate the token or has generated the token.
Missing or Empty data
This normally means that all or some of the data was filtered using our privacy aggregation. This can also be validated against MoMa data.
Check if there is an omitted_results array, this means that the data is being aggregated, please try a larger request. For more information, please read the aggregation section.
read_audience_network_insights not visible for the Token
The app created does not have a business portfolio attached.
Ensure that you are creating the App that has a Business associated with it. Try to create a new app and ensure you follow the instructions under the Permissions section.
Error validating access token: Session has expired on ...
The token has expired
Please ensure that the token is converted into a Long Live token. Follow the instructions under the “Turn this token into the Long-Lived access token” section Long Live tokens are refreshed once per day, when a Reporting API request is made to Facebook’s servers. If no requests are made, the token will expire after about 60 days and the person will have to generate a new token.
Two Apps with the same name are showing
Check if one app has read_audience_network_insights permissions
Use the app that has the correct read_audience_network_insights permissions.