Request
A request log is generated for each Ad Decision Request and it contains data from the fields outside of the Placement object.
| Name | Type | Description | Sample Data |
|---|---|---|---|
| RequestId | string | Unique identifier for the request record, generated as MD5 hash of concatenated fields | "90e19b84e78f436286aa4195140c2998" |
| Id | string | Original request identifier. A unique ID is generated for each Ad Decision Request API fired. | "a1b2c3d4e5f6g7h8i9j0" |
| EventCreatedOn | timestamp | Unix timestamp in milliseconds when the event, in this case request, was created | 1735689600000 |
| BlockedAdvertiserIds | json | A list of Advertiser Ids sent in the request to be excluded from being selected in the ads | [ 123456, 234567 ] |
| BlockedCampaignIds | json | A list of Campaign Ids sent in the request to be excluded from being selected in the ads | [ 123456, 234567 ] |
| BlockedCreativeIds | json | A list of Creative Ids sent in the request to be excluded from being selected in the ads | [ 123456, 234567 ] |
| BlockedFlights | json | A list of Flight Ids sent in the request to be excluded from being selected in the ads | [ 123456, 234567 ] |
| Datacenter | boolean | Flag indicating if the request was served from a datacenter | false |
| DeviceBrandName | string | Brand name of the device | "Apple" |
| DeviceBrowser | string | Browser name of the device | "Chrome" |
| DeviceBrowserMajorVersion | string | Major version of the browser | "120" |
| DeviceBrowserMinorVersion | string | Minor version of the browser | "0" |
| DeviceBrowserRawVersion | string | Raw version string of the browser | "120.0.6099.130" |
| DeviceFormFactor | string | Form factor of the device | "mobile" |
| DeviceModelName | string | Model name of the device | "iPhone 13" |
| DeviceOsMajorVersion | string | Major version of the operating system | "15" |
| DeviceOsMinorVersion | string | Minor version of the operating system | "4" |
| DeviceOsRawVersion | string | Raw version string of the operating system | "15.4.1" |
| Dt | string | Date partition | "2024/01/01" |
| EnableBotFiltering | boolean | Flag indicating if the request should go through the filter of bots and spiders. Defaults to false | true |
| Enableuserdbip | boolean | Flag indicating if the request should use the ip address stored in UserDB instead of the ip in the request | false |
| Gdprcomputed | boolean | If true, the request has GDPR consent either from the request itself, from a UserDB record etc | true |
| Gdpriseu | boolean | Flag indicating if the impression is from EU, UK, or Switzerland | true |
| Gdprraw | string | Raw GDPR consent string in the request | "true" or "false" |
| Gdprsource | string | Source of GDPR consent information. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'. | "req" or "udb" |
| Hostname | string | The hostname taken from the request | "e-11158.adzerk.net" |
| Isvalidua | boolean | Flag indicating if the user agent is valid | true |
| Keywords | json | JSON array of keywords | ["shoes", "sports"] |
| LocationCity | string | City name | "San Francisco" |
| LocationCountryCode | string | Country code. Can be referenced here. | "US" |
| LocationCountryName | string | Country name | "United States" |
| LocationDmaCode | string | DMA code | "807" |
| LocationLatitude | float | Latitude coordinate | 37.7749 |
| LocationLongitude | float | Longitude coordinate | -122.4194 |
| LocationMetroCode | string | Metro code | "SF" |
| LocationPostalCode | string | Postal code | "94105" |
| LocationRegion | string | Region name | "California" |
| LocationSubregion | string | Subregion name | "Bay Area" |
| NetworkId | string | Identifier for the network | "12345" |
| Properties | json | JSON object of additional custom properties sent with the request event | {"key": "value"} |
| Protocol | string | The protocol taken from the request | "https" |
| ReferrerUrl | string | Referral URL of where the ad served, requires passing in the referrer field in the Ad Decision Request | "https://example.com" |
| SearchTerm | string | Search Term string sent in the request | "dog food" |
| Url | string | URL of where the ad served, requires passing in the url field in the Ad Decision Request | "https://example.com/page123" |
| UserKey | string | Key identifying the user | "ue_e8be4e08dc0345e1b94157f104a5b2ef" |
| UserSegments | vector | List of user segments that the user belongs to at the point of the request | [ 154, 155 ] |
Updated about 5 hours ago
