/
ClearLine Log Level Data

ClearLine Log Level Data

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

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:

  • <= 0 - "unknown"

  • 1 <= w <= 249 - "x-small"

  • 250 <= w <= 349 - "small"

  • 350 <= w <= 500 - "medium"

  • 501 <= w <= 799 - "large"

  • 800 <= w - "x-large"

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 the impression

revenue

numeric(16,10)

Revenue the Clearline account is paid by the demand partner for the impression

third_party_fees

numeric(16,10)

Any third party fees for the impression which includes IVT Fees and Partner Segment Cost fees

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.

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_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

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

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

 

Related content

Log Level Data
More like this
Event Types
Read with this
Campaigns API
More like this
SpringServe API / SDK
SpringServe API / SDK
Read with this
CL -Campaigns API
CL -Campaigns API
More like this
API - Getting Started
API - Getting Started
Read with this