Samsung Ads: Most-used fields

The table below gives information about most-used fields that you can import from Samsung Ads. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
3rd-Party Delivery Vendor	3rd-Party Delivery Vendor	The name of the third-party vendor responsible for ad delivery.	dimension
AdServing Fees	AdServing Fees	Fees incurred for serving advertisements.	metric
Advertiser	Advertiser	The name of the advertiser.	dimension
Advertiser ID	Advertiser ID	The unique identifier for the advertiser.	metric
Advertiser Spend	Advertiser Spend	The total spend by the advertiser on advertising.	metric
App Bundle	App Bundle	The application bundle identifier.	dimension
App Bundle ID	App Bundle ID	The unique identifier for the application bundle.	dimension
Bid Model	Bid Model	The model used for bidding on ad inventory.	dimension
Browser	Browser	The name of the web browser used by the user.	dimension
Browser ID	Browser ID	The unique identifier for the web browser.	metric
Browser Language	Browser Language	The language setting of the user’s web browser.	dimension
Browser Variant ID	Browser Variant ID	The unique identifier for a specific variant of the web browser.	metric
Browser Version	Browser Version	The version of the web browser used by the user.	dimension
Budget	Budget	The allocated budget for the advertising campaign or line item.	dimension
Budget Delivered	Budget Delivered	The portion of the budget that has been spent or delivered.	metric
Buyer	Buyer	The name of the buyer or trading desk.	dimension
Buyer Currency	Buyer Currency	The currency used by the buyer for transactions.	dimension
Buyer Spend	Buyer Spend	The total spend by the buyer on advertising.	metric
CTR	CTR	The Click-Through Rate, which is the percentage of impressions that resulted in a click.	metric
Campaign	Campaign	The name of the advertising campaign.	dimension
Campaign Group	Campaign Group	The name of the campaign group to which a campaign belongs.	dimension
Campaign Group ID	Campaign Group ID	The unique identifier for the campaign group.	dimension
Campaign ID	Campaign ID	The unique identifier for the advertising campaign.	metric
Campaign State	Campaign State	The current state or status of the advertising campaign (e.g., active, paused, completed).	dimension
Channel Type	Channel Type	The type of channel where the advertisement is displayed, such as mobile, desktop, or connected TV.	dimension
Clicks	Clicks	The total number of clicks on an advertisement.	metric
Clicks Dropped	Clicks Dropped	The number of clicks that were dropped or not registered due to various reasons.	metric
Completed	Completed	The count of video ad plays that reached 100% completion.	metric
Completion Rate	Completion Rate	The rate at which video ads are completed, calculated as (Completed views / Started views) * 100%.	metric
Conv Conversion Group ID	Conv Conversion Group ID	The unique identifier for the conversion group.	metric
Conv Segment ID	Conv Segment ID	The unique identifier for the conversion segment.	metric
Conv. Click Through	Conv. Click Through	The number of conversions attributed to clicks.	metric
Conv. View Through	Conv. View Through	The number of conversions attributed to view-throughs (impressions without clicks).	metric
Conversion Group	Conversion Group	The name of the conversion group.	dimension
Conversion Segment	Conversion Segment	The name of the conversion segment.	dimension
Conversion Type	Conversion Type	The type of conversion (e.g., purchase, signup).	dimension
Conversion Type ID	Conversion Type ID	The unique identifier for the conversion type.	metric
Conversions	Conversions	The total number of conversions recorded.	metric
Country	Country	The country where the advertisement was shown.	dimension
Country Code	Country Code	The two-letter ISO country code where the advertisement was shown.	dimension
Creative	Creative	The name or identifier of the advertisement creative.	dimension
Creative Group	Creative Group	The name or identifier of the creative group.	dimension
Creative Group ID	Creative Group ID	The unique identifier for the creative group.	dimension
Creative ID	Creative ID	The unique identifier for the advertisement creative.	metric
Creative Size	Creative Size	The dimensions (width x height) of the advertisement creative.	dimension
DMA	DMA	The Designated Market Area (DMA) where the advertisement was shown.	dimension
DMA Code	DMA Code	The unique code for the Designated Market Area (DMA).	metric
Data Fees	Data Fees	Fees associated with using data for targeting or reporting.	metric
Day	Day	The specific day the data was recorded.	dimension
Deal	Deal	The name or identifier of the private deal for ad inventory.	dimension
Deal ID	Deal ID	The unique identifier for the private deal.	dimension
Device	Device	The specific device model where the advertisement was displayed.	dimension
Device Chipset	Device Chipset	The chipset of the device where the advertisement was shown.	dimension
Device ID	Device ID	The unique identifier for the device.	metric
Device Type	Device Type	The general category of the device where the advertisement was displayed (e.g., mobile, tablet, smart TV).	dimension
Device Type ID	Device Type ID	The unique identifier for the device type.	metric
Errors	Errors	The number of errors encountered during ad serving or playback.	metric
Exchange	Exchange	The name of the ad exchange where the inventory was bought or sold.	dimension
Exchange ID	Exchange ID	The unique identifier for the ad exchange.	metric
Exchange Seller	Exchange Seller	The name of the seller on the ad exchange.	dimension
Exchange Seller Site	Exchange Seller Site	The website or application of the seller on the ad exchange.	dimension
Exchange Seller Site ID	Exchange Seller Site ID	The unique identifier for the seller’s site on the ad exchange.	dimension
Exchange name	Exchange name	The name of the ad exchange where the inventory was bought or sold. This field is a duplicate of ‘Exchange’ but provided with a different display name.	dimension
Flight	Flight	The name or identifier of the ad flight, a period during which specific ads run.	dimension
Flight ID	Flight ID	The unique identifier for the ad flight.	metric
Format	Format	The format of the advertisement (e.g., video, display, native).	dimension
Fullscreen Views	Fullscreen Views	The number of times an ad was viewed in fullscreen mode.	metric
Hour	Hour	The specific hour of the day when the data was recorded.	dimension
Hour Of Day	Hour Of Day	The specific hour of the day when the data was recorded (0-23).	metric
IAB Name	IAB Name	The Interactive Advertising Bureau (IAB) content category name for the inventory.	dimension
Iab Category	Iab Category	The Interactive Advertising Bureau (IAB) content category for the inventory, representing the type of content shown with the ad.	dimension
Impressions	Impressions	The total number of times an advertisement was displayed.	metric
Insertion Order	Insertion Order	The name or identifier of the insertion order.	dimension
Insertion Order ID	Insertion Order ID	The unique identifier for the insertion order.	dimension
Inventory Country Name	Inventory Country Name	The name of the country where the ad inventory is located. The source lists ‘Inventory Country’ as dimension, which is the same concept.	dimension
Inventory ID	Inventory ID	The unique identifier for the ad inventory.	dimension
Inventory Type	Inventory Type	The type of ad inventory (e.g., app, web). The source lists ‘Inventory Type Name’ as dimension, which is the same concept.	dimension
Language ID	Language ID	The unique identifier for the language.	metric
Line Item	Line Item	The name or identifier of the line item within an insertion order.	dimension
Line Item ID	Line Item ID	The unique identifier for the line item.	dimension
Media Spend	Media Spend	The total amount spent on media for advertising.	metric
OS Version	OS Version	The version of the operating system on the device where the ad was shown.	dimension
Operating System Variant ID	Operating System Variant ID	The unique identifier for a specific variant of an operating system.	metric
Position	Position	The position of the ad on the page or screen.	dimension
Position ID	Position ID	The unique identifier for the ad position.	metric
Postal Code	Postal Code	The postal code of the location where the advertisement was shown.	metric
Product	Product	The product associated with the advertisement or campaign.	dimension
Region	Region	The geographical region where the advertisement was shown.	dimension
Region code	Region code	The code for the geographical region where the advertisement was shown.	dimension
Revenue	Revenue	The total revenue generated from advertising.	metric
Revenue CTR	Revenue CTR	The Click-Through Rate (CTR) calculated based on revenue.	metric
Revenue VTR	Revenue VTR	The View-Through Rate (VTR) calculated based on revenue.	metric
Samsung App Name	Samsung App Name	The name of the Samsung application where ads are displayed or for which performance data is being reported. This can be identified by the content_name from the Galaxy Store Statistics API, which also uses a unique 12-digit content ID.	dimension
Skipped	Skipped	The number of times a skippable video ad was skipped by the user.	metric
Started	Started	The number of times a video ad play was initiated.	metric
Streaming Channel Name	Streaming Channel Name	The name of the streaming channel or platform where the advertising content was displayed. This dimension helps to analyze ad performance across different streaming environments.	dimension
Trackable Impressions	Trackable Impressions	The number of impressions that were trackable and eligible for measurement.	metric
Trader Fees	Trader Fees	Fees charged by the trader for ad transactions.	metric
Unique Users Approx.	Unique Users Approx.	The approximate number of unique users who saw or interacted with the ad.	metric
Url Domain	Url Domain	The domain of the URL where the advertisement was displayed.	dimension
Video Clicks	Video Clicks	The number of clicks on a video advertisement.	metric
Video Replay	Video Replay	The number of times a video ad was replayed.	metric
View-through Rate	View-through Rate	The percentage of impressions that led to a conversion without a direct click.	metric
Viewable Impressions	Viewable Impressions	The number of impressions that were deemed viewable according to industry standards.	metric