Teads
Overview
Vendor/Partner | Teads |
---|---|
Version | Not specified |
API Documentation | |
Sunset Date | None as of Jan. 2025 |
Channel(s) | Programmatic |
Refresh Time (CST) | 6am |
Default backfill | 7 Days |
Alli Data Library |
Getting Started
Required Authorization
Log into the TAM UI
Open "Settings" screen by clicking on the gear icon located in the header.
Click the "Generate API Key" button in the "API Keys" section.
Optional - Click edit icon to change the API Key name.

Save & Authorize your datasource

Input your API key

Upon saving the API key, the authorization will be available globally within the Alli client. You can customize the authorization access level by clicking the settings wheel in the Required Authorization section and selecting Only Me (Private)
or Any user in <client>
.
Define your Data
Name | ID | Type | Description |
---|---|---|---|
Hour |
| string | Hour for the data |
Day |
| date | Day for the data |
Seat id |
| string | Teads Ad Manager Seat id |
Seat name |
| string | Teads Ad Manager Seat name |
Advertiser ID |
| string | Teads id of the advertiser |
Advertiser name |
| string | Name of the advertiser |
Advertising Solution |
| string | Advertising Solution of the campaign |
Campaign ID |
| string | Teads id of the campaign |
Campaign name |
| string | Name of the campaign |
Campaign Objective |
| string | Objective of the campaign. Allows to breakdown between Branding and Performance campaigns. |
Conversion name |
| string | Name of a conversion event (as configured in Events Manager, which allows the setup and management of website event). |
Conversion type |
| string | Type of a conversion event (as configured in Events Manager, which allows the setup and management of website event). |
Cookieless Delivery |
| string | True or False - indicates if the targeting applied to deliver the impression only used cookieless signals (true) or relied on a 3rd party cookie (false) |
Budget spent currency |
| string | Currency of the budget spent |
Campaign currency |
| string | Currency of the campaign |
Campaign budget |
| string | Total budget of the campaign |
Campaign external integration code |
| string | User-defined code to integrate campaign data with another reporting system |
Line item ID |
| string | Teads id of the line item |
Line Item Name |
| string | Name of the line item |
Line item budget |
| string | Budget of the line item |
Line End Date |
| string | End date of the line item |
Line Group ID |
| string | Unique identifier of the Line Group |
Line Group Name |
| string | Name of the Line Group |
Line item billable event |
| string | Billable event for the line item |
Line Item Targeting Mode |
| string | Cookieless if the line item is forced to use only cookieless signals in its targeting, otherwise standard. |
Line Start Date |
| string | Start date of the line item |
Campaign Updated At |
| string | |
Advertiser Updated At |
| string | |
Line Group Updated At |
| string | |
Line Item Updated At |
| string | |
Creative Updated At |
| string | |
Creative ID |
| string | Teads id of the creative |
Creative name |
| string | Name of the creative |
Creative external integration code |
| string | Code for integrating with another reporting system |
Creative portfolio item |
| string | Commercial name of the creative type |
Creative family |
| string | Creative family (Video, Viewable Display, etc) |
Creative type |
| string | Creative type (Carousel, Scroller, etc) |
Creative size |
| string | Creative size: (landscape, square, vertical, social) |
Position |
| string | Position of the slot displaying the creative (values: in Article, instream etc.) |
Studio Action |
| string | Custom creative actions tracked through Teads Studio (ex: Click on Endscreen) |
Studio creative id |
| string | Unique identifier of the Studio creative |
Studio Segment |
| string | Unique identifier of a Studio creative's personalization segment, for dynamic creatives |
Video or Display |
| string | Type of the creative delivered: video or display |
Deal Currency |
| string | Currency of the Deal ID (i.e., USD, EUR) |
Deal ID Key |
| string | An identifier shared by the Publisher or Exchange for a Deal ID in their system |
Deal Rate CPM |
| string | The minimum or fixed cost per thousand impressions (CPM) for the inventory associated with a Deal ID |
Deal Rate Type |
| string | The rate type of the inventory. For example: Fixed or Dynamic |
Auction has billable |
| string | Auction has billable - TRUE if the impression was billed, FALSE otherwise. Computing if an event (impression, click, etc) was tracked as part of a billable session is based on a 30 minute window and could contain false negatives, when an event is part of a billable session but was tracked in a different time window. There are no false positives. |
Country code |
| string | Country code of the user - ISO 3166-1 alpha-2 format, ex: US, FR |
Country name |
| string | Country name of the user |
City Name |
| string | Name of the country where the user saw the ad |
Market Area Code |
| string | Code of the market area where the user saw the ad |
Market Area Name |
| string | Name of the market area name where the user saw the ad |
Postal Code |
| string | Postal code where the user saw the ad |
Region Code |
| string | Code of the region where the user saw the ad |
Region Name |
| string | Name of the region where the user saw the ad |
App Bundle ID |
| string | Unique identifier of the application on the application store |
App Name |
| string | Name of the application |
App Platform |
| string | Platform or Operating System where the application is used |
Channel |
| string | Delivery channel of the line item (values: Web & Mobile App or CTV) |
Website domain |
| string | The domain of the website |
Website or App |
| string | 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) |
Browser |
| string | Name of browser |
Browser version |
| string | Version of browser |
Device |
| string | Device: (Desktop, SmartTV, Smartphone, Tablet) |
Operating System |
| string | Operating system of the device where the ad was delivered |
Name | ID | Type | Description |
---|---|---|---|
Budget spent |
| number | Budget spent (i.e. invoiced by Teads). Includes Ad Manager fee. Does not include Added Value budget nor Agency fee. |
Total ad cost |
| number | Budget spent on advertising cost. Does not include Added Value Budget, nor Ad Manager fee, nor Agency fee. |
Fee |
| number | Budget spent on Ad Manager fee cost |
Budget delivered |
| number | Advertiser budget consumed. Includes Added Value budget, Ad Manager fee and Agency fee. |
Budget delivered Teads |
| number | Total value delivered by Teads. Includes Added Value budget and Ad Manager fee. Does not include Agency fee. |
Budget delivered Agency Fee |
| number | Agency fee. Not invoiced by Teads. |
Budget Delivered Fee |
| string | TAM fee. It is invoiced by Teads. |
Budget delivered Total Ad Cost |
| number | Advertising value (media & data) delivered by Teads. Includes Added Value budget. Does not include Ad Manager fee nor Agency fee. |
Budget spent - Cost per result |
| number | Average price of each result, considering the budget spent (invoiced by Teads) and the total volume delivered. |
Budget delivered - Cost per result |
| number | Average price of each result, based on the budget_delivered. This is the cost per result paid by the advertiser, including advertising cost, Ad Manager fee and Agency fee. |
Budget delivered Teads - Cost per result |
| number | Average price of each result, based on the budget_delivered_teads. This is the cost per result delivered by Teads, including advertising cost and Ad Manager fee. |
Budget delivered Total Ad Cost - Cost per result |
| number | Average price of each result, based on the budget_delivered_advertising. This is the cost per result considering only the advertising cost. |
Budget spent - CPM |
| number | Average price of a thousand impressions, considering the budget spent (invoiced by Teads) and the total volume delivered. |
Budget delivered - CPM |
| number | Average price of a thousand impressions (display) or starts (video), based on the budget_delivered. This is the CPM value paid by the advertiser, including advertising cost, Ad Manager fee and Agency fee. |
Budget delivered Teads - CPM |
| number | Average price of a thousand impressions (display) or starts (video), based on the budget_delivered_teads. This is the CPM value delivered by Teads, including advertising cost and Ad Manager fee. |
Budget delivered Total Ad Cost - CPM |
| number | Average price of a thousand impressions (display) or starts (video), based on the budget_delivered_advertising. This is the CPM value considering only the advertising cost. |
Budget spent - CPC |
| number | Average price of each click, considering the budget spent (invoiced by Teads) and the total volume delivered. |
Budget delivered - CPC |
| number | Average price of a click, based on the budget_delivered. This is the CPC value paid by the Advertiser, including advertising cost, Ad Manager fee and Agency fee. |
Budget delivered Teads - CPC |
| number | Average price of a click, based on the budget_delivered_teads. This is the CPC value delivered by Teads, including advertising cost and Ad Manager fee. |
Budget delivered Total Ad Cost - CPC |
| number | Average price of a click, based on the budget_delivered_advertising. This is the CPC value considering only the advertising cost. |
Billable impressions |
| number | Number of results delivered |
Cookieless Impressions |
| string | Number of impressions delivered using cookieless signals |
Cookieless Impressions Rate |
| string | Cookieless Impressions / Impression |
Impressions |
| number | Impressions |
Video starts |
| number | Video starts |
Video first quartile |
| number | Video first quartile |
Video midpoint |
| number | Video midpoint |
Video third quartile |
| number | Video third quartile |
Video completes |
| number | Video completes |
Video completion rate |
| number | Video completion rate |
Clicks |
| number | Clicks |
Clickthrough rate |
| number | Clickthrough rate |
Post view conversions |
| number | Post view conversions |
Post click conversions |
| number | Post click conversions |
MOAT - Impressions Analyzed (unfiltered for IVT) |
| number | MOAT - Impressions Analyzed (unfiltered for IVT) |
MOAT - Impressions Analyzed (filtered for IVT) |
| number | MOAT - Impressions Analyzed (filtered for IVT) |
MOAT - In-View Measurable Impressions |
| number | MOAT - In-View Measurable Impressions |
MOAT - Valid and Viewable Impressions |
| number | MOAT - Valid and Viewable Impressions |
MOAT - Valid and Viewable % |
| number | MOAT - Valid and Viewable % |
MOAT - Total In-View Time (ms) |
| number | MOAT - Total In-View Time (ms) |
MOAT - Average In-View Time (ms) |
| number | MOAT - Average In-View Time (ms) |
MOAT - Total Ad Length (ms) |
| number | MOAT - Total Ad Length (ms) |
MOAT - Complete In-View Impressions |
| number | MOAT - Complete In-View Impressions |
MOAT - Average Ad Length (ms) |
| number | MOAT - Average Ad Length (ms) |
MOAT - 1 Sec In-View Impressions |
| number | MOAT - 1 Sec In-View Impressions |
MOAT - 2 Sec In-View Impressions |
| number | MOAT - 2 Sec In-View Impressions |
MOAT - 3 Sec In-View Impressions |
| number | MOAT - 3 Sec In-View Impressions |
MOAT - 4 Sec In-View Impressions |
| number | MOAT - 4 Sec In-View Impressions |
MOAT - 5 Sec In-View Impressions |
| number | MOAT - 5 Sec In-View Impressions |
MOAT - 6 Sec In-View Impressions |
| number | MOAT - 6 Sec In-View Impressions |
MOAT - 7 Sec In-View Impressions |
| number | MOAT - 7 Sec In-View Impressions |
MOAT - 8 Sec In-View Impressions |
| number | MOAT - 8 Sec In-View Impressions |
MOAT - 9 Sec In-View Impressions |
| number | MOAT - 9 Sec In-View Impressions |
MOAT - 10 Sec In-View Impressions |
| number | MOAT - 10 Sec In-View Impressions |
MOAT - 11 Sec In-View Impressions |
| number | MOAT - 11 Sec In-View Impressions |
MOAT - 12 Sec In-View Impressions |
| number | MOAT - 12 Sec In-View Impressions |
MOAT - 13 Sec In-View Impressions |
| number | MOAT - 13 Sec In-View Impressions |
MOAT - 14 Sec In-View Impressions |
| number | MOAT - 14 Sec In-View Impressions |
MOAT - 15 Sec In-View Impressions |
| number | MOAT - 15 Sec In-View Impressions |
MOAT - 16 Sec In-View Impressions |
| number | MOAT - 16 Sec In-View Impressions |
MOAT - 17 Sec In-View Impressions |
| number | MOAT - 17 Sec In-View Impressions |
MOAT - 18 Sec In-View Impressions |
| number | MOAT - 18 Sec In-View Impressions |
MOAT - 19 Sec In-View Impressions |
| number | MOAT - 19 Sec In-View Impressions |
MOAT - 20 Sec In-View Impressions |
| number | MOAT - 20 Sec In-View Impressions |
MOAT - 21 Sec In-View Impressions |
| number | MOAT - 21 Sec In-View Impressions |
MOAT - 22 Sec In-View Impressions |
| number | MOAT - 22 Sec In-View Impressions |
MOAT - 23 Sec In-View Impressions |
| number | MOAT - 23 Sec In-View Impressions |
MOAT - 24 Sec In-View Impressions |
| number | MOAT - 24 Sec In-View Impressions |
MOAT - 25 Sec In-View Impressions |
| number | MOAT - 25 Sec In-View Impressions |
MOAT - 26 Sec In-View Impressions |
| number | MOAT - 26 Sec In-View Impressions |
MOAT - 27 Sec In-View Impressions |
| number | MOAT - 27 Sec In-View Impressions |
MOAT - 28 Sec In-View Impressions |
| number | MOAT - 28 Sec In-View Impressions |
MOAT - 29 Sec In-View Impressions |
| number | MOAT - 29 Sec In-View Impressions |
MOAT - 30 Sec In-View Impressions |
| number | MOAT - 30 Sec In-View Impressions |
MOAT - Complete In-View Impressions |
| number | MOAT - Complete In-View Impressions |
Video progress 1 second |
| number | Video progress 1 second |
Video progress 2 second |
| number | Video progress 2 second |
Video progress 3 second |
| number | Video progress 3 second |
Video progress 4 second |
| number | Video progress 4 second |
Video progress 5 second |
| number | Video progress 5 second |
Video progress 6 second |
| number | Video progress 6 second |
Video progress 7 second |
| number | Video progress 7 second |
Video progress 8 second |
| number | Video progress 8 second |
Video progress 9 second |
| number | Video progress 9 second |
Video progress 10 second |
| number | Video progress 10 second |
Video progress 11 second |
| number | Video progress 11 second |
Video progress 12 second |
| number | Video progress 12 second |
Video progress 13 second |
| number | Video progress 13 second |
Video progress 14 second |
| number | Video progress 14 second |
Video progress 15 second |
| number | Video progress 15 second |
Video progress 16 second |
| number | Video progress 16 second |
Video progress 17 second |
| number | Video progress 17 second |
Video progress 18 second |
| number | Video progress 18 second |
Video progress 19 second |
| number | Video progress 19 second |
Video progress 20 second |
| number | Video progress 20 second |
Video progress 21 second |
| number | Video progress 21 second |
Video progress 22 second |
| number | Video progress 22 second |
Video progress 23 second |
| number | Video progress 23 second |
Video progress 24 second |
| number | Video progress 24 second |
Video progress 25 second |
| number | Video progress 25 second |
Video progress 26 second |
| number | Video progress 26 second |
Video progress 27 second |
| number | Video progress 27 second |
Video progress 28 second |
| number | Video progress 28 second |
Video progress 29 second |
| number | Video progress 29 second |
Video progress 30 second |
| number | Video progress 30 second |
Display 1 second view |
| number | Display 1 second view |
Display 2 second view |
| number | Display 2 second view |
Display 3 second view |
| number | Display 3 second view |
Display 4 second view |
| number | Display 4 second view |
Display 5 second view |
| number | Display 5 second view |
Display 6 second view |
| number | Display 6 second view |
Display 7 second view |
| number | Display 7 second view |
Display 8 second view |
| number | Display 8 second view |
Display 9 second view |
| number | Display 9 second view |
Display 10 second view |
| number | Display 10 second view |
Display 11 second view |
| number | Display 11 second view |
Display 12 second view |
| number | Display 12 second view |
Display 13 second view |
| number | Display 13 second view |
Display 14 second view |
| number | Display 14 second view |
Display 15 second view |
| number | Display 15 second view |
Display 16 second view |
| number | Display 16 second view |
Display 17 second view |
| number | Display 17 second view |
Display 18 second view |
| number | Display 18 second view |
Display 19 second view |
| number | Display 19 second view |
Display 20 second view |
| number | Display 20 second view |
Display 21 second view |
| number | Display 21 second view |
Display 22 second view |
| number | Display 22 second view |
Display 23 second view |
| number | Display 23 second view |
Display 24 second view |
| number | Display 24 second view |
Display 25 second view |
| number | Display 25 second view |
Display 26 second view |
| number | Display 26 second view |
Display 27 second view |
| number | Display 27 second view |
Display 28 second view |
| number | Display 28 second view |
Display 29 second view |
| number | Display 29 second view |
Display 30 second view |
| number | Display 30 second view |
Estimated number of unique Teads IDs exposed to the ad |
| number | This metric is only compatible with specific dimensions & metrics (learn more) |
Aggregate amount of eyes on visual attention received by 1,000 impressions |
| number | Aggregate amount of eyes on visual attention received by 1,000 impressions, as estimated by Lumen attention models. |
Average amount of time - in seconds - that viewed ads were looked at |
| number | Average amount of time - in seconds - that viewed ads were looked at, as estimated by Lumen attention models. |
% of impressions receiving at least 1 eye fixation (minimum duration 100ms) |
| number | % of impressions receiving at least 1 eye fixation (minimum duration 100ms), as estimated by Lumen attention models. |
Scope3 - Ad Selection Emissions |
| number | 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) |
Scope3 - Creative Distribution Emissions |
| number | Emissions associated with the data transfer of the creative asset. Unit: grams of CO₂ equivalent (gCO₂e) |
Scope3 - Media Distribution Emissions |
| number | Media delivery including CMS; CDNs and hosting services; publishing overhead including employee and office expenses; data transfer. Unit: grams of CO₂ equivalent (gCO₂e) |
Scope3 - Media Consumer Device Emissions |
| number | 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) |
Scope3 - Creative Consumer Device Emissions |
| number | 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) |
Scope3 - Total Emissions |
| number | Sum of all the five emissions metrics above. Unit: grams of CO₂ equivalent (gCO₂e) |
Scope3 - Total Emissions Without Device |
| number | Sum of the Ad Selection, Creative Distribution and Media Distribution emissions metrics. Unit: grams of CO₂ equivalent (gCO₂e) |
Scope3 - Measured Impressions |
| number | Number of impressions for which the Scope3 API returned emissions. Unit: Impression |
Scope3 - Total Emissions per Mille |
| number | Carbon score per Mille including all the emissions metrics. Unit: grams of CO₂ equivalent per 1000 impressions (gCO2PM) |