Enabling Ad Manager Line Item API Access for //Signal

The //Signal reload can be applied to only a few items. Learn how to apply exclusions based on Line Item Type, Order ID, or placement.

In order to provide in depth reporting, honor exclusions, and accurately bill you for //Signal, we require read-only API access to your Ad Manager account.

API Access allows us to:

  1. Detect specific line item types, order IDs, or placements are on the page, and exclude that inventory from reloading — allowing you to reload inventory more selectively.
  2. Pull impression data to deliver in-depth automated reporting directly to your inbox
  3. Ensure that our billable numbers are accurate, so you are invoiced fairly

In this guide you can find all the steps on how to setup API access correctly. Please note that the process differs slightly depending on which Ad Manager version you use. We have included guides for both Google Ad Manager & Google Ad Manager 360.

Google Ad Manager - Small Business set up

Step 1 - Create a Role

In your Google Ad Manager account, create a new Role under the Admin section.

Admin > Access and Authorization > Roles.

Name the Role as “API Access User” for example.

Under “Trafficking and delivery” apply the following permissions:

  • View ad units, placements, mobile apps, key-values, and labels

Screenshot 2021-12-01 at 17.17.29

Step 2 - Create a Service Account User

Under Admin > Global Settings > Network Settings, click “Add A Service Account User”.

Just like in the screenshot below:

Name the new service account user as “sovrn-reload” for example, and use the following email address: service@onscroll-dfp-gateway.iam.gserviceaccount.com

Add the Role created in the first step (so for example “API Access User”) and Save.

Google Ad Manager 360 - with Team feature enabled

Steps are a bit different if you are using a “Team” feature in your GAM account.

Step 1 - Set up Role

Enter a name just like above for Step 1 and name it for example “API User Access”. Make sure to check these boxes :

  • View Creatives
  • View ad Units
  • Placements and key values
  • View my orders and line-items

Then save.

Step 2 - Create a Service Account User

Go to Admin > Global Settings > Network Settings and click “Add A Service Account User”.

If “Teams” are enabled, when setting up the new service account user, ensure this new user has permission to view ‘All entities’. Make sure the box highlighted below is checked.

Don’t forget to reach out to Sovrn Support if you encounter any issues.