Brightcove: Most-used fields#
The table below gives information about most-used fields that you can import from Brightcove. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
account Dimension
The unique identifier for the Brightcove account.
account.name Dimension
The name associated with the Brightcove account.
ad_mode_begin Metric
The number of times the Brightcove Player or SDK switched into ad mode to begin playing ad content. This event occurs before the video_view event in a pre-roll scenario or after the video_view event in a mid or post-roll configuration. This metric indicates when ad playback started, but not necessarily the number of ads delivered.
ad_mode_complete Metric
The number of times the Brightcove Player or SDK returned from playing ad content, indicating the completion of an ad playback session.
alive_ss_ad_start Metric
The number of times server-side inserted advertisements started playing.
browser_type Dimension
The type of browser used by the viewer.
bytes_delivered Metric
The total number of bytes of video data delivered to viewers.
city Dimension
The city from which the video was viewed.
country Dimension
The two-letter ISO 3166-1 alpha-2 code for the country from which the video was viewed.
country_name Dimension
The name of the country from which the video was viewed.
daily_unique_viewers Metric
The count of unique viewers on a given day.
date Dimension
The date when the video activity occurred.
date_hour Dimension
The date and hour when the video activity occurred.
destination_domain Dimension
The domain of the web page where the video was viewed.
destination_path Dimension
The path of the web page where the video was viewed.
device_manufacturer Dimension
The manufacturer of the device used by the viewer.
device_os Dimension
The operating system of the device used by the viewer.
device_type Dimension
The type of device used by the viewer (e.g., desktop, mobile, tablet).
dma Dimension
The designated market area (DMA) from which the video was viewed.
engagement_score Metric
A calculated score indicating viewer engagement with the video.
live_stream Dimension
Indicates if the stream was a live event.
play_rate Metric
The ratio of video views to video impressions.
play_request Metric
The number of times a viewer attempted to play a video.
player Dimension
The unique identifier for the Brightcove player used to view the video.
player_load Metric
The number of times the video player was loaded.
player_name Dimension
The name of the Brightcove player used to view the video.
referrer_domain Dimension
The domain of the referring URL from which the video player was loaded.
region Dimension
The region code (e.g., state or province) from which the video was viewed.
region_name Dimension
The name of the region (e.g., state or province) from which the video was viewed.
search_terms Dimension
The search terms used to find the video.
social_platform Dimension
The social platform from which the video analytics data originates (e.g., Twitter, Facebook, YouTube). This dimension provides insights into video performance across different social channels.
social_seconds_viewed Metric
The total number of seconds a video has been viewed on social platforms within a specific reporting period.
social_views Metric
The total number of times a video has started playing on social platforms within a specific reporting period.
source_type Dimension
The type of source that referred the viewer to the video.
video Dimension
The unique identifier for the video.
video.complete Dimension
The number of times a video has been watched to 100% completion.
video.created_at Dimension
The date and time when the video was initially added or ingested into the Brightcove account. This field can be used to filter reports.
video.description Dimension
A brief, short description of the video content. This field is available for retrieval when reporting on the video dimension.
video.duration Dimension
The total duration of the video in seconds.
video.long_description Dimension
A detailed, extended description of the video content. This field is available for retrieval when reporting on the video dimension.
video.name Dimension
The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.
video.reference_id Dimension
A unique identifier assigned to the video by the user or an external system, which can be used to sort and filter video reports.
video.state Dimension
The current lifecycle state of the video, indicating its status and playability. Possible states include ACTIVE (playable), INACTIVE (deactivated or missing required metadata), PENDING (shared from another account but not yet accepted), or DELETED.
video.tags Dimension
A list of keywords or tags associated with the video, used for categorization and discoverability. This field is available for sorting and retrieval in video reports.
video.updated_at Dimension
The date and time when the video's metadata or properties were last modified.
video_duration Dimension
This field indicates the total duration of the video in seconds. It represents the complete length of the video asset.
video_engagement_1 Metric
The number of times 1% of the video was viewed.
video_engagement_100 Metric
The number of times 100% (the entire) of the video was viewed.
video_engagement_25 Metric
The number of times 25% of the video was viewed.
video_engagement_50 Metric
The number of times 50% of the video was viewed.
video_engagement_75 Metric
The number of times 75% of the video was viewed.
video_impression Metric
The number of times a video player loaded.
video_name Dimension
The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.
video_percent_viewed Metric
The average percentage of the video watched by viewers.
video_seconds_viewed Metric
The total number of seconds all viewers watched the video.
video_view Metric
The number of times a video was played.