Report dimensions
Overview
This article provides definitions for the dimensions available in Maestro’s Instant Insights, Instant Report Builder, and Reporting API.
Dimensions
Dimensions in Instant Insights and Instant Report Builder are organized by views. Consider switching the view if you cannot find a dimension.
Dimension names and definitions
| Dimension name in the Instant Report Builder¹ |
Dimension name in the Reporting API |
Dimension definition |
|---|---|---|
| Ad Break Type Id/Name | adBreakTypeId² / adBreakTypeName | The type of in-stream video ad break (pre-roll, mid-roll, post-roll). |
| Advertiser Domain | The domain of the advertiser, whose ad was served. | |
| App/Site Domain | appOrSiteDomain | The publisher domain. In case of (mobile) web, it is the site domain (no http://, no www, no query string parameters). In case of app, it is the app bundle ID. |
| App/Site Id/Name | appOrSiteId / appOrSiteName | The publisher site/app, as defined in Equativ’s Monetization Platform (Equativ SSP). |
| Auction Package Deal Id | AuctionPackageExternalDealId (previously called dealId) | The deal ID of an Auction package deal. Auction packages are created and managed by Equativ or by curators/buyers using the Maestro platform. |
| Auction Package Internal Id | AuctionPackageDealId (previously called internalDealId) | The Equativ internal deal ID of an Auction package deal. Auction packages are created and managed by Equativ or by curators/buyers using the Maestro platform. |
| Auction Package Name | AuctionPackageDealName (previously called dealName) | The name of an Auction package deal. Auction packages are created and managed by Equativ or by curators/buyers using the Maestro platform. |
| Billed Audience Segment Id/Name | BilledAudienceSegmentId / BilledAudienceSegmentName | The audience segment billed by Equativ.³ |
| Billed Audience Segment Provider Id/Name | BilledAudienceSegmentProviderId / BilledAudienceSegmentProviderName | The provider of the audience segment billed by Equativ.³ |
| Billed Semantic Segment Id/Name | BilledSemanticSegmentId / BilledSemanticSegmentName | The semantic segment billed by Equativ.³ |
| Billed Semantic Segment Provider Id/Name | BilledSemanticSegmentProviderId / BilledSemanticSegmentProviderName | The provider of the semantic segment billed by Equativ.³ |
| Browser | browserParentId, browserParentName | The browser. |
| Campaign / CampaignId | The campaign, as configured in the Activation module. | |
| Cookieless targeting | isUserIdLess |
The traffic without cookie-based user IDs or mobile IDs: 0: a deal has been delivered to inventory that is not cookieless or not mobile ID-less. 1: a deal has been delivered to cookieless or mobile ID-less inventory. |
| Company Id/Name | The company in the Maestro platform. Each company has an associated set of users, buyer seats, and deals. | |
| Consent String Status Id/Name | consentStringStatusId² |
The status of the TCF consent string (GDPR): -1: N/A (malformed/invalid) 0: Empty 1: Ok 2: Fallback consent for Connected TV (CTV). This is a simplified consent string used in CTV apps, where consent to or rejection of all Purposes, Features, and Special Features is sent. In most CTV environments, granular consent by Purpose, Feature, or Special Feature isn't supported due to the absence of a CMP. |
| Content Category | The content category, as specified in the IAB content taxonomy, for example, "IAB2". | |
| Content Context / Content Context Name |
The content context: 1: Video 2: Game 3: Music 4: Application 5: Text 6: Other 7: Unknown |
|
| Content Genre | The content genre, for example, "comedy". | |
| Content Id | The content identifier. | |
| Content Language | The content language, following ISO 639-1 specification, for example, "en". | |
| Country Id/Name | countryId² / countryName | The country the traffic is coming from. It is determined based on the IP address. |
| Creative / Creative Id | The creative, as configured in the Activation module. | |
| Creative Size | creativeSize | The size (in pixels) of the delivered creative (width and height). |
| Day | The day dimension. | |
| Device Type Id/Name | deviceTypeId² / deviceTypeName |
The device type: 0: N/A 1: Desktop 2: Smartphone 4: Tablet 8: TV 16: Other connected device 32: Set Top Box 64: Game console |
| Environment Type Id/Name | environmentTypeId² / environmentTypeName |
The environment type: 0: Web 1: Mobile Web 2: App |
| Format Type Id/Name | formatTypeId² / formatTypeName |
The format type: 0: Display 1: Video InStream 2: Native 3: Video OutStream |
| GDPR Applies | gdprApplies |
The applicability of the GDPR legislation: 0: GDPR doesn't apply (ad call doesn't come from EU territory) 1: GDPR applies (ad call comes from EU territory) |
| Header Bidding Type Id/Name | headerBiddingTypeId² / headerBiddingTypeName |
The type of Header Bidding mechanism: 0: No Header Bidding 1: Client Side Header Bidding 2: Server Side Header Bidding |
| Hour | The hour dimension. | |
| Is Rewarded | A dimension indicating whether the user is rewarded after viewing an ad (for example, free access to a news article, an extra life in a game, or an ad-free music session). | |
| Line Item / Line Item Id | The line item. Line items are created within a campaign and contain the creatives and the delivery settings, such as bid price, start/end date, frequency capping. | |
| Max Ad Duration Bucket Id/Name |
The maximum ad duration, as requested by publishers in bid requests, expressed in the following duration buckets: 0: N/A 1: Short (0 - 15 seconds) 2: Medium (16 - 30 seconds) 3: Long (31 seconds to 60 seconds) 4: Extra_long (61 seconds and longer) |
|
| Month | The month dimension. | |
| Partner Id/Name | partnerId² / partnerName | The demand partner connected to Equativ. A partner is a DSP or an aggregator of DSPs. |
| Platform Store Id/Name | The app store of the platform (smartphone, tablet, connected TV); for example, "Samsung Smart TV". | |
| Position in Ad Break | The position of an in-stream video ad within an ad break. | |
| Publisher Id/Name | publisherId² / publisherName | The publisher in the Equativ Monetization Platform (also referred to as "Network"). |
| Seat Id/Name | seatId / seatName | The external Buyer seat Id/name, used on both supply and demand side. |
| Seat Internal Id | The Equativ internal seat ID. | |
| Server Side Bidding Caller Id/Name | serverSideBiddingCallerId² / serverSideBiddingCallerName |
The type of Header Bidding mechanism: 0: No Header Bidding 1: Client Side Header Bidding 2: Server Side Header Bidding |
| Skippable Id/Name |
A dimension indicating if the in-stream/out-stream video inventory is skippable or non-skippable. Possible values: -1: unknown 0: No 1: Yes |
|
| Targeted Audience Segment Id/Name | TargetedAudienceSegmentId / TargetedAudienceSegmentName | The audience segment that matched with an audience segment targeted by a deal.⁴ |
| Targeted Audience Segment Provider Id/Name | TargetedAudienceSegmentProviderId / TargetedAudienceSegmentProviderName | The provider of the audience segment that matched with an audience segment targeted by a deal.⁴ |
| Targeted Deal Id/Name | The deal (with its settings) that is targeted by another deal. | |
| Targeted Deal Internal Id | The Equativ internal ID of the deal (with its settings) that is targeted by another deal. | |
| Targeted Semantic Segment Id/Name | TargetedSemanticSegmentId / TargetedSemanticSegmentName | The semantic segment that matched with a semantic segment targeted by a deal.⁴ |
| Targeted Semantic Segment Provider Id/Name | TargetedSemanticSegmentProviderId / TargetedSemanticSegmentProviderName | The provider of the semantic segment that matched with a semantic segment targeted by a deal.⁴ |
| Template Id/Name | templateName | The creative template used by publishers in the Equativ Monetization Platform. Creative templates determine the way a creative is displayed (for example, as an Interstitial, Parallax). |
| templateVersionId² | ||
| Video Placement Type Id/Name | videoPlacementTypeId² / videoPlacementTypeName |
The type of placement for programmatic video ads: 0: No Placement Type 1: In-Stream 2: In-Banner 3: In-Article 4: In-Feed 5: Interstitial/Slider/Floating |
| Video Player Height | videoPlayerHeight | The height of the video player (in pixels) that played a programmatic video ad. |
| Video Player Size Bucket Id/Name | videoPlayerSizeBucketId² / videoPlayerSizeBucketName |
The static size of the video player is grouped into the following buckets: 0: N/A – Not applicable 1: NoSize – Both player width and height are less than or equal to 0 2: Not Categorized – Width between 1 and 49 pixels or height between 1 and 29 pixels; or any other size that doesn’t fit the Small, Large, or Extra Large categories 3: Small – Desktop: Less than 400×225 pixels Mobile: Covers less than 20% of the screen 4: Large – Desktop: Between 400×225 and 1280×720 pixels. Mobile: Covers 21% to 90% of the screen 5: Extra Large – Desktop: Greater than 1280×720 pixels Mobile: Covers more than 91% of the screen
A "NoSize" or "Not Categorized" player size usually indicates a technical or configuration issue that should be investigated. To determine the exact dimensions, refer to the Video Player Width and Video Player Height fields. |
| Video Player Width | videoPlayerWidth | The width of the video player (in pixels) that played a programmatic video ad. |
| Week | The week dimension. | |
| Winner Deal Type Id/Name | winnerDealTypeId² / winnerDealTypeName |
The type of deal that won the auction: 0: OpenAuction (that is, no deal) 1: PrivateAuction 2: DirectDeal 3: ProgrammaticGuaranteed 4: AuctionPackage |
¹ For most dimensions, Instant Report Builder provides both an "Id" dimension and a "Name" dimension. In Instant Insights, the same dimension is named without "Id" or "Name". For example, the "Environment Type Id" / "Environment Type Name" dimension in Instant Report Builder is called "Environment Type" in Instant Insights. In the table above, such dimensions are mentioned according to the pattern "[Dimension name] Id/Name" (for example, "Environment Type Id/Name").
² IDs defined by and specific to Equativ. In the Report API, if needed, these IDs can be mapped to custom IDs, but the mapping cannot be stored on Equativ’s side.
³ The "Billed …" dimensions represent segments that are billed by Equativ. For more information, see "Total cost" in the Audience targeting and Semantic and performance targeting articles. Note that segments without any fee (free segments, Total cost: 0) aren't included in this dimension. To report on free segments, use the "Targeted …" dimensions.
⁴ The "Targeted …" dimensions represent the segments that matched with a segment targeted in a deal, and therefore, resulted in the delivery of the deal. Note that in case of a deal targeting multiple audience/semantic segments, there can be more than one matching audience/semantic segment that resulted in the delivery of the deal. For example, if a deal targets audience segments A, B, and C, and if it was delivered to a user belonging to segment A and B, then this deal will be included in the Targeted Audience Segment A and B.