trader_delivery_3p_staq (Trader API v1)
  • 26 Jun 2023
  • 6 Minutes to read
  • Dark
    Light

trader_delivery_3p_staq (Trader API v1)

  • Dark
    Light

Article summary

trader_delivery_3p_staq

  • Data retention: 1 year and 1 month
  • Maximum selected date range: 1 year and 1 month

Dimensions

Name

Type

Description

day_of_week

string

Day name of the week (ex: Wednesday)

day

string

Date in ISO format (ex: 2020-01-01)

third_party_placement_name

string

Third party placement name

third_party_placement_id

int

Third party placement Id

third_party_vendor

string

Third party vendor name

third_party_vendor_id

int

Third party vendor id

third_party_country

string

Country of campaign

month

string

Year and month of event in the following format: YYYY-MM

third_party_timezone

string

Timezone of third party

li_delivery_start_date

date

Impressions delivery start date

creative_id

int

Creative Name

advertiser_id

int

Advertiser Name

advertiser_name

string

Advertiser Name

campaign_id

int

Campaign Name

format

string

Creative Format (ex: 300x250, Video)

ppg_priority

int

Priority Group (Number) of the flight in a Shared (Prioritized Impressions) campaign

account_exec_name

string

Account executive associated with the order as defined in Operative One.

campaign_name

string

Campaign Name

li_start_date

date

Start date of the line item as defined in Operative One.

li_end_date

date

End date of the line item as defined in Operative One.

li_external_id

int

Line item external id

li_name

string

Name of the line item as defined in Operative One.

creative_type_name

string

Creative Type (ex: Video)

campaign_external_label

string

External Label set at the campaign level

campaign_group_name

string

Campaign group name

campaign_group_external_label

string

Campaign group external label

li_impressions_booked

int

Number of impressions booked (objective) for the line item as defined in Operative One.

li_product

string

Type of inventory being targeted by this line item. e.g. CTV, Online Video, Display, First Screen, etc. Defined in Operative One.

rate_type

string

Type of payment rate used in the contract. Can be either a flat rate (predefined fees) or CPM (based on the number or impressions times a predefined CPM). Defined in Operative One.

rate

float

Spend based on predefined contract rate. This is the amount billed to clients. Defined in Operative One.

campaign_state

string

Campaign state

io_external_id

int

Insertion order external id

io_name

string

Order as defined in Operative One

csm_name

string

CSM associated with the order as defined in Operative One.

flight_id

int

Flight Name

flight_name

string

Flight Name

flight_state

string

Flight state

flight_external_label

string

External Label set at the flight level

third_party_delivery_vendor

string

3rd Party adserver used by the client to track impressions and clicks.

budget

float

Budget expected to be delivered as part of the contract. Defined in Operative One.

inventory_type_id

int

ex: App

creative_size

string

Creative Format (ex: 300x250) or Video Player Size (ex: 1280x720)

player_w

int

Video Player Size (ex: 1280x720)

player_h

int

Video Player Size (ex: 1280x720)

creative_group_name

string

Creative Group Name

creative_external_label

string

External Label set at the creative level

creative_name

string

Creative Name

country_name

string

Country Name

deal_id

string

Direct Deal ID

deal_name

string

Deal name

deal_type

string

Deal Type

exchange_name

string

Exchange Name

exchange_seller_name

string

Exchange Seller Name

inventory_type_name

string

ex: App

inventory_name

string

Inventory ID exposes URLs and App Bundles depending on the Inventory Type.

url_domain

string

Site Domain URL

position_name

string

Above the fold, Below the fold or Unknown

start_delay

int

Pre-Roll, Mid-Roll, Post-Roll or Unknown

channel_type

string

Channel Type

stv_tile_id

int

Samsung Smart TV Tile Ad Name

start_delay_type

string

Pre-Roll, Mid-Roll, Post-Roll or Unknown

account_exec_id

int

Account executive associated with the order as defined in Operative One.

creative_type_id

int

Creative Type (ex: Video)

