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.

API name	Description	Use in Adverity
account	The unique identifier for the Brightcove account.	dimension
account.name	The name associated with the Brightcove account.	dimension
ad_mode_begin	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.	metric
ad_mode_complete	The number of times the Brightcove Player or SDK returned from playing ad content, indicating the completion of an ad playback session.	metric
alive_ss_ad_start	The number of times server-side inserted advertisements started playing.	metric
browser_type	The type of browser used by the viewer.	dimension
bytes_delivered	The total number of bytes of video data delivered to viewers.	metric
city	The city from which the video was viewed.	dimension
country	The two-letter ISO 3166-1 alpha-2 code for the country from which the video was viewed.	dimension
country_name	The name of the country from which the video was viewed.	dimension
daily_unique_viewers	The count of unique viewers on a given day.	metric
date	The date when the video activity occurred.	dimension
date_hour	The date and hour when the video activity occurred.	dimension
destination_domain	The domain of the web page where the video was viewed.	dimension
destination_path	The path of the web page where the video was viewed.	dimension
device_manufacturer	The manufacturer of the device used by the viewer.	dimension
device_os	The operating system of the device used by the viewer.	dimension
device_type	The type of device used by the viewer (e.g., desktop, mobile, tablet).	dimension
dma	The designated market area (DMA) from which the video was viewed.	dimension
engagement_score	A calculated score indicating viewer engagement with the video.	metric
live_stream	Indicates if the stream was a live event.	dimension
play_rate	The ratio of video views to video impressions.	metric
play_request	The number of times a viewer attempted to play a video.	metric
player	The unique identifier for the Brightcove player used to view the video.	dimension
player_load	The number of times the video player was loaded.	metric
player_name	The name of the Brightcove player used to view the video.	dimension
referrer_domain	The domain of the referring URL from which the video player was loaded.	dimension
region	The region code (e.g., state or province) from which the video was viewed.	dimension
region_name	The name of the region (e.g., state or province) from which the video was viewed.	dimension
search_terms	The search terms used to find the video.	dimension
social_platform	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.	dimension
source_type	The type of source that referred the viewer to the video.	dimension
video	The unique identifier for the video.	dimension
video.complete		dimension
video.created_at	The date and time when the video was initially added or ingested into the Brightcove account. This field can be used to filter reports.	dimension
video.description	A brief, short description of the video content. This field is available for retrieval when reporting on the video dimension.	dimension
video.duration	The total length of the video, typically measured in milliseconds.	dimension
video.long_description	A detailed, extended description of the video content. This field is available for retrieval when reporting on the video dimension.	dimension
video.name	The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.	dimension
video.reference_id	A unique identifier assigned to the video by the user or an external system, which can be used to sort and filter video reports.	dimension
video.state		dimension
video.tags	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.	dimension
video.updated_at	The date and time when the video’s metadata or properties were last modified.	dimension
video_duration	The total length of the video, typically measured in seconds.	dimension
video_engagement_1	The number of times 1% of the video was viewed.	metric
video_engagement_100	The number of times 100% (the entire) of the video was viewed.	metric
video_engagement_25	The number of times 25% of the video was viewed.	metric
video_engagement_50	The number of times 50% of the video was viewed.	metric
video_engagement_75	The number of times 75% of the video was viewed.	metric
video_impression	The number of times a video player loaded.	metric
video_name	The title or name of the video. This field is available for sorting and retrieval when reporting on the video dimension.	dimension
video_percent_viewed	The average percentage of the video watched by viewers.	metric
video_seconds_viewed	The total number of seconds all viewers watched the video.	metric
video_view	The number of times a video was played.	metric