GAM Integration: Guidance and Onboarding

This documentation covers both Qt and non-Qt customers.

Introduction

TODO: Brief overview of the platform and its benefits

TODO: Explanation of the onboarding process

As a Multiple Customer Management (MCM) partner, we provide comprehensive ad management services, enabling publishers to focus on their core business while we handle their ad operations.

Why Choose Qt?

Choosing Qt as your MCM partner brings you a host of benefits:

  1. Maximize Ad Revenue: Our platform is designed to help you maximize your ad revenue through advanced features like Google Open Bidding and Google Ad Manager integration.
  2. Granular Control: With Qt, you have granular control over your ad inventory. You can create ad units, placements, and key-values that correspond to your website or mobile app inventory.
  3. Multiple Ad Exchanges and Networks: Our platform supports multiple ad exchanges and networks, giving you a wide range of options for your ad inventory.
  4. Expert Support: Our team of experts is always ready to assist you with any questions or issues you may have. We're committed to ensuring your success on our platform.

Onboarding Process Overview

The onboarding process involves several steps, including setting up Google Ad Manager, preparing for Google Ad Manager setup, setting up inventory in Google Ad Manager, testing, activating Google Open Bidding, and onboarding future publishers. Each of these steps is detailed in the following sections of this document.

Account Creation

  • Step-by-step guide on how to create an account
  • Information on required details during account creation

Setting Up Google Ad Manager

  1. Create a Google Account: If you don't already have a Google account, go to the Google account creation page and follow the prompts to create a new account.
  2. Create a Google Adsense Account: Even if you don't plan to use it regularly, you need to have an active Google Adsense account. Go to the Google Adsense page and click on "Get Started". Follow the prompts to create your Adsense account.
  3. Sign Up for Google Ad Manager: Visit Google Ad Manager and click on "Create Account". Answer a few questions about your business.
  4. Verify Your Network Settings: Once you create an order, you won't be able to change your time zone and currency. To verify your network settings, go to Admin > Global Settings > Network Settings in Google Ad Manager.

Preparing for Google Ad Manager Setup

Before you start setting up your ad inventory in Google Ad Manager, it's important to understand a few key concepts and tools. This includes the Google Publisher Tag and the Google Mobile Ads SDK.

Google Publisher Tag

The Google Publisher Tag (GPT) is a tagging library for Google Ad Manager. It allows you to build ad requests dynamically. GPT allows you to define available ad slots on your website, send requests for ads to Google Ad Manager, and then display those ads on your website. GPT takes key details from your ad slots and uses them to request ads from Ad Manager. It also provides the ability to group multiple ad slots together, allowing you to request and display ads on them simultaneously.

You can learn more about the Google Publisher Tag and decide which GPT mode to use by visiting the Google Publisher Tag guide.

Understanding GPT

Before you start using GPT, it's important to understand a few key concepts:

  • Ad Slot: This is a space on your website where you want to display an ad. You define ad slots using GPT.
  • Ad Unit: This is a container you create in Google Ad Manager to represent an ad slot on your website. The ad unit contains settings that determine how ads display in the corresponding ad slot.
  • Ad Request: This is a call made to Google Ad Manager to fetch an ad. The ad request contains information about the ad slot and the user viewing the page.
  • Ad Response: This is the ad that Google Ad Manager returns in response to an ad request. The ad response contains the creative code that displays the ad in the ad slot.

Implementing GPT

Here's a step-by-step guide on how to implement GPT on your website:

Load the GPT JavaScript library: Include the following line in the head of your HTML document:

html

<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>

Define ad slots: In your JavaScript code, define the ad slots where you want to display ads. Here's an example of how to define an ad slot:

Javascript

var slot = googletag.defineSlot('/6355419/Travel', [728, 90], 'div-gpt-ad-123456789-0') .addService(googletag.pubads());

In this example, '/6355419/Travel' is the ad unit code, [728, 90] is the size of the ad slot, and 'div-gpt-ad-123456789-0' is the ID of the div element where the ad will be displayed.

Display ads: After defining your ad slots, you can request and display ads with the following code:

Javascript

googletag.display('div-gpt-ad-123456789-0');

Replace 'div-gpt-ad-123456789-0' with the ID of the div element for the ad slot.

