- 26 Jun 2023
- 6 Minutes to read
- DarkLight
trader_delivery_3p_staq (Trader API v1)
- Updated on 26 Jun 2023
- 6 Minutes to read
- DarkLight
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 |