Dimension: referrer_domain

In this topic, you will learn about the Analytics API 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.

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 - use the interactive tool here to determine if a combination is valie) none
where Used to specify filters for reports no {dimension}=={value} - one or more as a semi-colon-delimited list. The value will be one or more values for the primary metric of that dimension. For example: video==video_id, country=country-code, or viewer=viewer_id (in the last case, the form of the viewer_id will vary depending on whether you are capturing and sending some kind of viewer_id yourself or depending on the value generated by the analytics system). 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 any field that is being returned by the request video_view
fields Fields to return no varies according to the dimension you are reporting on video,video_view
format Format to return results in no json (default) | csv | xlxs json
reconciled If included, will limit results to either historical or realtime data. Analytics data is derived from multiple sources: some is sent by the player, but other data is collected from CDNs and the Video Cloud system. In order to deliver analytics as quickly as possible, we start delivering "real-time" data as soon as it is available, and then adjust the analytics later when data from all sources has been collected and processed. The fully processed data is called reconciled no true | false true
from The beginning of the date range for the request no One of the following:
  • An ISO 8601 date (YYYY-MM-DD)
  • Epoch time in milliseconds (example: 1659641316719 [= Thursday, August 4, 2022 7:28:36.719 PM GMT]). See the Epoch time converter.
  • A string: from=alltime
  • +/- relative dates in days (d), weeks (w), or months (m) - example: from=-6m&to=%2B2w (the period from 6 months ago to 2 weeks after that -- note that the + sign needs to be URI encoded as %2B)

Only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.

 -30d
to The end of the date range for the request no One of the following:
  • An ISO 8601 date (YYYY-MM-DD)
  • Epoch time in milliseconds (example: 1659641316719 [= Thursday, August 4, 2022 7:28:36.719 PM GMT]). See the Epoch time converter.
  • A string: to=now
  • +/- relative dates in days (d), weeks (w), or months (m) - example: from=-6m&to=%2B2w (the period from 6 months ago to 2 weeks after that -- note that the + sign needs to be URI encoded as %2B)

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 mode
  • ad_mode_complete - the number of times the player completed ad mode
  • engagement_score - the average engagement score for a videos played in a player
  • play_request - total number of times video playback was requested
  • play_rate - the average play rate (video views divided by impressions) for a video
  • player_load - the number of times a player was loaded
  • referrer_domain - the domain the viewer left to reach the page where the player was hosted
  • video_impression - the total number of videos loaded into the player
  • video_percent_viewed - the sum of percent viewed of videos in the player
  • video_seconds_viewed - total seconds of videos viewed in the player
  • video_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.

Referrer policy header

HTTP requests sometimes include the optional referer header, which indicates the origin or URL of the web page from which the request was made. The referrer-policy header defines what data is available in the referrer header. To learn more about this, see here.

Syntax

  • Referrer-Policy: no-referrer
  • Referrer-Policy: no-referrer-when-downgrade
  • Referrer-Policy: origin
  • Referrer-Policy: origin-when-cross-origin
  • Referrer-Policy: same-origin
  • Referrer-Policy: strict-origin
  • Referrer-Policy: strict-origin-when-cross-origin
  • Referrer-Policy: unsafe-url

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
Sample Response 
{
  "item_count": 83,
  "items": [
    {
      "referrer_domain": "google.com.my",
      "video_view": 1
    },
    {
      "referrer_domain": "etulix.com",
      "video_view": 1
    },
    {
      "referrer_domain": "google.co.nz",
      "video_view": 1
    },
    {
      "referrer_domain": "google.be",
      "video_view": 1
    },
    {
      "referrer_domain": "ihostdog.com",
      "video_view": 1
    },
    {
      "referrer_domain": "google.se",
      "video_view": 1
    },
    {
      "referrer_domain": "yahoo.com",
      "video_view": 1
    },
    {
      "referrer_domain": "ey.com",
      "video_view": 1
    },
    {
      "referrer_domain": "google.pl",
      "video_view": 1
    },
    {
      "referrer_domain": "google.ae",
      "video_view": 1
    }
  ],
  "summary": {
    "video_view": 45135
  }
}