exchange_seller_id

int

Exchange Seller Name

csm_id

int

CSM associated with the order as defined in Operative One.

enhanced_inventory_name

string

App name. Available for “app” inventory type.

iab_category

string

App or streaming channel’s IAB Category. Available for “app” inventory type.

nielsen_genre_code

string

App or streaming channel’s Nielsen Genre Code. Available for “app” inventory type.

streaming_channel

string

TV channel within the Samsung TV Plus app.

inventory_country

string

Country associated with a given app. Available for “app” inventory type.

budget_goal

int

Budget Goal for Campaign

impression_goal

int

Impression Goal for Campaign

Metrics

Name

Type

Description

adserving_fee

float

Ad serving fees will only appear in Samsung DSP reports if the campaign is serving enhanced display creatives or video creatives. All standard creatives and creatives served via third party ad tags will not have any ad serving fees aggregated in the report. If the campaign is serving enhanced and video creatives, the ad serving fees will be added to Samsung DSP buyer spend to make sure budget pacing includes ad serving and the campaign does not overspend.

advertiser_cpa

float

Cost per acquisition/conversion for this advertiser - advertiser spend / Conv. view Through.

advertiser_cpc

float

Cost per click for this advertiser

advertiser_cpm

float

Cost per mille (thousand impressions) for this advertiser

advertiser_postclick_cpa

float

Cost per post-click acquisition/conversion for this advertiser. per post-click acquisition = Conv. Click Through.

advertiser_spend

float

The advertiser spend report reflects the marked up price of the flight for the advertiser. (the active margin field, in the margin section of the strategy portion of the flight form)

average_view_rate

float

Average progress for Video creatives that shows on average how far the video creative is allowed to play before being closed/stopped. This is based on the exact percentage, not the percentiles.

buyer_cpa

float

Cost per acquisition/conversion for this buyer - acquisition and conversion are the same thing.

buyer_cpc

float

Cost per click for this buyer

buyer_cpcv

float

Cost per completed views for this buyer (spend/how many people actually watch the whole creative).

buyer_cpm

float

Cost per mille (thousand impressions) for this buyer

buyer_margin_percent

float

buyer spend / advertiser spend

buyer_postclick_cpa

float

Post-click cost per action for this buyer. This is calculated as [buyer_spend / conversion_postclick]

buyer_spend

float

Buyer spend includes the media spend plus all the fees which are incurred by the campaigns. The buyer spend is a sum of the media fees plus the data fees, ad serving fees and Samsung DSP fees. The buyer spend reflects your actual cost of a campaign to the agency.

clicks

int

A click event is counted when a user clicks on the ad/creative.

clicks_dropped

int

Clicks dropped

completion_rate

float

Video Completed / Video Started

conv_caused

int

Number of times a conversion event was triggered and can be attributed to a valid impression or click event for this campaign/flight/creative.

conv_caused_ctr

float

Percentage of Conv. Click Through / Clicks

conv_caused_vtr

float

Percentage of Conv. View Through / Impressions

conv_postclick

int

Conversion Click Through (attributed to a click) - this is a count of conversions attributed to a click.

conv_postclick_revenue

float

Conversion revenue Click-Through Rate - this is the click through rate for post click conversion, i.e. when the ad has been clicked and the viewer has converted (e.g. made a purchase, signup etc.)

conv_postview

int

Conversion View Through (attributed to an impression) - this is a count of conversions attributed to an impression.

conv_postview_revenue

float

Conversion revenue View-Through Rate - Revenue from post view conversions.

conv_revenue

float

This is the Revenue from a conversion. - how much revenue we track when there is a conversion, i.e. when the viewer completes a purchase of whatever is being advertised.

conv_srr

float

Buyer Spend / Conversion Revenue

ctr

float

Click Through Rate – this is the number of Clicks events over the number of overall Impressions expressed as a percentage.

data_fee

float

