Adalyser: Most-used fields

The table below gives information about most-used fields that you can import from Adalyser. 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
Day	Day	The specific day when the TV spot aired or when a metric was recorded.	dimension
account_id	account_id	A unique identifier for the advertiser account within Adalyser. This is used to retrieve data specific to an account.	dimension
account_name	account_name	The human-readable name of the advertiser account.	dimension
adGroup	adGroup	A collection of advertisements that are grouped together within a larger campaign, sharing common targeting criteria.	dimension
apptCount	apptCount	The total number of appointments or sign-ups attributed to the TV advertising campaign.	metric
apptResponseRate	apptResponseRate	The rate at which viewers respond to TV ads by taking an action, such as signing up or making an appointment. This is derived from attributed responses to the campaign.	metric
avgSalesValue	avgSalesValue	The average monetary value generated per sale. This metric is crucial for understanding the financial return from sales activities.	metric
channel	channel	The broadcast channel where the TV spot aired.	dimension
clientCost	clientCost	The client’s net cost for the TV spot.	dimension
cpa	cpa	Cost Per Acquisition, a metric representing the cost incurred for each customer acquisition or conversion generated by the TV campaign.	metric
cpl	cpl	The cost per lead, calculated as total spend divided by the number of leads generated.	metric
cplSources.desktop	cplSources.desktop	The cost per lead (CPL) for leads attributed to desktop sources.	metric
cplSources.mobile	cplSources.mobile	The cost per lead (CPL) for leads attributed to mobile sources.	metric
cps	cps	The cost per sale, calculated as total spend divided by the number of sales attributed.	metric
cpt	cpt	Cost Per Thousand (mille), a standard advertising metric representing the cost to reach one thousand viewers or impressions. It is used in pricing TV ad schedules.	metric
creative	creative	A unique identifier or name for the creative (advertisement asset) that aired.	dimension
date	date	The date the TV spot was aired or when the associated metric was recorded.	dimension
day	day	The specific day of the week or month when the TV spot aired.	dimension
dayPart	dayPart	The time segment of the day during which a TV spot aired (e.g., ‘morning’, ‘primetime’).	dimension
equivalentImpacts	equivalentImpacts	A metric representing the overall measurable effects or impressions generated by the TV campaign, potentially including incremental visits or conversions.	metric
equivalentTvrs	equivalentTvrs	A standardized measure used to compare the audience reach and impact of TV advertising spots, often reflecting an equivalent Television Rating (TVR) across different platforms or campaigns.	metric
genre	genre	The category or type of television program during which an ad spot was broadcast.	dimension
grossCost	grossCost	The total monetary cost incurred for an advertising campaign or specific ad spots before any deductions or adjustments.	dimension
impacts	impacts	The total number of advertising impressions or views collected by Adalyser’s tracking solutions, often referring to digital impressions resulting from TV ads.	metric
ipa	ipa		metric
ipl	ipl	The cost per attributed impression or view.	metric
iplSources.desktop	iplSources.desktop	The cost per impression (IPL) for impressions attributed to desktop sources.	metric
iplSources.mobile	iplSources.mobile	The cost per impression (IPL) for impressions attributed to mobile sources.	metric
ips	ips	The cost per attributed install or app activity.	metric
leadActions.New	leadActions.New	The number of new leads generated attributed to a TV spot.	metric
leadActions.Returning	leadActions.Returning	The number of returning leads generated attributed to a TV spot.	metric
leadBaseline	leadBaseline	The expected number of leads in the absence of advertising, used for measuring incremental impact.	metric
leadCount	leadCount	The number of leads generated and attributed to a TV spot.	metric
leadOrigins.Direct	leadOrigins.Direct	The number of leads resulting from a direct response to a TV advertisement.	metric
leadOrigins.Organic	leadOrigins.Organic	The number of leads generated through organic (unpaid) search or direct website visits, attributed to the TV campaign.	metric
leadOrigins.Paid Search	leadOrigins.Paid Search	The number of leads generated through paid search efforts, attributed to the TV campaign.	metric
leadResponseRate	leadResponseRate	The rate at which viewers respond to TV ads by becoming leads, often measured within specific time windows post-broadcast.	metric
leadSaleConvRate	leadSaleConvRate	The conversion rate from leads to sales, indicating the effectiveness of lead nurturing.	metric
leadSources.desktop	leadSources.desktop	The number of leads generated from desktop sources.	metric
leadSources.mobile	leadSources.mobile	The number of leads generated from mobile sources.	metric
leadUplift	leadUplift	The incremental increase in leads attributed to a TV campaign beyond the expected baseline.	metric
length	length	The duration of the creative (advertisement) in seconds.	metric
linkKey	linkKey	A unique identifier used to establish connections between different data points or entities within the platform, often for attribution.	dimension
market	market	The geographical region or target market where the TV spot aired.	dimension
name	name	The human-readable name of a campaign or creative.	dimension
platform	platform	The advertising platform or channel where an ad campaign was run, such as Linear TV, BVOD (Broadcaster Video On Demand), or Connected TV.	dimension
position	position	The break position of the TV spot within a programme.	dimension
product	product	The specific product or service associated with an advertising campaign, lead, or sale.	dimension
programme	programme	The name of the TV programme during which the spot aired.	dimension
roi	roi	Return On Investment, a key performance indicator that measures the profitability of an advertising campaign or marketing effort relative to its cost.	metric
saleCount	saleCount	The number of actual sales attributed to a TV spot.	metric
saleResponseRate	saleResponseRate	The rate at which viewers respond to TV ads by making a purchase, often measured within specific time windows post-broadcast.	metric
salesHouse	salesHouse	The TV sales house responsible for the airtime of the spot.	dimension
salesValue	salesValue	The monetary value generated from attributed sales.	metric
status	status	The current state or condition of a campaign component, lead, or sale within the system.	dimension
timezone	timezone	The geographical timezone relevant to the broadcast or response data.	dimension
tvrs	tvrs	Television Viewer Rating Shares, a key metric in TV advertising representing the percentage of the total TV viewing audience watching a particular program or spot at a given time. Adalyser integrates with BARB for audience data.	metric
type	type	The classification of the TV spot (e.g., ‘National’, ‘Regional’, ‘Sponsorship’).	dimension
weekStart	weekStart	The start date of the week to which the data pertains, used for weekly aggregations.	dimension