Standard Logs

Standard Logs

The standard logs stored within the Data Shipping logs include:

Impression Logs

Name Description Sample Data Type
Id The unique Impression ID "83ea1dc7160f4
83397eb6f5d1c4e62aa"
string
AdTypeId The numeric ID of an ad size. Sourced from the event shim 162 int
AuctionBids The number of non-RTB ads competing for the impression in an Auction priority. If the ad served was selected outside of an Auction priority, then this AuctionsBids value will be zero... 78 int
BrandId The numeric ID of the impression's advertiser. Sourced from the event shim 554125 int
BidModifier The bid modifier that was applied (not present if no bid modifier was matched) {"match": {"keyword": "x"}, "multiplier": 2} object
BurnIn If 1, the impression/click/event was served when an eCPM optimized flight was in a "burn-in" period. TRUE boolean
CampaignId The numeric ID of the impression's campaign. Sourced from the event shim 1331048 int
Categories An array of behavior targeting categories, set by the impression's flight. Sourced from the event shim, absent if absent in the shim. [] array
ChannelId The numeric ID of the impression's channel. Sourced from the event shim 40304 int
CreativeId The numeric ID of the impression's creative. Sourced from the event shim 16458736 int
CreatedOn A time/date stamp (milliseconds since UNIX epoch) that indicates when the impression happened "/Date(1581038413783)/" int (date)
CreativePassId The numeric ID of the impression's ad (creative mapped to flight). Sourced from the event shim 19126348 int
Datacenter If true, the event originates from a TAG known datacenter.
FALSE boolean
DecisionId The ID of the Decision associated with the impression/click/event "7fb50ca376064d9ba
50005e24535f4c9"
string
DecisionIdx Decision Index. For multi-winner placements, the DecisionIdx will be the order of the Selection within the Decision (zero indexed). 0 int
DeliveryMode 1 = Web (served by ados.js tags)
2 = Email (served by HTML tags)
3 = API (served by REST call)
4 = Static Tracking Link (served by GIF) 3 int
Device.brandName Device fields are from the WURFL field set. "" string
Device.modelName Device fields are from the WURFL field set. "" string
Device.osRawVersion Device fields are from the WURFL field set. "" string
Device.osMajorVersion Device fields are from the WURFL field set. 0 int
Device.osMinorVersion Device fields are from the WURFL field set. 0 int
Device.advertisedOsRawVersion Device fields are from the WURFL field set. "10.14" string
Device.advertisedOsMajorVersion Device fields are from the WURFL field set. 10 int
Device.advertisedOsMinorVersion Device fields are from the WURFL field set. 14 int
Device.advertisedOs Device fields are from the WURFL field set. "Mac OS X" string
Device.browser Device fields are from the WURFL field set. "" string
Device.browserRawVersion Device fields are from the WURFL field set. "" string
Device.browserMajorVersion Device fields are from the WURFL field set. 0 int
Device.browserMinorVersion Device fields are from the WURFL field set. 0 int
Device.deviceIdentified Confirms if the client device used has been successfully identified. true boolean
Device.formFactor Device fields are from the WURFL field set. "desktop" string
Ecpm Calculated ECPM of the impression/click/event 830.070956 float
EcpmPartition eCPM Partitions track the eCPM performance data of ads separately for different partitions of your inventory. null string
EventCreatedOn When the impression event occurred, as a UNIX timestamp 1581038414099 long
FirstChannelId Deprecated. 40304 int
FrequencyCap The type(s) of frequency capping applied to the impression. Logged as the decimal value of a hex bit flag. 17 int
GdprComputed If true, the request has GDPR consent. TRUE boolean
GdprConsentRequired If true, the gdprConsentRequired parameter was provided on the request, indicating that the user was subject to GDPR regulation. FALSE boolean
GdprConsentString The IAB consent string provided with the request if the string was used when computing GDPR consent. "" string
GdprIsEU If true, the request originates from the EU, the UK, or Switzerland. TRUE boolean
GdprSource Where GDPR consent data comes from. "none" string
GdprVendorId The vendor ID provided in the request (if available). 1234 int
Gmv Gross Merchandise Value. 1000000 int
GrossRevenue 0 int
ImpressionCount Refers to the number of impressions registered. Default is 1. 1 int
ImpressionCreatedOn Records the time this Event was created in the server. 1581038413783 long
IsNoTrack If true, the impression was served to a Do Not Track enabled user. FALSE boolean
IsPublisherPayoutExempt FALSE boolean
IsRemainder If true, the impression was served as part of the "Remainder Percentage" in an auction priority. FALSE boolean
IsTrackingCookieEvents If true, the impression is tracking conversions. FALSE boolean
IsValidUA If true, the impression passed the bots and spiders filter. TRUE boolean
Keywords Keyword(s) sent on the request, converted into a comma separated string. "fpfdvrmwggl4z,j7sr2ywldd
6m,dt7zi5mlfrrs7,kr74uow
fsyyzp"
string (comma delimited)
Location.CountryCode An array of location data from the request. "AU" string
Location.CountryName See above. "Australia" string
Location.Region See above. "NSW" string
Location.City See above. "Sydney" string
Location.DmaCode See above.
Location.MetroCode See above.
Location.PostalCode See above. "2000" string
Location.Latitude See above. 0 int
Location.Longitude See above. 0 int
Matching Keywords Keyword(s) present in the ad. The standard logs stored within the array
ModifiedPrice The price after bid modifier was applied -- if no bid modifier was applied this will be the same as the Price. "12.02" string
Meta:schema The type of log - will always be event "event" string
Meta:version The version of the log format this log object uses. "1.3" string
NetRevenue 0 int
NetworkId The numeric ID of the impression's network. Sourced from the event shim. 10322 int
OptimizedPrice The price set by a bid optimizer. 26 number
PassId The numeric ID of the impression's flight. Sourced from the event shim. 11082877 int
PhantomCreativePassId Internal - used during phantom mode for impression goal ads. 0 int
PlacementName The name of the Placement object or <div> that served the ad. "placement 1" string
PhantomPassId Internal - used during phantom mode for impression goal ads. 0 int
PriorityId The numeric ID of the impression's priority. Sourced from the event shim. 161492 int
Price The price per unit associated with the impression. "6.01" string
RateType The rate used by the flight. 3 int
ReferrerUrl The URL that led to the page that hosted the ad request.
RelevancyScore 500 int
Revenue Revenue generated via the event(impression/click). 0 int
RemoteIP This is sanitized as 0.0.0.0 instead of the IP address. "0.0.0.0" string
RtbBids The number of RTB bids competing for the impression.
ServedBy "i-0ecaf52dd4dba2672" string
ServedByAsg "bifrost-adservers-default-
us-east-1"
string
ServedByPid 43473 int
SiteId The numeric ID of the impression's site. Sourced from the event shim. 1086974 int
TimeZoneId The time zone of the flight.
If no time zone is explicitly set, defaults to "UTC". string
Url The URL of the page the ad served on. string
User.Key An array of user data (in UserDB) associated with the impression. Contains two fields: the Key, and whether or not this is a new user. "ue1-3542a229b8be4109
bcad892fc317ddfa"
string
User.IsNew FALSE boolean
User.Type Where user data was stored/retrieved from: int
UserAgent Deprecated for privacy purposes. "" string
UserKey The user Key associated with the impression. "ue1-3542a229b8be4109
bcad892fc317ddfa"
string
ZoneId The numeric ID of the impression's zone (if applicable). 0 int

