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. |