trader_delivery (Trader API v1)

Updated on 26 Jun 2023
4 Minutes to read

Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

trader_delivery

Data retention: 2 years and 1 month
Maximum selected date range: 2 years and 1 month

Dimensions

Name	Type	Description
advertiser_id	int	Advertiser Name
advertiser_name	string	Advertiser Name
bidder_id	int	Bidder Name
bidder_name	string	Bidder Name
buyer_id	int	Buyer identifier
buyer_name	string	Buyer name
campaign_id	int	Campaign Name
campaign_name	string	Campaign Name
conv_conversion_group_name	string	Conversion Group Name and ID
conv_conversion_group_id	int	Conversion Group Name and ID
country_code	string	Country Name
country_name	string	Country Name
creative_id	int	Creative Name
creative_name	string	Creative Name
creative_type_id	int	Creative Type (ex: Video)
creative_type_name	string	Creative Type (ex: Video)
buyer_currency	string	Buyer currency
device_id	int	(ex: Tizen TV)
device_name	string	(ex: Tizen TV)
device_type_id	int	ex: Connected TV
device_type_name	string	ex: Connected TV
deal_id	string	Direct Deal ID
flight_id	int	Flight Name
flight_name	string	Flight Name
format	string	Creative Format (ex: 300x250, Video)
language_id	int	(ex: EN, FR)
language_name	string	(ex: EN, FR)
region_code	string	State, Province or Region Name
region_name	string	State, Province or Region Name
conv_segment_id	int	Conversion Segment Name
conv_segment_name	string	Conversion Segment Name
exchange_id	int	Exchange Name
exchange_name	string	Exchange Name
position_id	int	Above the fold, Below the fold or Unknown
position_name	string	Above the fold, Below the fold or Unknown
exchange_seller_id	int	Exchange Seller Name
exchange_seller_name	string	Exchange Seller Name
day	string	Date in ISO format (ex: 2020-01-01)
hour	string	Date and hour in ISO format (ex: 2020-01-01-10)
day_of_week	string	Day name of the week (ex: Wednesday)
hour_of_day	string	Hour of the day, in 24h format (ex: 10)
browser_id	int	(ex: Google Chrome, Samsung Internet)
browser_name	string	(ex: Google Chrome, Samsung Internet)
browser_variant_id	int	(ex: Microsoft Internet Explorer 11)
browser_variant_name	string	(ex: Microsoft Internet Explorer 11)
operating_system_id	int	Operating System (ex: Tizen, Microsoft Windows)
operating_system_name	string	Operating System (ex: Tizen, Microsoft Windows)
operating_system_variant_id	int	ex: Microsoft Windows 10
operating_system_variant_name	string	ex: Microsoft Windows 10
campaign_external_label	string	External Label set at the campaign level
flight_external_label	string	External Label set at the flight level
creative_external_label	string	External Label set at the creative level

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_postclick_cpa	float	Cost per post-click acquisition/conversion for this advertiser. per post-click acquisition = Conv. Click Through.
advertiser_cpm	float	Cost per mille (thousand impressions) for this advertiser
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)
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_postclick_cpa	float	Post-click cost per action for this buyer. This is calculated as [buyer_spend / conversion_postclick]
buyer_cpm	float	Cost per mille (thousand impressions) for this buyer
buyer_margin_percent	float	buyer spend / advertiser spend
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.
ctr	float	Click Through Rate – this is the number of Clicks events over the number of overall Impressions expressed as a percentage.
clicks	int	A click event is counted when a user clicks on the ad/creative.
clicks_dropped	int	Clicks dropped
conv_postclick	int	Conversion Click Through (attributed to a click) - this is a count of conversions attributed to a click.
conv_postview	int	Conversion View Through (attributed to an impression) - this is a count of conversions attributed to an impression.
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
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
media_cpa	float	Cost per acquisition/conversion for this media
media_cpc	float	Cost per click for this media
media_postclick_cpa	float	Cost per post-click acquisition/conversion for this media. media_spend / conv_postclick
media_cpm	float	Media CPM: Cost per mille (thousand impressions) for this media
media_spend	float	The raw cost of the media without the data, ad serving and Samsung DSP fees included.
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_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_revenue	float	Conversion revenue View-Through Rate - Revenue from post view conversions.
conv_srr	float	Buyer Spend / Conversion Revenue
impressions_measurable_percent	float	This is the percentage of trackable impressions (by MOAT) over the total impressions.
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.
trader_fee	float	Samsung DSP fees are simply the platform usage fees outlined in your contract.
unique_browsers_approx	int	Approximate unique browsers
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.
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.

Was this article helpful?

What's Next

Examples (Trader API v1)

Table of contents

trader_delivery