Stackadapt: Most-used fields

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

Advertiser

Advertiser

The name of the advertiser.

dimension

Campaign

Campaign

The name of the advertising campaign.

dimension

Campaign ID

Campaign ID

A unique identifier for the advertising campaign.

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, such as width and height. This field refers to either image or video creative sizes.

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

audience

audience

The targeted group of individuals for an advertising campaign.

dimension

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

channel_name

channel_name

The name of the advertising channel used for the campaign.

dimension

click

click

The number of clicks on the ad.

metric

click_url

click_url

The URL where users are directed after clicking the ad.

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 cost incurred per conversion.

metric

conv_imp

conv_imp

The number of conversions attributed to impressions.

metric

conv_rev

conv_rev

The revenue generated from conversions.

dimension

conversion_tracker_id

conversion_tracker_id

A unique identifier for the conversion tracker.

dimension

conversion_tracker_name

conversion_tracker_name

The name of the conversion tracker configured in StackAdapt.

dimension

cost

cost

The total cost incurred for the ad campaign.

metric

country

country

The country where the ad was displayed or the user is located.

dimension

cpm_cost

cpm_cost

The cost incurred per one thousand ad impressions (CPM).

metric

creative_name

creative_name

The name of the ad creative.

dimension

creative_size

creative_size

The dimensions of the creative asset, such as width and height.

dimension

creatives

creatives

The advertising assets such as images, videos, or text used in a campaign.

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 data, indicating where it was collected from (e.g., StackAdapt API).

dimension

date

date

The date for which the data is reported, corresponding to the start time of the granularity.

dimension

demographics_segment

demographics_segment

The demographic segment targeted by the campaign.

dimension

devicetype

devicetype

The type of device on which the ad was displayed (e.g., mobile, desktop, tablet).

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 heading text used in the ad creative.

dimension

image_url

image_url

The URL of the image creative used in the ad.

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 general category of the advertising channel, such as social, email, or display.

dimension

native_ad_id

native_ad_id

The unique identifier for a native ad.

dimension

native_ad_type

native_ad_type

The specific type or format of the native ad creative.

dimension

nativead

nativead

Represents the native ad model.

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_15s

page_time_15s

Time spent on a page, specifically measured for durations of 15 seconds or more.

metric

page_view

page_view

The number of times a page was viewed.

metric

region

region

The geographical region (e.g., state, province) where the ad was displayed or the user is located.

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 traffic or data, such as a search engine or specific website.

dimension

start_date

start_date

The start date of the reporting period.

dimension

tagline

tagline

The tagline text used in the ad creative.

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

total_conversions

total_conversions

The total number of conversions recorded.

metric

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