Fields listing for Teads

Indicates the last time the campaign object was updated.​​Notes:- API-only field- Format: YYYY-MM-ddTHH:mm:ss- Timezone: the timezone of your report

Unique identifier of the advertiser.

Name of the advertiser.

Indicates the last time the advertiser object was updated.​​Notes:- API-only field- Format: YYYY-MM-ddTHH:mm:ss- Timezone: the timezone of your report

Advertising Solution of the campaign (i.e. "Clicks", "Contextual Reachcast", "Conversions", etc.)

Unique identifier of the application on the application store.

Name of the application.

Platform or Operating System where the application is used.

True if auction billed, false otherwise. Note: due to technical implementation, there can be false negatives (but no false positives).

"Total Ad Length" / "Valid and Viewable Impressions".

"Total In-View Time" / "Valid and Viewable Impressions".

Number of billable events delivered (ex: clicks for CPC, impressions for Display CPM, etc.).

Name of the browser of the user seeing the ad.

Version of the browser of the user seeing the ad.

Advertiser budget consumed. Includes added value budget, TAM fee and agency fee.

Average price of a result, based on "Budget Delivered". This is the cost per result paid by the advertiser, including advertising cost, TAM fee and agency fee.

Average price of a click, based on "Budget Delivered". This is the CPC value paid by the advertiser, including advertising cost, TAM fee and agency fee).

Average price of 1000 impressions (display) or starts (video), based on "Budget Delivered". This is the CPM value paid by the advertiser, including advertising cost, TAM fee and agency fee.

Agency fee. It is not invoiced by Teads.

TAM fee. It is invoiced by Teads.

Total value delivered by Teads. Includes added value budget and TAM fee. Does not include agency fee.

Average price of a result, based on "Budget Delivered Teads". This is the cost per result delivered by Teads, including advertising cost and TAM fee.

Average price of a click, based on "Budget Delivered Teads". This is the CPC value delivered by Teads, including advertising cost and TAM fee.

Average price of 1000 impressions (display) or starts (video), based on "Budget Delivered Teads". This is the CPM value delivered by Teads, including advertising cost and TAM fee.

Advertising value (media & data) delivered by Teads. Includes added value budget, but excludes TAM fee and agency fee.

Average price of a result, based on "Budget Delivered Total Ad Cost". This is the cost per result considering only the advertising cost.

Average price of a click, based on "Budget Delivered Total Ad Cost". This is the CPC value considering only the advertising cost.

Average price of 1000 impressions (display) or starts (video), based on "Budget Delivered Total Ad Cost". This is the CPM value considering only the advertising cost.

Budget spent invoiced by Teads. Includes TAM fee, but excludes added value budget and agency fee.

Average price of a result, considering the budget spend (invoiced by Teads) and the total volume delivered.

Average price of a click, considering the budget spend (invoiced by Teads) and the total volume delivered.

Average price of 1000 impressions (display) or starts (video), considering the budget spend (invoiced by Teads) and the total volume delivered.

Currency of the budget spent.

Total budget booked for a campaign.

Currency of the campaign budget.

User-defined code to integrate campaign data with another reporting system.

Unique identifier of the campaign.

Name of the campaign.

Objective of the campaign. Allows to breakdown between Branding and Performance campaigns.

Delivery channel of the line item (values: "Web & Mobile App" or "CTV")

Name of the city where the user saw the ad.

Number of clicks.

Number of clicks that your ad receives divided by the number of times your ad is shown.

Number of impressions that have been in-view on complete (from Teads).

Name of a conversion event (as configured in Events Manager, which allows the setup and management of website event).

Type of a conversion event (as configured in Events Manager, which allows the setup and management of website event). Note: event types are standardized and are predefined by Teads, they can be used to log conversions (ex: Lead, Purchase, Add to cart).

Number of impressions delivered using cookieless signals.

"Cookieless Impressions" / Impression".

Code of the country where the user saw the ad. Uses the ISO 3166-1 alpha-2 standard.

Name of the country where the user saw the ad.

User-defined code to integrate creative data with another reporting system.

Family of the creative (values: Video, Viewable Display, etc.).

ID of the creative.

Name of the creative.

Commercial name of the creative.

Size of the creative (values: Landscape, Square, Vertical, etc.).

Type of the creative (values: Carousel, Scroller, etc.).

Indicates the last time the creative object was updated.​​Notes:- API-only field- Format: YYYY-MM-ddTHH:mm:ss- Timezone: the timezone of your report

Year, month, and day.

Day of the year

Week of the year

Currency of the Deal ID (i.e., USD, EUR).

An identifier shared by the Publisher or Exchange for a Deal ID in their system.

The minimum or fixed cost per thousand impressions (CPM) for the inventory associated with a Deal ID.

The rate type of the inventory. For example: Fixed or Dynamic.

