# Standard Logs The standard logs stored within the Data Shipping logs include: - [Impression Logs](https://dev.kevel.co/docs/standard-logs-1#impression-logs) - [Click Logs](https://dev.kevel.co/docs/standard-logs-1#click-logs) - [Conversion Logs](https://dev.kevel.co/docs/standard-logs-1#conversion-logs) - [Custom Event Logs](https://dev.kevel.co/docs/standard-logs-1#custom-event-logs) ## 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](https://www.tagtoday.net/) 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 `
` 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](https://www.tagtoday.net/) 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 `
` 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.