...

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

1supply


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

2

account_

tag_3

id

int

SpringServe supply tag ID

Clearline account ID
demand_tag_id	int

SpringServe

Clearline demand tag ID

4


campaign_id	int

SpringServe

Clearline campaign ID

56

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

7


user_id	String (UUID)	User's

SpringServe

Clearline cookie ID

8


user_ip	String	IP address of the user

9

user_agent

String

Full user-agent string of the user

10


country	String (max length 2)	Country code (e.g. "US", "GB", "DE")

11


full_page_url	String	Full-page url that is declared on the incoming ad request.

1215

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"

13detected_player_sizeString (max length 7)Player size detected by our VPAID. Same boundaries as declared_player_size14key_valuesJSON

Key:Values associated with the event. This field is a JSON object with String keys and String values, e.g.

Code Block
{"our_campaign_id": "123", "user_segment": "high_value_users"}

js_impressions

int

Impression served (JS VPAID)

16


clicks	int	Video ad is clicked on by user

17


cost	numeric(16,10)	Media cost the

SpringServe

Clearline account pays the supply partner (for this event)

18


revenue	numeric(16,10)	Revenue the

SpringServe

Clearline account is paid by the demand partner (for this event)

19


third_party_fees	numeric(16,10)	Any third party fees for the demand partner (for this event)

20


first_quartile	int	Video ad has played through 1/4 of its duration.

21

second_quartile

int

Video ad has played through 1/2 of its duration.

22


third_quartile	int	Video ad has played through 3/4 of its duration.

23


fourth_quartile	int	Video ad has played through its entire duration

.24ad_requestsint(Demand-side event) Fired any time our VPAID requests a demand tag's VAST endpoint URL25has_adsint(Demand-side event) VAST endpoint URL responds with a non-empty VAST response26opportunitiesint

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

27errorsint(Demand-side event) 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

2830

device_id_hashed

String (max 40)

User device identifier for Mobile and Connected TV's, stored hashed for privacy compliance

29pc_user_idString (max 128)

dma_id

int

31

ID corresponding to Demographic Market Area (DMA)
postal_code	String (max 16)

32

Postal code for US & CA traffic only.
state	String (max 7)

33


City	String (max 64)

34


starts	int	Video ad started

35


app_name	String (Max 256)	App name as it is sent from the supply request

36


app_bundle	String (Max 256)	App bundle as it is sent in the supply request

3738

spotx_channel_idint

adomain

String (Max 128)

39

Advertiser domain
duplicate_impressions	int	Impressions that are duplicate (ie. same impression beacon fired more than once)

40


bid_price_actual	numeric(16,10)	Non-price reduced bid value as returned in the bid response from a demand partner

41


bid_price_reduced	numeric(16,10)	Price reduced bid value

42


device_id	string (max 40)	The user specific Device Identifier, ex: AAID, RIDA, IFA

43


coppa	boolean	Whether supply is COPPA compliant (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

44


us_privacy	boolean	Whether Supply is CCPA compliant (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

45


dnt	boolean	Do Not Track enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

46


gdpr	boolean	Whether Supply is GDPR enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

47


lmt	boolean	Limit Ad tracking enabled (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

48


app_id	int	The app_id from the incoming dsp_data object

49

content_id

int

Content ID passed in the content_data object

50

. IRIS segment IDs will be passed through this field.
detected_adomain	string	Detected advertiser domain value

51


publisher_name	string	RTB publisher name field

5253


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

54app


language	string	Language of the content

55

content_

id

episode

string

RTB app_id from the incoming dsp_data object56

	Episode name of the content
content_genre_list	string	Genre of the content
content_

custom1

producer_

param57

name

string

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

Producer of the content

content_

custom2

rating_

param58content_custom3_paramstringCustom parameter for content macros that may not be covered in the standardized content macros59content_episodestringEpisode name of the content60content_genre_liststringGenre of the content61content_producer_namestringProducer of the content

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_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
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.
deal_ids	string	Deal ID associated with the inventory source
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 2	New Version Current
Changes made by	Brian Garey	Brian Garey
Saved on	Dec 08, 2022	Nov 19, 2024

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>

Clearline Log Level Data Events

Fields