Device where the ad was delivered (values: Desktop, Smartphone, etc.).

Budget spent on TAM fee.

Hour of the day

Number of impressions delivered.

The number of impressions where viewability was measurable by Teads.

Indicates the last time the Line Item object was updated.​​Notes:- API-only field- Format: YYYY-MM-ddTHH:mm:ss- Timezone: the timezone of your report

End date of the line item.

Unique identifier of the Line Group

Name of the Line Group

Indicates the last time the Line Group object was updated.​​Notes:- API-only field- Format: YYYY-MM-ddTHH:mm:ss- Timezone: the timezone of your report

Unique identifier of the Line Group. Note: Please use "Line Group ID" instead.

Billing event of the line item depending on your buying model. Note: for CPM billing event is Start (video) or Impression (display), for CPCV billing event is Complete, for vCPM billing event is Viewable Impression, for CPC billing event is Click.

Total budget booked for the line item.

Unique identifier of the line item.

Name of the line item.

Cookieless if the line item is forced to use only cookieless signals in its targeting, otherwise standard.

Start date of the line item.

Aggregate amount of "eyes on" visual attention received by 1000 impressions

The average amount of time - in seconds - that viewed ads were looked at, as predicted by Lumen attention models.

Percentage of impressions receiving at least 1 eye fixation (minimum duration 100ms) as predicted by Lumen attention models.

Code of the market area where the user saw the ad.

Name of the market area name where the user saw the ad.

Month and day

Month of the year

Operating system of the device where the ad was delivered.

Position of the slot displaying the creative (values: in Article, instream etc.)

Number of post-click conversions. Post-click conversions occur when a user is served an ad, clicks on it and then converts on your site within a set period.

Number of post view conversions. Post-view conversions occur when a user is served an ad and didn’t click it. They later returned your site (via some other path) and converted within a set period.

Postal code where the user saw the ad.

Quarter of the year

Code of the region where the user saw the ad.

Name of the region where the user saw the ad.

Ad tech supply emissions including servers and cloud computing; analytics; network traffic; storage; data providers; and vendor overhead. Unit: grams of CO₂ equivalent (gCO₂e)

Emissions associated with the consumer device during ad exposure. Includes both emissions based on the use of the device and embodied emissions of the device.Unit: grams of CO₂ equivalent (gCO₂e)

Emissions associated with the data transfer of the creative asset.Unit: grams of CO₂ equivalent (gCO₂e)

Number of impressions for which the Scope3 API returned emissionsUnit: Impression

Emissions associated with the consumer device during media consumption. Includes both emissions based on the use of the device and embodied emissions of the device.Unit: grams of CO₂ equivalent (gCO₂e)

Media delivery including CMS; CDNs and hosting services; publishing overhead including employee and office expenses; data transfer.Unit: grams of CO₂ equivalent (gCO₂e)

Sum of all the five emissions metrics aboveUnit: grams of CO₂ equivalent (gCO₂e)

Carbon score per Mille including all the emissions metricsUnit: grams of CO₂ equivalent per 1000 impressions (gCO2PM)

Sum of the Ad Selection, Creative Distribution and Media Distribution emissions metricsUnit: grams of CO₂ equivalent (gCO₂e)

Unique identifier of the seat.

Name of the seat.

Custom creative actions tracked through Teads Studio (ex: Click on Endscreen)

Unique identifier of the Studio creative.

Unique identifier of a Studio creative's personalization segment, for dynamic creatives.

Number of impressions where an in-view time was measurable. This is helpful to calculate an overall average inview time with the following formula: "Total In-View Time" / "Time Measurable Impressions"

Budget spent on advertising cost. Does not include added value budget, nor TAM fee, nor agency fee.

Total ad length in milliseconds (from Teads).

The total time in milliseconds that the ad was visible for users who met the requirement for a 2 Sec in-view impression (from Teads).

Estimated number of unique Teads IDs exposed to an ad.​Note: this metric is only compatible with a limited set dimensions & metrics (learn more about Unique Viewers)

"Valid and Viewable Impressions" / "In-View Measurable Impressions".

Number of valid impressions that were viewable under the MRC standard (50% of pixels in-view for at least 2 continuous seconds for video, 1 continuous second for display).

Number of times a video ad was played to completion.

The percentage of video ad impressions that played to completion ("Video Completes" / "Video Starts").

Number of times a video ad played for 25% of its duration..

Number of times a video ad played for 50% of its duration..

Type of the creative delivered: video or display.

Number of times a video ad started playing.

Number of times a video ad played for 75% of its duration.

Domain of the website where the ad was delivered.

Website domain (if the impression happened on a website) or App Name / App Platform / App Bundle ID (if the impression happened on a CTV app).

Week of the year

Week of the year

Year such as 2017.

Year and month.

Year, month, day, and hour.

Year and quarter.

Year and week.