Updated November 20, 2026
Key-value pairs are a feature offered in Google Ad Manager (GAM) and other ad servers that define custom parameters within Google’s ad server. But how can publishers benefit from using them in their reporting and optimization strategy? Read on to find out.
Key-value pairs are custom tags that can be attached to ad units in GAM, which pass additional information to the ad server for each ad request. Key-value pairs can be extremely helpful, depending on how the publisher decides to use them. First, they can help ads reach the right group of people. Key-values can also be used to help meet media quality requirements from advertising clients.
Key-value pairs consist of two elements: a key (such as “age”) and a value (“18-32 years”). After setting up key-value tags in GAM, if a line item targets a specific key-value pair, the ad server will only place that line item on publisher inventory that includes said key-value in the ad request.
There are two types of key-value types: predefined and dynamic.
Predefined
Predefined key-value pairs have a limited, pre-defined set of possible values. They are best used when publishers already know the possible range. Pre-defined key-values allow publishers to get full reporting insights into each key-value pair.
Dynamic
Dynamic key-value pairs use a defined key but have dynamic values, for example, any number or a freeform text value. Dynamic key-values could be used to target ads to a user based on their specific search terms on a site, or to pass in an engagement score. Dynamic key-values allow publishers to have many values without having to define them in advance, but don’t allow reports broken down by individual values.
The primary benefit of key-value pairs is the ability for publishers to create custom delivery packaging in order to sell segments at higher CPMs than standard run-of-site inventory. The added context provided by key-value pairs is a critical component in identifying high-performing segments that are highly valued by advertisers.
Publishers can also leverage key-value pairs to gain a more granular understanding of ad performance as it relates to different attributes such as viewability, brand suitability or contextual alignment. Reporting on metrics captured by key-values can create better insights into website traffic and provide information about a site’s unique visitors. Employing key-value pairs as part of a comprehensive contextual strategy is a simple and often underutilized way to improve revenue by matching the right content with the right audience.
DV Publisher Suite (DVPS) can help media suppliers harness the power of key-value pairs. While DVPS does not collect data or serve ads based on key-value pairs, users can analyze these values within the server for their optimization needs.
With DV’s Quality Targeting, for example, teams can leverage signal IDs with key-values to create custom inventory packages based on a publisher’s media quality and contextual goals. All of this is enabled by a DVPS tag that enables Quality Targeting without increasing page load times. Lastly, publishers can feel secure that DV’s signals are privacy-friendly, using no persistent tracking or third-party cookies.
These signals create revenue-generating opportunities for publishers. These can come in during the sales cycle, such as enabling the ability to sell packages that only deliver to contextually relevant inventory, or including viewability or fraud-free guarantees. They can also account for an advertiser’s brand suitability requirements without the need for manual input. Instead of having to micro-manage placements and campaigns, all of these signals are automatically triggered pre-delivery.
When it comes time to report on those metrics, publishers can use a combination of different IDs to create custom segments of their traffic. DV’s Unified Analytics aggregates and normalizes all advertising data in one place and provides powerful tools to customize reporting and data presentation for data collected with key-value pairs.
Contact us today to learn more about Quality Targeting, or the other ways that DV works to help publishers enhance their reporting and ad delivery strategies.