Publisher Ad Server – Google Ad Manager Set-Up and Permissions

This document explains how Freestar configures our header bidding set-up in your Google Ad Manager (GAM) account and walks you through the permissions required to integrate with our platform. Please let us know if you have questions about any of the permissions described below.

Existing Set-up

We are expecting that your programmatic ad units (to be used with Freestar) have already been created in your Google Ad Manager (GAM) account. If not, create the necessary ad units.

We are also expecting that this GAM will be the only one used on your pages. Since all GAM set-ups use the GPT library, multiple GAMs on the same page can cause unexpected issues and impact ad serving or reporting.

Please note, we are unable to accept publishers/sites that have Ad Exchange or AdSense site-wide policy bans or are denied from Google.

Changes Freestar makes in your Google Ad Manager account

Key-Values

Freestar will add the following key-value combinations into your Google Ad Manager (GAM) account for bid communication and reporting.

Key Name (using Publisher Ad Exchange)ValuesReportablePurposeRequired
srt_b424NoEncoded bid price valuesYes
srt_bs16NoAd size valuesYes
srt_u15,000YesEncoded reporting values; the quantity of values is configurable; 15,000 is our defaultYes
srt_sdbg10YesValues used for manual report pullingYes
srt_as2YesValues to measure split tests added if split testingNo
srt_s1NoValue for Freestar's AdX account; added when using Freestar’s AdX accountNo
srt_st15NoValues for declaring ad refresh to AdX; added when using Freestar’s managed refresh; added with our default set-upNo

Customer

Freestar will add the "Sortable" customer to allow our orders to be associated.

Orders, Line Items, and Creatives

Freestar uses the Google Ad Manager API to add 16 orders with 424 line items each (with our necessary creatives) into your Google Ad Manager account. We will pass the highest-priced bid to your Google Ad Manager (GAM). 

Interstitial Ad Units

We will create the interstitial ad unit for you and load the interstitial through our tag file unless you reach out to us to opt out. Our default set-up is to create an interstitial ad unit (sizes: 320x480, 300x250, and 336x280) to be used on your site. If you have an existing Google Ad Exchange order, we will add the new interstitial ad unit into the targeting and the three (3) sizes with any necessary creatives to ensure it can serve. 

Refresh Declaration

We will add our managed refresh and the required Google Ad Exchange declarations to your GAM unless you reach out to us to opt-out. This includes adding the st key described above and the required publisher declarations based on the time intervals and types of refresh Freestar uses. When Freestar's managed refresh is enabled, we will send the key and the appropriate value with the ad requests so that the declaration of refresh is sent to the Ad Exchange being used with your account.

Creating a user for Freestar in your GAM account with permissions 

  1. In the Admin tab of your Google Ad Manager, navigate to Access & authorizationUsers. Click New user.
  2. Enter the following information in the required fields.

  3. Select the appropriate user role. 
    • GAM Small Business: Administrator – This user has access to all Ad Exchange and Google Ad Manager functionality.
    • GAM 360: Administrator or create a custom role that grants access with the specific permissions needed to set up header bidding orders and maintain ongoing reporting via the API. The permissions required are described in the table in the Custom user permission breakdown section (below). Along with the typical Google Ad Manager permissions, include the Ad Exchange permission in the Access to Google Ad Manager tabs section to allow access to both sections. If using Teams, add "Sortable" to “All entities” so that we can complete our set-up.
  1. Click Save to send an email invitation to Freestar.

Custom user permission breakdown

If creating a custom user profile for Freestar, use the following list of permissions. We need two (2) sets of permissions for initial set-up and reporting. 

  • The initial set-up permissions at the start of the integration allow Freestar to set up key values, line items, and creatives. You can disable the extra set-up permissions once your test page or live site verification has passed our testing. 
  • The reporting permissions allow Freestar to pull API data from Google Ad Manager and Ad Exchange to ensure we can report on your total earnings.
Define and deliver ordersInitial set-upReporting  (always on)
View all orders and line items
Edit the priority and delivery rate for line items
View creatives
Edit creatives
Enable and disable creatives
Pause, unpause, archive, and unarchive orders and line items
Approve and reject orders and line items
View ad units, placements, and key-values
Edit ad units, placements, and key-values
View my orders and line items
Edit approved orders and line items
Activate line items
Edit creative templates
Edit orders and line items, and submit for approval
View line item defaults
Edit key-values values
Manage peopleInitial set-upReporting (always on)
View users, roles, and teams
View companies and contacts
Edit companies
ReportingInitial set-upReporting (always on)
Create and view reports
View dynamic allocation opportunity report
Create and view Ad Exchange reports
Access to Google Ad Manager tabsInitial set-upReporting (always on)
Delivery
Admin
Inventory
Ad Exchange

Enabling API access in your Google Ad Manager account

Freestar requires API access to add our set-up into your Google Ad Manager account, and to continue to pull hourly reports to ensure you will be paid the full amount owed to you for your earnings. This setting needs to remain active while using Freestar. 

To enable, in the Admin tab of Google Ad Manager, select Global Settings and ensure that the API access toggle is enabled.

Multiple Customer Management (MCM) Request

In order to work with Freestar and allow us to traffic our inventory through your GAM, we will send you an MCM request after we have been given access to your GAM account. Once you have received this request, please review and accept the agreement. This provides Freestar with the permission to traffic in your account and to speak to Google on your behalf should there be a need to escalate any issues or questions.

For industry insights and information about our product offerings, check out our blog!

Want to see our products in action? For a demo, fill out a form here.