Teads Ad Manager: Most-used fields

The table below gives information about most-used fields that you can import from Teads Ad Manager. 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 ID	Advertiser ID	The unique Teads ID of the advertiser.	dimension
Advertiser name	Advertiser name	The name of the advertiser.	dimension
App Name	App Name	The name of the mobile application where the ad was shown.	dimension
App Platform	App Platform	The platform where the ad impressions occurred, such as iOS, Android, or web.	dimension
Billable events	Billable events	The number of billable events delivered (e.g., clicks for CPC, impressions for Display CPM).	metric
Billable impressions	Billable impressions	The number of impressions delivered that are considered billable.	metric
Budget delivered	Budget delivered	The total advertiser budget consumed, including Added Value budget, Ad Manager fee, and Agency fee.	metric
Budget delivered Agency Fee	Budget delivered Agency Fee	The agency fee included in the budget delivered, which is not invoiced by Teads.	metric
Budget delivered Fee	Budget delivered Fee	The Ad Manager fee included in the budget delivered.	metric
Budget delivered Teads	Budget delivered Teads	The total value delivered by Teads, including Added Value budget and Ad Manager fee, but excluding Agency fee.	metric
Budget delivered Total Ad Cost	Budget delivered Total Ad Cost	The advertising cost portion of the budget delivered, excluding Teads Ad Manager fees and agency fees.	metric
Budget spent	Budget spent	The total budget spent or invoiced by Teads, which includes the Ad Manager fee but excludes Added Value budget or Agency fee.	metric
Budget spent - CPM	Budget spent - CPM	The average price of 1000 impressions (display) or starts (video), considering the budget spent (invoiced by Teads) and the total volume delivered.	metric
Budget spent - Cost per result	Budget spent - Cost per result	The average cost incurred for each desired result (e.g., conversion, click) based on the total budget delivered, which includes advertising cost, Teads Ad Manager fee, and agency fee.	metric
Budget spent currency	Budget spent currency	The currency in which the budget was spent.	dimension
Campaign ID	Campaign ID	The unique Teads ID of the campaign.	dimension
Campaign budget	Campaign budget	The total budget allocated or booked for a specific advertising campaign.	metric
Campaign currency	Campaign currency	The currency of the campaign budget.	dimension
Campaign name	Campaign name	The name of the campaign.	dimension
Channel	Channel	Represents the family of the creative used in the ad, such as Video, Viewable Display, or Standard Display.	dimension
Clicks	Clicks	The number of clicks recorded for the ad.	metric
Clickthrough rate	Clickthrough rate	The ratio of clicks to impressions (Clicks / Impressions).	metric
Conversion type	Conversion type	The specific type of conversion event tracked (e.g., purchase, lead, sign-up).	dimension
Cookieless impressions	Cookieless impressions	The total number of ad impressions served without the use of third-party cookies for tracking.	metric
Country code	Country code	The country code of the user, in ISO 3166-1 alpha-2 format.	dimension
Country name	Country name	The name of the country where the user activity originated.	dimension
Creative ID	Creative ID	The unique Teads ID of the creative.	dimension
Creative family	Creative family	The creative family type (e.g., Video, Viewable Display).	dimension
Creative name	Creative name	The name of the creative.	dimension
Creative portfolio item	Creative portfolio item	The commercial name of the creative type.	dimension
Creative size	Creative size	The size of the creative (e.g., landscape, square, vertical, social).	dimension
Creative type	Creative type	The specific type of creative (e.g., Carousel, Scroller).	dimension
Day	Day	The specific day for which the report data is aggregated.	dimension
Device	Device	The type of device on which the ad was displayed (e.g., Desktop, SmartTV, Smartphone, Tablet).	dimension
Fee	Fee	The Ad Manager fee or platform fee associated with the campaign or line item.	metric
Impressions	Impressions	The number of times an ad was displayed.	metric
Line End Date	Line End Date	The end date of the line item’s campaign period.	dimension
Line Group ID	Line Group ID	The unique identifier for a Line Group in Teads Ad Manager.	metric
Line Group Name	Line Group Name	The name associated with a Line Group in Teads Ad Manager.	dimension
Line ID	Line ID	The unique identifier for the line item.	metric
Line Item Name	Line Item Name	The name of the line item.	dimension
Line Start Date	Line Start Date	The start date of the line item’s campaign period.	dimension
Line item ID	Line item ID	The unique Teads ID of the line item.	metric
Line item billable event	Line item billable event	The billable event configured for the line item.	dimension
Line item budget	Line item budget	The total budget allocated or booked for a specific line item within a campaign.	metric
Line item name	Line item name	The name of the line item.	dimension
Line item targeting mode	Line item targeting mode	Indicates the targeting mode of a line item. It specifies if the line item is configured to use only cookieless signals for its targeting or if it uses standard targeting methods.	dimension
Lumen - Attention seconds per 1000 impressions	Lumen - Attention seconds per 1000 impressions	The average number of seconds of active attention generated for every 1000 ad impressions, as measured by Lumen, an attention measurement provider.	metric
Lumen - Eyes-on Dwell Time	Lumen - Eyes-on Dwell Time	The predicted total aggregated duration a user’s eyes are focused on an ad, as measured by Lumen’s eye-tracking data models.	metric
MOAT - Average In-View Time (ms)	MOAT - Average In-View Time (ms)	The average amount of time, in milliseconds, that the ad was in view.	metric
MOAT - In-View Measurable Impressions	MOAT - In-View Measurable Impressions	The number of impressions that were considered measurable and in-view by MOAT, an independent third-party verification vendor.	metric
MOAT - Valid and Viewable %	MOAT - Valid and Viewable %	The percentage of impressions that were deemed valid and viewable according to MOAT standards.	metric
MOAT - Valid and Viewable Impressions	MOAT - Valid and Viewable Impressions	The number of impressions deemed valid and viewable according to MOAT standards.	metric
Month	Month	The month for which the report data is aggregated.	dimension
Post click conversions	Post click conversions	Conversions attributed to a click on the ad.	metric
Post view conversions	Post view conversions	Conversions attributed to an impression (view) of the ad.	metric
Seat id	Seat id	The unique identifier of the Teads seat.	metric
Seat name	Seat name	The name of the Teads seat.	dimension
Total ad cost	Total ad cost	The budget spent specifically on the advertising cost, excluding other fees.	metric
Unique viewers	Unique viewers	The number of unique individuals who viewed the ad.	dimension
Video completes	Video completes	The number of times a video ad played to 100% completion.	metric
Video first quartile	Video first quartile	The number of times a video ad played past the 25% mark.	metric
Video midpoint	Video midpoint	The number of times a video ad played past the 50% mark.	metric
Video starts	Video starts	The number of times a video ad began playing.	metric
Video third quartile	Video third quartile	The number of times a video ad played past the 75% mark.	metric
Website domain	Website domain	The internet domain name of the website where the ad was displayed.	dimension
Website or App	Website or App	Indicates whether the ad was displayed on a website or within a mobile application.	dimension
Week	Week	The week for which the report data is aggregated.	dimension
Year	Year	The year for which the report data is aggregated.	metric
ad_format	ad_format	The general category or family of the ad creative, such as Video or Viewable Display.	dimension
advertiser	advertiser	The name of the advertiser.	dimension
advertiser_id	advertiser_id	The unique Teads ID of the advertiser.	dimension
buying_type	buying_type	Indicates the buying model of the advertising campaign or insertion.	dimension
campaign_id	campaign_id	The unique Teads ID of the campaign.	dimension
campaign_name	campaign_name	The name of the campaign.	dimension
campaign_objective	campaign_objective	Represents the specific optimization goal defined for a campaign, which guides its delivery and performance.	dimension
clicks	clicks	The number of clicks recorded for the ad.	metric
conversions_click	conversions_click	Conversions attributed to a click on the ad.	metric
conversions_view	conversions_view	Conversions attributed to an impression (view) of the ad.	metric
country	country	The name of the country where the user activity originated.	dimension
creative_id	creative_id	The unique Teads ID of the creative.	dimension
creative_name	creative_name	The name of the creative.	dimension
date	date	The specific date for which the reporting data is aggregated.	dimension
device_type	device_type	The type of device on which the ad was viewed (e.g., mobile, tablet, desktop).	dimension
format_size	format_size	The size of the ad creative, such as Landscape, Square, Vertical, or MPU.	dimension
format_type	format_type	The specific type of the ad creative, such as Video, 360, Carousel, Scroller, or Flow.	dimension
impressions	impressions	The number of times an ad was displayed.	metric
line_item_id	line_item_id	The unique Teads ID of the line item.	dimension
line_item_name	line_item_name	The name of the line item.	dimension
spend	spend	The total budget spent or invoiced by Teads, which includes the Ad Manager fee but excludes Added Value budget or Agency fee.	metric
video_complete	video_complete	The number of times a video ad played to 100% completion.	metric
video_first_quartile	video_first_quartile	The number of times a video ad played past the 25% mark.	metric
video_midpoint	video_midpoint	The number of times a video ad played past the 50% mark.	metric
video_third_quartile	video_third_quartile	The number of times a video ad played past the 75% mark.	metric