Some metrics and dimensions cannot be combined together in the same report. Refer to this compatibility matrix to identify valid combinations.
API v2 now availableVisit the API v2 documentation or follow the migration guide to upgrade.
Metrics & Dimensions compatibility
Audience Data
| Metrics | Supported dimensions |
|---|---|
VIEWS TIME_WATCHED_SECONDS VIEW_THROUGH_RATEAVERAGE_WATCH_TIME_SEC | HOUR, DAY, MONTH, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, MEDIA_TYPE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION |
Account Data
| Metrics | Supported dimensions |
|---|---|
UPLOADS | MONTH, DAY, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, VISIBILITY |
Live streaming data
| Metrics | Supported dimensions |
|---|---|
LIVE_VIEWERS LIVE_TIME_WATCHED_SECONDS | HOUR, DAY, MONTH, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION |
Revenue data
| Metrics | Supported dimensions |
|---|---|
ESTIMATED_EARNINGS_USD ESTIMATED_EARNINGS_EUR | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, INVENTORY_POSITION_INDEX, AD_FORMAT |
Bandwidth, encoding and storage
| Metrics | Supported dimensions |
|---|---|
BANDWIDTH_USED_VOD_BYTESBANDWIDTH_USED_LIVE_BYTESBANDWIDTH_USED_TOTAL_BYTESTRANSCODING_USED_VOD_SECONDSTRANSCODING_USED_LIVE_SECONDSTRANSCODING_USED_TOTAL_SECONDSSTORAGE_LIFETIME_USED_BYTES | RENDITION_RESOLUTION, RENDITION_FPS |
Ads Data
| Metrics | Supported dimensions |
|---|---|
TOTAL_INVENTORYNO_FILLSTIMEOUTS | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION |
NO_ADSNO_AD_RATE | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, NOAD_REASON_READABLE |
SELLABLE_INVENTORY FILL_RATE | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, INVENTORY_POSITION_INDEX, BUYER_TYPE |
NB_IMPRESSION | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, INVENTORY_POSITION_INDEX, BUYER_TYPE, AD_FORMAT |
NB_MISSED_IMPRESSION | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, INVENTORY_POSITION_INDEX, BUYER_TYPE, OUTCOME, AD_ERROR_READABLE, AD_ERROR_CODE |
AD_ERRORS | DAY, MONTH, CHANNEL_SLUG, VIDEO_OWNER_CHANNEL_SLUG, VIDEO_ID, VIDEO_TITLE, CONTENT_TAG, CONTENT_TAG_LIST, PLAYLIST_ID, PLAYLIST_TITLE, VIDEO_POSITION, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_COUNTRY, VISITOR_DEVICE_TYPE, ACTION, INVENTORY_POSITION, BUYER_TYPE, AD_ERROR_READABLE, AD_ERROR_CODE |
Quality Data
| Metrics | Supported dimensions |
|---|---|
VIEWABILITY_SCORE VTR_SCORE GDPR_FULL_CONSENT_SCORE | DAY, MONTH, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_DEVICE_TYPE, PLAYER_SIZE_BUCKET |
IVT_SCORE | DAY, MONTH, PLAYER_ID, PLAYER_TITLE, PUBLISHER_ID, PUBLISHER_CHANNEL, VISITOR_DOMAIN_GROUP, VISITOR_PAGE_URL, VISITOR_SUBDOMAIN, VISITOR_DEVICE_TYPE |
Metrics & metrics compatibility
| Metric | Also compatible with |
|---|---|
| Audience | Revenue |
| Uploads | Standalone only |
| Live | Standalone only |
| Revenue | Audience, Ads |
| Bandwidth | Storage |
| Encoding | Standalone only |
| Storage | Bandwidth |
| Ads | Revenue |
| Quality | Standalone only |
Filters & metrics compatibility
| Filters | VIEWS | TIME_WATCHED_SECONDS | IMPRESSIONS | ESTIMATED_EARNINGS |
|---|---|---|---|---|
profile_name | ✅ | |||
video_owner_profile_name | ✅ | ✅ | ✅ | |
media_type | ✅ | ✅ | ||
visitor_domain_group | ✅ | ✅ | ✅ | ✅ |
monetization_type | ✅ |