Step 1: Create System User on Business Manager

  1. Open Business Manager Settings and select Users > System Users from the menu on the left.
  2. Click on + Add button to add a system user.
  3. Adding system user to a business without users.
    Adding system user to a business with existing users.
  4. Set the System User Name and select Regular System User for the System User Role. You don't need to create an Admin System User to use the Audience Network Reporting API.
  5. Click Create System User to complete the process.
  6. Create System User dialog.

Step 2: Add System User to the Property

  1. On the Business Manager Settings page, select Data Sources > Properties.
  2. Find and select the Property from the list so that the System User can access to Audience Network insights.
  3. Click Add People.
  4. Property selection.
  5. Select the new System User and enable the Manage Property setting. By adding system user to property, you are granting system user to access your property data.
  6. Click Assign to complete the process.
  7. Assign system user as property manager.

Step 3: Set System User as App Developer

  1. On the Business Manager Settings page, select Accounts > Apps.
  2. Find and select your app in the list of apps, and then select Add People.
  3. Add people to app.
    If your app is not listed, then the app isn't associated with your business. Use the Add button to associate the app ID of the app with your business. You can find your app id in the Facebook Developer App Dashboard.
  4. From the Add People and Set Permissions window, select your system user and enable the App Developer permission. Click Assign.
  5. Give the system user app developer permissions.

Step 4: Generate System User Access Token

  1. On the Business Manager Settings page, select System Users.
  2. Find and select your system user. Click Generate New Token.
  3. Generate new token for system user.
  4. From the Generate Token window, select your app from the Select App drop-down. This app that will be used to query Audience Network Insights.
  5. API access will be given the all properties that you have added on step 2 regardless of what app you chose while generating the system user token.

    As a best practice, and to make management easier, we suggest that you create and use a Facebook App ID that is different from the app/property that's using Audience Network. You can create this specific app id by clicking on Add a New App on developer site. If you need to add the application to your business, you can check out this help center article.

    Select app.
  6. Select read_audience_network_insights to be able to read Audience Network insights. Click Generate Token.
  7. Select permissions.
  8. Your generated token will be displayed. This token is not saved on Facebook servers so it cannot be recovered. Copy and save it in a secure location for future use.
  9. Generated token.

Step 5: Using the token

  • Use the system user access token with your API queries.
  • If you are using mediation platform, you can enter the system user access token and property ID on its dashboard to allow the platform to read your property data.
  • If you generate a new system user access token, the old token will still be valid and have the same permissions as the new token unless it is revoked.