Option 1: Publisher Steps in Monetisation Manager (During Onboarding):

The user generated token below is associated with the System User: "MediationSystemUser". To assign it to any other User, please go to Business Manager Settings

Step 1: Open Monetisation Manager and create a new property

Step 2: During Onboarding, Click on "Add System User Token" to view "Generate Token" button

System User Token

Step 3: Click on "Generate Token" button to get a token for your property.

Generate Token
Generated Token

Option 2: Publisher Steps in Monetisation Manager (After Onboarding):

The user generated token below is associated with the System User: "MediationSystemUser". To assign it to any other User, please go to Business Manager Settings

Step 1: Open Monetisation Manager and go to your Property page > Manage Property

Manage Property

Step 2: Here you will notice the "Generate token" button after the property has been set up.

Generate Token

Step 3: Click on the "Generate token" to get the System User Token for this property

Generated Token

If you are having trouble with tokens, try creating a brand new token using the following steps.

Step 1: Create a new App ID (for the Access Token only)

  1. Log in to Business Manager .
  2. Navigate to Business Settings > Accounts > Apps.
  3. Click on + Add drop-down button, and click Create a New App ID.
  4. Select Business as the App ID, and click Continue.
  5. Enter an App Display Name and an App Contact Email, and click on Create App.

Step 2: Create System User on Business Manager (if you don't have one)

If you already have a System User in Business Manager, go to Step 3:
If you don't:

  1. Navigate to Business Settings > Users > System Users, then click on Add.
  2. Enter a System Username, and the select the System User Role for this user. Click Create System User.

Step 3: Set System User as App Developer

  1. Navigate to Business Settings > 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 the Token with the System User

  1. Navigate to Business Settings > Users > System Users > System User Name (where System User Name is the actual name of your System User).
  2. Click on Generate New Token and select the newly created app.
  3. Grant read_audience_network_insights to this app.
  4. Click Generate Token.
  5. Save the newly created Token.

Step 5: Add Properties to the System User

If you have properties already created in Monetization Manager, set them up to be managed by the System User:

  1. Navigate to Business Settings > Users > System Users, and select the System User name.
  2. Select Add Assets > Properties.
  3. Select an Asset Name, then turn on the Manage Property slider.
  4. Click Save Changes.
  5. Repeat steps 1 to 4 for each existing Property, and for each Property you add to Monetization Manager.

Step 6: 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.