0%

Bid Request

User Object

Field

Type

Details

id*

string

Unique Criteo 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"

buyeruid*

string

The Buyer user ID as mapped by Criteo for the DSP.

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:

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.

data*

array of objects

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

{
  "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"
          }
        ]
      }
    ]
  }
}