Overview

This guide explains how to use AdButler’s Prebid Wrapper inside Google Ad Manager (GAM) so that GAM can call your AdButler wrapper for header bidding.

You’ll also learn how to use AdButler as a third-party ad tag within GAM if you’re not using Prebid.

How It Works

When you use AdButler’s Prebid Wrapper, GAM remains your ad server of record but the wrapper handles the header bidding auction and passes the winning bid information to GAM through key-values.

• AdButler Wrapper: Manages demand partners, auction logic, and reporting.
• Google Ad Manager: Selects the winning ad using key-value pairs sent by the wrapper.
• Integration: Google Ad Manager calls the AdButler Wrapper script on page load, runs the auction, and delivers the winning creative.

Prerequisites

Before you begin, make sure you have:

• A Google Ad Manager account with permission to create ad units, orders, line items, and creatives.
• An AdButler account with our Programmatic Add-On
• A list of bidders and placements you plan to run through the wrapper.
• Relationships with demand partners you will connect via Prebid to AdButler

Step 1. Assign your Bidders to your Inventory

From the Bidders menu, add in your credentials for the Prebid partner you wish to participate in your auction.

After entering your credentials, hit the "Add Bidder" button.

Next, you'll want to assign that bidder to your Zone (Inventory).

Step 2. Generate Your AdButler Header Bidding Scripts

In your AdButler dashboard, go to your Publisher in the left Navigation menu.

Select "Other" from the top right navigation menu (...) and choose Header Bidding Setup.

On this window you will find the Header Script.

Step 3. Get the Zone Entries

Next, navigate to the Zones (Inventory) that you will want to use.

Click on the "Header Bidding Tags" section.

From the new Header Bidding modal that appears, you will find two key components.

• First is the Zone Entry. This will go directly under the line in Step 2 that says /* === ZONE ENTRIES GO HERE === */

Step 4. Add AdButler into Google Ad Manager

• In Google Ad Manager, go to Inventory → Ad Units → New Ad Unit.

• Give it a name like prebid_top_banner.

• Save and note the ad unit path — you’ll reference it in your GPT tag.

• Insert the AdButler Header Bidding Script from Step 2 before the GPT tag loads

• Create Line Items for Prebid Bidders in Google Ad Manager

• Add a line item for each price bucket and bidder.

• Under Key-Value Targeting, set:

hb_pb = 0.50 (example)

hb_bidder = indexExchange

-Upload a 1x1 creative that uses the header bidding a %% PATTERN:hb_adid %%

• Set Priority to Priority (Type: 8) or higher.

Step 5. Testing the Setup

• Load your page and open the browser console.
• Check for AdButler’s wrapper auction logs.
• Verify that hb_pb, hb_bidder, and hb_adid appear in the GAM ad request.
• In GAM, confirm that the correct line item serves the winning ad.