referrer_domain
dimension. The referrer_domain
dimension is the top private domain of the referrer URL (the URL for the page the viewer was on just before coming to the page where the video was viewed) on a page where events are collected for analytics.URL parameters
Analytics API reports support the following URL parameters.
Parameter | Description | Required | Values | Default |
---|---|---|---|---|
account |
The accounts you want to report on | yes | one or more account ids as a comma-delimited list | none |
dimensions |
The dimension(s) to report on | yes | one or more dimensions as a comma-delimited list (some combinations are not valid) | none |
where |
Used to specify filters for reports | no | {dimension}=={value} - one or more as a semi-colon-delimited list | none |
limit |
Number of items to return | no | positive integer | 10 |
offset |
Number of items to skip | no | positive integer | 0 |
sort |
Field to sort items on | no | a valid field for the request | video_view |
fields |
Fields to return | no | varies according to the dimension you are reporting on | video_view |
format |
Format to return results in | no | json | csv | xlxs | json |
reconciled |
If included, will limit results to either historical or realtime data | no | true | false | true |
from |
The beginning of the date range for the request | no | An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string alltime, or relative date (-1m); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false. | 30 days prior to now |
to |
The end of the date range for the request | no | An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string now, or relative data (+7d); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false. | now |
Fields available
The following fields can be returned for the dimension.
ad_mode_begin
- the number of times the player entered ad modead_mode_complete
- the number of times the player completed ad modeengagement_score
- the average engagement score for a videos played in a playerplay_request
- total number of times video playback was requestedplay_rate
- the average play rate (video views divided by impressions) for a videoplayer_load
- the number of times a player was loadedreferrer_domain
- the domain the viewer left to reach the page where the player was hostedvideo_impression
- the total number of videos loaded into the playervideo_percent_viewed
- the sum of percent viewed of videos in the playervideo_seconds_viewed
- total seconds of videos viewed in the playervideo_view
- total times video playback started in the player
Filter values
Used as a filter, a dimension allows you to narrow the results.
Filter values: A comma-delimited list of domains; e.g. brightcove.com,docs.brightcove.com
Combining dimensions
To see what dimensions this on can be combined with, and what fields are available for the combination, see Dimension and Fields.
Request Examples
Dimension request
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=referrer_domain
Filter request
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=referrer_domain==brightcove.com,docs.brightcove.com
Response
Response will appear here when you test a request