Dimension : referrer_domain

Dans cette rubrique, vous découvrirez les Analytics API referrer_domain dimension. Les referrer_domain dimension est le domaine privé supérieur de l'URL de provenance (l'URL de la page sur laquelle se trouvait l'internaute juste avant d'accéder à la page où la vidéo a été visionnée) sur une page où les événements sont collectés à des fins d'analyse.

Paramètres d'URL

Les rapports de l'API Analytics prennent en charge les paramètres d'URL suivants.

Paramètres d'URL
Paramètre Description Obligatoire Valeurs Défaut
account Les comptes sur lesquels vous souhaitez créer un rapport Oui un ou plusieurs identifiants de compte sous forme de liste délimitée par des virgules aucun
dimensions La ou les dimensions à signaler Oui une ou plusieurs dimensions sous forme de liste délimitée par des virgules (certaines combinaisons ne sont pas valables - utilisez l'outil interactif ici pour déterminer si une combinaison est valable) aucun
where Utilisé pour spécifier des filtres pour les rapports non {dimension}=={valeur} - un ou plusieurs éléments sous forme de liste délimitée par des points-virgules. La valeur sera une ou plusieurs valeurs pour la métrique primaire de cette dimension. Par exemple : video==video_id country=country-code, ou viewer=viewer_id(dans ce dernier cas, la forme du viewer_id varie selon que vous capturez et envoyez vous-même une sorte de viewer_id ou selon la valeur générée par le système d'analyse). aucun
limit Nombre d'articles à retourner non entier positif 10
offset Nombre d'éléments à ignorer non entier positif 0
sort Champ sur lequel trier les éléments non tout champ renvoyé par la requête Video_View
fields Champs à retourner non varie en fonction de la dimension sur laquelle vous créez un rapport video,video_view
format Format pour renvoyer les résultats dans non json (par défaut) | csv | xlxs json
reconciled Si elle est incluse, elle limitera les résultats aux données historiques ou en temps réel. Les données analytiques proviennent de plusieurs sources : certaines sont envoyées par le lecteur, mais d'autres sont collectées à partir des CDN et du système Video Cloud. Afin de fournir des analyses le plus rapidement possible, nous commençons à fournir des données « en temps réel » dès qu'elles sont disponibles, puis nous ajustons les analyses ultérieurement lorsque les données de toutes les sources ont été collectées et traitées. Les données entièrement traitées sont appelées réconciliées non vrai | faux true
from Le début de la plage de dates de la demande non L'un des éléments suivants :
  • Une date ISO 8601 (AAAA-MM-JJ)
  • Heure de l'époque en millisecondes (exemple : 1659641316719 [= jeudi 4 août 2022 7:28:36.719 PM GMT]). Voir le convertisseur d'époque.
  • Une chaîne : from=alltime
  • +/- dates relatives en jours (d), semaines (w) ou mois (m) - exemple : from=-6m&to=%2B2w(la période allant d'il y a 6 mois à 2 semaines plus tard -- notez que le signe + doit être codé en URI sous la forme %2B)

Seules les dates des 32 derniers jours sont autorisées pour les points finaux d'engagement ou si reconciled=false.

 -30d
to La fin de la plage de dates pour la demande non L'un des éléments suivants :
  • Une date ISO 8601 (AAAA-MM-JJ)
  • Heure de l'époque en millisecondes (exemple : 1659641316719 [= jeudi 4 août 2022 7:28:36.719 PM GMT]). Voir le convertisseur d'époque.
  • Une chaîne : to=now
  • +/- dates relatives en jours (d), semaines (w) ou mois (m) - exemple : from=-6m&to=%2B2w(la période allant d'il y a 6 mois à 2 semaines plus tard -- notez que le signe + doit être codé en URI sous la forme %2B)

Seules les dates des 32 derniers jours sont autorisées pour les points finaux d'engagement ou si reconciled=false.

 maintenant

Champs disponibles

Les champs suivants peuvent être renvoyés pour la dimension.

  • ad_mode_begin- le nombre de fois où le joueur est entré en mode publicité
  • ad_mode_complete- le nombre de fois où le joueur a terminé le mode publicité
  • engagement_score- le score d'engagement moyen pour une vidéo jouée dans un player
  • play_request- nombre total de fois où la lecture vidéo a été demandée
  • play_rate- le taux de lecture moyen (vues vidéo divisées par impressions) pour une vidéo
  • player_load- le nombre de fois qu'un joueur a été chargé
  • referrer_domain- le domaine que le spectateur a quitté pour atteindre la page où le joueur a été hébergé
  • video_impression- le nombre total de vidéos chargées dans le lecteur
  • video_percent_viewed- la somme des pourcentages visionnés des vidéos dans le lecteur
  • video_seconds_viewed- nombre total de secondes de vidéos visionnées dans le lecteur
  • video_view- nombre total de fois où la lecture vidéo a commencé dans le lecteur

Filtrer les valeurs

Utilisée comme filtre, une dimension permet d'affiner les résultats.

Filtrer les valeurs : Une liste de domaines délimitée par des virgules ; par exemple brightcove.com, docs.brightcove.com

Combinaison de dimensions

Pour voir avec quelles dimensions cet élément peut être combiné et quels champs sont disponibles pour la combinaison, voir Dimension et champs.

En-tête de la politique de référence

Les requêtes HTTP incluent parfois l' referer en-tête facultatif, qui indique l'origine ou l'URL de la page Web à partir de laquelle la demande a été effectuée. L' referrer-policy en-tête définit les données disponibles dans l'en-tête du référent. Pour en savoir plus, voir ici.

Syntaxe

  • 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

Exemples de demandes

Demande de dimension

  https ://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=referrer_domain

Demande de filtre

  https ://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=referrer_domain==brightcove.com,docs.brightcove.com
Exemple de réponse 
{
  "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
  }
}