Click
A click log is generated when the Click URL is fired.
| Name | Type | Description | Sample Data |
|---|---|---|---|
| ClickId | string | Unique identifier for the click record, generated as MD5 hash of concatenated fields | "90e19b84e78f436286aa4195140c2998" |
| Id | string | Original click identifier. A unique ID is generated for each click fired. | "a1b2c3d4e5f6g7h8i9j0" |
| EventCreatedOn | timestamp | Unix timestamp in milliseconds when the event, in this case click, 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 |
| AttributableItems | json | JSON array of items that can be attributed to the click |
MatchType: string ProductId: string BrandId: string MainCategoryId: string MerchantId: string Promoted: boolean`[{"MatchType": "SameProduct", "ProductId": "prod123", "Promoted": true}]` |
| AttributionClickLookbackWindow | integer | Window period for click attribution | 30 |
| AttributionClickMatchType | string | Type of click attribution matching | "exact" |
| AttributionViewLookbackWindow | integer | Window period for view attribution | 30 |
| AttributionViewMatchType | string | Type of view attribution matching | "exact" |
| 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 |
| Burnin | boolean | Flag indicating if the the ad is still in burn-in phase | true |
| CampaignId | bigint | Identifier for the campaign | 123456789 |
| ChannelId | bigint | Identifier for the channel | 123456789 |
| ClickBuckets | json | Whether the click was bucketed as Unique by [click bucketing](https://dev.kevel.com/docs/click-bucketing). This object carries the `Unique` key only — it is not an itemised breakdown of every bucket. To reconstruct the other buckets from the log, read the `IsValidUa` and `Fraudulent` fields alongside it. | ``` { "Unique": { "Value": true } } ``` |
| ClickCount | bigint | [Count](https://dev.kevel.com/reference/response#event-multipliers) of clicks that has been incremented by the Event Multiplier in either the Request placement or in the query parameter of the click. | 1 |
| CreativeId | bigint | Identifier for the creative | 123456789 |
| Datacenter | boolean | Flag indicating if the click 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/1/1" |
| Ecpm | float | Calculated ECPM (Effective cost per thousand impressions) of the click | 2.50 |
| EcpmPartition | string | [Partition](https://dev.kevel.com/docs/ecpm-partitions) for eCPM | "landing" |
| 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"], "ProductId": ["12345", "23456", "34567"] } ``` |
| FlightId | bigint | Identifier for the flight | 123456789 |
| Fraudulent | boolean | Flag indicating if the click is fraudulent | false |
| 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 |
| GdprIsEu | boolean | Flag indicating if the click is from EU, UK, or Switzerland | true |
| GdprRaw | string | Raw [GDPR consent string](https://dev.kevel.com/docs/gdpr-compliance-and-consent-settings#setting-additional-consent-and-regulatory-parameters) in the request | "true" or "false" |
| GdprSource | string | Source of GDPR consent information. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'. | "req" or "udb" |
| ImpressionCreatedOn | timestamp | Unix timestamp in milliseconds when the request was created | 1735689600000 |
| ImpressionId | string | Original identifier of the impression generated by the same request. | "a1b2c3d4e5f6g7h8i9j0" |
| IsRemainder | boolean | Flag indicating if this is a [remainder percentage](https://dev.kevel.com/docs/priorities#priority-fields) impressions 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 | float | Latitude coordinate | 37.7749 |
| LocationLongitude | float | 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" |
| MatchedSearchTerm | string | The targeted term the shopper's query matched — the term configured on the Ad or Flight, not the raw query. See [Search Term Targeting](doc:search-term-targeting). | "dog food" |
| MatchingKeywords | json | JSON array of matching keywords | `["shoes", "sports"]` |
| ModifiedPrice | float | Modified price value, for when [Bid Modifiers](https://dev.kevel.com/docs/bid-modifiers) are used | 0.75 |
| NetworkId | string | Identifier for the network | "12345" |
| OptimizedPrice | float | Optimized price value, after factoring in auto-bidding, second pricing and bid modifiers | 0.80 |
| PlacementName | string | Name of the placement, as specified by 'divName' in the Ad Decision Request | "homepage\_leaderboard" |
| Price | float | Price of the Flight that is associated with the click e.g. $20.70. | 20.70 |
| PriorityId | bigint | PriorityId of the Flight that is associated with the click | 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 click event | `{"key": "value"}` |
| RateType | integer | [Rate type](https://dev.kevel.com/docs/flights#flight-fields) of the Flight that is associated with the click | 1 |
| ReferrerUrl | string | Referral URL of where the ad served, requires passing in the `referrer` field in the Ad Decision Request | "[https://example.com"](https://example.com") |
| RelevanceScore | float | The relevancy score applied to the ad in this auction. See [relevancy score](https://dev.kevel.com/docs/relevancy-score) | 500.00 |
| Revenue | bigint | Revenue generated from the click 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 |
| SearchTerm | string | The shopper's search query, exactly as sent on the ad decision request. | "puppy chow" |
| SiteId | bigint | Identifier for the Site that the click served in | 1234567 |
| TargetedSearchTerms | json | Search terms configured on the Ad or Flight, grouped by match type, each with `include` and `exclude` lists. See [Search Term Targeting](doc:search-term-targeting). | {"broad": {"include": \["dog food"], "exclude": \["cat food"]}} |
| 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"](https://example.com/page123") |
| UserKey | string | Key identifying the user | "ue\_e8be4e08dc0345e1b94157f104a5b2ef" |
| ZoneId | bigint | Identifier for the Zone that the click served in | 1234567 |
Updated 15 days ago
