Show Menu
TOPICS×

Ereignisanfrage

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

URI-Parameter

sid
: Die Sitzungs-ID, die von einer Sitzungsanforderung 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.
***Anzeigen-Tracking –*
Sie können Anzeigen nur innerhalb einer
adBreak
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
Clientaktionselemente
204
Kein Inhalt.
Der Heartbeat-Aufruf war erfolgreich.
nicht angegeben
400
Unzulässige Anfrage.
Die Anfrage hatte ein unzulässiges Format.
Überprüfen Sie die JSON-Validierungsschemata 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 einen Tracking-Bericht zu erstellen.
410
Vorbei.
Die Mediensitzung wurde im Backend-Service gefunden, aber der Client kann die Aktivität nicht mehr berichten.
Die Client-Anwendung sollte die Sitzungsanfrage-API verwenden, um eine weitere Mediensitzung und einen Tracking-Bericht zu erstellen.
500
Serverfehler
nicht angegeben