Click Logs

The JSON objects for other events use the same format as the impression object. Additional parameters for clicks (or parameters with differences):

Name Description
Id The unique Click ID
AdTypeId The numeric ID of an ad size. Sourced from the event shim
BrandId The numeric ID of the impression's advertiser. Sourced from the event shim
BurnIn True if in initial/learning phase
CampaignId The numeric ID of the impression's campaign. Sourced from the event shim
Categories An array of behavior targeting categories, set by the impression's flight.
ChanelId
ClickBuckets Whether the click was bucketed as Unique.
ClickCount Refers to the number of clicks registered if Event Multipliers are used. Default is 1
CreativeId The numeric ID of the impression's creative. Sourced from the event shim
CreatedOn A time/date stamp that indicates when the impression happened
CreativePassId The numeric ID of the impression's ad (creative mapped to flight). Sourced from the event shim.
Datacenter If true, the event originates from a TAG known datacenter
DecisionId The ID of the Decision associated with the impression/click/event
DecisionIdx
DeliveryMode
Device.brandName Device fields are from the WURFL field set
Device.modelName Device fields are from the WURFL field set
Device.osRawVersion Device fields are from the WURFL field set
Device.osMajorVersion Device fields are from the WURFL field set
Device.osMinorVersion Device fields are from the WURFL field set
Device.advertisedOsRawVersion Device fields are from the WURFL field set
Device.advertisedOsMajorVersion Device fields are from the WURFL field set
Device.advertisedOsMinorVersion Device fields are from the WURFL field set
Device.advertisedOs Device fields are from the WURFL field set
Device.browser Device fields are from the WURFL field set
Device.browserRawVersion Device fields are from the WURFL field set
Device.browserMajorVersion Device fields are from the WURFL field set
Device.browserMinorVersion Device fields are from the WURFL field set
Device.deviceIdentified Device fields are from the WURFL field set
Device.formFactor Device fields are from the WURFL field set
Ecpm Calculated ECPM of the impression/click/event
EcpmPartition Value passed in during decision request
EventCreatedOn When the click event occurred, as a UNIX timestamp
FirstChannelId Deprecated
Fradulent True if matches the IAB/TAG group for fraudulent IPs/datacenter traffic
GdprComputed If true, the request has GDPR consent
GdprConsentRequired
GdprConsentString
GdprIsEU
GdprSource
Gmv
GrossRevenue
ImpressionCount Refers to the number of impressions registered if Event Multipliers are used. Default is 1
ImpressionCreatedOn Records the time this Event was created in the server.
ImpressionId The Impression ID
IsNoTrack If true, the impression was served to a Do Not Track enabled user
IsPublisherPayoutExempt
IsRemainder If true, the impression was served as part of the "Remainder Percentage"
IsTrackingCookieEvents
IsValidUA If true, the impression passed the bots and spiders filter
Keywords
Location.CountryCode An array of location data from the request
Location.CountryName See above
Location.Region See above
Location.City See above
Location.DmaCode See above
Location.MetroCode See above
Location.PostalCode See above
Location.Latitude See above
Location.Longitude See above
Matching Keywords Keyword(s) present in the ad
Meta:schema The type of log - will always be event
Meta:version The version of the log format this log object uses.
NetRevenue
NetworkId The numeric ID of the impression's network.
PassId The numeric ID of the impression's flight.
PlacementName The name of the Placement object or <div> that served the ad.
PriorityId The numeric ID of the impression's priority.
Price The price per unit (CPA, CPM, CPC).
RateType Use by flight
RelevancyScore
RemoteIP The sanitized IP address
Revenue
ServedBy
ServedByAsg
ServedByPid
SiteId The numeric ID of the impression's site.
TimeZoneId
Url The URL of the page the ad served on.
User An array of user data associated with the impression
UserAgent The string of the user agent
UserKey The user Key used by UserDB associated with the impression
ZoneId The numeric ID of the impression's zone

