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.
Advertiser IDDimension
The unique Teads ID of the advertiser.
Advertiser nameDimension
The name of the advertiser.
App NameDimension
The name of the mobile application where the ad was shown.
App PlatformDimension
The platform where the ad impressions occurred, such as iOS, Android, or web.
Auction has billableDimension
Indicates whether an ad auction resulted in a billable event. This is related to the advertiser_billable_volume metric in the Teads Reporting API.
Billable eventsMetric
The number of billable events delivered (e.g., clicks for CPC, impressions for Display CPM).
Billable impressionsMetric
The number of impressions delivered that are considered billable.
BrowserDimension
The name of the browser used by the user.
Browser versionMetric
The specific version of the web browser used by the user who viewed the advertisement. This data helps in understanding audience technology preferences and for browser-specific optimizations.
Budget deliveredMetric
The total advertiser budget consumed, including Added Value budget, Ad Manager fee, and Agency fee.
Budget delivered - CPCMetric
The amount of budget delivered based on a Cost Per Click (CPC) model.
Budget delivered - CPMMetric
The amount of budget delivered based on a Cost Per Mille (CPM) or cost per thousand impressions model.
Budget delivered - Cost per resultMetric
The amount of budget delivered, calculated as cost per desired result or action.
Budget delivered Agency FeeMetric
The agency fee included in the budget delivered, which is not invoiced by Teads.
Budget delivered FeeMetric
The Ad Manager fee included in the budget delivered.
Budget delivered TeadsMetric
The total value delivered by Teads, including Added Value budget and Ad Manager fee, but excluding Agency fee.
Budget delivered Teads - CPCMetric
The budget delivered specifically by Teads campaigns based on a Cost Per Click (CPC) model.
Budget delivered Teads - CPMMetric
The budget delivered specifically by Teads campaigns based on a Cost Per Mille (CPM) model.
Budget delivered Teads - Cost per resultMetric
The average price of each result, based on the value delivered by Teads, including advertising cost and Ad Manager fee.
Budget delivered Total Ad CostMetric
The advertising cost portion of the budget delivered, excluding Teads Ad Manager fees and agency fees.
Budget delivered Total Ad Cost - CPCMetric
The total advertising cost delivered based on a Cost Per Click (CPC) model.
Budget delivered Total Ad Cost - CPMMetric
The total advertising cost delivered based on a Cost Per Mille (CPM) model.
Budget delivered Total Ad Cost - Cost per resultMetric
The total advertising cost delivered, calculated as cost per desired result or action.
Budget spentMetric
The total budget spent or invoiced by Teads, which includes the Ad Manager fee but excludes Added Value budget or Agency fee.
Budget spent - CPCMetric
The total budget spent on campaigns based on a Cost Per Click (CPC) model.
Budget spent - CPMMetric
The total budget spent on campaigns based on a Cost Per Mille (CPM) model.
Budget spent - Cost per resultMetric
The average price of each result, considering the budget spent (invoiced by Teads) and the total volume delivered.
Budget spent currencyDimension
The currency in which the budget was spent.
Campaign IDDimension
The unique Teads ID of the campaign.
Campaign budgetDimension
The total budget allocated or booked for a specific advertising campaign.
Campaign currencyDimension
The currency of the campaign budget.
Campaign external integration codeDimension
A user-defined code used to integrate campaign data from Teads with an external reporting system.
Campaign nameDimension
The name of the campaign.
ChannelDimension
Represents the family of the creative used in the ad, such as Video, Viewable Display, or Standard Display.
ClicksMetric
The number of clicks recorded for the ad.
Clickthrough rateMetric
The ratio of clicks to impressions (Clicks / Impressions).
Conversion typeDimension
The specific type of conversion event tracked (e.g., purchase, lead, sign-up).
Cookieless impressionsMetric
The total number of ad impressions served without the use of third-party cookies for tracking.
Country codeDimension
The country code of the user, in ISO 3166-1 alpha-2 format.
Country nameDimension
The name of the country where the user activity originated.
Creative IDDimension
The unique Teads ID of the creative.
Creative external integration codeDimension
A user-defined code used to integrate creative data with an external reporting system.
Creative familyDimension
The creative family type (e.g., Video, Viewable Display).
Creative nameDimension
The name of the creative.
Creative portfolio itemDimension
The commercial name of the creative type.
Creative sizeDimension
The size of the creative (e.g., landscape, square, vertical, social).
Creative typeDimension
The specific type of creative (e.g., Carousel, Scroller).
DayDimension
The specific day for which the report data is aggregated.
DeviceDimension
The type of device on which the ad was displayed (e.g., Desktop, SmartTV, Smartphone, Tablet).
Display 20 second viewMetric
A metric indicating that a display ad was viewed for a duration of 20 seconds or more. This helps assess the engagement and viewability of display creatives.
FeeMetric
The budget spent on Ad Manager fee cost or the platform fee associated with the campaign or line item.
ImpressionsMetric
The number of times an ad was displayed.
Line End DateDimension
The end date of the line item's campaign period.
Line Group IDMetric
The unique identifier for a Line Group in Teads Ad Manager.
Line Group NameDimension
The name associated with a Line Group in Teads Ad Manager.
Line IDDimension
The unique identifier for the line item.
Line Item NameDimension
The name of the line item.
Line Start DateDimension
The start date of the line item's campaign period.
Line item IDDimension
The unique Teads ID of the line item.
Line item billable eventDimension
The billable event configured for the line item.
Line item budgetMetric
The total budget allocated or booked for a specific line item within a campaign.
Line item nameDimension
The name of the line item.
Line item targeting modeDimension
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.
Lumen - Attention seconds per 1000 impressionsMetric
The average number of seconds of active attention generated for every 1000 ad impressions, as measured by Lumen, an attention measurement provider.
Lumen - Eyes-on Dwell TimeMetric
The predicted total aggregated duration a user's eyes are focused on an ad, as measured by Lumen's eye-tracking data models.
Lumen - View RateMetric
A metric representing the average number of seconds of active attention generated for every 1000 ad impressions, as measured by Lumen, an attention measurement provider.
MOAT - 1 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 1 second. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 10 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 10 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 11 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 11 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 12 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 12 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 13 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 13 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 14 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 14 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 15 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 15 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 16 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 16 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 17 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 17 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 18 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 18 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 19 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 19 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 2 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 2 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 20 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 20 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 21 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 21 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 22 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 22 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 23 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 23 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 24 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 24 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 25 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 25 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 26 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 26 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 27 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 27 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 28 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 28 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 29 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 29 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 3 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 3 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 30 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 30 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 4 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 4 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 5 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 5 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 6 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 6 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 7 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 7 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 8 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 8 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - 9 Sec In-View ImpressionsMetric
The number of impressions measured by Moat that were in-view for at least 9 seconds. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Average Ad Length (ms)Metric
The average duration, in milliseconds, that an ad was displayed, as measured by Moat. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Average In-View Time (ms)Metric
The average time, in milliseconds, that an ad was considered in-view, as measured by Moat. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Complete In-View ImpressionsMetric
The number of impressions measured by Moat that achieved a complete in-view status. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Impressions Analyzed (filtered for IVT)Metric
The number of impressions analyzed by Moat for In-View Time (IVT), after applying specific filters. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Impressions Analyzed (unfiltered for IVT)Metric
The total number of impressions analyzed by Moat for In-View Time (IVT), without applying any filters. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - In-View Measurable Impressions MOAT - In-View Measurable ImpressionsMetric
The number of impressions that were considered measurable and in-view by MOAT, an independent third-party verification vendor.
MOAT - Total Ad Length (ms)Metric
The total duration, in milliseconds, that ads were displayed across all impressions, as measured by Moat. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Total In-View Time (ms)Metric
The total time, in milliseconds, that ads were considered in-view across all impressions, as measured by Moat. These are available through the `moat_*` metrics in the Teads Reporting API.
MOAT - Valid and Viewable %Metric
The percentage of impressions that were deemed valid and viewable according to MOAT standards.
MOAT - Valid and Viewable ImpressionsMetric
The number of impressions deemed valid and viewable according to MOAT standards.
MonthDimension
The month for which the report data is aggregated.
Post click conversionsMetric
Conversions attributed to a click on the ad.
Post view conversionsMetric
Conversions attributed to an impression (view) of the ad.
Progress-1Metric
The number of times the ad was viewed for at least 1 second.
Progress-10Metric
The number of times the ad was viewed for at least 10 seconds.
Progress-11Metric
The number of times the ad was viewed for at least 11 seconds.
Progress-12Metric
The number of times the ad was viewed for at least 12 seconds.
Progress-13Metric
The number of times the ad was viewed for at least 13 seconds.
Progress-14Metric
The number of times the ad was viewed for at least 14 seconds.
Progress-15Metric
The number of times the ad was viewed for at least 15 seconds.
Progress-16Metric
The number of times the ad was viewed for at least 16 seconds.
Progress-17Metric
The number of times the ad was viewed for at least 17 seconds.
Progress-18Metric
The number of times the ad was viewed for at least 18 seconds.
Progress-19Metric
The number of times the ad was viewed for at least 19 seconds.
Progress-2Metric
The number of times the ad was viewed for at least 2 seconds.
Progress-20Metric
The number of times the ad was viewed for at least 20 seconds.
Progress-21Metric
The number of times the ad was viewed for at least 21 seconds.
Progress-22Metric
The number of times the ad was viewed for at least 22 seconds.
Progress-23Metric
The number of times the ad was viewed for at least 23 seconds.
Progress-24Metric
The number of times the ad was viewed for at least 24 seconds.
Progress-25Metric
The number of times the ad was viewed for at least 25 seconds.
Progress-26Metric
The number of times the ad was viewed for at least 26 seconds.
Progress-27Metric
The number of times the ad was viewed for at least 27 seconds.
Progress-28Metric
The number of times the ad was viewed for at least 28 seconds.
Progress-29Metric
The number of times the ad was viewed for at least 29 seconds.
Progress-3Metric
The number of times the ad was viewed for at least 3 seconds.
Progress-30Metric
The number of times the ad was viewed for at least 30 seconds.
Progress-4Metric
The number of times the ad was viewed for at least 4 seconds.
Progress-5Metric
The number of times the ad was viewed for at least 5 seconds.
Progress-6Metric
The number of times the ad was viewed for at least 6 seconds.
Progress-7Metric
The number of times the ad was viewed for at least 7 seconds.
Progress-8Metric
The number of times the ad was viewed for at least 8 seconds.
Progress-9Metric
The number of times the ad was viewed for at least 9 seconds.
Seat idDimension
The unique identifier of the Teads seat.
Seat nameDimension
The name of the Teads seat.
Studio actionDimension
Represents a specific action or interaction performed within a 'Studio' creative or environment. This could include clicks, hovers, or other custom events defined for rich media ad formats.
Studio creative idMetric
The unique identifier assigned by Teads to a specific creative. This dimension is used to report on the performance of individual ad creatives.
Studio segmentDimension
Identifies a segment or group related to a 'Studio' creative, possibly indicating a specific audience segment targeted by the ad, or a particular creative variation served.
Total ad costMetric
The budget spent specifically on the advertising cost, excluding other fees. It does not include Added Value Budget, Ad Manager fee, or Agency fee.
Unique viewersDimension
The number of unique individuals who viewed the ad.
Video completesMetric
The number of times a video ad played to 100% completion.
Video completion rateMetric
The percentage of video ads that played to completion. This metric is related to video engagement and can be derived from video progress events, such as `video_start` mentioned in the API's configurable metrics.
Video first quartileMetric
The number of times a video ad played past the 25% mark.
Video midpointMetric
The number of times a video ad played past the 50% mark.
Video progress 10 secondMetric
Indicates that a video ad played for at least 10 seconds.
Video progress 20 secondMetric
Indicates that a video ad played for at least 20 seconds.
Video progress 3 secondMetric
Indicates if a video advertisement has been played for at least 3 seconds. This metric is crucial for measuring initial engagement and viewability of video campaigns.
Video startsMetric
The number of times a video ad began playing.
Video third quartileMetric
The number of times a video ad played past the 75% mark.
Website domainDimension
The internet domain name of the website where the ad was displayed.
Website or AppDimension
Indicates whether the ad was displayed on a website or within a mobile application.
WeekDimension
The week for which the report data is aggregated.
YearDimension
The year for which the report data is aggregated.