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.
accountDimension
The unique identifier for the Brightcove account.
account.nameDimension
The name associated with the Brightcove account.
ad_mode_beginMetric
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_completeMetric
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_startMetric
The number of times server-side inserted advertisements started playing.
browser_typeDimension
The type of browser used by the viewer.
bytes_deliveredMetric
The total number of bytes of video data delivered to viewers.
cityDimension
The city from which the video was viewed.
countryDimension
The two-letter ISO 3166-1 alpha-2 code for the country from which the video was viewed.
country_nameDimension
The name of the country from which the video was viewed.
daily_unique_viewersMetric
The count of unique viewers on a given day.
dateDimension
The date when the video activity occurred.
date_hourDimension
The date and hour when the video activity occurred.
destination_domainDimension
The domain of the web page where the video was viewed.
destination_pathDimension
The path of the web page where the video was viewed.
device_manufacturerDimension
The manufacturer of the device used by the viewer.
device_osDimension
The operating system of the device used by the viewer.
device_typeDimension
The type of device used by the viewer (e.g., desktop, mobile, tablet).
dmaDimension
The designated market area (DMA) from which the video was viewed.
engagement_scoreMetric
A calculated score indicating viewer engagement with the video.
live_streamDimension
Indicates if the stream was a live event.
play_rateMetric
The ratio of video views to video impressions.
play_requestMetric
The number of times a viewer attempted to play a video.
playerDimension
The unique identifier for the Brightcove player used to view the video.
player_loadMetric
The number of times the video player was loaded.
player_nameDimension
The name of the Brightcove player used to view the video.
referrer_domainDimension
The domain of the referring URL from which the video player was loaded.
regionDimension
The region code (e.g., state or province) from which the video was viewed.
region_nameDimension
The name of the region (e.g., state or province) from which the video was viewed.
search_termsDimension
The search terms used to find the video.
social_platformDimension
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_viewedMetric
The total number of seconds a video has been viewed on social platforms within a specific reporting period.
social_viewsMetric
The total number of times a video has started playing on social platforms within a specific reporting period.
source_typeDimension
The type of source that referred the viewer to the video.
videoDimension
The unique identifier for the video.
video.completeDimension
The number of times a video has been watched to 100% completion.
video.created_atDimension
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.descriptionDimension
A brief, short description of the video content. This field is available for retrieval when reporting on the video dimension.
video.durationDimension
The total duration of the video in seconds.
video.long_descriptionDimension
A detailed, extended description of the video content. This field is available for retrieval when reporting on the video dimension.
video.nameDimension
The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.
video.reference_idDimension
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.stateDimension
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.tagsDimension
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_atDimension
The date and time when the video's metadata or properties were last modified.
video_durationDimension
This field indicates the total duration of the video in seconds. It represents the complete length of the video asset.
video_engagement_1Metric
The number of times 1% of the video was viewed.
video_engagement_100Metric
The number of times 100% (the entire) of the video was viewed.
video_engagement_25Metric
The number of times 25% of the video was viewed.
video_engagement_50Metric
The number of times 50% of the video was viewed.
video_engagement_75Metric
The number of times 75% of the video was viewed.
video_impressionMetric
The number of times a video player loaded.
video_nameDimension
The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.
video_percent_viewedMetric
The average percentage of the video watched by viewers.
video_seconds_viewedMetric
The total number of seconds all viewers watched the video.
video_viewMetric
The number of times a video was played.