To connect Supermetrics to Facebook Audience Network, you will need to create an App, setup a system user account, and finally generate a user access token. You will then use this user token to connect with Supermetrics.
The instructions below will guide you through the full process to get the user tokens needed to connect.
Quick links to the sections below:
- Before You Begin
- Step #1 - Setting Up Your App
- Step #2 - Creating the System User and Access Token
- Step #3 - Connecting Supermetrics to Facebook Audience Network
- Further Assistance
Before You Begin
This connector requires that you have a valid Facebook user account and a valid Facebook Business Manager account that is connected to an Audience Network property.
Your Facebook user account must have admin privileges to the Business Manager you wish to connect to, as this is required to add the app and system user.
This process will generate access tokens that are basically user credentials to access your Facebook Audience Network data. Protect the access tokens like you would a password!
Step #1 - Setting Up Your App
To get started, you only need to create a basic app and use it in development mode. These instructions only over the basic app setup. However, if you go through the process to complete and get your app approved for your business following Facebook's App Review process, you will gain additional request quota, which may be necessary if you need to make a lot of requests for Audience Network data.
- Log into Facebook for Developers with your Facebook user account. https://developers.facebook.com/apps/
- This Facebook user should be an admin of the Business Manager account you will be connecting the app with later, as it will make the process faster.
- Click Add a New App.
- Add a meaningful Display Name for your app and contact email. Click Create App ID.
- This will create a new app and it should redirect you to the app's dashboard. Copy your APP ID found near the top for the next steps.
- Log into the Business Manager with the properties you want to pull data from with Supermetrics. Follow these steps to connect your newly created app to the Business Manager: https://www.facebook.com/business/help/2199735813629697?id=420299598837059
- You will now be able to proceed to Step #2 - Creating the System User and Access Token.
Step #2 - Creating the System User and Access Token
With the app created and connected to your Business Manager account, you can now create the System User account, link it to your properties, and generate the access token needed for connecting through Supermetrics.
- Open the Business Manager Settings.
- Follow Steps 1 - 4 of this guide to setup and configure the System User and obtain the access token: https://developers.facebook.com/docs/audience-network/guides/reporting/system-user
- IMPORTANT- Step 4d of the above guide instructs you to add the 'read_audience_network_insights' scope. You also need to add 'business_management' scope.
- IMPORTANT- Step 4d of the above guide instructs you to add the 'read_audience_network_insights' scope. You also need to add 'business_management' scope.
- Copy the access key shown in Step 4.e of the guide, you will need this for configuring the Supermetrics connection in the next section.
Step #3 - Connecting Supermetrics to Facebook Audience Network
Once you have obtained the access key for the System User linked to your properties, you can now connect Supermetrics to your Facebook Audience Network data.
- Open your Supermetrics product and click on the Facebook Audience Network data source.
- A new window should open asking you for the two parts for authentication that you obtained at the end of setting up you API keys: API Key and API Secret. Fill those and click START to continue with the authentication process.
- You are now ready to create queries with the Facebook Audience Network connector!
Further Assistance
If you have issues with the Supermetrics connection part of the process, please create a new support request with the details of the issue and we will assist you.