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 EreignistypenadStart
undchapterStart
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 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
Client-Aktionen
204
Kein Inhalt.
Der Heartbeat-Aufruf war erfolgreich.
Der Heartbeat-Aufruf war erfolgreich.
nicht angegeben
400
Ungültige Anfrage.
Die Anfrage hatte ein unzulässiges Format.
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 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 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