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 company responsible for the ad delivery and tracking.	dimension
Advertiser	Advertiser	The name of the advertiser associated with the campaign.	dimension
Advertiser ID	Advertiser ID	A unique identifier for the advertiser.	dimension
App Bundle	App Bundle	The identifier for a mobile or Smart TV application package where an ad was served.	dimension
App Bundle ID	App Bundle ID	A unique identifier assigned to the application bundle where an ad was served.	dimension
Browser	Browser	The web browser used by the viewer when an advertisement was displayed.	dimension
Browser Language	Browser Language	The language setting configured in the viewer’s web browser.	dimension
Browser Version	Browser Version	The specific version number of the web browser used by the viewer.	dimension
Buyer	Buyer	The advertiser or buying entity responsible for purchasing the ad inventory.	dimension
Buyer Spend	Buyer Spend	The total cost incurred by the buyer for advertising campaigns.	metric
CTR	CTR	The Click-Through Rate, calculated as Clicks divided by Impressions.	metric
Campaign	Campaign	The name of the advertising campaign.	dimension
Campaign Group	Campaign Group	A user-defined grouping of advertising campaigns for organizational purposes.	dimension
Campaign Group ID	Campaign Group ID	A unique identifier for a specific campaign group.	dimension
Campaign ID	Campaign ID	A unique identifier for the advertising campaign.	dimension
Channel Type	Channel Type	The type of media channel through which the advertisement was delivered, such as Mobile, Desktop, or Connected TV.	dimension
Clicks	Clicks	The total number of times an ad was clicked.	metric
Completed	Completed	A metric indicating whether a specific event, such as a video ad playback, was fully completed.	metric
Conv Conversion Group ID	Conv Conversion Group ID	The unique identifier for the conversion group, which defines how Samsung DSP interprets data from a segment to track user actions after ad engagement.	metric
Conv Segment ID	Conv Segment ID	The unique identifier for the conversion segment, used to track specific customer actions within a conversion group.	metric
Conv. Click Through	Conv. Click Through	The number of conversions attributed to user clicks on an ad.	metric
Conv. View Through	Conv. View Through	The number of conversions attributed to users viewing an ad without clicking.	metric
Conversion Group	Conversion Group	A user-defined grouping of conversion events, allowing for a consolidated view of campaign effectiveness across various online efforts.	dimension
Conversion Segment	Conversion Segment	A segment defining a group of users or a category of actions that resulted in a conversion, as reported by Samsung Ad Manager.	dimension
Conversion Type	Conversion Type	The specific type of conversion action recorded.	dimension
Conversion Type ID	Conversion Type ID	The unique identifier for a specific conversion type.	metric
Conversions	Conversions	The total number of desired actions taken by users after interacting with an ad.	metric
Creative	Creative	The specific advertisement asset or ad unit displayed.	dimension
Creative Group	Creative Group	A user-defined grouping of ad creatives within a campaign.	dimension
Creative Group ID	Creative Group ID	A unique identifier for a specific creative group.	dimension
Creative ID	Creative ID	A unique identifier for the ad creative.	dimension
DMA	DMA	Designated Market Area, a geographic region used for TV and radio advertising.	dimension
DMA Code	DMA Code	The unique numeric code identifying a Designated Market Area.	dimension
Day	Day	The specific calendar day for which the data is reported.	dimension
Device	Device	The specific device model (e.g., Samsung Smart TV, Galaxy S23) on which an ad was displayed.	dimension
Device Chipset	Device Chipset	Represents the type of processor or chipset used in the Samsung device where ads were displayed, offering insights into performance across various hardware configurations. While not directly available, this field is conceptually related to the ‘device_type_name’ dimension available in the ‘Trader Delivery All’ report.	dimension
Device Type	Device Type	The general category of device an ad was served on (e.g., Smart TV, Mobile, Tablet, Desktop).	dimension
Exchange	Exchange	The ad exchange platform from which the ad inventory was procured.	dimension
Exchange Seller	Exchange Seller	The publisher or entity selling ad inventory through the identified exchange.	dimension
Exchange Seller Site	Exchange Seller Site	The specific website or application property of the exchange seller where the ad was displayed.	dimension
Exchange Seller Site ID	Exchange Seller Site ID	A unique identifier for the specific site or app property of the exchange seller.	dimension
Flight	Flight	A specific period during which an advertising campaign or part of a campaign runs.	dimension
Flight ID	Flight ID	The unique identifier for an advertising flight.	dimension
Format	Format	The type or format of the advertisement (e.g., banner, interstitial, video).	dimension
IAB Name	IAB Name	The name of the Interactive Advertising Bureau (IAB) content category associated with the ad or inventory.	dimension
Iab Category	Iab Category	The specific Interactive Advertising Bureau (IAB) content category ID.	dimension
Impressions	Impressions	The total number of times an ad was displayed.	metric
Insertion Order ID	Insertion Order ID	The unique identifier for an Insertion Order, a document that authorizes an ad campaign.	dimension
Inventory ID	Inventory ID	A unique identifier for the specific ad inventory unit where an ad was served.	dimension
Inventory Type	Inventory Type	The classification of the ad inventory (e.g., in-app, web display, video).	dimension
Line Item	Line Item	A specific targeting and budgeting configuration within an advertising campaign.	dimension
Line Item ID	Line Item ID	The unique identifier for an advertising line item.	dimension
OS Version	OS Version	The version of the operating system running on the device where the ad was shown.	dimension
Operating System Variant ID	Operating System Variant ID		metric
Postal Code	Postal Code	A geographical code used for more granular targeting and reporting.	dimension
Product	Product	Refers to the specific Samsung device model (e.g., Smart TV model, smartphone model) or product line on which the advertisement was displayed. This helps in analyzing ad performance across different Samsung products. This is related to the ‘device_type_name’ dimension found in the ‘Trader Delivery All’ report, providing a more granular understanding of the device context.	dimension
Revenue	Revenue	The total revenue generated from advertising activities.	metric
Revenue CTR	Revenue CTR	The Click-Through Rate (CTR) that generates revenue.	metric
Revenue VTR	Revenue VTR	The View-Through Rate (VTR) that generates revenue.	metric
Started	Started	The date and time when an advertising event (e.g., impression, click) or a reporting period began.	metric
Streaming Channel Name	Streaming Channel Name	The specific channel on which streaming video advertisements were delivered or displayed.	dimension
Url Domain	Url Domain	The domain name of the URL where the advertisement was displayed.	dimension