---
updatedAt: 2026-11-06T16:48:13.000Z
agentTools:
  projectIndex: https://dev.kevel.com/llms.txt
---

# Custom Event

A custom event log is generated when a Custom Event URL is fired.

| Name                      | Type      | Description                                                                                                                                                                                                                                                                        | Sample Data                                                                                                                |
| :------------------------ | :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| IsLastModified            | timestamp | Timestamp 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                                                                                                    |
| Id                        | string    | Unique identifier for the custom event record, generated as MD5 hash of concatenated fields                                                                                                                                                                                        | "90e19b84e78f436286aa4195140c2998"                                                                                         |
| CustomEventId             | string    | Original custom event identifier. A unique ID is generated for each custom event fired.                                                                                                                                                                                            | "a1b2c3d4e5f6g7h8i9j0"                                                                                                     |
| EventCreatedOn            | timestamp | Unix timestamp in milliseconds when the event, in this case custom event, was created                                                                                                                                                                                              | 1735689600000                                                                                                              |
| AdId                      | bigint    | Identifier for the ad                                                                                                                                                                                                                                                              | 123456789                                                                                                                  |
| AdTypeId                  | bigint    | [Type](https://dev.kevel.com/docs/ad-sizes) identifier for the ad                                                                                                                                                                                                                  | 1                                                                                                                          |
| BidModifier               | json      | JSON array of [bid modifications](https://dev.kevel.com/docs/bid-modifiers)                                                                                                                                                                                                        | Match: json Keyword: string Zone: bigint Site: bigint Multiplier: float Price: float`[{"multiplier": 1.5, "price": 0.75}]` |
| AdvertiserId              | bigint    | Identifier for the advertiser                                                                                                                                                                                                                                                      | 2325487                                                                                                                    |
| CampaignId                | bigint    | Identifier for the campaign                                                                                                                                                                                                                                                        | 123456789                                                                                                                  |
| ChannelId                 | bigint    | Identifier for the channel                                                                                                                                                                                                                                                         | 123456789                                                                                                                  |
| CreativeId                | bigint    | Identifier for the creative                                                                                                                                                                                                                                                        | 123456789                                                                                                                  |
| CustomEventCount          | bigint    | [Count](https://dev.kevel.com/reference/response#event-multipliers) of the event that has been incremented by the Event Multiplier in either the Request placement or in the query parameter of the event.                                                                         | 1                                                                                                                          |
| Datacenter                | boolean   | Flag indicating if the custom event was served from a datacenter                                                                                                                                                                                                                   | false                                                                                                                      |
| DecisionId                | string    | Identifier for the decision. A distinct value is created for each `placement` object in an ADR.                                                                                                                                                                                    | "90e19b84e78f436286aa4195140c2998"                                                                                         |
| DecisionIdx               | bigint    | Decision 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                                                                                                                          |
| 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"                                                                                                               |
| Ecpm                      | float     | Calculated ECPM (Effective cost per thousand impressions) of the custom event                                                                                                                                                                                                      | 2.50                                                                                                                       |
| EventId                   | bigint    | ID of the custom event, in the case of conversion is 1, 2, or 3                                                                                                                                                                                                                    | 3                                                                                                                          |
| EventMetadata             | json      | Additional [metadata](https://dev.kevel.com/docs/metadata-on-impressions-and-clicks) for the event. Refer to the doc for parameters and values                                                                                                                                     | `{"Position": ["1", "5"], "Component": ["logo", "video", "CTA"]}`                                                          |
| FlightId                  | bigint    | Identifier for the flight                                                                                                                                                                                                                                                          | 123456789                                                                                                                  |
| GdprComputed              | boolean   | If true, the request has [GDPR consent](https://dev.kevel.com/docs/gdpr-compliance-and-consent-settings) either from the request itself, from a UserDB record etc                                                                                                                  | true                                                                                                                       |
| GdprSource                | string    | Source of GDPR consent information. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'.                                                                                                                                                                | "req" or "udb"                                                                                                             |
| Gmv                       | bigint    | Gross Merchandise Value. Sourced from the event URL if appended as a query parameter. Calculated by taking the gmv parameter on the event URL and multiplying by 1,000,000.                                                                                                        | 1000000                                                                                                                    |
| ImpressionCreatedOn       | timestamp | Unix timestamp in milliseconds when the request was created                                                                                                                                                                                                                        | 1735689600000                                                                                                              |
| IsRemainder               | boolean   | Flag indicating if this is a [remainder percentage](https://dev.kevel.com/docs/priorities#priority-fields) impression as part of the Auction optimisation process                                                                                                                  | false                                                                                                                      |
| 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](https://dev.kevel.com/reference/list-geo-codes).                                                                                                                                                                                            | "US"                                                                                                                       |
| LocationCountryName       | string    | Country name                                                                                                                                                                                                                                                                       | "United States"                                                                                                            |
| LocationDmaCode           | string    | DMA code                                                                                                                                                                                                                                                                           | "807"                                                                                                                      |
| LocationLatitude          | double    | Latitude coordinate                                                                                                                                                                                                                                                                | 37.7749                                                                                                                    |
| LocationLongitude         | double    | 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"                                                                                                                 |
| MatchingKeywords          | json      | JSON array of matching keywords                                                                                                                                                                                                                                                    | `["shoes", "sports"]`                                                                                                      |
| ModifiedPrice             | float     | `Price` with [Bid Modifiers](https://dev.kevel.com/docs/bid-modifiers) applied                                                                                                                                                                                                     | 0.75                                                                                                                       |
| NetworkId                 | string    | Identifier for the network                                                                                                                                                                                                                                                         | "12345"                                                                                                                    |
| OptimizedPrice            | float     | `ModifiedPrice` with auto-bidding applied. This is the final price used when entering an auction. It will be the same as `ModifiedPrice` if auto-bid didn't have an effect and same as `Price` if bid modifiers also didn't take place                                             | 0.80                                                                                                                       |
| PlacementName             | string    | Name of the placement, as specified by 'divName' in the Ad Decision Request                                                                                                                                                                                                        | "homepage\_leaderboard"                                                                                                    |
| Price                     | float     | Price set on the Ad associated with the custom event e.g. $20.70.                                                                                                                                                                                                                  | 20.70                                                                                                                      |
| PriorityId                | bigint    | PriorityId of the Flight that is associated with the custom event                                                                                                                                                                                                                  | 123456                                                                                                                     |
| ProductId                 | string    | Identifier for the product, if it is associated with a product Ad.                                                                                                                                                                                                                 | "prod\_123"                                                                                                                |
| Properties                | json      | JSON object of additional [custom properties ](https://dev.kevel.com/docs/custom-data-shipping-properties)sent with the custom event                                                                                                                                               | `{"key": "value"}`                                                                                                         |
| RateType                  | integer   | [Rate type](https://dev.kevel.com/docs/flights#flight-fields) of the Flight that is associated with the custom event                                                                                                                                                               | 1                                                                                                                          |
| ReferrerUrl               | string    | Referral URL of where the ad served, requires passing in the `referrer` field in the Ad Decision Request                                                                                                                                                                           | "<https://example.com">                                                                                                    |
| Revenue                   | bigint    | Revenue generated from the custom event multiplied by 1,000,000 (in order to support very small prices, such as $0.01 CPC).May be altered by [revenue modifying parameters](https://dev.kevel.com/docs/metadata-on-impressions-and-clicks#revenue-aka-advertiser-ad-spend) .       | 50000                                                                                                                      |
| SiteId                    | bigint    | Identifier for the Site that the custom event served in                                                                                                                                                                                                                            | 1234567                                                                                                                    |
| TimeZoneId                | string    | Identifier for the [time zone](https://dev.kevel.com/docs/time-zones-1#available-time-zones-strings)                                                                                                                                                                               | "America/Los\_Angeles"                                                                                                     |
| 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"                                                                                     |
| UserGroup                 | integer   | Integer (0-99) identifying the stable, randomly-assigned bucket the user falls into. Used for holdout testing and incrementality experiments.                                                                                                                                      | 42                                                                                                                         |
| HoldoutGroups             | json      | JSON array describing the holdout group(s) evaluated for this event.                                                                                                                                                                                                               |                                                                                                                            |
| HoldoutAdId               | bigint    | The ID of the ad that would have served had the user not been placed in a holdout group.                                                                                                                                                                                           | 123456789                                                                                                                  |
| HoldoutCampaignId         | bigint    | The ID of the campaign associated with the holdout ad (see HoldoutAdId).                                                                                                                                                                                                           | 123456789                                                                                                                  |
| HoldoutAdHoldoutGroups    | json      | JSON array of the holdout groups associated with the holdout ad.                                                                                                                                                                                                                   |                                                                                                                            |
| ZoneId                    | bigint    | Identifier for the Zone that the custom event served in                                                                                                                                                                                                                            | 1234567                                                                                                                    |
| SearchTerm                | string    | Search Term string sent in the request                                                                                                                                                                                                                                             | "dog food"                                                                                                                 |
| TargetedSearchTerms       | json      | JSON object of search terms configured on the flight                                                                                                                                                                                                                               | {"broad": {"include": ["dog food"]}}                                                                                       |
| MatchedSearchTerm         | string    | Search term string matching what was sent in the request                                                                                                                                                                                                                           | "dog food"                                                                                                                 |