Conversion Logs

The JSON objects for other events use the same format as the impression object. Additional parameters for conversions:

Name Description
CreatedOn (Deprecated) When the impression associated with the conversion occurred, as a UNIX timestamp
EventCreatedOn When the conversion occurred, as a UNIX timestamp
ImpressionCreatedOn Records the time this Event was created in the server.
IsValidUA If true, the impression passed the bots and spiders filter.
Location An array of location data from the request.
RemoteIP This is sanitized as 0.0.0.0 instead of the IP address
Url The URL of the page the ad served on.
User An array of user data associated with the impression.
UserAgent The string of the user agent that created the impression.
UserKey The user Key associated with the impression.

Custom Event Logs

The JSON objects for other events use the same format as the impression object. They have the same additional parameters as conversions, with two notable differences:

Custom event logs have an additional EventId field that is the ID of the custom event type. The logs also contain a CustomEventCount field that refers to the number of Custom Events registered.

For "EventId": 3 generated from the purchase event endpoint the following parameters will be present:

Name Description
AttributedPurchaseMetadata.UserKey The array of user keys supplied with the purchase event.
AttributedPurchaseMetadata.Timestamp The timestamp supplied via the purchase event.
AttributedPurchaseMetadata.Quantity The quantity of items in this transaction.
AttributedPurchaseMetadata.Price The product price of the line item.
AttributedPurchaseMetadata.TransactionId The transaction identifier
AttributedPurchaseMetadata.ProductId The product identifier
AttributedPurchaseMetadata.LtvQuantity The expected additional quantity of items sold to this customer.
AttributedPurchaseMetadata.LtvValue The expected additional sales value sold to this customer.