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	An identifier for a specific ad group within a larger advertising campaign. This helps organize and track the performance of different ad sets.	dimension
apptActions.Brochure Requests	apptActions.Brochure Requests	The number of brochure requests attributed as appointments or sign-ups.	metric
apptActions.Click To Call	apptActions.Click To Call	The number of ‘click-to-call’ actions attributed as appointments or sign-ups.	metric
apptCount	apptCount	The number of successful appointments or sign-ups attributed to a TV spot.	metric
apptOrigins.Direct	apptOrigins.Direct	The number of appointments or sign-ups resulting from a direct response to a TV advertisement.	metric
apptOrigins.Organic	apptOrigins.Organic	The number of appointments or sign-ups generated through organic (unpaid) search or direct website visits, attributed to the TV campaign.	metric
apptOrigins.Paid Search	apptOrigins.Paid Search	The number of appointments or sign-ups generated through paid search efforts, attributed to the TV campaign.	metric
apptResponseRate	apptResponseRate	The rate at which viewers respond to TV ads by making an appointment or signing up, often measured within specific time windows post-broadcast.	metric
apptSources.desktop	apptSources.desktop	The number of appointments or sign-ups generated from desktop sources.	metric
apptSources.mobile	apptSources.mobile	The number of appointments or sign-ups generated from mobile sources.	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.	metric
cpa	cpa	The cost per appointment or sign-up, calculated as total spend divided by the number of appointments.	metric
cpaSources.desktop	cpaSources.desktop	The cost per appointment (CPA) for appointments attributed to desktop sources.	metric
cpaSources.mobile	cpaSources.mobile	The cost per appointment (CPA) for appointments attributed to mobile sources.	metric
cpl	cpl	The cost per lead, calculated as total spend divided by the number of leads generated.	metric
cplSources.Indirect	cplSources.Indirect	The cost per lead (CPL) for leads attributed to indirect sources.	dimension
cplSources.Unknown	cplSources.Unknown	The Cost Per Lead (CPL) attributed to sources that could not be specifically identified. This metric helps in understanding the cost efficiency of generating leads from various, unclassified marketing efforts.	dimension
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
cpsSources.Indirect	cpsSources.Indirect	The cost per sale (CPS) for sales attributed to indirect sources.	dimension
cpsSources.Unknown	cpsSources.Unknown	The Cost Per Sale (CPS) attributed to sources that could not be specifically identified. This metric provides insight into the cost efficiency of converting leads into sales from unclassified marketing efforts.	dimension
cpsSources.desktop	cpsSources.desktop	The cost per sale (CPS) for sales attributed to desktop sources.	metric
cpsSources.mobile	cpsSources.mobile	The cost per sale (CPS) for sales attributed to mobile sources.	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	An adjusted or normalized figure for advertising impacts (impressions/views), often calculated to account for various factors or to provide a comparable metric across different contexts.	metric
equivalentTvrs	equivalentTvrs	An adjusted or normalized figure for Television Viewer Rating Shares (TVRS), often calculated to provide a comparable metric across different campaigns or timeframes.	metric
genre	genre	The category or genre of the TV programme in which the spot aired (e.g., ‘drama’, ‘comedy’, ‘news’).	dimension
grossCost	grossCost	The total monetary cost incurred for an advertising campaign or specific ad spots before any deductions or adjustments.	metric
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	The cost per attributed install or app activity.	metric
ipaSources.desktop	ipaSources.desktop	The cost per install (IPA) for installs attributed to desktop sources.	metric
ipaSources.mobile	ipaSources.mobile	The cost per install (IPA) for installs attributed to mobile sources.	metric
ipl	ipl	The cost per attributed impression or view.	metric
iplSources.Indirect	iplSources.Indirect	The cost per impression (IPL) for impressions attributed to indirect sources.	dimension
iplSources.Unknown	iplSources.Unknown	The number of advertising impacts (impressions or views) associated with generating a lead, where the specific source of these impacts is not identified. This helps understand the exposure required per lead from unclassified sources.	dimension
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
ipsSources.Annual	ipsSources.Annual	Impact Per Sale attributed to annual sources. This categorizes the advertising exposure leading to sales based on an annual recurring or identified source.	dimension
ipsSources.Brand PPC	ipsSources.Brand PPC	The cost per install (IPS) for installs attributed to Brand Pay-Per-Click (PPC) campaigns.	dimension
ipsSources.Direct	ipsSources.Direct	The cost per install (IPS) for installs directly attributed to advertising efforts.	dimension
ipsSources.Generic PPC	ipsSources.Generic PPC	The cost per install (IPS) for installs attributed to generic Pay-Per-Click (PPC) campaigns.	dimension
ipsSources.Indirect	ipsSources.Indirect	The cost per install (IPS) for installs from indirect sources, where the response is not immediate.	dimension
ipsSources.Monthly	ipsSources.Monthly	Impact Per Sale attributed to monthly sources. This categorizes the advertising exposure leading to sales based on a monthly recurring or identified source.	dimension
ipsSources.Organic Search	ipsSources.Organic Search	The cost per install (IPS) for installs attributed to organic search results.	dimension
ipsSources.Unidentified PPC	ipsSources.Unidentified PPC	Impact Per Sale attributed to Pay-Per-Click (PPC) sources that could not be specifically identified. This helps attribute exposure leading to sales from unclassified PPC efforts.	dimension
ipsSources.Unknown	ipsSources.Unknown	The number of advertising impacts (impressions or views) associated with generating a sale, where the specific source of these impacts is not identified. This helps understand the exposure required per sale from unclassified sources.	dimension
ipsSources.desktop	ipsSources.desktop	The cost per install (IPS) for installs attributed to desktop sources.	metric
ipsSources.mobile	ipsSources.mobile	The cost per install (IPS) for installs attributed to mobile sources.	metric
leadActions.Call	leadActions.Call	The number of leads generated through call actions attributed to a TV spot.	dimension
leadActions.Indirect	leadActions.Indirect	The number of leads generated through indirect actions attributed to a TV spot.	dimension
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
leadActions.Unknown	leadActions.Unknown	A categorization for actions taken by leads that could not be specifically identified or classified. This field groups various lead activities when a precise action type is unknown.	metric
leadAttribute4	leadAttribute4	A custom attribute field used to classify leads based on specific criteria relevant to the user’s business. This provides flexibility in categorizing different types of leads.	dimension
leadAttribute4.Call	leadAttribute4.Call	A specific value for leadAttribute4, indicating that the lead originated from a phone call. This categorizes leads based on a ‘Call’ interaction.	dimension
leadAttribute4.Indirect	leadAttribute4.Indirect	A specific value for leadAttribute4 indicating that the lead was generated indirectly, meaning it was not a direct, immediate response to a specific ad interaction.	dimension
leadAttribute5	leadAttribute5	Another custom attribute field used to further classify leads based on additional specific criteria relevant to the user’s business.	dimension
leadAttribute5.Indirect	leadAttribute5.Indirect	A specific value for leadAttribute5 indicating that the lead was generated indirectly, meaning it was not a direct, immediate response to a specific ad interaction.	dimension
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.Indirect	leadOrigins.Indirect	The number of leads whose origin is indirect, meaning the response occurred later than the immediate viewing of the ad.	dimension
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
leadOrigins.Unknown	leadOrigins.Unknown	The origin of a lead, when the specific channel or method through which the lead was acquired cannot be explicitly identified or categorized.	dimension
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.Indirect	leadSources.Indirect	The number of leads generated from indirect sources.	dimension
leadSources.Unknown	leadSources.Unknown	The source channel or campaign that generated a lead, when it could not be specifically identified. This helps in attributing leads from unclassified sources.	dimension
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		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 that was promoted or sold as part of an advertising campaign. This helps categorize performance by offering.	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
saleActions.Donation	saleActions.Donation	The number of donations attributed as sales actions.	dimension
saleActions.Indirect	saleActions.Indirect	The number of sales resulting from an indirect response to a TV advertisement.	dimension
saleActions.New	saleActions.New	The number of new sales attributed to a TV spot.	dimension
saleActions.One-Off	saleActions.One-Off	The number of one-off sales attributed to a TV spot.	dimension
saleActions.Regular Giver	saleActions.Regular Giver	The number of regular giver (subscription) sales attributed to a TV spot.	dimension
saleActions.Returning	saleActions.Returning	The number of sales from returning customers attributed to a TV spot.	metric
saleActions.Signup	saleActions.Signup	The number of sign-ups attributed as sales actions.	metric
saleAttribute4	saleAttribute4	A custom attribute field used to classify sales based on specific criteria relevant to the user’s business. This provides flexibility in categorizing different types of sales.	dimension
saleAttribute4.Indirect	saleAttribute4.Indirect	A specific value for saleAttribute4 indicating that the sale was indirectly influenced by advertising efforts, rather than being a direct consequence of a specific ad interaction.	dimension
saleAttribute4.One-Off	saleAttribute4.One-Off	A specific value for saleAttribute4, indicating that the sale was a single, non-recurring transaction.	dimension
saleAttribute4.Regular	saleAttribute4.Regular	A specific value for saleAttribute4 indicating that the sale is classified as a regular or standard type of transaction, potentially recurring.	dimension
saleAttribute4.Regular Giver	saleAttribute4.Regular Giver	A specific value for saleAttribute4, indicating that the sale originated from a customer identified as a regular giver or recurring purchaser.	dimension
saleAttribute5	saleAttribute5	Another custom attribute field used to further classify sales based on additional specific criteria relevant to the user’s business.	dimension
saleAttribute5.Indirect	saleAttribute5.Indirect	A specific value for saleAttribute5 indicating that the sale was indirectly influenced by advertising efforts, rather than being a direct consequence of a specific ad interaction.	dimension
saleCount	saleCount	The number of actual sales attributed to a TV spot.	metric
saleOrigins.Direct	saleOrigins.Direct	The number of sales resulting from a direct response to a TV advertisement.	dimension
saleOrigins.Indirect	saleOrigins.Indirect	The number of sales whose origin is indirect, meaning the response occurred later than the immediate viewing of the ad.	dimension
saleOrigins.No	saleOrigins.No	Indicates whether a sale did NOT originate from a specific, tracked marketing source or campaign. Useful for filtering sales that are not directly attributable to defined efforts.	metric
saleOrigins.Organic	saleOrigins.Organic	The number of sales generated through organic (unpaid) search or direct website visits, attributed to the TV campaign.	metric
saleOrigins.Paid Search	saleOrigins.Paid Search	The number of sales generated through paid search efforts, attributed to the TV campaign.	dimension
saleOrigins.Unknown	saleOrigins.Unknown	The origin of a sale, when the specific channel or method through which the sale was acquired cannot be explicitly identified or categorized.	dimension
saleOrigins.Yes	saleOrigins.Yes	Indicates whether a sale DID originate from a specific, tracked marketing source or campaign. Useful for identifying sales directly attributable to defined efforts.	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
saleSources.Indirect	saleSources.Indirect	The number of sales generated from indirect sources.	dimension
saleSources.Unknown	saleSources.Unknown	The source channel or campaign that generated a sale, when it could not be specifically identified. This helps in attributing sales from unclassified sources.	dimension
saleSources.desktop	saleSources.desktop	The number of sales generated from desktop sources.	metric
saleSources.mobile	saleSources.mobile	The number of sales generated from mobile sources.	metric
saleValueActions.Donation	saleValueActions.Donation	The value of donations attributed as sales actions.	dimension
saleValueActions.Indirect	saleValueActions.Indirect	The value of sales resulting from an indirect response to a TV advertisement.	dimension
saleValueActions.New	saleValueActions.New	The value of new sales attributed to a TV spot.	dimension
saleValueActions.One-Off	saleValueActions.One-Off	The value of one-off sales attributed to a TV spot.	dimension
saleValueActions.Regular Giver	saleValueActions.Regular Giver	The value of regular giver (subscription) sales attributed to a TV spot.	dimension
saleValueActions.Returning	saleValueActions.Returning	The value of sales from returning customers attributed to a TV spot.	metric
saleValueActions.Signup	saleValueActions.Signup	The value of sign-ups attributed as sales actions.	metric
saleValueAttribute4	saleValueAttribute4	A custom attribute field used to classify the monetary value of sales based on specific criteria. This allows for detailed analysis of revenue segments.	dimension
saleValueAttribute4.Indirect	saleValueAttribute4.Indirect	A specific value for saleValueAttribute4 indicating that the sale value was indirectly influenced by advertising efforts, rather than being a direct consequence of a specific ad interaction.	dimension
saleValueAttribute4.One-Off	saleValueAttribute4.One-Off	A specific value for saleValueAttribute4, indicating that the sale value is associated with a single, non-recurring transaction.	dimension
saleValueAttribute4.Regular	saleValueAttribute4.Regular	A specific value for saleValueAttribute4 indicating that the sale value is classified as regular or standard, potentially from a recurring transaction.	dimension
saleValueAttribute4.Regular Giver	saleValueAttribute4.Regular Giver	A specific value for saleValueAttribute4, indicating that the sale value is associated with a customer identified as a regular giver or recurring purchaser.	dimension
saleValueAttribute5	saleValueAttribute5	Another custom attribute field used to further classify the monetary value of sales based on additional specific criteria.	dimension
saleValueAttribute5.Indirect	saleValueAttribute5.Indirect	A specific value for saleValueAttribute5 indicating that the sale value was indirectly influenced by advertising efforts, rather than being a direct consequence of a specific ad interaction.	dimension
saleValueOrigins.Direct	saleValueOrigins.Direct	The value of sales resulting from a direct response to a TV advertisement.	dimension
saleValueOrigins.Indirect	saleValueOrigins.Indirect	The value of sales whose origin is indirect, meaning the response occurred later than the immediate viewing of the ad.	dimension
saleValueOrigins.No	saleValueOrigins.No	Indicates whether the value of a sale did NOT originate from a specific, tracked marketing source or campaign. Useful for analyzing sales values not directly attributable.	metric
saleValueOrigins.Organic	saleValueOrigins.Organic	The value of sales generated through organic (unpaid) search or direct website visits, attributed to the TV campaign.	metric
saleValueOrigins.Paid Search	saleValueOrigins.Paid Search	The value of sales generated through paid search efforts, attributed to the TV campaign.	dimension
saleValueOrigins.Unknown	saleValueOrigins.Unknown	The origin of a sale’s monetary value, when the specific channel or method influencing it cannot be explicitly identified or categorized.	dimension
saleValueOrigins.Yes	saleValueOrigins.Yes	Indicates whether the value of a sale DID originate from a specific, tracked marketing source or campaign. Useful for analyzing sales values directly attributable.	metric
saleValueSources.Indirect	saleValueSources.Indirect	The value of sales generated from indirect sources.	dimension
saleValueSources.Unknown	saleValueSources.Unknown	The source channel or campaign that influenced the monetary value of a sale, when it could not be specifically identified. This helps in attributing sale values from unclassified sources.	dimension
saleValueSources.desktop	saleValueSources.desktop	The value of sales generated from desktop sources.	metric
saleValueSources.mobile	saleValueSources.mobile	The value of sales generated from mobile sources.	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 operational status of a campaign, ad spot, lead, or sale. This helps track the lifecycle and active state of various advertising elements.	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