Ereignisanfrage

Letzte Aktualisierung: 2023-01-23
  • Erstellt für:
  • User
    Admin
    Developer

POST https://{uri}/api/v1/sessions/{sid}/events

URI-Parameter

sid: Die Sitzungs-ID, die von einer Sitzungsanfrage zurückgegeben wird.

Anfrageinhalt

Der Anforderungstext muss im JSON-Format vorliegen und die gleiche Struktur aufweisen wie dieser Beispiel-Anforderungstext:

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}
  • playerTime (Obligatorisch)
    • playhead: Muss in Sekunden angegeben werden, es kann sich jedoch um einen Float-Wert handeln.
    • ts: Zeitstempel, der in Millisekunden angegeben werden muss.
  • eventType (Obligatorisch)
  • params (Optional)
  • customMetadata (Optional, nur mit den Ereignistypen adStart und chapterStart senden)
  • qoeData (Optional)

Eine Liste gültiger Ereignistypen für diese Version finden Sie unter Ereignistypen und -beschreibungen.

WICHTIG

Anzeigen-Tracking – Sie können Anzeigen nur innerhalb eineradBreak verfolgen.

Wenn Anzeigen nicht durch adBreakStart und adBreakComplete eingeschlossen sind, werden die Ereignisse adStart und adComplete einfach ignoriert und die Werbedauer wird der Dauer des Hauptinhalts angerechnet. Das kann deutliche Auswirkungen auf die aggregierten Daten haben, die in Adobe Analytics zur Verfügung stehen.

Antwort

HTTP/1.1 204 No Content
Server nginx/1.13.5
Date Thu, 26 Oct 2017 19:15:24 GMT
Connection keep-alive
Access-Control-Allow-Origin *
Access-Control-Allow-Methods OPTIONS,POST,PUT
Access-Control-Allow-Headers Content-Type
Access-Control-Expose-Headers Location

HTTP-Antwortcodes

HTTP-Antwortcode Beschreibung Client-Aktionen
204 Kein Inhalt.

Der Heartbeat-Aufruf war erfolgreich.
nicht angegeben
400 Ungültige Anfrage.

Die Anfrage hatte ein unzulässiges Format.
Überprüfen Sie die JSON-Validierungs-Schemata für den Anfragetyp.
404 Nicht gefunden.

Die Sitzungs-ID für die Mediensitzung wurde im Backend-Service nicht gefunden.
Die Client-Anwendung sollte die Sitzungsanfrage-API verwenden, um eine weitere Mediensitzung und Berichte dazu zu erstellen.
410 Nicht mehr auffindbar.

Die Mediensitzung wurde im Backend-Service gefunden, aber der Client kann einen Bericht mehr über die Aktivität bereitstellen.
Die Client-Anwendung sollte die Sitzungsanfrage-API verwenden, um eine weitere Mediensitzung und Berichte dazu zu erstellen.
500 Serverfehler nicht angegeben

Auf dieser Seite