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 |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
Video |
video |
The unique identifier for the video. |
metric |
Video impression |
video_impression |
The number of times a video player loaded. |
metric |
Video seconds viewed |
video_seconds_viewed |
The total number of seconds all viewers watched the video. |
metric |
Video view |
video_view |
The number of times a video was played. |
metric |
account |
Account ID |
The unique identifier for the Brightcove account. |
metric |
account.name |
account.name |
The name associated with the Brightcove account. |
dimension |
ad_mode_begin |
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 |
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 |
SSAI ad starts |
The number of times server-side inserted advertisements started playing. |
metric |
browser_type |
browser_type |
The type of browser used by the viewer. |
dimension |
bytes_delivered |
bytes_delivered |
The total number of bytes of video data delivered to viewers. |
metric |
ccu |
Concurrent viewers |
The number of concurrent viewers watching a live stream. |
metric |
city |
city |
The city from which the video was viewed. |
dimension |
country |
country |
The two-letter ISO 3166-1 alpha-2 code for the country from which the video was viewed. |
dimension |
country_name |
country_name |
The name of the country from which the video was viewed. |
dimension |
daily_unique_viewers |
daily_unique_viewers |
The count of unique viewers on a given day. |
metric |
date |
date |
The date when the video activity occurred. |
dimension |
date_hour |
date_hour |
The date and hour when the video activity occurred. |
dimension |
destination_domain |
destination_domain |
The domain of the web page where the video was viewed. |
dimension |
destination_path |
destination_path |
The path of the web page where the video was viewed. |
dimension |
device_manufacturer |
device_manufacturer |
The manufacturer of the device used by the viewer. |
dimension |
device_os |
device_os |
The operating system of the device used by the viewer. |
dimension |
device_type |
device_type |
The type of device used by the viewer (e.g., desktop, mobile, tablet). |
dimension |
dma |
dma |
The designated market area (DMA) from which the video was viewed. |
metric |
engagement_score |
engagement_score |
A calculated score indicating viewer engagement with the video. |
metric |
live_stream |
live_stream |
Indicates if the stream was a live event. |
dimension |
play_rate |
play_rate |
The ratio of video views to video impressions. |
metric |
play_request |
play_request |
The number of times a viewer attempted to play a video. |
metric |
player |
player |
The unique identifier for the Brightcove player used to view the video. |
dimension |
player_load |
player_load |
The number of times the video player was loaded. |
metric |
player_name |
player_name |
The name of the Brightcove player used to view the video. |
dimension |
referrer_domain |
referrer_domain |
The domain of the referring URL from which the video player was loaded. |
dimension |
region |
region |
The region code (e.g., state or province) from which the video was viewed. |
dimension |
region_name |
region_name |
The name of the region (e.g., state or province) from which the video was viewed. |
dimension |
search_terms |
search_terms |
The search terms used to find the video. |
dimension |
source_type |
source_type |
The type of source that referred the viewer to the video. |
dimension |
timestamp |
timestamp |
The exact time and date when an event occurred. |
dimension |
video |
Video ID |
The unique identifier for the video. |
metric |
video.complete |
video.complete |
Indicates whether the video playback was completed. |
dimension |
video.created_at |
video.created_at |
The date and time when the video was created in Brightcove. |
dimension |
video.duration |
video.duration |
The total duration of the video in milliseconds. |
metric |
video.name |
video.name |
The name or title of the video. |
dimension |
video_engagement_1 |
video_engagement_1 |
The number of times 1% of the video was viewed. |
metric |
video_engagement_100 |
video_engagement_100 |
The number of times 100% (the entire) of the video was viewed. |
metric |
video_engagement_25 |
video_engagement_25 |
The number of times 25% of the video was viewed. |
metric |
video_engagement_50 |
video_engagement_50 |
The number of times 50% of the video was viewed. |
metric |
video_engagement_75 |
video_engagement_75 |
The number of times 75% of the video was viewed. |
metric |
video_impression |
Video impression |
The number of times a video player loaded. |
metric |
video_percent_viewed |
video_percent_viewed |
The average percentage of the video watched by viewers. |
metric |
video_seconds_viewed |
Video seconds viewed |
The total number of seconds all viewers watched the video. |
metric |
video_view |
Video view |
The number of times a video was played. |
metric |