Improve ad campaigns with PPS

AI-generated Key Takeaways

outlined_flag

• Publisher-provided signals (PPS) allow you to improve programmatic ad monetization by using your user data to share audience and contextual information with bidders in all transaction types, without sharing user identifiers.

• PPS uses standard taxonomies such as IAB Audience Taxonomy 1.1 and IAB Content Taxonomy 2.2 to categorize user interests, behavior, and content.

• You construct a JSON object with taxonomy signals and structured signals containing user data and encode it in Base64 before adding it to your ad requests.

• The encoded user signals are included in the adTagParameters of your stream request using the key "ppsj" for Google Ad Manager to utilize.

You can send audience and contextual data as publisher provided signals (PPS) in ad requests. With PPS, you can use your user data to improve programmatic monetization by communicating your audience characteristics to bidders in all transaction types, using standard taxonomies, without the need to share user identifiers. Your audience characteristics can include behavioral and interest-based data ( IAB Audience Taxonomy 1.1), and contextual data ( IAB Content Taxonomy 2.2). You can also send publisher provided structured signals, which are defined by Google, and allow for additional signals to be sent.

Construct the user signals JSON

At the top level, create a JSON object with a single key-value pair. The key should be PublisherProvidedTaxonomySignals, and its value should be an array of objects. Each object in the array should have 2 key-value pairs:

• The taxonomy key, which accepts the following values that are mapped to following IAB public specifications:

  • IAB_AUDIENCE_1_1 for Audience Taxonomy 1.1
  • IAB_CONTENT_2_2 for Content Taxonomy 2.2

• The values key with a corresponding array of string taxonomy values.

Construct the structured signals array

For structured signals, add the PublisherProvidedStructuredSignals key with a value of an array of objects. Construct the object based on the following list of signal key-values:

See the following example that uses the IAB_AUDIENCE_1_1 and IAB_CONTENT_2_2 for taxonomy signals and includes structured signals.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

Configure your stream request

Follow these steps to send PPS with your StreamRequest:

• Create a JSON object with the user's interest, behavior, or contextual data.
• Create a Base64-encoded ASCII string from the JSON object above.
• Add your encoded string using StreamRequest.adTagParameters.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["1", "284"]
  }]
};

const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));

streamRequest.adTagParameters = { "ppsj" : encodedSignals };