Data fees are a sum of all the data which are being used by the campaigns. They will include MOAT Viewability tracking, any and all IAS brand safety, viewability filtering, suspicious activity filtering and context attributes and any Lotame audiences which are being leveraged by the campaigns.

impressions

int

An Impression is counted when the ad is initially loaded. In the case of video ads, it is not necessary for the video creative to play for an impression to be counted.

impressions_dropped

int

Impressions dropped

impressions_measurable

int

This is a measure of the number of impressions that can be tracked by MOAT. This includes both viewable and non-viewable impressions. Some impressions may not be tracked if MOAT isn’t tracking the impression source, application or website where those impressions may occur.

impressions_measurable_percent

float

This is the percentage of trackable impressions (by MOAT) over the total impressions.

impressions_viewable

int

This is the number of impressions that are rendered, such that they can be viewed by a user. This data is provided by MOAT.

impressions_viewable_percent

float

This is the number of viewable impressions over the measurable impressions as determined by MOAT. This value is expressed as a percentage.

media_cpa

float

Cost per acquisition/conversion for this media

media_cpc

float

Cost per click for this media

media_cpcv

float

Cost per completed views for this media

media_cpm

float

Media CPM: Cost per mille (thousand impressions) for this media

media_postclick_cpa

float

Cost per post-click acquisition/conversion for this media. media_spend / conv_postclick

media_spend

float

The raw cost of the media without the data, ad serving and Samsung DSP fees included.

tile_impressions

int

Impressions of the Preview Tile

tile_video_complete

int

Tile Video Completed

tile_video_first_quartile

int

Auto Play Video viewed at 25% before being skipped or exited. Also known as Auto Play Video First Quartiles

tile_video_fullscreen

int

Auto Play Video being viewed in fullscreen mode

tile_video_midpoint

int

Auto Play Video viewed at 50% before being skipped or exited. Also known as Auto Play Video Mid Point

tile_video_start

int

Auto Play Video Started

tile_video_third_quartile

int

Auto Play Video viewed at 75% before being skipped or exited. Also known as Auto Play Video Third Quartiles

trader_fee

float

Samsung DSP fees are simply the platform usage fees outlined in your contract.

unique_browsers_approx

int

Approximate unique browsers

video_click

int

Video Click

video_complete

int

Video viewed completely - number of times the video was viewed to the end.

video_errors

int

Video Errors

video_first_quartile

int

Video viewed at 25% before being skipped or exited. Also known as Video First Quartiles

video_fullscreen

int

Video being viewed in fullscreen mode

video_midpoint

int

Video viewed at 50% before being skipped or exited. Also known as Video Mid Point

video_mute

int

Video being Muted - number of impressions

video_pause

int

Video being Paused - number of impressions where the video was paused.

video_replay

int

Video Replay

video_resume

int

Video being Resumed - number of impressions where the video was paused and then resumed afterward.

video_skip

int

Video that was skipped

video_start

int

Video Started

video_third_quartile

int

Video viewed at 75% before being skipped or exited. Also known as Video Third Quartiles

video_unmute

int

Video being Unmuted

li_impressions_pct

float

Percentage of impressions compared to the number of impressions booked

li_time_elapsed_pct

float

Percentage of time elapsed for a given line item

li_pacing

float

line_item_impressions_pct / line_item_time_elapsed

vtr

float

View through rate (video_complete / impressions)

budget_delivered

float

Budget delivered

clicks_3p

float

Clicks reported by third party

impressions_3p

float

Impressions reported by third party

billable_impressions

float

Impressions for billing

billable_revenue

float

Revenue calculated for billing

ctr_3p

float

Clickthrough rate reported by third party

impressions_disc_3p

float

Discrepancy between Samsung Ads recorded impressions and third party recorded impressions

clicks_disc_3p

float

Discrepancy between Samsung Ads recorded clicks and third party recorded clicks

budget_disc_3p

float

Discrepancy between Samsung Ads recorded budget and third party recorded budget

budget_tracked_3p

float

Third party tracked budget

delivered_3p

float

(impressions_3p/impressions_booked) *100


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.