More info: https://developers.google.com/publisher-tag/guides/get-started Google Publisher Tag guide.

Google Mobile Ads SDK

The Google Mobile Ads SDK is the latest generation in Google mobile advertising featuring refined ad formats and streamlined APIs for access to mobile ad networks and advertising solutions. The SDK enables mobile app developers to maximize their monetization on Android and iOS.

You can use the Google Mobile Ads SDK to deliver directly sold ads into applications. The Google IMA SDK is needed for some video formats. More information can be found here for Android and here for iOS.

Please feel free to modify this sample section to better suit your platform's specific needs and requirements.

Inventory Setup in Google Ad Manager

Once you've set up Google Ad Manager and prepared for its setup, the next step is to set up your ad inventory. This involves creating ad units, placements, and key-values, and configuring your content management system and your content to request ads from Ad Manager. Create ad units, placements, and key-values

Creating Ad Units

Ad units are the building blocks of your ad inventory. They represent the different spaces on your website or app where you want to display ads. Here's a more detailed guide on creating ad units:

  1. Sign in to Google Ad Manager: Go to Google Ad Manager and sign in with your Google account.
  2. Navigate to Ad Units: Click on "Inventory" in the left-hand menu, then click on "Ad Units".
  3. Create a New Ad Unit: Click on the "New Ad Unit" button.
  4. Enter a Name for the Ad Unit: The name should be descriptive and indicate where the ad unit will be placed on your website or app. For example, if the ad unit is for a banner ad at the top of your homepage, you might name it "Homepage Top Banner".
  5. Enter a Code for the Ad Unit: The code will be used in your ad tags, so it should be unique and easily identifiable. For example, if the ad unit is for a banner ad at the top of your homepage, you might use the code "home_top_banner".
  6. Select the Ad Sizes: Choose the sizes that the ad unit will support. For example, if the ad unit is for a banner ad, you might select sizes like 728x90 and 970x250.
  7. Save the Ad Unit: Click on the "Save" button to create the ad unit.

Creating Placements

Placements are groups of ad units that advertisers can specifically target with their ads. Here's a more detailed guide on creating placements:

  1. Sign in to Google Ad Manager: Go to Google Ad Manager and sign in with your Google account.
  2. Navigate to Placements: Click on "Inventory" in the left-hand menu, then click on "Placements".
  3. Create a New Placement: Click on the "New Placement" button.
  4. Enter a Name for the Placement: The name should be descriptive and indicate the ad units that are included in the placement. For example, if the placement includes all banner ad units on your website, you might name it "Banner Ads".
  5. Add Ad Units to the Placement: In the "Ad Units" section, click on "Add Ad Units". Select the ad units that you want to include in the placement.
  6. Save the Placement: Click on the "Save" button to create the placement.

Creating Key-Values

Key-values provide additional information about the ad request, which can be used for targeting. Here's a more detailed guide on creating key-values:

  1. Sign in to Google Ad Manager: Go to Google Ad Manager and sign in with your Google account.
  2. Navigate to Key-Values: Click on "Inventory" in the left-hand menu, then click on "Key-values".
  3. Create a New Key: Click on the "New Key" button.
  4. Enter a Name for the Key: The name should be descriptive and indicate the type of information that the key represents. For example, if the key represents the user's age, you might name it "age".
  5. Enter Values for the Key: If you want to predefine values for the key, enter them in the "Values" section. For example, if the key represents the user's age, you might enter values like "18-24", "25-34", "35-44", etc.
  6. Save the Key: Click on the "Save" button to create the key.

Configuring Your Content Management System and Content

After setting up your ad inventory in Google Ad Manager, you need to configure your content management system (CMS) and your content to request ads from Ad Manager. This involves adding the Google Publisher Tag to your website or app.

For example, if you're using WordPress as your CMS, you would add the Google Publisher Tag to your WordPress theme files. You might add the tag to the header.php file to display ads in the header of your website, or to the single.php file to display ads in individual posts.

Remember to test your setup to ensure that ads are being requested and displayed correctly. You can use the Google Publisher Console, a debugging tool for Google Publisher Tags, to check for common issues and view detailed information about ad requests.

  • Create user-defined creative templates
  • Configure your content management system and your content to request ads from Ad Manager
  • Use Google Publisher Tags for desktop and mobile web inventory
  • Use the Google Mobile Ads SDK for mobile apps
  • Use the Google IMA SDK for video players

