User Object

Note

Fields marked with asterisk (*) are optional.

User Object Properties

Value

Type

Description

id*

string

Unique The MediaGrid ID of this user, for example, "252eb154-b3e5-473f-bad8-9b6d7f8646e5". For in-app traffic the lowercase IDFA, or Android ID is used. For example, "38f72eaf-5d6f-4143-824f-deaf753d7239". The User ID can be a maximum of 50 characters.

buyeruid*

string

The Buyer user ID as mapped by The MediaGrid for the DSP. The User ID can be a maximum of 50 characters.

consent*

string

Passes the Transparency & Consent Framework string. The current valid version of this string is v2.0. You can read more about the the information encoded within the consent string here: Transparency and Consent String with Global Vendor & CMP List Formats

The Buyer should use the information in the consent string to ascertain which vendors and for which purposes the user gave consent.

  • If the user has not given consent, then do not respond with an ad which utilises user information and neither access nor store information on the user’s device e.g. cookies, IDFA, fingerprints

  • If the user has given consent, then identify all vendors to whom the user has given consent and for which purposes

    • Buyers should also only use and store user data if the user has given consent to the buyer and only for the purposes for which the user has given consent

    • Buyers should only allow third-party direct or redirect links to those who have received consent from the user

    • https://vendor-list.consensu.org/v2/vendor-list.json

  • If no consent is given, you cannot use personal data and may not have the right to use cookies. Each party is responsible for determining what that means for their business. If user consent explicitly states that it is not given, then do not respond with an ad which utilises user information and neither access nor store information on the user’s device e.g. cookies, IDFA, fingerprints

For more information see the following links:

customdata*

string

Optional feature to pass bidder data that was set in the exchange’s cookie. The string must be in base85 cookie safecharacters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks.

eids*

array of objects

Contains the Extended identifiers object, see the Extended Identifiers section for details

keywords*

string

A comma separated list of keywords about the App, e.g "news, weather, sports". Only one of keywords or kwarray should be passed.

kwarray*

array of string

An array of keywords about the App, e.g ["news", "weather", "sports"]. Only one of keywords or kwarray should be passed.

yob*

integer

Year of birth as a 4-digit integer, for example, 1977

Deprecated since version 5.3.

gender*

string

Specifies the user gender.

Deprecated since version 5.3.

data*

array of objects

Additional data. Each data object represents a different data source, for more information, see the Data Object section.

ext*

object

For more information, see the User Ext Object Properties section.

Extended Identifiers

Supports the official Open RTB community extension for passing multiple third party user identifiers, see the official Extended Identifiers spec for more details.

This object passes any additional User IDs a Supplier, Consent Management Platform (CMP), Data Management Platform (DMP), or The MediaGrid may have for a user. There is a number of identity solutions that provide IDs for users that are not based on 3rd party data, and many of these solution providers extend their first-party data as offerings that can be used to offset the decline of 3rd party cookies.

The MediaGrid and many of our partners support these offerings and have build systems to collate, map, and make these IDs available to Buyers, who can use them to improve the robustness of targeted advertising. When the appropriate consent is in place (e.g CCPA, GDPR) The MediaGrid passes all and any correctly set ID in this field. The following IDs are the most commonly sent through The MediaGrid, but if you are looking for a particular ID in requests, you should check the source value to identify it. You can find a more extensive list of possible IDs on the Prebid User ID Module page

Note

  • The LiveRamp ID is encrypted and only enabled for certain Buyers that have the business contracts in place to decrypt and use this ID, contact support@bidswitch.com if you are a LiveRamp partner.

  • The LiveIntent ID is only available to certain Buyers to whom LiveIntent wish to grant usage rights.

eids Object Properties

Value

Type

Description

source

string

(Required) Source or technology provider responsible for the set of included IDs. Expressed as a top-level domain. The MediaGrid includes the following IDs when available.

  • The Trade Desk backed Unified ID passed using "adserver.org" for v1.0 and as "uidapi.com" for v2.0.

  • id5 passed using "id5-sync.com".

  • The LiveIntent ID passed using "liveintent.com".

  • IDL passed using "liveramp.com".

  • SharedID passed using "sharedid.org".

  • FloC IDs may be passed using "chrome.com" if coming from prebid, but see the FloC Object also.

uids

array of objects

(Required) Passes the User IDs matched from the given provider.

uids Object

uids Object Properties

Value

Type

Description

id

string

(Required) The User ID with this provider.

atype

int

(Optional) The type of user agent the match is from.

  • 1 An ID which is tied to a specific web browser or device (cookie-based, probabilistic, or other).

  • 2 In-app impressions, which will typically contain a type of device ID (or rather, the privacy-compliant versions of device IDs).

  • 3 A person-based ID, i.e., that is the same across devices.

  • 500+ Vendor-specific codes.

User Object Example

{
  "user":{
    "id":"45asdf987656789adfad4678rew656789",
    "buyeruid":"1234567890",
    "keywords":"sports, entertainment",
    "consent":"Y29uc2VudCBkYXRh",
    "eids":[
      {
        "source":"adserver.org",
        "uids":[
          {
            "id":"zzz123",
            "atype":1
          },
          {
            "id":"DB700403-9A24-4A4B-A8D5-8A0B4BE777D2",
            "atype":2
          }
        ]
      },
      {
        "source":"liveintent.com",
        "uids":[
          {
            "id":"IPl4zj44RhezVyNE83bYfogYRN6W8LaCy3USy8dPQ==",
            "atype":3
          }
        ]
      },
      {
        "source":"liveramp.com",
        "uids":[
          {
            "id":"0db20294a3908612bc7e732c2022095391074cf3"
          }
        ]
      }
    ]
  }
}