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 |
|---|---|---|---|
Advertiser |
Advertiser |
The name of the advertiser associated with the campaign. |
dimension |
Advertiser ID |
Advertiser ID |
A unique identifier for the advertiser. |
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 ID |
Campaign ID |
A unique identifier for the advertising campaign. |
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 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 |
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 |
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 |
Line Item ID |
Line Item ID |
The unique identifier for an advertising line item. |
dimension |
Postal Code |
Postal Code |
A geographical code used for more granular targeting and reporting. |
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 |