Conviva-Defined Dimensions
Use the dimensions endpoint (GET /3.0/metrics/_meta/references/dimensions) to look up the list of available filtering and group by dimensions for the c3 account.

Specify the group_by parameters in the URL path, and they are in kebab-case format.
Format
GET /3.0/metrics/{metric_group}/group-by/{dimension}
Example
GET /3.0/metrics/attempts/group-by/geo-city-name
-
ad-break-id (tag c3.ad.breakId)
-
ad-break-index (tag c3.ad.breakIndex)
-
ad-campaign-name (tag c3.ad.campaignName)
-
ad-category (tag c3.ad.category)
-
ad-creative-id (tag c3.ad.creativeId)
-
ad-creative-name (tag c3.ad.creativeName)
-
ad-creative-type (tag c3.ad.creativeType)
-
ad-day-part (tag c3.ad.dayPart)
-
ad-deal-id (tag c3.ad.dealId)
-
ad-fallback-index (tag c3.ad.fallbackIndex)
-
ad-first-ad-id (tag c3.ad.firstAdId)
-
ad-first-ad-system (tag c3.ad.firstAdSystem)
-
ad-first-creative-id (tag c3.ad.firstCreativeId)
-
ad-id (tag c3.ad.id)
-
ad-is-slate (tag c3.ad.isSlate)
-
ad-manager-name (tag c3.ad.adManagerName)
-
ad-manager-version (tag c3.ad.adManagerVersion)
-
ad-media-file-api-framework (tag c3.ad.mediaFileApiFramework)
-
ad-planned-duration (tag c3.ad.plannedDuration)
-
ad-position (tag c3.ad.position)
-
ad-sequence (tag c3.ad.sequence)
-
ad-session-start-event (tag c3.ad.sessionStartEvent)
-
ad-stitcher (tag c3.ad.adStitcher)
-
ad-system (tag c3.ad.system)
-
ad-technology (tag c3.ad.technology)
-
ad-type (tag c3.ad.type)
-
ad-unit-name (tag c3.ad.unitName)
-
ad-video-asset-name (tag c3.ad.videoAssetName)
-
advertiser (tag c3.ad.advertiser)
-
advertiser-category (tag c3.ad.advertiserCategory)
-
advertiser-id (tag c3.ad.advertiserId)
-
advertiser-name (tag c3.ad.advertiserName)
-
app-version (tag c3.app.version)
-
asn
-
asset
-
asset-type (tag c3.asset.type)
-
browser-name
-
browser-version
-
cdn
-
cdn-edge-group
-
cdn-edge-server
-
connection-type (tag c3.device.conn)
-
content-category (tag c3.video.isLive)
-
content-meta-affiliate (tag c3.cm.affiliate)
-
content-meta-brand (tag c3.cm.brand)
-
content-meta-category-type (tag c3.cm.categoryType)
-
content-meta-channel (tag c3.cm.channel)
-
content-meta-content-type (tag c3.cm.contentType)
-
content-meta-episode-number (tag c3.cm.episodeNumber)
-
content-meta-genre (tag c3.cm.genre)
-
content-meta-genre-list (tag c3.cm.genreList)
-
content-meta-id (tag c3.cm.id)
-
content-meta-name (tag c3.cm.name)
-
content-meta-season-number (tag c3.cm.seasonNumber)
-
content-meta-series-name (tag c3.cm.seriesName)
-
content-meta-show-title (tag c3.cm.showTitle)
-
conviva-core-sdk-version (tag c3.cws.clv)
-
customer
-
device-category
-
device-hardware-type
-
device-manufacturer
-
device-marketing-name
-
device-model
-
device-name
-
device-os
-
device-os-family
-
device-os-version
-
geo-city-name
-
geo-continent-name
-
geo-country-code
-
geo-dma
-
geo-postal-code
-
geo-state-name
-
is-ad-requested
-
isp
-
network-connection-type
-
platform (tag c3.pt)
-
platform-version (tag c3.pt.ver)
-
player-name (tag c3.player.name)
-
player-framework-name
-
player-framework-version
-
precision-algo-id (tag c3.go.algoid)
-
precision-cdn (tag c3.de.cdn)
-
precision-rs (tag c3.de.rs)
-
preroll-status
-
stream-host (tag c3.sh)
-
user-agent (tag c3.device.ua)
-
utm-tracking-code (tag c3.cm.utmTrackingUrl)
-
video-asset-name (tag c3.cp.an)
Error Code Dimensions:
-
video-playback-failure-error (for metric video-playback-failures only)
-
video-playback-failure-business-error (for metric video-playback-failures-business only)
-
video-playback-failure-tech-error (for metric video-playback-failures-tech only)
-
video-start-failure-error (for metric video-start-failures only)
-
video-start-failure-business-error (for metric video-start-failures-business only)
-
video-start-failure-tech-error (for metric video-start-failures-tech only)
-
ad-video-start-failure-error (for metric ad-video-start-failures only)
-
ad-video-playback-failure-error (for metric ad-video-playback-failures only)

Specify filter parameters in the query string, in snake_case format.
Format:
GET /3.0/metrics/{metric_group}{/group-by/{dimension}}?{filter_dimension_name}={filter_dimension_value}
Example:
GET /3.0/metrics/attempts?device_os=Android
-
ad_break_id
-
ad_break_index
-
ad_campaign_name
-
ad_category
-
ad_creative_id
-
ad_creative_name
-
ad_creative_type
-
ad_day_part
-
ad_deal_id
-
ad_fallback_index
-
ad_first_ad_id
-
ad_first_ad_system
-
ad_first_creative_id
-
ad_id
-
ad_is_slate
-
ad_manager_name
-
ad_manager_version
-
ad_media_file_api_framework
-
ad_planned_duration
-
ad_position
-
ad_sequence
-
ad_session_start_event
-
ad_stitcher
-
ad_system
-
ad_technology
-
ad_type
-
ad_unit_name
-
ad_video_asset_name
-
advertiser
-
advertiser_category
-
advertiser_id
-
advertiser_name
-
app_version
-
asn
-
asset
-
asset_type
-
browser_name
-
browser_version
-
cdn
-
cdn_edge_group
-
cdn_edge_server
-
connection_type
-
content_category
-
content_meta_affiliate
-
content_meta_brand
-
content_meta_category_type
-
content_meta_channel
-
content_meta_content_type
-
content_meta_episode_number
-
content_meta_genre
-
content_meta_genre_list
-
content_meta_id
-
content_meta_name
-
content_meta_season_number
-
content_meta_series_name
-
content_meta_show_title
-
conviva_core_sdk_version
-
customer
-
device_category
-
device_hardware_type
-
device_manufacturer
-
device_marketing_name
-
device_model
-
device_name
-
device_os
-
device_os_family
-
device_os_version
-
geo_city_name
-
geo_continent_name
-
geo_country_code
-
geo_dma
-
geo_postal_code
-
geo_state_name
-
is_ad_requested
-
isp
-
network_connection_type
-
platform
-
platform_version
-
player_name
-
player_framework_name
-
player_framework_version
-
precision_algo_id
-
precision_cdn
-
precision_rs
-
preroll_status
-
stream_host
-
user_agent
-
utm_tracking_code
-
video_asset_name
-
video_playback_failure_business_error
-
video_playback_failure_error
-
video_playback_failure_tech_error
-
video_start_failure_business_error
-
video_start_failure_error
-
video_start_failure_tech_error