Ereignisanfrage events-request

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.

IMPORTANT
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
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb