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. This is relevant for reports of type trader_delivery_3p.	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 unique identifier or name of the application bundle where an ad impression occurred. This helps in identifying the specific app on a device.	dimension
App Bundle ID	App Bundle ID	The unique identifier for an application bundle. This is often a numeric or alphanumeric code used to identify the app programmatically.	dimension
Browser	Browser	The web browser used by the user when the ad event occurred, such as Chrome, Firefox, or Safari.	dimension
Browser Language	Browser Language		dimension
Browser Version	Browser Version		dimension
Buyer	Buyer	The entity or advertiser who is 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 higher-level organizational unit that groups multiple individual campaigns together.	dimension
Campaign Group ID	Campaign Group ID	The unique identifier for a campaign group.	dimension
Campaign ID	Campaign ID	A unique identifier for the advertising campaign.	dimension
Channel Type	Channel Type	The type of channel through which the advertisement was delivered, e.g., streaming, linear TV, display.	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 specific segment or subset within a defined conversion group, used for more granular analysis of user actions.	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 collection of related ad creatives used in a campaign, often grouped for reporting and optimization purposes.	dimension
Creative Group ID	Creative Group ID	A unique identifier assigned to a 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 type of device on which the ad was served, such as a smart TV, mobile phone, or tablet.	dimension
Device Chipset	Device Chipset		dimension
Device Type	Device Type	The category of device used, such as “Smart TV”, “Mobile”, or “Desktop”.	dimension
Exchange	Exchange	The ad exchange where the impression occurred.	dimension
Exchange Seller	Exchange Seller	The entity or publisher selling ad inventory on an ad exchange.	dimension
Exchange Seller Site	Exchange Seller Site	The publisher’s website or application within an ad exchange where the ad impression occurred.	dimension
Exchange Seller Site ID	Exchange Seller Site ID	A unique identifier for the exchange seller site.	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 creative format of the ad, such as video, display banner, or native.	dimension
IAB Name	IAB Name	The name of the Interactive Advertising Bureau (IAB) content category.	dimension
Iab Category	Iab Category	The content category of the ad placement as defined by the Interactive Advertising Bureau (IAB) taxonomy.	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 (ad space) where the advertisement was displayed.	dimension
Inventory Type	Inventory Type	The classification of the ad inventory, such as premium inventory, standard inventory, or direct-sold inventory.	dimension
Line Item	Line Item	A specific entry within an advertising campaign, detailing ad placements, targeting, and budget.	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 displayed (e.g., Android 12, iOS 15).	dimension
Operating System Variant ID	Operating System Variant ID	A specific identifier for a variant or sub-version of an operating system.	metric
Postal Code	Postal Code	A geographical code used for more granular targeting and reporting.	dimension
Product	Product	Refers to the product or service being advertised by the buyer.	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 timestamp indicating when an ad-related event, such as an impression or video playback, began.	metric
Streaming Channel Name	Streaming Channel Name	Represents the name of the streaming channel where ads are displayed. This is particularly relevant for smart TV environments where Samsung Ads operates.	dimension
Url Domain	Url Domain	The domain of the URL where the advertisement was displayed.	dimension