Fields
| Field Name | Field Data Type | Field Description |
|---|---|---|
| ymdh | timestamp | Timestamp of the event, in UTC, in ISO format. The character "T" serves as the separator between Date and Time parts. Format: YYYY-MM-DDTHH:MM:SS |
| account_id | int | Clearline account ID |
| demand_tag_id | int | Clearline demand tag ID |
| campaign_id | int | Clearline campaign ID |
| creative_id | int | Clearline creative ID |
| auction_id | String (UUID) | Unique ID identifying an auction; different events can be tied together through their auction ID |
| user_id | String (UUID) | User's Clearline cookie ID |
| user_ip | String | IP address of the user |
| user_agent | String | Full user-agent string of the user |
| country | String (max length 2) | Country code (e.g. "US", "GB", "DE") |
| full_page_url | String | Full-page url that is declared on the incoming ad request. |
| declared_player_size | String (max length 7) | Declared player size. Sizes are based on width and are defined by the following boundaries:
|
| detected_player_size | String (max length 7) | Player size detected by our VPAID. Same boundaries as declared_player_size |
| js_impressions | int | Impression served (JS VPAID) |
| clicks | int | Video ad is clicked on by user |
| cost | numeric(16,10) | Media cost the Clearline account pays the supply partner (for this event) |
| revenue | numeric(16,10) | Revenue the Clearline account is paid by the demand partner (for this event) |
| third_party_fees | numeric(16,10) | Any third party fees for the demand partner (for this event) |
| first_quartile | int | Video ad has played through 1/4 of its duration. |
| second_quartile | int | Video ad has played through 1/2 of its duration. |
| third_quartile | int | Video ad has played through 3/4 of its duration. |
| fourth_quartile | int | Video ad has played through its entire duration. |
| has_ads | int | VAST endpoint URL responds with a non-empty VAST response |
| opportunities | int | Indicates the VPAID received a non-empty VAST response / media file back from VAST endpoint URL, and initiated it |
| errors | int | Indicates an error occurred with the demand tag. Most common case is due to the demand not filling or our VPAID timing out the demand tag |
| device_id_hashed | String (max 40) | User device identifier for Mobile and Connected TV's, stored hashed for privacy compliance |
| dma_id | int | ID corresponding to Demographic Market Area (DMA) |
| postal_code | String (max 16) | Postal code for US & CA traffic only. |
| state | String (max 7) | |
| City | String (max 64) | |
| starts | int | Video ad started |
| app_name | String (Max 256) | App name as it is sent from the supply request |
| app_bundle | String (Max 256) | App bundle as it is sent in the supply request |
| adomain | String (Max 128) | Advertiser domain |
| duplicate_impressions | int | Impressions that are duplicate (ie. same impression beacon fired more than once) |
| bid_price_actual | numeric(16,10) | Non-price reduced bid value as returned in the bid response from a demand partner |
| bid_price_reduced | numeric(16,10) | Price reduced bid value |
| device_id | string (max 40) | The user specific Device Identifier, ex: AAID, RIDA, IFA |
| coppa | boolean | Whether supply is COPPA compliant (1) or not (0). Determined by the presence of the corresponding parameter in the ad request. |
| us_privacy | boolean | Whether Supply is CCPA compliant (1) or not (0). Determined by the presence of the corresponding parameter in the ad request. |
| dnt | boolean | Do Not Track enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request. |
| gdpr | boolean | Whether Supply is GDPR enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request. |
| lmt | boolean | Limit Ad tracking enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request. |
| app_id | int | The app_id from the incoming dsp_data object |
| content_id | int | Content ID passed in the content_data object. IRIS segment IDs will be passed through this field. |
| detected_adomain | string | Detected advertiser domain value |
| publisher_name | string | RTB publisher name field |
| publisher_id_string | String (Max 38) | Specific to Clearline and is the publisher_id |
| inventory_source | string | Source of the supply |
| language | string | Language of the content |
| content_custom1_param | string | Custom parameter for content macros that may not be covered in the standardized content macros |
| content_custom2_param | string | Custom parameter for content macros that may not be covered in the standardized content macros |
| content_custom3_param | string | Custom parameter for content macros that may not be covered in the standardized content macros |
| content_episode | string | Episode name of the content |
| content_genre_list | string | Genre of the content |
| content_producer_name | string | Producer of the content |
| content_rating_list | string | Rating of the content |
| content_season | string | Seaons of the content |
| content_series | string | Series of the content |
| content_title | string | Title of the content |
| network | string | Publisher declared network of the content |
| declared_domain | String (max length128) | Declared domain on the incoming ad request. |
| event_type | String (max length 128) | List of Event Types can be found here. |
| opportunity_response_time | bigint | Amount of time it takes for the demand tag to fill an impression. This is the time between an ad_request event and an impression event. |
| deal_ids | string | Deal ID associated with the inventory source bid request |
| opportunity_timeouts | int | When our VPAID times out a demand tag for taking too long to find an ad |
| iris_id | string | Publisher declared IRIS identifier. More information on IRIS here. |
| iris_context | string | Publisher declared IRIS context. More information on IRIS here. |
| brand_name | String (Max 64) | Connected TV brands |