Request

A request log is generated for each Ad Decision Request and it contains data from the fields outside of the Placement object.

NameTypeDescriptionSample Data
RequestIdstringUnique identifier for the request record, generated as MD5 hash of concatenated fields"90e19b84e78f436286aa4195140c2998"
IdstringOriginal request identifier. A unique ID is generated for each Ad Decision Request API fired."a1b2c3d4e5f6g7h8i9j0"
EventCreatedOntimestampUnix timestamp in milliseconds when the event, in this case request, was created1735689600000
BlockedAdvertiserIdsjsonA list of Advertiser Ids sent in the request to be excluded from being selected in the ads[ 123456, 234567 ]
BlockedCampaignIdsjsonA list of Campaign Ids sent in the request to be excluded from being selected in the ads[ 123456, 234567 ]
BlockedCreativeIdsjsonA list of Creative Ids sent in the request to be excluded from being selected in the ads[ 123456, 234567 ]
BlockedFlightsjsonA list of Flight Ids sent in the request to be excluded from being selected in the ads[ 123456, 234567 ]
DatacenterbooleanFlag indicating if the request was served from a datacenterfalse
DeviceBrandNamestringBrand name of the device"Apple"
DeviceBrowserstringBrowser name of the device"Chrome"
DeviceBrowserMajorVersionstringMajor version of the browser"120"
DeviceBrowserMinorVersionstringMinor version of the browser"0"
DeviceBrowserRawVersionstringRaw version string of the browser"120.0.6099.130"
DeviceFormFactorstringForm factor of the device"mobile"
DeviceModelNamestringModel name of the device"iPhone 13"
DeviceOsMajorVersionstringMajor version of the operating system"15"
DeviceOsMinorVersionstringMinor version of the operating system"4"
DeviceOsRawVersionstringRaw version string of the operating system"15.4.1"
DtstringDate partition"2024/01/01"
EnableBotFilteringbooleanFlag indicating if the request should go through the filter of bots and spiders. Defaults to falsetrue
EnableuserdbipbooleanFlag indicating if the request should use the ip address stored in UserDB instead of the ip in the requestfalse
GdprcomputedbooleanIf true, the request has GDPR consent either from the request itself, from a UserDB record etctrue
GdpriseubooleanFlag indicating if the impression is from EU, UK, or Switzerlandtrue
GdprrawstringRaw GDPR consent string in the request"true" or "false"
GdprsourcestringSource of GDPR consent information. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'."req" or "udb"
HostnamestringThe hostname taken from the request"e-11158.adzerk.net"
IsvaliduabooleanFlag indicating if the user agent is validtrue
KeywordsjsonJSON array of keywords["shoes", "sports"]
LocationCitystringCity name"San Francisco"
LocationCountryCodestringCountry code. Can be referenced here."US"
LocationCountryNamestringCountry name"United States"
LocationDmaCodestringDMA code"807"
LocationLatitudefloatLatitude coordinate37.7749
LocationLongitudefloatLongitude coordinate-122.4194
LocationMetroCodestringMetro code"SF"
LocationPostalCodestringPostal code"94105"
LocationRegionstringRegion name"California"
LocationSubregionstringSubregion name"Bay Area"
NetworkIdstringIdentifier for the network"12345"
PropertiesjsonJSON object of additional custom properties sent with the request event{"key": "value"}
ProtocolstringThe protocol taken from the request"https"
ReferrerUrlstringReferral URL of where the ad served, requires passing in the referrer field in the Ad Decision Request"https://example.com"
SearchTermstringSearch Term string sent in the request"dog food"
UrlstringURL of where the ad served, requires passing in the url field in the Ad Decision Request"https://example.com/page123"
UserKeystringKey identifying the user"ue_e8be4e08dc0345e1b94157f104a5b2ef"
UserSegmentsvectorList of user segments that the user belongs to at the point of the request[ 154, 155 ]