Bidding with In-House Mediation

Facebook Login - In-House integration publishers guide

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.

Currently, we are enforcing Facebook Login for Reporting API v2. We are planning to enforce Facebook Login for Reporting API v1 by July 1, so make sure you migrate to Facebook Login.

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. Due to the nature of the old approach of token copy-pasting, we don’t have information which partner is currently accessing your data.

I’m using in-house solution with UI interface

If you have a custom solution for which you can change the UI and add the “Facebook Login” button, follow the integration and authentication guide that we linked in the Reporting API v2 documentation. There you can find a link to platform-independent (mobile, web, devices) guide on Facebook Login integration.

I’m using in-house server-to-server solution

If you have a custom solution without any frontend interface and you use it to query the data only for your business, you can follow the approach of querying your data using the Marketing API access.


Create user token through Graph API Explorer

  1. Go to https://developers.facebook.com
  2. Create a new app
    • Create a business app and assign it to the Audience Network business containing data you want to get access to
    • Make sure you are assigning app to the business and not attaching it to any Audience Network monetization property
  3. If you are already using “Marketing API” in your app, skip this step. Otherwise, follow instructions on obtaining read_audience_network_insights permission
  4. Go to our Graph API explorer
  5. Select your app, enter necessary permissions and generate a token
    - 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 guide below.

Turn this token into the Long-Lived access token

  1. Go to Access Token Debugger
  2. Insert your token and press “Debug”
  3. Below the table with token information, click on the button “Extend Access token”
  4. Copy the resulting token

You can now access Audience Network Reporting API data with this token instead of the one from Monetisation Manager.

Next Steps