Teads Analytics: Most-used fields

The table below gives information about most-used fields that you can import from Teads Analytics. 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
Click-call-button	Click-call-button	Records when a user clicks on the end-screen ‘Learn More’ (click-to-action) button.	metric
Click-replay	Click-replay	Records when a user clicks on the end-screen ‘Replay’ button.	metric
ClickTracking	ClickTracking	Records when a user clicks within the video frame while a Linear ad is playing.	metric
Close	Close	Records when a user clicks on the close button of an ad.	metric
ad	ad	Aggregates statistics for all insertions related to an ad, including its ID and name.	metric
adAvailable-success	adAvailable-success	Indicates that the SSP (Supply-Side Platform) successfully responded with a compatible ad to be served.	metric
adCall	adCall	Records when an ad is called because the user has scrolled to its designated slot on the page.	metric
adNotAvailable-blockedSite-doubleVerify	adNotAvailable-blockedSite-doubleVerify	Indicates that an ad was not available because DoubleVerify, a 3rd party partner, blacklisted the website.	metric
adNotAvailable-ivt-doubleVerify	adNotAvailable-ivt-doubleVerify	Indicates an ad was not available due to invalid traffic (IVT) as detected by DoubleVerify.	metric
adNotAvailable-ivt-tag	adNotAvailable-ivt-tag	Indicates that an ad was not available because TAG, a 3rd party partner, declared the current session as invalid.	metric
ad_end	ad_end		dimension
ad_is_moat	ad_is_moat	A flag indicating whether Moat measurement is enabled or active for the advertisement.	dimension
ad_is_test	ad_is_test	Indicates whether the test flag is activated or not for the ad.	dimension
ad_start	ad_start		dimension
ad_type	ad_type	The type of the ad, such as managed, monitoring, or agency, as defined in the database.	dimension
adsource	adsource	The parent entity of a connection, typically a DSP, VAST Compliant source, or the marketplace, including its ID and name.	dimension
advertiser	advertiser	The name of the advertiser associated with the campaign.	dimension
advertiser_billable_volume	advertiser_billable_volume	The number of billable events or results delivered for the advertiser.	metric
advertiser_name	advertiser_name	The name of the advertiser.	dimension
agency	agency	The advertising agency associated with the campaign.	dimension
agency_name	agency_name	The name of the agency responsible for an ad or a connection.	dimension
browser	browser	The name of the web browser used by the user.	dimension
callJS	callJS	Records that the JavaScript script has been called by each placement on the webpage or app.	metric
click	click	The total number of clicks on the creative or advertisement.	metric
complete	complete	Indicates that a video advertisement has played to its completion.	metric
connection	connection	A specific ad source configuration used by an entity with an SSP, including its ID and name.	dimension
connection_is_moat	connection_is_moat	Indicates whether Moat is activated at the connection level.	dimension
connection_type	connection_type	The type of connection, which can be either RTB (Real-Time Bidding) or fixed.	dimension
country	country	The name of the country where the user’s activity originated.	dimension
country_code	country_code	The ISO 3166-1 alpha-2 country code of the user’s location (e.g., ‘US’, ‘FR’).	dimension
country_continent	country_continent	The continent of the country where the event occurred.	dimension
creative	creative	The name or identifier of the creative asset used in the advertisement.	dimension
day	day	The specific day the data refers to.	dimension
demand	demand	Displays common attributes of connection and insertion dimensions, including their ID and name.	dimension
demand_category	demand_category	Indicates the format mode of the connection or insertion.	dimension
demand_id	demand_id	Displays the ID of the connection or the insertion.	dimension
demand_name	demand_name	Displays the name of the connection or the insertion.	dimension
demand_source	demand_source	Indicates if a report row pertains to a programmatic or an IO-based (insertion order) campaign.	dimension
demand_start_mode	demand_start_mode	Indicates the start mode of the connection or insertion.	dimension
demand_type	demand_type	Indicates the buying type of the connection or insertion.	dimension
device	device	The type of device on which the ad was displayed (e.g., Desktop, SmartTV, Smartphone, Tablet).	dimension
dsp_response-rate	dsp_response-rate	Represents the ratio of bid responses received from a DSP over the total number of bid requests sent to it.	metric
dsp_response_bid	dsp_response_bid	The number of valid bids received from the DSP.	metric
dsp_response_declined	dsp_response_declined	The number of bids that were declined by the DSP.	metric
dsp_response_error	dsp_response_error	The number of bid responses that resulted in an error, indicating an inability to obtain a bid.	metric
dsp_response_filtered	dsp_response_filtered	The number of bid responses that were filtered due to an invalid bid.	metric
emptyPage	emptyPage	Indicates that the page does not contain any placements.	metric
errorVast	errorVast	This metric is no longer raised by the V3 format and has been replaced by adAvailable-error-vast-code and noAd-vastError-code.	metric
exit-fullscreen	exit-fullscreen	Records when a user de-activates the full-screen mode (device only).	metric
firstQuartile	firstQuartile	Indicates that a video advertisement has reached its first quartile (25%) of playback.	metric
focusOut	focusOut	Records when a user scrolls away before the ad format can fully load on the webpage.	metric
format	format	The commercial name or type of the creative format (e.g., Video, Viewable Display).	dimension
format_creative_type	format_creative_type	The specific creative type within a format (e.g., Carousel, Scroller).	dimension
format_creative_type_family	format_creative_type_family	The family of the creative type (e.g., Video, Viewable Display).	dimension
format_position	format_position	The position where the creative is displayed, such as inRead, inBoard, Smart, or Slider.	dimension
format_size	format_size	The size of the creative format (e.g., landscape, square, vertical, social).	dimension
fullscreen	fullscreen	Records when a user activates the full-screen mode (device only).	metric
hb_provider	hb_provider	The provider of the Header Bidding implementation; ‘null’ or ‘N/A’ indicates that the integration is not Header Bidding.	dimension
hour	hour	The hour of the day when the event occurred.	dimension
impression	impression	The total number of times an advertisement was displayed.	metric
income-aed	income-aed	The income generated in United Arab Emirates Dirham (AED).	metric
income-ars	income-ars	The income generated in Argentine Peso (ARS).	metric
income-aud	income-aud	The income generated in Australian Dollar (AUD).	metric
income-brl	income-brl	The income generated in Brazilian Real (BRL).	metric
income-cad	income-cad	The income generated in Canadian Dollar (CAD).	metric
income-chf	income-chf	The income generated by the publisher through the Teads platform, specifically in Swiss Francs (CHF).	metric
income-clp	income-clp	The income generated in Chilean Peso (CLP).	metric
income-cny	income-cny	The income generated in Chinese Yuan (CNY).	metric
income-cop	income-cop	The income generated in Colombian Peso (COP).	metric
income-czk	income-czk	The income generated in Czech Koruna (CZK).	metric
income-dkk	income-dkk	The income generated in Danish Krone (DKK).	metric
income-eur	income-eur	The income generated in Euro (EUR).	metric
income-gbp	income-gbp	The income generated in British Pound (GBP).	metric
income-hkd	income-hkd	The income generated in Hong Kong Dollar (HKD).	metric
income-huf	income-huf	The income generated in Hungarian Forint (HUF).	metric
income-idr	income-idr	The income generated in Indonesian Rupiah (IDR).	metric
income-inr	income-inr	The income generated in Indian Rupee (INR).	metric
income-jpy	income-jpy	The income generated in Japanese Yen (JPY).	metric
income-krw	income-krw	The income generated in South Korean Won (KRW).	metric
income-mad	income-mad	The income generated in Moroccan Dirham (MAD).	metric
income-mxn	income-mxn	The income generated in Mexican Peso (MXN).	metric
income-myr	income-myr	The income generated in Malaysian Ringgit (MYR).	metric
income-nok	income-nok	The income generated in Norwegian Krone (NOK).	metric
income-nzd	income-nzd	The income generated in New Zealand Dollar (NZD).	metric
income-pen	income-pen	The income generated in Peruvian Sol (PEN).	metric
income-php	income-php	The income generated in Philippine Peso (PHP).	metric
income-pln	income-pln	The income generated in Polish Zloty (PLN).	metric
income-ron	income-ron	The income generated in Romanian Leu (RON).	metric
income-rub	income-rub	The income generated in Russian Ruble (RUB).	metric
income-sar	income-sar	The income generated in Saudi Riyal (SAR).	metric
income-sek	income-sek	The income generated in Swedish Krona (SEK).	metric
income-sgd	income-sgd	The income generated in Singapore Dollar (SGD).	metric
income-thb	income-thb	The income generated in Thai Baht (THB).	metric
income-try	income-try	The income generated in Turkish Lira (TRY).	metric
income-twd	income-twd	The income generated in New Taiwan Dollar (TWD).	metric
income-usd	income-usd	The income generated in United States Dollar (USD).	metric
income-zar	income-zar	The income generated in South African Rand (ZAR).	metric
insertion	insertion	A sub-division of a campaign with specific criteria such as volume, targeting, capping, and format, identified by its ID and name.	dimension
insertion_budget	insertion_budget	The budget allocated for the insertion, expressed as a numerical value without currency.	dimension
insertion_end_date	insertion_end_date	The end date of the insertion.	dimension
insertion_price_advertiser	insertion_price_advertiser	The selling price configured at the insertion level.	dimension
insertion_price_advertiser_event	insertion_price_advertiser_event	The billable event defined for the advertiser for a specific ad insertion.	dimension
insertion_price_publisher	insertion_price_publisher	The buying price configured at the insertion level.	dimension
insertion_price_publisher_cpm	insertion_price_publisher_cpm	If a price is defined for the insertion, this value represents the buying price displayed as a cost per mille (CPM).	dimension
insertion_price_publisher_currency	insertion_price_publisher_currency	If a price is defined for the insertion, this indicates the currency of the buying price (e.g., USD).	dimension
insertion_start_date	insertion_start_date	The start date of the insertion.	dimension
insertion_type	insertion_type	The type of the insertion, which can be direct sold, intragroup, or self-serve.	dimension
insertion_volume_event	insertion_volume_event	If a volume is defined for the insertion, this dimension prints the volume limit event (e.g., ‘start’).	dimension
insertion_volume_value	insertion_volume_value	If a volume is defined for the insertion, this dimension prints the numerical volume limit (e.g., ‘60000’).	dimension
integration-rate	integration-rate	Represents the efficiency of the script in finding an available slot on the publishers’ pages.	metric
midpoint	midpoint	Indicates that a video advertisement has reached its midpoint (50%) of playback.	metric
month	month	The specific month the data refers to.	metric
mute	mute	Records when a user activates the mute control and mutes the creative.	metric
noAd	noAd	A category indicating that an advertisement was not served. This metric accounts for various reasons why an ad impression failed.	metric
noAd-badResponse	noAd-badResponse	Indicates that no ad was displayed because the JSON response from the ad server was not correctly formatted.	metric
noAd-exitPage	noAd-exitPage	Indicates that an advertisement was not served because the user exited the page.	metric
noAd-networkError	noAd-networkError	Indicates that no ad was displayed because the internet connection was lost.	metric
noAd-notFilled	noAd-notFilled	Indicates that an advertisement was not served because the ad slot could not be filled.	metric
noAd-parseTimeout	noAd-parseTimeout	Indicates that the time taken to parse the VAST (Video Ad Serving Template) was too long.	metric
noAd-serverError	noAd-serverError	Indicates that no ad was displayed because the server was not responding.	metric
noAd-settingsError	noAd-settingsError	Indicates that an advertisement was not served due to an error in the ad delivery settings.	metric
noAd-vastError	noAd-vastError	Indicates that no ad was displayed due to an error originating from the VAST (Video Ad Serving Template), with the error code being IAB.	metric
noAdCall	noAdCall	Indicates that an ad was not called because the user had not scrolled to the slot.	metric
noSlot	noSlot	A category indicating that an ad slot was not available for an advertisement. This metric combines various reasons for slot unavailability.	metric
noSlot-BTF	noSlot-BTF	Indicates that an ad slot was not available because it was ‘Below The Fold’ (not initially visible on the screen).	metric
noSlot-DOM	noSlot-DOM	Indicates that an ad slot was not available due to issues related to the Document Object Model (DOM) structure of the page. This dimension is being phased out in favor of noSlot-selector.	metric
noSlot-avoid	noSlot-avoid	Indicates that a match was found for an ‘avoidSlot’ rule defined in the script.	metric
noSlot-content	noSlot-content	Indicates that the format detected either too few characters on the page or the presence of forbidden DOM elements.	metric
noSlot-filter	noSlot-filter	Indicates that a match was found for a filter defined in the script.	metric
noSlot-minSlot	noSlot-minSlot	Indicates that no slot was available below the ‘minSlot’ defined in the script. This metric is being phased out in favor of ‘noSlot-minimum’.	metric
noSlot-minimum	noSlot-minimum	Indicates that no slot was available below the minimum slot requirement defined in the script.	metric
noSlot-minimumBelow	noSlot-minimumBelow	Indicates that no slot was available below the minimum threshold. This is often an aggregate of ‘noSlot-minimum’.	metric
noSlot-position	noSlot-position	Indicates that the format detected issues with the slot’s top position meeting minimum requirements or distorting page layout.	metric
noSlot-selector	noSlot-selector	Indicates that an ad slot was not available due to issues with the CSS selector used to identify the slot on the page. This is the preferred dimension over noSlot-DOM.	metric
noSlot-size	noSlot-size	Indicates that an ad slot was not available because of a size mismatch or an invalid slot size.	metric
operating_system	operating_system	The operating system of the viewer (e.g., Windows, MacOS, Linux, Android).	dimension
page	page	A page integrated on a publisher’s website with a generic tag embedding a page ID, including its ID and name.	dimension
pageAvailable	pageAvailable	Indicates that the page has been set up correctly and contains at least one placement.	metric
pageCall	pageCall	Records that the script has been called by the webpage or app.	metric
passback	passback	This metric is being phased out in favor of ‘passback-noAd’ or ‘passback-integration’.	metric
passback-integration	passback-integration	Relates to the integration of a passback tag, which is used when Teads cannot fill an ad request and passes it back to another ad server.	metric
passback-noAd	passback-noAd	Indicates that a ‘noAd’ event occurred and the publisher had defined a fallback in the placement settings.	metric
pause	pause	Records when a user scrolled to a point where the video is less than 50% visible, causing it to pause.	metric
placement	placement	A specific space on a webpage or app where ad data from campaigns is made accessible, identified by its ID and name.	dimension
placementCall	placementCall	Records that the script has been called by each placement on the webpage or app. This metric replaces ‘callJS’.	metric
placementCapping	placementCapping	Indicates that the placement capping limit has been reached.	metric
progress-x	progress-x	Indicates that the ad has played up to a specific ‘x’ second of the video.	metric
publisher	publisher	Aggregates statistics for all websites or all publishers associated with an ad network, identified by its ID and name.	dimension
publisher-perf-rate	publisher-perf-rate	Represents the efficiency of the integration in providing actual delivery opportunities, calculated as ‘adCall’ divided by ‘placementCall’.	metric
publisher_billable_volume	publisher_billable_volume	The amount of events that require payment to the publisher.	metric
quarter	quarter	Represents the quarter of the year.	metric
resume	resume	Records when a user scrolled to a point where the video is more than 50% visible, causing it to resume playback.	metric
scenario_id	scenario_id	The unique identifier of the scenario, a set of connection configurations for broadcasting.	dimension
scenario_name	scenario_name	The name of the scenario, a set of connection configurations for broadcasting.	dimension
scroll-rate	scroll-rate	Represents the percentage of times a user scrolled down to the ad slot on the page, calculated as ‘adCall’ divided by ‘slot_available’.	metric
slotAvailable	slotAvailable	Indicates that the browser and device are compatible, and an ad slot is available on the webpage.	metric
ssp_auction	ssp_auction	The number of auctions triggered for a placement.	metric
ssp_auctionwon	ssp_auctionwon	The number of auctions won by a DSP.	metric
ssp_bidrequest	ssp_bidrequest	The number of bid requests made to the DSP.	metric
ssp_timeout	ssp_timeout	The number of timeouts on SSP bid requests, indicating that the DSP took too long to respond.	metric
ssp_win-rate	ssp_win-rate	Represents the ratio of auctions won by a DSP over the number of bid requests sent to it.	metric
start	start	Indicates the start of a video advertisement playback.	metric
studio_creative_id	studio_creative_id	A unique identifier for a creative managed within Teads Studio.	dimension
studio_segment	studio_segment	The studio segment as defined in Teads Studio.	dimension
teads_billing-aed	teads_billing-aed	The amount billed by Teads in United Arab Emirates Dirham (AED).	metric
teads_billing-ars	teads_billing-ars	The amount billed by Teads in Argentine Peso (ARS).	metric
teads_billing-aud	teads_billing-aud	The amount billed by Teads in Australian Dollar (AUD).	metric
teads_billing-brl	teads_billing-brl	The amount billed by Teads in Brazilian Real (BRL).	metric
teads_billing-cad	teads_billing-cad	The amount billed by Teads in Canadian Dollar (CAD).	metric
teads_billing-chf	teads_billing-chf	The amount billed by Teads in Swiss Francs (CHF) for advertising services.	metric
teads_billing-clp	teads_billing-clp	The amount billed by Teads in Chilean Peso (CLP).	metric
teads_billing-cny	teads_billing-cny	The amount billed by Teads in Chinese Yuan (CNY).	metric
teads_billing-cop	teads_billing-cop	The amount billed by Teads in Colombian Peso (COP).	metric
teads_billing-czk	teads_billing-czk	The amount billed by Teads in Czech Koruna (CZK).	metric
teads_billing-dkk	teads_billing-dkk	The amount billed by Teads in Danish Krone (DKK).	metric
teads_billing-eur	teads_billing-eur	The amount billed by Teads in Euro (EUR).	metric
teads_billing-gbp	teads_billing-gbp	The amount billed by Teads in British Pound (GBP).	metric
teads_billing-hkd	teads_billing-hkd	The amount billed by Teads in Hong Kong Dollar (HKD).	metric
teads_billing-huf	teads_billing-huf	The amount billed by Teads in Hungarian Forint (HUF).	metric
teads_billing-idr	teads_billing-idr	The amount billed by Teads in Indonesian Rupiah (IDR).	metric
teads_billing-inr	teads_billing-inr	The amount billed by Teads in Indian Rupee (INR).	metric
teads_billing-jpy	teads_billing-jpy	The amount billed by Teads in Japanese Yen (JPY).	metric
teads_billing-krw	teads_billing-krw	The amount billed by Teads in South Korean Won (KRW).	metric
teads_billing-mad	teads_billing-mad	The amount billed by Teads in Moroccan Dirham (MAD).	metric
teads_billing-mxn	teads_billing-mxn	The amount billed by Teads in Mexican Peso (MXN).	metric
teads_billing-myr	teads_billing-myr	The amount billed by Teads in Malaysian Ringgit (MYR).	metric
teads_billing-nok	teads_billing-nok	The amount billed by Teads in Norwegian Krone (NOK).	metric
teads_billing-nzd	teads_billing-nzd	The amount billed by Teads in New Zealand Dollar (NZD).	metric
teads_billing-pen	teads_billing-pen	The amount billed by Teads in Peruvian Sol (PEN).	metric
teads_billing-php	teads_billing-php	The amount billed by Teads in Philippine Peso (PHP).	metric
teads_billing-pln	teads_billing-pln	The amount billed by Teads in Polish Zloty (PLN).	metric
teads_billing-ron	teads_billing-ron	The amount billed by Teads in Romanian Leu (RON).	metric
teads_billing-rub	teads_billing-rub	The amount billed by Teads in Russian Ruble (RUB).	metric
teads_billing-sar	teads_billing-sar	The amount billed by Teads in Saudi Riyal (SAR).	metric
teads_billing-sek	teads_billing-sek	The amount billed by Teads in Swedish Krona (SEK).	metric
teads_billing-sgd	teads_billing-sgd	The amount billed by Teads in Singapore Dollar (SGD).	metric
teads_billing-thb	teads_billing-thb	The amount billed by Teads in Thai Baht (THB).	metric
teads_billing-try	teads_billing-try	The amount billed by Teads in Turkish Lira (TRY).	metric
teads_billing-twd	teads_billing-twd	The amount billed by Teads in New Taiwan Dollar (TWD).	metric
teads_billing-usd	teads_billing-usd	The amount billed by Teads in United States Dollar (USD).	metric
teads_billing-zar	teads_billing-zar	The amount billed by Teads in South African Rand (ZAR).	metric
thirdQuartile	thirdQuartile	Indicates that a video advertisement has reached its third quartile (75%) of playback.	metric
unmute	unmute	Records when a user activates the mute control and un-mutes the creative.	metric
vastError	vastError	This metric is no longer raised by the V3 format and has been replaced by adAvailable-error-vast-code and noAd-vastError-code.	metric
website	website	The domain of the website where the ad was displayed.	dimension
website_domain	website_domain	The domain of the website where the ad was displayed.	dimension
week	week	The specific week of the year the data refers to (either Sunday-Saturday or Monday-Sunday depending on ISO standard).	metric
year	year	The specific year the data refers to.	metric