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 |
Auction has billable |
Auction has billable |
Indicates if the impression in the auction was billed (TRUE) or not (FALSE). |
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 |
Browser |
Browser |
The name of the browser used by the user. |
dimension |
Browser version |
Browser version |
The version of the browser used by the user. |
metric |
Budget delivered |
Budget delivered |
The total advertiser budget consumed, including Added Value budget, Ad Manager fee, and Agency fee. |
metric |
Budget delivered - CPC |
Budget delivered - CPC |
The average price of a click, based on the total budget delivered, including advertising cost, Ad Manager fee, and Agency fee. |
metric |
Budget delivered - CPM |
Budget delivered - CPM |
The average price of a thousand impressions (display) or video starts, based on the total budget delivered, including advertising cost, Ad Manager fee, and Agency fee. |
metric |
Budget delivered - Cost per result |
Budget delivered - Cost per result |
The average price of each result, based on the total budget delivered, including advertising cost, 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 Teads - CPC |
Budget delivered Teads - CPC |
The average price of a click, based on the value delivered by Teads, including advertising cost and Ad Manager fee. |
metric |
Budget delivered Teads - CPM |
Budget delivered Teads - CPM |
The average price of a thousand impressions (display) or video starts, based on the value delivered by Teads, including advertising cost and Ad Manager fee. |
metric |
Budget delivered Teads - Cost per result |
Budget delivered Teads - Cost per result |
The average price of each result, based on the value delivered by Teads, including advertising cost and Ad Manager 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 delivered Total Ad Cost - CPC |
Budget delivered Total Ad Cost - CPC |
The average price of a click, considering only the advertising cost. |
metric |
Budget delivered Total Ad Cost - CPM |
Budget delivered Total Ad Cost - CPM |
The average price of a thousand impressions (display) or video starts, considering only the advertising cost. |
metric |
Budget delivered Total Ad Cost - Cost per result |
Budget delivered Total Ad Cost - Cost per result |
The average price of each result, considering only the advertising cost. |
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 - CPC |
Budget spent - CPC |
The average price of each click, considering the budget spent (invoiced by Teads) and the total volume delivered. |
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 price of each result, considering the budget spent (invoiced by Teads) and the total volume delivered. |
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 external integration code |
Campaign external integration code |
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 external integration code |
Creative external integration code |
A user-defined code used to integrate creative data with an external reporting system. |
metric |
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 |
Display 20 second view |
Display 20 second view |
The number of display ads viewed for at least 20 seconds. |
metric |
Display 5 second view |
Display 5 second view |
The number of display ads viewed for at least 5 seconds. |
metric |
Fee |
Fee |
The budget spent on Ad Manager fee cost or the 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 |
Lumen - View Rate |
Lumen - View Rate |
metric |
|
MOAT - 1 Sec In-View Impressions |
MOAT - 1 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 1 second. |
metric |
MOAT - 10 Sec In-View Impressions |
MOAT - 10 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 10 seconds. |
metric |
MOAT - 11 Sec In-View Impressions |
MOAT - 11 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 11 seconds. |
metric |
MOAT - 12 Sec In-View Impressions |
MOAT - 12 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 12 seconds. |
metric |
MOAT - 13 Sec In-View Impressions |
MOAT - 13 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 13 seconds. |
metric |
MOAT - 14 Sec In-View Impressions |
MOAT - 14 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 14 seconds. |
metric |
MOAT - 15 Sec In-View Impressions |
MOAT - 15 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 15 seconds. |
metric |
MOAT - 16 Sec In-View Impressions |
MOAT - 16 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 16 seconds. |
metric |
MOAT - 17 Sec In-View Impressions |
MOAT - 17 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 17 seconds. |
metric |
MOAT - 18 Sec In-View Impressions |
MOAT - 18 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 18 seconds. |
metric |
MOAT - 19 Sec In-View Impressions |
MOAT - 19 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 19 seconds. |
metric |
MOAT - 2 Sec In-View Impressions |
MOAT - 2 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 2 seconds. |
metric |
MOAT - 20 Sec In-View Impressions |
MOAT - 20 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 20 seconds. |
metric |
MOAT - 21 Sec In-View Impressions |
MOAT - 21 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 21 seconds. |
metric |
MOAT - 22 Sec In-View Impressions |
MOAT - 22 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 22 seconds. |
metric |
MOAT - 23 Sec In-View Impressions |
MOAT - 23 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 23 seconds. |
metric |
MOAT - 24 Sec In-View Impressions |
MOAT - 24 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 24 seconds. |
metric |
MOAT - 25 Sec In-View Impressions |
MOAT - 25 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 25 seconds. |
metric |
MOAT - 26 Sec In-View Impressions |
MOAT - 26 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 26 seconds. |
metric |
MOAT - 27 Sec In-View Impressions |
MOAT - 27 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 27 seconds. |
metric |
MOAT - 28 Sec In-View Impressions |
MOAT - 28 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 28 seconds. |
metric |
MOAT - 29 Sec In-View Impressions |
MOAT - 29 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 29 seconds. |
metric |
MOAT - 3 Sec In-View Impressions |
MOAT - 3 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 3 seconds. |
metric |
MOAT - 30 Sec In-View Impressions |
MOAT - 30 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 30 seconds. |
metric |
MOAT - 4 Sec In-View Impressions |
MOAT - 4 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 4 seconds. |
metric |
MOAT - 5 Sec In-View Impressions |
MOAT - 5 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 5 seconds. |
metric |
MOAT - 6 Sec In-View Impressions |
MOAT - 6 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 6 seconds. |
metric |
MOAT - 7 Sec In-View Impressions |
MOAT - 7 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 7 seconds. |
metric |
MOAT - 8 Sec In-View Impressions |
MOAT - 8 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 8 seconds. |
metric |
MOAT - 9 Sec In-View Impressions |
MOAT - 9 Sec In-View Impressions |
The number of MOAT-measured impressions that were in-view for at least 9 seconds. |
metric |
MOAT - Average Ad Length (ms) |
MOAT - Average Ad Length (ms) |
The average length of the ad in milliseconds, as measured by MOAT. |
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 - Complete In-View Impressions |
MOAT - Complete In-View Impressions |
The number of MOAT-measured video impressions that were in-view for 100% of the ad length. |
metric |
MOAT - Impressions Analyzed (filtered for IVT) |
MOAT - Impressions Analyzed (filtered for IVT) |
The number of MOAT-measured impressions that were analyzed after filtering for invalid traffic (IVT). |
metric |
MOAT - Impressions Analyzed (unfiltered for IVT) |
MOAT - Impressions Analyzed (unfiltered for IVT) |
The number of MOAT-measured impressions that were analyzed without filtering for invalid traffic (IVT). |
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 - Total Ad Length (ms) |
MOAT - Total Ad Length (ms) |
The total length of all ads in milliseconds, as measured by MOAT. |
metric |
MOAT - Total In-View Time (ms) |
MOAT - Total In-View Time (ms) |
The total amount of time, in milliseconds, that ads were in view, as measured by MOAT. |
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. |
metric |
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 |
Progress-1 |
Progress-1 |
The number of times the ad was viewed for at least 1 second. |
metric |
Progress-10 |
Progress-10 |
The number of times the ad was viewed for at least 10 seconds. |
metric |
Progress-11 |
Progress-11 |
The number of times the ad was viewed for at least 11 seconds. |
metric |
Progress-12 |
Progress-12 |
The number of times the ad was viewed for at least 12 seconds. |
metric |
Progress-13 |
Progress-13 |
The number of times the ad was viewed for at least 13 seconds. |
metric |
Progress-14 |
Progress-14 |
The number of times the ad was viewed for at least 14 seconds. |
metric |
Progress-15 |
Progress-15 |
The number of times the ad was viewed for at least 15 seconds. |
metric |
Progress-16 |
Progress-16 |
The number of times the ad was viewed for at least 16 seconds. |
metric |
Progress-17 |
Progress-17 |
The number of times the ad was viewed for at least 17 seconds. |
metric |
Progress-18 |
Progress-18 |
The number of times the ad was viewed for at least 18 seconds. |
metric |
Progress-19 |
Progress-19 |
The number of times the ad was viewed for at least 19 seconds. |
metric |
Progress-2 |
Progress-2 |
The number of times the ad was viewed for at least 2 seconds. |
metric |
Progress-20 |
Progress-20 |
The number of times the ad was viewed for at least 20 seconds. |
metric |
Progress-21 |
Progress-21 |
The number of times the ad was viewed for at least 21 seconds. |
metric |
Progress-22 |
Progress-22 |
The number of times the ad was viewed for at least 22 seconds. |
metric |
Progress-23 |
Progress-23 |
The number of times the ad was viewed for at least 23 seconds. |
metric |
Progress-24 |
Progress-24 |
The number of times the ad was viewed for at least 24 seconds. |
metric |
Progress-25 |
Progress-25 |
The number of times the ad was viewed for at least 25 seconds. |
metric |
Progress-26 |
Progress-26 |
The number of times the ad was viewed for at least 26 seconds. |
metric |
Progress-27 |
Progress-27 |
The number of times the ad was viewed for at least 27 seconds. |
metric |
Progress-28 |
Progress-28 |
The number of times the ad was viewed for at least 28 seconds. |
metric |
Progress-29 |
Progress-29 |
The number of times the ad was viewed for at least 29 seconds. |
metric |
Progress-3 |
Progress-3 |
The number of times the ad was viewed for at least 3 seconds. |
metric |
Progress-30 |
Progress-30 |
The number of times the ad was viewed for at least 30 seconds. |
metric |
Progress-4 |
Progress-4 |
The number of times the ad was viewed for at least 4 seconds. |
metric |
Progress-5 |
Progress-5 |
The number of times the ad was viewed for at least 5 seconds. |
metric |
Progress-6 |
Progress-6 |
The number of times the ad was viewed for at least 6 seconds. |
metric |
Progress-7 |
Progress-7 |
The number of times the ad was viewed for at least 7 seconds. |
metric |
Progress-8 |
Progress-8 |
The number of times the ad was viewed for at least 8 seconds. |
metric |
Progress-9 |
Progress-9 |
The number of times the ad was viewed for at least 9 seconds. |
metric |
Seat id |
Seat id |
The unique identifier of the Teads seat. |
metric |
Seat name |
Seat name |
The name of the Teads seat. |
dimension |
Studio action |
Studio action |
Custom creative actions tracked through Teads Studio, such as clicks on an end screen. |
dimension |
Studio creative id |
Studio creative id |
An identifier for a creative asset that is managed or created within Teads Studio, often associated with custom creative actions. |
dimension |
Studio segment |
Studio segment |
dimension |
|
Total ad cost |
Total ad cost |
The budget spent specifically on the advertising cost, excluding other fees. It does not include Added Value Budget, Ad Manager fee, or Agency fee. |
metric |
Unique viewers |
Unique viewers |
The number of unique individuals who viewed the ad. |
metric |
Video completes |
Video completes |
The number of times a video ad played to 100% completion. |
metric |
Video completion rate |
Video completion rate |
The video completion rate, calculated as Video completes / Video starts. |
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 progress 10 second |
Video progress 10 second |
The number of video ads that played for at least 10 seconds. |
metric |
Video progress 15 second |
Video progress 15 second |
The number of video ads that played for at least 15 seconds. |
metric |
Video progress 20 second |
Video progress 20 second |
The number of video ads that played for at least 20 seconds. |
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. |
dimension |
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 |
platform |
platform |
The platform where the ad impressions occurred, such as iOS, Android, or web. |
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 |