Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

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

1

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

2

demand_tag_id

int

SpringServe

Clearline demand tag ID

3

campaign_id

int

SpringServe

Clearline campaign ID

4

creative_id

int

Currently not used5

Clearline creative ID

auction_id

String (UUID)

Unique ID identifying an auction; different events can be tied together through their auction ID

6

user_id

String (UUID)

User's

SpringServe

Clearline cookie ID

7

user_ip

String

IP address of the user

8

user_agent

String

Full user-agent string of the user

9

country

String (max length 2)

Country code (e.g. "US", "GB", "DE")

10

full_page_url

String

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

11

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"

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

js_impressions

int

Impression served (JS VPAID)

14

clicks

int

Video ad is clicked on by user

15

cost

numeric(16,10)

Media cost the

SpringServe

Clearline account pays the supply partner

(for this event)16

for the impression

revenue

numeric(16,10)

Revenue the

SpringServe

Clearline account is paid by the demand partner

(

for

this event)17

the impression

third_party_fees

numeric(16,10)

Any third party fees for the

demand partner (for this event)18

impression which includes IVT Fees and Partner Segment Cost fees

first_quartile

int

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

19

second_quartile

int

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

20

third_quartile

int

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

21

fourth_quartile

int

Video ad has played through its entire duration.

2223has_adsintVAST endpoint URL responds with a non-empty VAST response24opportunitiesint

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

25errorsintIndicates an error occurred with the demand tag. Most common case is due to the demand not filling or our VPAID timing out the demand tag26

ad_requestsintFired any time our VPAID requests a demand tag's VAST endpoint URL

device_id_hashed

String (max 40)

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

27

dma_id

int

ID corresponding to Demographic Market Area (DMA)

28

postal_code

String (max 16)

Postal code for US & CA traffic only.

29

state

String (max 7)

30

City

String (max 64)

31

starts

int

Video ad started

32

app_name

String (Max 256)

App name as it is sent from the supply request

33

app_bundle

String (Max 256)

App bundle as it is sent in the supply request

34spotx_channel_idint35

adomain

String (Max 128)

Advertiser domain

36

duplicate_impressions

int

Impressions that are duplicate (ie. same impression beacon fired more than once)

37

bid_price_actual

numeric(16,10)

Non-price reduced bid value as returned in the bid response from a demand partner

38

bid_price_reduced

numeric(16,10)

Price reduced bid value

39

device_id

string (max 40)

The user specific Device Identifier, ex: AAID, RIDA, IFA

40

coppa

boolean

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

41

us_privacy

boolean

Whether Supply is

CCPA compliant

CCPA compliant (1) or not (0). Determined by the presence of the corresponding parameter in the ad request.

42

dnt

boolean

Do Not Track enabled (1) or not (0).

 Determined

 Determined by the presence of the corresponding parameter in the ad request.

43

gdpr

boolean

Whether Supply is GDPR enabled (1) or not (0).

 Determined

 Determined by the presence of the corresponding parameter in the ad request.

44

lmt

boolean

Limit Ad tracking enabled (1) or not (0).

 Determined

 Determined by the presence of the corresponding parameter in the ad request.

45

app_id

int

The app_id from the incoming dsp_data object

46

content_id

int

Content ID passed in the content_data object

47

. IRIS segment IDs will be passed through this field.

detected_adomain

string

Detected advertiser domain value

48

publisher_name

string

RTB publisher name field

4950

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

51app

language

string

Language of the content

52

content_

id53

episode

string

RTB app_id from the incoming dsp_data object

Episode name of the content

content_

custom1

genre_

param54

list

string

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

Genre of the content

content_

custom2

producer_

param55

name

string

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

Producer of the content

content_

custom3

rating_

param56content_episodestringEpisode name of the content57content_genre_liststringGenre of the content58content_producer_namestringof the content59

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

60

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.

61

event_type

String (max length 128)

List of Event Types can be

found 

found here.

62opportunity_response_timebigintAmount 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.63

deal_ids

string

Deal ID associated with the inventory source

bid request64opportunity_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

Non Billable Fees as entered on Settings page of Demand Partner, Campaign or Demand Tag.

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

  • 26 Set-top Box