Selection

A selection log is generated for every ad that was returned in an Ad Decision Request.

NameTypeDescriptionSample Data
IsLastModifiedtimestampTimestamp of when the source log file was last modified in object storage. New in V3, and used to run incremental, de-duplicated transfers so that only files changed since your last successful sync are re-read.2026-06-09 14:32:10.000
IdstringOriginal selection identifier. A unique ID is generated for each ad selected."a1b2c3d4e5f6g7h8i9j0"
SelectionIdstringUnique identifier for the selection record, generated as MD5 hash of concatenated fields"90e19b84e78f436286aa4195140c2998"
EventCreatedOntimestampUnix timestamp in milliseconds when the event, in this case selection, was created1735689600000
AdIdbigintIdentifier for the ad123456789
AdTypeIdbigintType identifier for the ad1
AuctionBidsbigintNumber of bids in the auction5
AdvertiserIdbigintIdentifier for the advertiser2325487
BurnInbooleanFlag indicating if the the ad is still in burn-in phase when the auction was conductedtrue
CampaignIdbigintIdentifier for the campaign123456789
ChannelIdbigintIdentifier for the channel123456789
CreativeIdbigintIdentifier for the creative123456789
CreativeMetadatajsonJSON array of metadata stored in a creative{"customData": {"hello": "world"}}
DatacenterbooleanFlag indicating if the impression was served from a datacenterfalse
DecisionIdstringIdentifier for the decision. A distinct value is created for each placement object in an ADR."90e19b84e78f436286aa4195140c2998"
DecisionIdxbigintDecision Index. If the Decision generates only one Selection (i.e. it does not originate from a multi-winner placement) then the DecisionIdx will always be 0. For multi-winner placements, the DecisionIdx will be the order of the Selection within the Decision (zero indexed).0
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"
EcpmfloatEffective cost per thousand impressions2.50
EcpmPartitionstringPartition for eCPM"landing"
FlightIdbigintIdentifier for the flight123456789
FrequencyCapbigintFrequency cap value. 1 = Hour 2 = Day 3 = Minute.3
GdprComputedbooleanIf true, the request has GDPR consent either from the request itself, from a UserDB record etctrue
GdprConsentRequiredbooleanFlag passed in the request indicating if consent is requiredfalse
GdprSourcestringSource of GDPR consent information. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'."req" or "udb"
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"
LocationLatitudedoubleLatitude coordinate37.7749
LocationLongitudedoubleLongitude coordinate-122.4194
LocationMetroCodestringMetro code"SF"
LocationPostalCodestringPostal code"94105"
LocationRegionstringRegion name"California"
LocationSubregionstringSubregion name"Bay Area"
MatchingKeywordsjsonJSON array of matching keywords["shoes", "sports"]
MatchedSegmentIdsvectorArray of matching segments[154, 155]
ModifiedPricefloatModified price value, for when Bid Modifiers are used0.75
NetworkIdstringIdentifier for the network"12345"
OptimizedPricefloatOptimized price value, after factoring in auto-bidding, second pricing and bid modifiers0.80
PlacementNamestringName of the placement, as specified by 'divName' in the Ad Decision Request"homepage_leaderboard"
PricefloatPrice of the Flight that is associated with the impression e.g. $20.70.20.70
PriorityIdbigintPriorityId of the Flight that is associated with the impression123456
RateTypeintegerRate type of the Flight that is associated with the impression1
RelevancyScorefloatScore indicating relevancy, requires passing in a relevancy score in the Ad Decision Request500.0
RevenueMultiplierbigintConstant scaling factor (1,000,000) applied to revenue-denominated fields such as Revenue and Gmv, included for downstream conversion back to currency units.1000000
SelectionCountbigintCount of the selection event, incremented by the event multiplier configured on the placement or event.1
SiteIdbigintIdentifier for the Site that the ad is selected in1234567
TimeZoneIdstringIdentifier for the time zone"America/Los_Angeles"
UserKeystringKey identifying the user"ue_e8be4e08dc0345e1b94157f104a5b2ef"
UserGroupintegerInteger (0-99) identifying the stable, randomly-assigned bucket the user falls into. Used for holdout testing and incrementality experiments.42
IsHoldoutbooleanIndicates whether eligible ads were intentionally withheld from this user because they were in a holdout group (used to measure incrementality).false
HoldoutGroupsjsonJSON array describing the holdout group(s) evaluated for this event.
HoldoutAdIdbigintThe ID of the ad that would have served had the user not been placed in a holdout group.123456789
HoldoutCampaignIdbigintThe ID of the campaign associated with the holdout ad (see HoldoutAdId).123456789
HoldoutAdHoldoutGroupsjsonJSON array of the holdout groups associated with the holdout ad.
ZoneIdbigintIdentifier for the Zone that the ad is selected in1234567
SearchTermstringSearch Term string sent in the request"dog food"
TargetedSearchTermsjsonJSON object of search terms configured on the flight{"broad": {"include": ["dog food"]}}
MatchedSearchTermstringSearch term string matching what was sent in the request"dog food"