TAM Reporting
Dimensions
Dimension API names for TAM Reporting.
Pass API names in the dimensions array, not TAM UI labels. The
glossary marks API names with **. Some fields exist only on the API (no
UI label).
Column titles in generated files can differ in casing from the Reporting
tab. That does not change the API name you send.
| API name | TAM label | Definition |
|---|
day | Day | Day of the data. |
hour | Hour | Hour of the data. |
week | Week | Week of the data. |
month | Month | Month of the data. |
year | Year | Year of the data. |
| API name | TAM label | Definition |
|---|
advertiser_id | Advertiser ID | Unique identifier of the advertiser. |
advertiser_name | Advertiser Name | Name of the advertiser. |
advertising_solution | Advertising Solution | Solution of the campaign (Clicks, Contextual Reachcast, Conversions, …). |
auction_has_advertiser_billable | Auction has Billable? | True if the auction billed. False negatives are possible, not false positives. |
turnover_currency | Budget Spent Currency | Currency of the budget spent. |
io_budget | Campaign Budget | Total budget booked for a campaign. |
io_currency | Campaign Currency | Currency of the campaign budget. |
ad_external_integration_code | Campaign External Integration Code | User-defined code for another reporting system. |
ad_id | Campaign ID | Unique identifier of the campaign. |
ad_external_name | Campaign Name | Name of the campaign. |
campaign_objective | Campaign Objective | Branding vs Performance. |
conversion_name | Conversion Name | Conversion event name from Events Manager. |
conversion_type | Conversion Type | Standardized event type (Lead, Purchase, Add to cart, …). |
io_line_end_date | Line End Date | End date of the line item. |
io_line_id_v3 | Line Group ID | Unique identifier of the line group. |
io_line_external_name_v2 | Line Group Name | Name of the line group. |
price_advertiser_event | Line Item Billable Event | Billing event (Start/Impression, Complete, Viewable Impression, Click). |
io_line_budget | Line Item Budget | Total budget booked for the line item. |
insertion_id | Line Item ID | Unique identifier of the line item. |
insertion_name | Line Item Name | Name of the line item. |
insertion_targeting_mode | Line Item Targeting Mode | Cookieless if forced to cookieless signals; otherwise standard. |
io_line_start_date | Line Start Date | Start date of the line item. |
ad_owner_id | Seat ID | Unique identifier of the seat. |
ad_owner_name | Seat Name | Name of the seat. |
ad_updated_at | (API only) | Last campaign-object update (YYYY-MM-ddTHH:mm:ss, report timezone). |
advertiser_updated_at | (API only) | Last advertiser-object update. |
io_line_updated_at | (API only) | Last line-group-object update. |
insertion_updated_at | (API only) | Last line-item-object update. |
Cookieless Delivery appears in the TAM UI (true if targeting used only
cookieless signals; available from 12 May 2023). The glossary does not
publish an API name for it.
| API name | TAM label | Definition |
|---|
creative_external_integration_code | Creative External Integration Code | User-defined code for another reporting system. |
format_creative_type_family_name | Creative Family | Family of the creative (Video, Viewable Display, …). |
creative_id | Creative ID | ID of the creative. |
creative_external_name | Creative Name | Name of the creative. |
creative_updated_at | (API only) | Last creative-object update. |
portfolio_item_name | Creative Portfolio Item | Commercial name of the creative. |
format_size_name | Creative Size | Landscape, Square, Vertical, … |
format_creative_type_name | Creative Type | Carousel, Scroller, … |
placement_format_integration_type | Position | in Article, instream, … |
studio_action | Studio Action | Custom Studio actions (for example Click on Endscreen). |
studio_creative_id | Studio Creative ID | Unique identifier of the Studio creative. |
studio_segment | Studio Segment | Personalization segment for dynamic creatives. |
business_common_video_or_display | Video or Display | Video or display. |
| API name | TAM label | Definition |
|---|
deal_currency | Deal Currency | Currency of the deal (USD, EUR, …). |
deal_id_key | Deal ID Key | Identifier shared by the publisher or exchange. |
deal_rate_cpm | Deal Rate CPM | Minimum or fixed CPM for the inventory. |
deal_rate_type | Deal Rate Type | Rate type (Fixed or Dynamic). |
Available from 1 April 2024. Location is inferred from IP address.
| API name | TAM label | Definition |
|---|
country_code | Country Code | ISO 3166-1 alpha-2. |
country_name | Country Name | Country where the user saw the ad. |
city_name | City Name | City where the user saw the ad. |
dma_code | Market Area Code | Market area code. |
dma_name | Market Area Name | Market area name. |
postal_code | Postal Code | Postal code. |
region_code | Region Code | Region code. |
region_name | Region Name | Region name. |
Precision, most to least: country, region, market area, city, postal code.
| API name | TAM label | Definition |
|---|
app_bundle_id | App Bundle ID | Application store identifier. |
app_name | App Name | Application name. |
app_platform | App Platform | OS where the application is used. |
channel | Channel | Web & Mobile App, or CTV. |
website_domain | Website Domain | Domain where the ad was delivered. |
website_or_app | Website or App | Website domain, or App Name / Platform / Bundle ID for CTV. |
| API name | TAM label | Definition |
|---|
browser | Browser | Browser name. |
browser_version | Browser Version | Browser version. |
device | Device | Desktop, Smartphone, … |
operating_system | Operating System | Operating system of the device. |
| API name | TAM label | Notes |
|---|
io_line_id | Line ID | Use Line Group ID (io_line_id_v3) instead. |