Contact support

Report dimension reference

Overview

This article provides definitions of the dimensions available in the EMP reporting tools Instant Insights and Instant Report Builder.

Report dimension definitions

Dimensions in Instant Insights and Instant Report Builder are organized by view (e. g. Programmatic view, as shown in the screenshot below). Consider switching the view if you cannot find a metric.

Dimension name* Dimension definition Data retention (days)**
Ad Break Type Id/Name The type of in-stream video ad break (pre-roll, mid-roll, post-roll). 40/400
Adserving Creative External Description The external description of a creative from a direct insertion. Unlimited
Adserving Creative Id/Name The creative, as specified in the "Creatives" section in direct insertions. Unlimited
Adserving Creative Weight The weight (in bytes) of the creative in a direct insertion. Unlimited
Advertiser Domain The domain of the programmatic advertiser. Unlimited
Advertiser Domain Category The category, a programmatic advertiser's domain belongs to.  Unlimited
Advertiser Id/Name The advertiser, as specified under Administration > Advertisers. Unlimited
Agency Id/Name The agency, as specified under Administration > Agencies. Unlimited
Allowed To Use Geolocation Data The permission (1) or prohibition (0) to use users' geolocation data, as per consent (not) given under the GPP/GDPR/CCPA frameworks. 40/400
Allowed To Use Personal Data The permission or prohibition to use users' personal data, as per consent (not) given under the GPP/GDPR/CCPA frameworks. 40/400
App/Site Domain

