Abmessung: referrer_domain

In diesem Thema erfahren Sie mehr über die Analytics API referrer_domain Dimension. Die referrer_domain dimension ist die oberste private Domain der Referrer-URL (die URL der Seite, auf der sich der Betrachter befand, kurz bevor er zu der Seite kam, auf der das Video angesehen wurde) auf einer Seite, auf der Ereignisse zu Analysezwecken erfasst werden.

URL-Parameter

Analytics-API-Berichte unterstützen die folgenden URL-Parameter.

URL-Parameter
Parameter Beschreibung Erforderlich Werte Standardwert
account Die Konten, über die Sie berichten möchten Ja eine oder mehrere Konto-IDs als durch Kommas getrennte Liste keiner
dimensions Die Dimension(en), über die berichtet werden soll Ja eine oder mehrere Dimensionen als kommagetrennte Liste (einige Kombinationen sind nicht gültig - verwenden Sie das interaktive Tool hier, um festzustellen, ob eine Kombination gültig ist) keiner
where Wird verwendet, um Filter für Berichte anzugeben nein {Dimension}=={Wert} - eine oder mehrere als durch Semikolon getrennte Liste. Der Wert ist ein oder mehrere Werte für die primäre Metrik der betreffenden Dimension. Zum Beispiel: video==video_id, country=country-code, oder viewer=viewer_id(im letzten Fall variiert die Form der viewer_id, je nachdem, ob Sie selbst eine Art von Viewer_ID erfassen und senden, oder abhängig von dem vom Analysesystem generierten Wert). keiner
limit Anzahl der zurückzugebenden Artikel nein positive ganze Zahl 10
offset Anzahl der zu überspringenden Elemente nein positive ganze Zahl 0
sort Feld zum Sortieren von Elementen nein jedes Feld, das von der Anfrage zurückgegeben wird video_view
fields Felder zum Zurückgeben nein variiert je nach Dimension, über die Sie berichten Video, Videoansicht
format Format, um Ergebnisse in zurückzugeben nein json (Standard) | csv | xlxs json
reconciled Falls vorhanden, werden die Ergebnisse auf historische oder Echtzeitdaten beschränkt. Analysedaten stammen aus mehreren Quellen: Einige werden vom Player gesendet, andere werden von CDNs und dem Video Cloud-System gesammelt. Um Analysen so schnell wie möglich bereitzustellen, beginnen wir mit der Bereitstellung von "Echtzeit"-Daten, sobald diese verfügbar sind, und passen die Analysen später an, wenn Daten aus allen Quellen gesammelt und verarbeitet wurden. Die vollständig verarbeiteten Daten werden als abgestimmte nein wahr | falsch wahr
from Der Anfang des Datumsbereichs für die Anfrage nein Einer der folgenden:
  • Ein ISO 8601-Datum (JJJJ-MM-TT)
  • Epochenzeit in Millisekunden (Beispiel: 1659641316719 [= Donnerstag, 4. August 2022, 19:28:36 .719 Uhr GMT]). Siehe den Epoch-Zeitkonverter.
  • Eine Zeichenfolge: from=alltime
  • +/- relative Daten in Tagen (d), Wochen (w) oder Monaten (m) — Beispiel: from=-6m&to=%2B2w(der Zeitraum von vor 6 Monaten bis 2 Wochen danach — beachten Sie, dass das Pluszeichen URI-kodiert sein muss als %2B)

Für Engagement-Endpunkte sind nur Daten innerhalb der letzten 32 Tage zulässig oder wenn reconciled=false.

 -30d
to Das Ende des Zeitraums für die Anfrage nein Einer der folgenden:
  • Ein ISO 8601-Datum (JJJJ-MM-TT)
  • Epochenzeit in Millisekunden (Beispiel: 1659641316719 [= Donnerstag, 4. August 2022, 19:28:36 .719 Uhr GMT]). Siehe den Epoch-Zeitkonverter.
  • Eine Zeichenfolge: to=now
  • +/- relative Daten in Tagen (d), Wochen (w) oder Monaten (m) — Beispiel: from=-6m&to=%2B2w(der Zeitraum von vor 6 Monaten bis 2 Wochen danach — beachten Sie, dass das Pluszeichen URI-kodiert sein muss als %2B)

Für Engagement-Endpunkte sind nur Daten innerhalb der letzten 32 Tage zulässig oder wenn reconciled=false.

 jetzt

Verfügbare Felder

Die folgenden Felder können für die Dimension zurückgegeben werden.

  • ad_mode_begin- wie oft der Spieler in den Anzeigenmodus gewechselt ist
  • ad_mode_complete- wie oft der Spieler den Anzeigenmodus abgeschlossen hat
  • engagement_score- der durchschnittliche Engagement-Score für ein in einem Player abgespieltes Video
  • play_request- Gesamtanzahl der angeforderten Videowiedergaben
  • play_rate- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für ein Video
  • player_load- wie oft ein Player geladen wurde
  • referrer_domain- die Domain, die der Zuschauer verlassen hat, um die Seite zu erreichen, auf der der Player gehostet wurde
  • video_impression- die Gesamtzahl der in den Player geladenen Videos
  • video_percent_viewed- die prozentuale Summe der angesehenen Videos im Player
  • video_seconds_viewed- Gesamtsekunden der im Player angezeigten Videos
  • video_view- Gesamtanzahl der im Player gestarteten Videowiedergabe

Filterwerte

Eine Dimension, die als Filter verwendet wird, ermöglicht es Ihnen, die Ergebnisse einzugrenzen.

Filterwerte: Eine kommagetrennte Liste von Domains, z. B. brightcove.com, docs.brightcove.com

Dimensionen kombinieren

Um zu sehen, mit welchen Dimensionen dies kombiniert werden kann und welche Felder für die Kombination verfügbar sind, siehe Dimension und Felder.

Kopfzeile der Referrer-Richtlinie

HTTP-Anfragen enthalten manchmal den optionalen referer Header, der den Ursprung oder die URL der Webseite angibt, von der aus die Anfrage gestellt wurde. Der referrer-policy Header definiert, welche Daten im Referrer-Header verfügbar sind. Weitere Informationen hierzu finden Sie hier.

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

Beispiele anfordern

Maßanfrage

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

Anfrage filtern

  https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensions=video&where=referrer_domain==brightcove.com, docs.brightcove.com
Beispielantwort 
{
  "Artikel_Zahl": 83,
  "Elemente": [
    {
      "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
    }
  ],
  "Zusammenfassung": {
    "video_view": 45135
  }
}}