This document explains how Sortable 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.
We are expecting that your programmatic ad units (to be used with Sortable) 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 (AdX) or AdSense site-wide policy bans or are denied from Google.
Changes Sortable makes in your Google Ad Manager account
Sortable will add the following key-value combinations into your Google Ad Manager (GAM) account for bid communication and reporting.
|Key Name (Sortable AdX account)||Key Name (publisher AdX account)||Values||Reportable||Purpose||Required|
|b||srt_b||424||No||Encoded bid price values||Yes|
|bs||srt_bs||16||No||Ad size values||Yes|
|u||srt_u||15,000||Yes||Encoded reporting values; the quantity of values is configurable; 15,000 is our default||Yes|
|sdbg||srt_sdbg||10||Yes||Values used for manual report pulling||Yes|
|as||srt_as||2||Yes||Values to measure split tests added if split testing||No|
|s||srt_s||1||No||Value for Sortable's AdX account; added when using Sortable’s AdX account||No|
|st||srt_st||15||No||Values for declaring ad refresh to AdX; added when using Sortable’s managed refresh; added with our default set-up||No|
Sortable will add the Sortable customer to allow our orders to be associated.
Orders, Line Items, and Creatives
Sortable 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 (AdX) 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. If you are using Sortable's AdX account, we will set up the interstitial with our set-up.
We will add our managed refresh and the required AdX 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 Sortable uses. When Sortable'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 Sortable in your GAM account with permissions
- In the Admin tab of your Google Ad Manager, navigate to Access & authorization > Users. Click New user.
Enter the following information in the required fields.
- Name: Sortable
- Email/Confirm email: firstname.lastname@example.org
- 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.
Click Save to send an email invitation to Sortable.
Custom user permission breakdown
If creating a custom user profile for Sortable, 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 Sortable 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 Sortable to pull API data from Google Ad Manager and Ad Exchange to ensure we can report on your total earnings.
|Define and deliver orders||Initial set-up||Reporting (always on)|
|View all orders and line items||✓||✓|
|Edit the priority and delivery rate for line items||✓||✕|
|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 people||Initial set-up||Reporting (always on)|
|View users, roles, and teams||✓||✓|
|View companies and contacts||✓||✓|
|Reporting||Initial set-up||Reporting (always on)|
|Create and view reports||✓||✓|
|View dynamic allocation opportunity report||✓||✓|
|Create and view Ad Exchange reports||✓||✓|
|Access to Google Ad Manager tabs||Initial set-up||Reporting (always on)|
Enabling API access in your Google Ad Manager account
Sortable 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 Sortable.
To enable, in the Admin tab of Google Ad Manager, select Global Settings and ensure that the API access toggle is enabled.
Requirements for using Sortable's AdX account
When using Sortable’s Google Ad Exchange (AdX) account, we need to be able to link Sortable’s account to your Google Ad Manager (GAM) account. If you do not have the option available to link an AdX account, we can contact Google on your behalf after you have accepted our MCM request (see below for details). This setting is found under Admin > Linked Accounts > Ad Exchange.
Changes we will make in your GAM to add Sortable's Ad Exchange
We will link our Ad Exchange to your GAM account using the Linked accounts section described above. We will then add:
- a Google Company to associate the order with
- one (1) key-value (s=0)
- one (1) order
- one (1) line item
- the necessary creatives
Multiple Customer Management (MCM) Request
In order to work with Sortable 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 Sortable 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.