...

Clearline Log Level Data Events

***ClearLine Log Level Data should be set up with these events only*** : impressions, clicks, starts, first_quartile, second_quartile, third_quartile, and fourth_quartile.

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

Springserve

Clearline account ID
demand_tag_id	int

SpringServe

Clearline demand tag ID
campaign_id	int

SpringServe

Clearline campaign ID
creative_id	int

Currently not used

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

SpringServe

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: <= 0 - "unknown" 1 <= w <= 249 - "x-small" 250 <= w <= 349 - "small" 350 <= w <= 500 - "medium" 501 <= w <= 799 - "large" 800 <= w - "x-large"

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

SpringServe

Clearline account pays the supply partner (for this event)
revenue	numeric(16,10)	Revenue the

SpringServe

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.

ad_requestsintFired any time our VPAID requests a demand tag's VAST endpoint URLhas_adsintVAST endpoint URL responds with a non-empty VAST responseopportunitiesint

Indicates the VPAID received a non-empty VAST response / media file back from VAST endpoint URL, and initiated it

errorsintIndicates 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

spotx_channel_id

int

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)

RTB publisher ID field

Specific to Clearline and is the publisher_id
inventory_source	string	Source of the supply
language	string	Language of the content

app

content_

id

episode

string

RTB app_id from the incoming dsp_data object

Episode name of the content

content_

custom1

genre_

param

list

string

Custom parameter for content macros that may not be covered in the standardized content macros

Genre of the content

content_

custom2

producer_

param

name

string

Custom parameter for content macros that may not be covered in the standardized content macros

Producer of the content

content_

custom3

rating_

param

list

string

Custom parameter for content macros that may not be covered in the standardized content macros

Rating of the content
channel_name	String (Max 64)	Name of the channel
content_

episode

season

string

Episode name

Seaons of the content

content_

genre_list

series

string

Genre

Series of the content

content_

producer_name

title	string	Title of the content
network	string	Publisher declared network of the content
production_quality	int	Production Quality of the content
livestream	boolean	Indicates whether the content is a livestream or not
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_timebigint

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 requestopportunity_timeoutsintWhen 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)	Device brand
platform_fees	int	Contractual platform fee
non_billable_fees	int	Aggregated 'Fees' as entered on Settings page of Demand Partner, Campaign. These fees are applied when using the Gross Cost budget type.
expired_impressions	int	Impressions fired outside of the beacon expiry (aka time to live) as determined by the SSP. These are not billed.
device_type_id	int	The Device type identifier as defined below. 0 Other 1 Computer 2 Mobile 3 Tablet 4 Game Console 5 Digital Media Receiver 6 Wearable Computer 7 Connected TV 20 Games Console 21 Mobile In-app 22 Mobile Web 23 Tablet In-app 24 Tablet Web 25 CTV 26Set-top Box

Version	Old Version 8	New Version Current
Changes made by	Brian Garey	Brian Garey
Saved on	Aug 29, 2023	Nov 19, 2024

Versions Compared

Key

Clearline Log Level Data Events

Fields

Page Comparison

Versions Compared

Key

<span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-0">[data-colorid=</span>

<span class="diff-html-added" data-a11y-before="Start of added content" data-a11y-after="End of added content" id="added-diff-0">smhi0p737h</span><span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-1">]{color:</span>

<span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-2">#222222} html[data-color-mode=dark] [data-colorid=</span>

Clearline Log Level Data Events

Fields