The publisher domain:

  • in case of (mobile) web: the site domain (no http://, no www, no query string parameters)
  • in case of app: the app bundle Id

Direct campaign data is approximate as the data for this dimension is sampled.

40/400
App/Site Id/Name The site or app, as defined under Inventory > Sites & Pages. Unlimited
App Site URL The URL of the site, app or TV channel. Unlimited
AppBundle The app bundle name (video auctions). 40/400
ATT Status/ATT Status Id

The authorization status to access app related data, as specified by Apple's App Tracking Transparency (ATT) framework. 

  • -1 – ATT Not Supported (for older SDKs that do not recognize ATT)
  • 0 – Not Determined
  • 1 – Restricted
  • 2 – Denied
  • 3 – Authorized 
40/400
Audience Segment Id

The Id of an audience targeting segment.

Direct campaign and programmatic data is approximate as the data for this dimension is sampled.

Unlimited
Bid Status Id/Name The status of bids in the auction process. This dimension is helpful when troubleshooting RTB – use the RTB Health tool for further investigations. This dimension can only be used in combination with some bid related metrics (e. g. with the "Bids" or "Bid Requests" metric). Unlimited
Browser Id/Name The end user's browser that calls an ad from Equativ. Unlimited
Campaign Id/Name The campaign, as specified under Campaigns > Campaign list. Unlimited
Campaign Traffic Manager The Id of the traffic manager associated with the campaign. Unlimited
City Id/Name The city the traffic is coming from; determined based on the IP address. 40/400
CMP Id The Id of the Consent Management Platform (CMP) used to retrieve the end users' consent to data processing, in compliance with privacy regulations. Unlimited
Consent String Status Id/Name

The status of the TCF consent string (GDPR):

  • -1 – N/A (malformed/invalid)
  • 0 – Empty
  • 1 – Ok
  • 2 – Fallback consent connected TV (more details about the TCF consent string on connected TV devices in chapter "Passing TCF consent signals to Equativ" in Comply with Global Privacy Platform (GPP).
  • 3 – N/A (the Consent Management Platform (CMP) which provided the consent string is not a registered member of the IAB Europe's Transparency & Consent Framework)
40/400
Country Id/Name The country the traffic is coming from; determined based on the IP address.  Unlimited
CPM Net / CPC Net The net CPM/CPC, as specified on direct insertion level, in the "Net Rate" field. Unlimited
Creative File Name The file name of a creative from a direct insertion. Unlimited
Creative Size

The size (width and height in pixels) of the RTB creative that won the Equativ auction.

At bid level, the size of the creative that won the auction globally.

Unlimited
Day The day dimension. Unlimited
Deal Id/Name The Deal (Private Auction, Preferred Deal, Programmatic Guaranteed Deal, Auction package); Auction Package deals are listed with the generic label “Auction Package” – each “Auction Package” row represents a deal that is running on your network as part of Equativ’s Auction Package offer. Unlimited
Deal Internal ID The Equativ internal deal Id.  Unlimited
Delivery Channel

The monetization channel:

  • RTB – programmatic monetization
  • Header bidding – monetization through header bidding
  • Direct – monetization through direct campaigns (direct insertions)
Unlimited
Device Model Id/Name The device model e. g. "iPhone". 40/400
Device Type Id/Name The device type (Desktop, Tablet, Smartphone etc.). Unlimited
Device Vendor Id/Name The device manufacturer/producer, e. g. "Apple". 40/400
Dsp Id/Name The DSP. Unlimited
Environment Type Id/Name

The environment type:

  • 0 – Web
  • 1 – Mobile Web
  • 2 – App
Unlimited
Extended Ids The presence of one or multiple extended Ids in the ad call. The report shows the Ids of extended id providers (see list of providers with the provider IDs in chapter "Logging" in the Extended ID integration (alternative/universal IDs) article. A row in the report containing multiple provider Ids (e. g. "4,5") represents the case where extended Ids of multiple providers were sent in the same ad call (e. g. Identity Link ("4") and ID5 ("5")). 40/400
Format Description The type of format/impressions: 0 - Banner; 1 - VideoInStream; 2 - Native; 3 - VideoOutStream; 4 - Unknown; 5 - Audio.  
Format External Id The external Id to identify a format in third party systems. Unlimited
Format Height The height of the format (in pixels). Unlimited
Format Id/Name The format, as specified under Inventory > Formats. Unlimited
Format Size The format height/width.  
Format Type Id/Name

The programmatic format type:

  • 0 – Display
  • 1 – Video InStream
  • 2 – Native
  • 3 – Video OutStream
Unlimited
Format Width The width of the format (in pixels). Unlimited
GDPR Applies

The applicability of the GDPR legislation:

  • 0 – GDPR does not apply (ad call does not come from EU territory)
  • 1 – GDPR applies (ad call comes from EU territory)
40/400
Has Buyer Uid The presence or absence of the Buyer Uid in the call; the Buyer Uid is stored on the user’s browser by the DSP through a third-party cookie and is shared with Equativ via cookie-sync. This way, Equativ can link its own Pid with the Buyer Uid and send the latter to the DSP when necessary. 40/400
Has User Pid The presence or absence of Equativ's Pid in the ad call; the Pid is Equativ's own proprietary user identifier assigned to each user. 40/400
Has User Uid The presence or absence of the User Uid in the ad call; the Uid is a 1st party user identifier generated by a publisher on the website. 40/400
Header Bidding Partner  The Header Bidding SSP in unified auction and  managed unified auction integrations. Unlimited
Header Bidding Type Id/Name

The type of Header Bidding mechanism:

  • 0 – No Header Bidding 
  • 1 – Client Side Header Bidding
  • 2 – Server Side Header Bidding
Unlimited
Hour The hour dimension. Unlimited
Insertion Currency Symbol The currency symbol of the currency specified in a direct insertion, such as USD or EUR. If no currency is specified in the insertion, the network currency is used.  Unlimited
Insertion Description The description of the insertion. Unlimited
Insertion End Date The end date of the insertion. Format:YYYY-MM-DDTHH:MM:SS.fffff. Unlimited
Insertion External Description The external description of the insertion, describing the insertion in a third party system. Unlimited
Insertion External Id The external Id of the insertion, identifying the insertion in a third party system. Unlimited
Insertion Id/Name The insertion that was selected, following the ad call. Unlimited
Insertion Period The insertion period (from start to end date).  
Insertion Priority The insertion priority: Very Low, Low, Normal, High, Exclusive.  
Insertion Start Date The start date of the insertion. Format:YYYY-MM-DDTHH:MM:SS.fffff. Unlimited
Insertion Type Id/Name The insertion type, as specified under AdministrationInsertion type. 40/400
Internet Service Provider (ISP) The Internet Service Provider.  
Is AMP A dimension indicating if the traffic (ad calls) is coming from an Accelerated Mobile Page (AMP). 40/400
Is Auction Packages A dimension indicating if a deal is an Auction Package deal. Auction packages serve as an additional source of programmatic demand, bundling open auction inventory and predefined targeting criteria, curated by Equativ or other parties across multiple publishers. Unlimited
Is Autopromotion A boolean indicating if an advertiser is set up as an "In-house Ad" advertiser. The campaigns/insertions created under an "In-house Ad" advertiser are used to fill unsold inventory with ads advertising for a publisher’s own products/services etc. Unlimited
Is Rewarded A dimension indicating if the user is being rewarded after viewing an ad (e. g. free access to a news article, extra life in a game, ad-free music session). Unlimited
Keywords

The keywords (keys or key=values) from the publisher site/app that were passed in the ad call. This dimension requires filtering specific keys / key=values (max. 3 keys/key=values).

Direct campaign and programmatic data is approximate as the data for this dimension is sampled.

The Keywords dimension is not compatible with viewability metrics. 

40/400
Maestro Company Id/Name The Maestro company (formerly “SBC company"), corresponding to a curator buying or reselling inventory from Equativ inventory suppliers. Unlimited
Month The month dimension. Unlimited
OS Id/Name The operating system of the device that called the ads. Unlimited
Pack Id/Name The pack, as specified under Inventory > Packs. Unlimited
Page Id/Name The page, as specified under Inventory > Sites & Pages.  Unlimited
Page URL The URL of the page. Unlimited
Partner Id/Name The demand partner connected to Equativ through the OpenRTB protocol.  A partner is a DSP or an aggregator of DSPs. Unlimited
Platform Store Id/Name The platform of the connected TV app store, e. g. SamsungSmartTV. 40/400
Position In AdBreak The position of an in-stream video ad within an ad break. Unlimited
SDK Version Id/Name The version of the Equativ mobile SDK. Unlimited
Seat Id The seat Id; a seat is an account in a DSP enabling an agency, trading desk or direct advertiser to participate in the programmatic marketplace. 40/400
Seat Internal Id The Equativ internal seat Id; a seat is an account in a DSP enabling an agency, trading desk or direct advertiser to participate in the programmatic marketplace. Unlimited
Seat Name The seat name; a seat is an account in a DSP enabling an agency, trading desk or direct advertiser to participate in the programmatic marketplace. Unlimited
Server Side Bidding Caller Id/Name The entity that calls Equativ with the according wrapper in a Server side bidding integration; callers include Amazon TAM, Google, PrebidServer etc. Unlimited
State Id/Name The state the traffic is coming from; determined based on the IP address. 40/400
Template Id/Name The creative template selected in insertions in the “Creatives” section. 40/400
Video Content Category The category of the publisher content where in-stream video ads are shown; passed in the ad call using the ctc parameter. 40/400
Video Content Duration The duration of the publisher content where in-stream video ads are shown; passed in the ad call using the ctd parameter. 40/400
Video Content Id The Id of the publisher content where in-stream video ads are shown; passed in the ad call using the ctid parameter. 40/400
Video Content Tags The tags that describe the publisher content where in-stream video ads are shown; passed in the ad call using the ctk parameter. Unlimited
Video Content Title The title (name) of the publisher content where in-stream video ads are shown; passed in the ad call using the ctn parameter. Unlimited
Video Content Type The type of publisher content where in-stream video ads are shown; passed in the ad call using the ctt parameter. Unlimited
Video Error Code Id/Name The code of an error that occurred in a video ad (see Video error code reference) 40/400
Video Integration Type Id/Name The type of out-stream video/in-stream video integration 0 – N/A 1 – Instream Plugins 2 – Instream Embedded Ad Manager 3 – Outstream synchronous formats (obsolete) 4 – Outstream asynchronous formats 40/400
Video Placement Type Id/Name

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
40/400
Video Playback Method

The way a video ad is played (start automatically, with/without sound etc.):

  • 0 – Unknown
  • 1 – AutoPlaySoundOn
  • 2 – AutoPlaySoundOff
  • 3 – ClickToPlay
  • 4 – MouseOver
  • 5 – EnterViewportSoundOn
  • 6 – EnterViewportSoundOff
Unlimited
Video Player Height The height of the video player (in pixels) that played a programmatic video ad. Unusual sizes (e. g. "0") may indicate implementation errors (see Video error code reference). 40/400
Video Player Size Bucket Id/Name

The static size of the video player, grouped into the following buckets:

  • No size – both player width and player height equal to or less than 0
  • Small – Desktop: less than 400x225; Mobile: less than 20% of screen covered
  • Large – Desktop: between 400x225 and 1280x720; Mobile: between 21% and 90% of screen covered
  • Extra Large – Desktop: greater than 1280x720; Mobile: more than 91% of screen covered
  • Not categorized – width between 1 and 49 or height between 1 and 29; any other sizes that do not match with the buckets Small, Large or Extra Large;

A "No size" or "Not categorized" player size indicates a technical or configuration-related problem that requires further investigation. To determine the exact size, use the Video Player Width and Video Player Height dimensions.

40/400
Video Player Width The width of the video player (in pixels) that played a programmatic video ad. Unusual sizes (e. g. "0") may indicate implementation errors (see Video error code reference). 40/400
Video CMS The video content management system of the publisher content where in-stream video ads are shown; passed in the ad call using the ctmsid parameter or synchronized using the Video content metadata API. Unlimited
Week The week dimension. Unlimited
Winner Deal Type Id/Name

The type of deal that won the auction:

  • 0 – OpenAuction (i. e. no deal)
  • 1 – PrivateAuction
  • 2 – DirectDeal
  • 3 – ProgrammaticGuaranteed
  • 4 – AuctionPackage
Unlimited

* Dimension name

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 instance, the "Campaign Id" / "Campaign Name" dimension in Instant Report Builder is called "Campaign" in Instant Insights. In the table above, such dimensions are listed in the format "[Dimension name] Id/Name" (for instance: "Campaign Id/Name").

  ** Data retention

  • 40/400: Data retention is 40 days for the free reporting plan or 400 days for the premium reporting plan.
  • Unlimited: Data retention is unlimited.

Read more about data retention in section “Reporting plans and data retention” in Create reports with Instant Report Builder.

.