Google Ad Manager Setup for BiddingStack

Overview

This guide explains how to configure key-value (KV) pairs in Google Ad Manager (GAM) to support BiddingStack’s advanced targeting and reporting features.

Creating Key-Value Pairs in Google Ad Manager

In Google Ad Manager, go to Inventory > Key-values, and create the following keys:

1. bs_isrefresh

  • Key: bs_isrefresh
  • Description: Indicates whether an impression is a refreshed impression.
  • Type: Predefined
  • Include in Reporting: Yes
  • Add as Custom Dimension: Yes
  • Accepted Values:
    • true
    • false

2. bs_refresh

  • Key: bs_refresh
  • Description: Tracks the number of times an impression has been refreshed.
  • Type: Predefined
  • Include in Reporting: Yes
  • Add as Custom Dimension: Yes
  • Accepted Values:
    • 0, 1, 2, 3, ..., 10

3. bs_preview

  • Key: bs_preview
  • Description: Used to identify preview requests for campaigns or line items. Add ?biddingstack_preview=true to the URL when testing.
  • Type: Predefined
  • Include in Reporting: No
  • Accepted Values:
    • true
    • false

4. bs_pagetype

  • Key: bs_pagetype
  • Description: Categorizes the page type for contextual targeting.
  • Type: Predefined
  • Include in Reporting: Yes
  • Accepted Values:
    • article
    • category
    • homepage

5. bs_group

  • Key: bs_group
  • Description: Assigns a test group for A/B or multivariate testing.
  • Type: Dynamic
  • Include in Reporting: Yes
  • Accepted Values:
    • 0 through 99

6. bs_fpon

  • Key: bs_fpon
  • Description: Indicates whether dynamic floor pricing is enabled.
  • Type: Predefined
  • Include in Reporting: Yes
  • Add as Custom Dimension: Yes
  • Accepted Values:
    • true
    • false

7. bs_fpid

  • Key: bs_fpid
  • Description: Specifies the dynamic floor pricing group ID.
  • Type: Dynamic
  • Include in Reporting: No
  • Accepted Values:
    • 1 through 50

8. bs_age

  • Key: bs_age
  • Description: Provides age group targeting.
  • Type: Predefined
  • Include in Reporting: No
  • Accepted Values:
    • - (unknown)
    • U18 (under 18)
    • O18 (over 18)