Enabling Ad Manager Line Item API Access for //Signal

Last Updated May 15, 2020

If you don’t want the //Signal reload to be applied to certain items, we can apply exclusions based on Line Item Type, Order ID, or placement. In order to detect if these items are present on the page and withhold the reload, we require API access to your Ad Manager account.

The information in this article details how to set this up.

Here are the most important reasons why this setup is required.

  1. If you want to be selective about what inventory //Signal Reload is applied to, we can apply exclusions based on Line Item Type, Order ID, or placement. In order to detect if these items are present on the page and withhold the reload, we require API access to your Ad Manager account.
  2. For billing purposes, it is highly recommended to enable the API and allow our team to view specific line items reloaded. 

In this guide you can find all the steps on how to set this up correctly. There are two different set up to follow in case normal Google Ad Manager is used or in case Google Ad Manager 360 is used.

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 all orders and line items
  • View creatives
  • View my orders and line items

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.

How satisfied are you with this article?

  • Not at all satisfied
  • 1
  • 2
  • 3
  • 4
  • 5
  • Completely satisfied