Unified User Matching for Mobile

Increase the overall value of web-based opportunities by identifying and targeting known users across Verizon Media SSP’s vast mobile web supply ecosystem via our unified user matching solution

Introduction

To increase the value of web-based (non-app) impression opportunities, SSP supports unified user matching with RTB buyers. User matching helps identify specific users so user-based targeting capabilities such as frequency capping and audience targeting can be activated.

Unified user matching provides a single global pixel endpoint across all Verizon Media SSP platforms, which improves match rates and allows bidders to tap into our vast ecosystem and reach cross-platform users.

SSP user matching leverages established and secure technologies for cookie syncing that has been used for years by major publishers (including TechCrunch and HuffPost) and by major buyers across the industry. SSP support and product teams are available to guide the implementation.

The user matching functionality is optional but highly recommended in order to maximize the value of web-based impression opportunities.

Steps to Implement User Matching

  1. Provide your system’s user matching endpoints (secure and non-secure) to our account manager who will make the necessary configuration in the SSP system.

Note: this step is only required for supply-side initiated user matching (more info below). When bidding into other Verizon Media platforms, make sure to return the same user-id across all platforms.

Use one of the following formats to provide endpoints:

  • Redirect - ends with an “=” sign which we will append with a redirect back to our system.
    Example: http://match.example.com/uidLink.do?rd=
  • Hard-coded - redirect to the SSP endpoint provided in step 1.
    Example: http://match.example.com
  1. Obtain user matching endpoints (secure and non-secure) for the SSP system from our account manager and configure in your own system. The format of this endpoint is: http(s)://pixel.advertising.com/ups/[PIXEL-ID]/sync?uid=$UID&_origin=1&gdpr=[GDPR_COMPLIANT]&gdpr_consent=[GDPR_CONSENT_STRING
    where ‘PIXEL-ID’ is a Verizon Media specific Pixel ID assigned to your account across our platform and ‘UUID’ is your system’s user ID for a given user.
  • PIXEL-ID - Verizon Media specific Pixel ID assigned to your account across ourplatform
  • UUID - Bidder’s user ID for a given user
  • GDPR_COMPLIANT - Indicates user jurisdiction
    1 = user is from EU region and under gdpr.
    2 = user is not from EU region.
  • GDPR_CONSENT_STRING - Consent string as defined by IAB Transparency and consent framework
  1. Confirm that valid user IDs are being received in the user.buyeruid field in OpenRTB bid requests from the SSP platform once an account manager indicates that user matching is active.

Methods of User Matching

There are two methods of User Matching —SSP Initiated and DSP Initiated— which are supported individually but it is highly recommended to use them in parallel.

SSP initiated user matching - SSP attempts to create a match, when one does not already exist in our user store. To do this we call the user matching endpoint you provided (step 1 above) on the publisher’s page. This pixel URL sends a request to your system for a new user ID which is then redirected to the SSP user matching system, via the user matching endpoint (provided by our account manager in step 2 above).

DSP initiated user matching - DSP initiated user mapping calls the SSP user matching endpoint (provided in step 2) and replaces the ‘UUID’ field with your specified user ID for a given user.

Advanced Options

Account managers can help you adjust the following settings if desired.

  • Time to live (TTL) - This value is set by default to 30 days but can be adjusted lower if needed. If TTL value is set to 30 days, SSP will attempt to initiate a new match on a known user after it has been in our system for 30 days.
  • iFrame - SSP can support iFrame user matching endpoints if needed. Please notify your account manager.
  • Receive requests for matched users only - Once user matching is enabled within an account, you have the option to receive only bid requests for web-based impression opportunities for which SSP can pass your unified user ID.

Note: this setting does not affect your decision to only receive bid requests where device ID is known for app impression opportunities.

Additional Information

  • Supply side vs. demand side user store - SSP hosts the user matching store and currently does not support user matching with partners that must host the user store in their system. This support may be added in the future.
  • Secure vs. non-secure user matching endpoints - To maximize match rates, we recommend providing both a secure and non-secure endpoint. If the ad content on a publisher’s page is secure (https), user matching will only be attempted for buyers who have provided a secure endpoint.
  • OpenRTB - When available, our platform will pass both the SSP unified user ID, and the buyer specific user ID, on the OpenRTB compliant bid request as follows:
  • Object

    Field Name (attribute)

    Type

    Description

    User Object

    id

    string

    Verizon Media’s unified user ID

    User Object

    buyeruid

    string

    Buyer (DSP) specific user ID