Dimensions¶

This article describes the dimensions of data returned by the Verizon Media DSP API.

Overview¶

A dimension is an attribute of data. A dimension may represent an attribute of a consumer, segment, campaign, ad, or line. For example, the MobileOs dimension tracks the operating system (Android, iOS, etc.) of consumer mobile devices. Compare with Metrics

In the Verizon Media DSP Reporting API, all report dimensions are identified by a unique dimension type ID. You can run reports on dimensions of data by specifying one or more report dimension IDs in the dimensionTypeIds array of a request.

Several dimension types return multiple report fields. For example, a request that specifies the Ad dimension (7) returns two fields: the ID and the Name of the ad.

You must specify at least one dimension type ID in every Reporting API request.

Dimension Types¶

A dimension may or may not be returned in a report depending on whether you have Seat access or GAN access to the Verizon Media DSP platform.

Seat Access
GAN Access

The table lists DSP Reporting API dimension types by dimension type ID, shows the dimensions that are returned for each dimension type, and indicates whether the dimension type is available to clients with seat or GAN access.

Dimension Type ID	Dimension Type	Description	Seat Access	GAN Access	Limitations
1	Publisher	Returns two dimensions: the ID and name of the publisher. Publisher ID: An integer that specifies the publisher ID number. Publisher: The name of publisher, the supply source that maintains the website or other inventory type with ad space for sale to advertisers	Y	N
3	Layout	Returns two dimensions: the ID and name of the layout. Layout ID: An integer that specifies the layout ID. Layout: A string that specifies the name of the layout expressed in terms of its dimesnions. For example, `300x250`.	Y	Y
4	Advertiser	Returns two dimensions: the ID and name of the advertiser. Advertiser ID: An integer that specifies the advertiser ID number. Advertiser: A string that specifies the name of the advertiser.	Y	Y
5	Campaign	Returns two dimensions: the ID and name of the campaign. Order ID: An integer that specifies the campaign ID. Order: A string that specifies the name of the campaign.	Y	Y
6	Line	Returns two dimensions: the ID and name of the line. Line ID: An integer that specifies the line ID. Line: A string that specifies the name of the line.	Y	Y
7	Ad	Returns two dimensions: the ID and name of the ad. Ad ID: An integer that specifies the ad ID. Ad: A string that specifies the name of the ad.	Y	Y
8	Creative	Returns two dimensions: the ID and name of the creative. Creative ID: An integer that specifies the the creative ID. Creative Name: A string that specifies the creative name.	Y	N
9	Domain	Returns the unique Internet address for a website.	Y	N
14	Advertiser Category ID	Returns the advertiser category ID as defined by the trafficker.	Y	N
19	Country	Returns two dimensions: the ID and name of the country. Country ID: An integer that specifies the country ID. Country: A string that specifies the name of the consumer’s country.	Y	N
20	Region	Returns the name of the consumer’s region or state.	Y	N
21	City	Returns two dimensions: the ID and name of the city. City ID: An integer that specifies the city ID of the consumer’s city. City: A string that specifies the name of the consumer’s city.	Y	N
22	Postal Code	Returns the consumer’s zip or postal code. Zip/Postal Code: A string that specifies the consumer’s zip code or postal code.	Y	Y
23	Device Category	Returns two dimensions: the ID and name of device category. Device Category ID: An integer that specifies the device category ID. Device Category Name: A string that specifies the name of the mobile operating system.	Y	N
25	Browser Type	Returns two dimensions: the ID and name of the browser type. Browser Type ID: An integer that specifies the ID of the browser type. Browser Type Name: A string that specifies the name of the consumer’s browser.	Y	N
26	Desktop OS	Returns two dimensions: the ID and name of the consumer’s operating system. OS ID: An integer that specifies the OS ID. OS Name: A string that specifies the OS name. Possible values: `Mac OS X` `Windows` `Linux` `Unknown`	Y	N
27	Age	Returns two dimensions: the ID and age range. Age ID: An integer that specifies the age ID. Age: A string that specifies the name of the age group expressed as an range of ages. For example, `25-34`. Possible values: `0` : `18-20` `1` : `21-24` `2` : `25-34` `3` : `35-44` `4` : `45-49` `5` : `50-54` `6` : `55-64` `7` : `65+` `9` : `UNKNOWN`	Y	N
28	Gender	Returns two dimensions: the ID and name of the gender. Gender ID: An integer that specifies the gender ID. Gender: A string that specifies the gender of the segment. Possible values: `0` : `Unknown` `1` : `Male` `2` : `Female`	Y	N
31	Ad Position	Returns the location on the page where the ad is displayed.	Y	N
34	Device Type	Returns the device type used by the consumer. Possible values: `Desktop` `Digital-Out-Of-Home` `Phone` `Tablet` `Unknown`	Y	N
39	Targeted Audience	DEPRECATED Use `Target Segment` dimension type (`104`) instead.	Y	N
42	Advertiser Sub-Category	Returns two dimensions: the ID and name of the advertiser subcategory in the IAB Taxonomy. Advertiser Sub-Category ID: An integer that specifies the advertiser subcategory ID. Advertiser Sub-Category: A string that specifies the name of the advertiser subcategory.	Y	N	500,000 row limit per report
46	Pixel	Returns two dimensions: the beacon ID and name of a conversion rule. Beacon ID: An integer that specifies the beacon ID of the conversion rule. Beacon: A string that specifies the name of the conversion rule.	Y	Y
47	Subdomain	Returns a subdomain of a site such as a regional property or subsite that is distinguished from a parent site. For example, `att.yahoo.com` or `tw.finance.yahoo.com`.	Y	N
50	Exchange Deal ID	Returns two dimensions: the deal ID and name of the exchange deal received from the supply partner to uniquely identify a supply slice. Deal ID: An integer that specifies the deal ID. Exchange Deal ID: A string that specifies the name of the deal	Y	N
55	App Name	Returns name of an iOS or Android app.	Y	Y
56	Seat	Returns the seat ID. Advertisers with the appropriate privileges may access and return advertising data from multiple seats. To learn more, see seats.	Y	Y
63	Media Type	Returns two dimensions: the media type ID and name. Media Type ID: An integer that specifies the media type ID. Media Type: A string that specifies the media type name. Possible values: `1` : `Display` `2` : `Video` `3` : `Native` `4` : `Audio`	Y	N
64	Advertiser Group	Returns an advertiser group, a logical grouping of advertisers as defined by a seat. Available only if the seat has at least one advertiser group registered.	Y	N
67	Goal Type	Returns two dimensions: the ID and name of the line’s goal type. Goal Type: An integer that specifies the goal type ID. Goal: A string that specifies the goal type name. Possible values: `1` : `None` `2` : `CPC` `3` : `CPA` `4` : `CPCV` `5` : `VCPM` `6` : `ROAS` `7` : `Maximize Viewability` `8` : `Maximize Completion Rate` `9` : `Viewability` (hard threshold) `10` : `Maximize CTR` `11` : `Completion Hard Threshold` `12` : `AVOC Hard Threshold` `13` : `Maximize AVOC Rate` `14` : `Maximize GroupM viewability rate` `15` : `eCPM` `16` : `CPI` `17` : `Publisher Bidder Optimization Goal` `18` : `"Cost Per Custom Completion Goal`	Y	N
73	Line Billing Method	Returns two dimensions: the ID and the name of the Line Billing Method. Line Billing Method: An integer that specifies the line billing method ID. Line Billing Method: A string that specifies the line billing method name. Possible values: `Default` `1` : `Profit Margin` `2` : `CPM Price` `3` : `CPC` `CPCV`	Y	N
75	Market Area	Returns two dimensions: the ID and name of the Nielsen Designated Marketing Area. Market Area ID: An integer that specifies the ID of the DMA. Market Area: A string that specifies the name of the DMA.	Y	N
103	Pixel Parameter	Returns the Pixel Query String, the parameters passed to a pixel query.	Y	N
104	Target Audience Id : Group A	Returns two dimensions: the ID and name of the targeted segment. Target Segment ID: An integer that specifies the ID of the targeted segment. Target Segment: A string that specifies the name of the targeted segment.	Y	Y
106	Inventory Type	Returns the name of the inventory type. Options include: `App` `Web`	Y	N
107	Bucketed Age	Returns two dimensions: the ID and age range. The Age ID is an integer that specifies the age ID. The Age is a string that specifies the name of the age group expressed as a range of ages. Options include: `0` : `18-20` `1` : `21-24` `2` : `25-34` `3` : `35-44` `4` : `45-49` `5` : `50-54` `6` : `55-64` `7` : `65+` `9` : `UNKNOWN`	Y	Y
128	Creative Custom ID	The custom ID set by an advertiser for the creative. Requires Creative (Dimension 8) also in the request for creative custom ID to work.	Y	Y
149	Package	The package name and ID.	Y	N
150	Exchange Deal ID	Returns two dimensions: the deal ID and name of the exchange deal received from the supply partner to uniquely identify a supply slice. Deal ID: An integer that specifies the deal ID. Exchange Deal ID: A string that specifies the name of the deal NOTE Replaces Dimension 50 which is deprecated.	Y	N
151	Dot Rule	Returns the dot rule ID.	Y	Y
153	Connected TV Device	A filter to distinguish between the CTV device types “Smart TV” or “Streaming Device.”	Y	Y	For connected TV lines only.
155	Supply Group	Returns the gemini supply group, i.e., `GROUP_1_DESKTOP`, `GROUP_1_MOBILE`, `GROUP_2_DESKTOP`, `GROUP_2_MOBILE`, `GROUP_3_DEKSTOP`, `GROUP_3_MOBILE`.	Y	Y
165	Target Audience Id : Group B	Returns two dimensions: the ID and name of the targeted segment. `Target Segment ID`: An integer that specifies the ID of the targeted segment. `Target Segment`: A string that specifies the name of the targeted segment.	Y	Y
174	Creative Format	Returns the creative format ID.	Y	Y
175	Site Name	Returns the Gemini site name ID.	Y	Y
183	Site Group Name	Returns the Gemini site group ID.	Y	Y
1116	Content Show	For CTV ads, returns the name of a series (such as “The Office” or “Star Wars”) playing when a user views an ad.	Y	Y	For CTV lines only.
1117	Content Channel	For CTV ads, returns the name of the channel (such as ABC or ESPN) on which a user views an ad.	Y	Y	For CTV lines only.
1118	Content Network	For CTV ads, returns the name of the network (such as Disney) on which a user views an ad.	Y	Y	For CTV lines only.
1119	Content Title	For CTV ads, returns the name of the title of the show (such as “Star Wars”) playing when a user views an ad.	Y	Y	For CTV lines only.
1120	Content Genre	For CTV ads, returns the content genre (such as Action or Animation) within which a user views an ad.	Y	Y	For CTV lines only.