Testing

  • Create an order and line item to use for testing
  • Test Google Publisher Tags on your sites with each layout and page template
  • Use troubleshooting tools to resolve delivery problems and better understand ad delivery patterns

Testing Your Network

After setting up your ad inventory in Google Ad Manager, it's crucial to test your network to ensure that ads are being requested and displayed correctly. Here's a step-by-step guide on how to do this:

Creating an Order and Line Item for Testing

  1. Sign in to Google Ad Manager: Go to Google Ad Manager and sign in with your Google account.
  2. Navigate to Orders: Click on "Sales" in the left-hand menu, then click on "Orders".
  3. Create a New Order: Click on the "New Order" button.
  4. Enter Details for the Order: Fill in the necessary details for the order, such as the advertiser, the name of the order, and the salesperson.
  5. Create a New Line Item: In the "Line items" section, click on "New line item". Fill in the necessary details for the line item, such as the name, size, and targeting criteria.
  6. Save the Order and Line Item: Click on the "Save" button to create the order and line item.

Testing Google Publisher Tags

After creating an order and line item for testing, you should test Google Publisher Tags on your sites with each layout and page template. Here's how to do this:

  1. Open a Page on Your Site: Open a page on your site where you've implemented Google Publisher Tags.
  2. Open the Google Publisher Console: In your browser, append ?google_console=1 to the URL and press Enter. This will open the Google Publisher Console, a debugging tool for Google Publisher Tags.
  3. Check for Issues: In the Google Publisher Console, check for any issues or errors. If you see any issues, use the information provided in the console to troubleshoot and resolve them.
  4. Repeat for Each Layout and Page Template: Repeat this process for each layout and page template on your site.

Remember, testing is a crucial part of setting up your network. By thoroughly testing your setup, you can ensure that ads are being requested and displayed correctly, leading to maximum ad revenue.

Activating Google Open Bidding

Google Open Bidding allows you to invite third-party demand partners to compete for your inventory in a single auction, maximizing your ad revenue. Here's a step-by-step guide on how to activate Google Open Bidding:

  1. Sign in to Google Ad Manager: Go to Google Ad Manager and sign in with your Google account.
  2. Navigate to Open Bidding: Click on "Sales" in the left-hand menu, then click on "Open Bidding".
  3. Add Demand Partners: Click on the "Add Demand Partners" button. Select the demand partners that you want to invite to participate in Open Bidding.
  4. Configure Each Demand Partner: For each demand partner, you'll need to provide certain information, such as the partner's network code and the percentage of revenue that you want to share with the partner. Follow the prompts to configure each demand partner.
  5. Save Your Changes: Click on the "Save" button to activate Open Bidding.

Inviting multiple demand partners to compete for your inventory in a single auction ensures you're getting the best possible price for each ad impression.

Onboarding Future Publishers

  • Establish a contractual relationship with each partner
  • Link a primary ad exchange to the Ad Manager account and ensure it is set as “default for dynamic allocation.”

Support and Contact

The next step after onboarding future publishers is to provide ongoing support and optimization. This involves monitoring performance, optimizing ad placements, and troubleshooting any issues that arise.

Providing Ongoing Support and optimization

Once a publisher is onboarded and their ads are live, your work isn't done. It's important to provide ongoing support and optimization to ensure that the publisher is getting the most out of your network. Here's a step-by-step guide on how to do this:

  1. Monitor Performance: Regularly check the performance of the publisher's ads. This includes metrics like impressions, clicks, and revenue. Look for any trends or issues that might need attention.
  2. Optimize Ad Placements: Based on the performance data, you might need to optimize the publisher's ad placements. This could involve changing the sizes or positions of the ads, or adjusting the targeting settings.
  3. Troubleshoot Issues: If the publisher is experiencing any issues, such as ads not displaying correctly or revenue being lower than expected, work with them to troubleshoot and resolve these issues.
  4. Provide Regular Updates: Keep the publisher informed about their performance and any changes you're making. This could involve sending regular reports or having regular meetings to discuss their performance.
  • Provide contact information for technical support
  • Include FAQs or link to a help center

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.