Stackadapt: Most-used fields

The table below gives information about most-used fields that you can import from Stackadapt. 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
Campaign	Campaign	The name of the advertising campaign.	dimension
Campaign ID	Campaign ID	A unique identifier for the advertising campaign.	dimension
acomp_0	acomp_0	The number of audio plays that have started.	metric
acomp_25	acomp_25	The number of audio plays that completed at least 25% of the audio.	metric
acomp_50	acomp_50	The number of audio plays that completed at least 50% of the audio.	metric
acomp_75	acomp_75	The number of audio plays that completed at least 75% of the audio.	metric
ad_size	ad_size	The dimensions of the ad creative, typically expressed as width x height (e.g., 300x250 pixels). This helps categorize and analyze ad performance based on its visual presentation.	dimension
advertiser_id	advertiser_id	A unique identifier for the advertiser.	dimension
advertiser_name	advertiser_name	The name of the advertiser.	dimension
atos	atos	The average time users spent on the landing page or site after clicking an ad.	metric
campaign	campaign	The name of the advertising campaign.	dimension
campaign_id	campaign_id	A unique identifier for the advertising campaign.	dimension
campaign_name	campaign_name	The name of the advertising campaign.	dimension
campaign_type	campaign_type	The type or category of the advertising campaign.	dimension
channel	channel	The advertising channel used for the campaign.	dimension
click	click	The number of clicks on the ad.	metric
click_url	click_url	The URL used in the ad creative to direct users to a specific website or landing page.	dimension
conv	conv	The total number of conversions.	metric
conv_click	conv_click	The number of conversions attributed to clicks.	metric
conv_cost	conv_cost	The total cost incurred that is attributed to conversions.	metric
conv_imp	conv_imp	The number of impressions that led to a conversion.	metric
conv_rev	conv_rev	The revenue generated from conversions.	metric
conversion_tracker_id	conversion_tracker_id	A unique identifier for a conversion tracker used to measure specific user actions.	dimension
conversion_tracker_name	conversion_tracker_name	The name associated with the conversion tracker.	dimension
cost	cost	The total cost incurred for the ad campaign.	metric
country	country	The country where the ad impression or conversion occurred.	dimension
cpm_cost	cpm_cost	The effective cost per thousand advertising impressions.	metric
creatives	creatives	Refers to the specific ad units, such as images, videos, or text variations, used in a campaign. Data related to creatives might include their ID, name, or type, enabling performance analysis at the individual ad level.	dimension
ctr	ctr	The Click-Through Rate, calculated as clicks divided by impressions.	metric
cvr	cvr	Cost Value Reconciliations (CVR) are carried out in order to monitor and measure expenditures against budgets on construction projects.	metric
data_source	data_source	The origin of the collected data, which in this case is the Stackadapt API.	dimension
date	date	The date for which the data is reported, corresponding to the start time of the granularity.	dimension
devicetype	devicetype	The type of device on which the ad was displayed, such as mobile, desktop, or tablet. This is often used for audience segmentation and performance analysis.	dimension
ecpa	ecpa	eCPA is effective cost per action.	metric
ecpc	ecpc	eCPC is effective cost per click.	metric
ecpe	ecpe	eCPE is effective cost per engagement.	metric
ecpm	ecpm	eCPM is effective cost per thousand advertising impressions.	metric
ecpv	ecpv	eCPV is effective cost per view.	metric
end_date	end_date	The end date of the reporting period.	dimension
engage_rate	engage_rate	The rate at which users engage with the ad or content.	metric
heading	heading	The main title or headline text used within the ad creative.	dimension
image_url	image_url	The URL pointing to the image asset used in the ad creative. This is analogous to the ‘Creative URL’ in the API documentation, which drives users to a specific image.	dimension
imp	imp	The number of impressions, representing how many times an ad was displayed.	metric
line_item	line_item	A specific component or item within an advertising campaign.	dimension
line_item_id	line_item_id	The identifier of the line item.	dimension
line_item_name	line_item_name	The name of the line item.	dimension
medium	medium	The advertising channel through which the campaign is delivered. Examples include native, display, video, connected TV, audio, in-game, and digital out-of-home. This helps categorize campaign reach by channel.	dimension
native_ad_id	native_ad_id	A unique identifier for the specific native ad creative.	dimension
native_ad_type	native_ad_type	The classification or format of the native ad, indicating its specific type within native advertising campaigns.	dimension
nativead	nativead	The name of the ad creative used in a native advertising campaign.	dimension
page_start	page_start	The number of times a user has spent at least 2 seconds on the site after clicking the ad.	metric
page_time	page_time	Time spent on one page.	metric
page_time_120s	page_time_120s	The number of times a user has spent at least 120 seconds on a page after clicking an ad.	metric
page_time_15s	page_time_15s	Time spent on a page, specifically measured for durations of 15 seconds or more.	metric
page_time_300s	page_time_300s	The number of times a user has spent at least 300 seconds on a page after clicking an ad.	metric
page_time_30s	page_time_30s	The number of times a user has spent at least 30 seconds on a page after clicking an ad.	metric
page_time_5s	page_time_5s	The number of times a user has spent at least 5 seconds on a page after clicking an ad.	metric
page_time_60s	page_time_60s	The number of times a user has spent at least 60 seconds on a page after clicking an ad.	metric
page_time_900s	page_time_900s	The number of times a user has spent at least 900 seconds on a page after clicking an ad.	metric
page_view	page_view	Represents the total number of times an ad or content was displayed on a webpage. This is a key performance indicator for gauging content visibility.	metric
region	region	The geographical region within a country where the ad impression or conversion occurred.	dimension
revenue	revenue	The revenue generated from conversions.	metric
roas	roas	Return On Ad Spend, a metric indicating the revenue generated for each dollar spent on advertising.	metric
source	source	The origin of the traffic or impression for an ad, indicating where the user engagement came from. This helps in understanding the effectiveness of different traffic sources for a campaign.	dimension
start_date	start_date	The start date of the reporting period.	dimension
tagline	tagline	The short descriptive text or slogan used in the ad creative, often appearing below the heading.	dimension
time_on_site	time_on_site	The average time users spent on the landing page or site after clicking an ad.	metric
time_segment	time_segment	The time granularity for reporting, can be hourly, daily, or total.	dimension
unique_imp	unique_imp	The number of unique users who saw an ad impression.	metric
user_id	user_id	A unique identifier for a user.	dimension
vcomp_0	vcomp_0	The number of times a video view has started.	metric
vcomp_25	vcomp_25	The number of video plays that completed at least 25% of the video.	metric
vcomp_50	vcomp_50	The number of video plays that completed at least 50% of the video.	metric
vcomp_75	vcomp_75	The number of video plays that completed at least 75% of the video.	metric
vcomp_95	vcomp_95	The number of times a video has been watched to at least 95% completion.	metric
vcomp_rate	vcomp_rate	The rate of video completion.	metric