Skip to main content

​
Overview

Once clean room audiences have been created, you need to configure targeting in your ad server. This guide covers setup for both Google Ad Manager and Microsoft Monetize.
Prerequisites:
  • Permutive SDK properly configured with your ad server integration
  • For GAM: DFP integration enabled in your Permutive SDK
  • For Microsoft Monetize: AppNexus Seller Tag installed and configured

​
Understanding Clean Room Targeting Values

Clean room audiences use unique targeting values specific to each publisher-advertiser connection. You can find these targeting values in the Permutive Platform under Connections when viewing a specific advertiser connection. These values are:
  • Stored in the _pcrprs local storage key on the user’s browser
  • Automatically populated by the Permutive SDK when a user is in a clean room audience
Targeting is automatic - no manual activation steps required. The Permutive SDK’s DFP addon automatically reads targeting values from _pcrprs and applies them to ad requests.
1

Verify SDK configuration

Ensure your Permutive SDK is configured with the DFP integration enabled. The DFP addon will automatically:
  • Read targeting values from the _pcrprs local storage key
  • Call Google Publisher Tag’s setTargeting() method
  • Attach targeting to every ad request
2

Create or update a line item in GAM

In GAM, go to Delivery > Line Items and create or edit a line item.
3

Add key-value targeting

Add key-value targeting using the targeting values from your advertiser connection. The key-value pairs will match what’s in _pcrprs.
4

Configure additional targeting

Configure additional targeting criteria as needed (geography, device, etc.). Set frequency caps if desired.
5

Associate with order and creative

Associate the line item with the appropriate order and creative.
6

Launch campaign

Launch your campaign.

​
Microsoft Monetize (formerly Xandr)

Targeting requires manual setup in your on-page code to read from _pcrprs and pass values to the AppNexus Seller Tag.
1

Install AppNexus Seller Tag

Ensure you have the AppNexus Seller Tag installed on your site. See the Microsoft Monetize integration guide for details.
2

Add targeting JavaScript

Add the following JavaScript to read clean room targeting values and set keywords on your ad tags:
window.apntag = window.apntag || {};
window.apntag.anq = window.apntag.anq || [];

window.apntag.anq.push(function () {
  var original = window.apntag.defineTag;
  window.apntag.defineTag = function (arg) {
    original(arg);
    try {
      if (arg.targetId) {
        // Read clean room targeting values from _pcrprs
        var kvs = window.localStorage.getItem("_pcrprs");
        window.apntag.setKeywords(
          arg.targetId,
          { permutive: kvs ? JSON.parse(kvs) : [] },
          { overrideKeyValue: true }
        );
      }
    } catch (e) {
      /* Ignore */
    }
  };
});
3

Deploy the code

Deploy this code before or alongside your Permutive tag.
4

Create or update a line item

In Microsoft Monetize, create or update a line item. Set targeting to use the permutive key-value. Values will match the targeting values shown in your connection details.
5

Configure and launch

Configure additional targeting criteria as needed and launch your campaign.
This setup is similar to the regular Microsoft Monetize integration but reads from _pcrprs (clean room values) instead of _papns (regular cohorts). See the full Microsoft Monetize integration documentation for more details.

​
Verification Tips

  • Check browser local storage for _pcrprs key to verify targeting values are being set
  • Use browser developer tools to inspect ad requests and confirm targeting key-values are present
  • Create test campaigns with low budget to verify targeting is working before full launch

​
Next Steps

Sharing Proposal and Deal Information

Set up PMP deals in GAM

Back to Clean Room

Return to product overview