DokumentationAnalyticsGuide för direktuppspelande medietjänster

Händelsebegäran events-request

Senast uppdaterad: 19 maj 2026

Skapat för:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

URI-parameter

sid: Sessions-ID som returnerats från en ​ sessionsbegäran ​ .

Begärandetext

Begärandetexten måste vara JSON och ha samma struktur som exempelbegärandetexten:

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}

  • playerTime (obligatoriskt)

    • playhead - Måste vara i sekunder, men det kan vara ett flyttal.
    • ts - Tidsstämpel; måste vara i millisekunder.

  • eventType (obligatoriskt)

  • params (valfritt)

  • customMetadata (valfritt; skicka endast med händelsetyperna adStart och chapterStart )

  • qoeData (valfritt)

En lista över giltiga händelsetyper och implementeringsexempel per SDK finns i Översikt över händelser.

IMPORTANT
Annonsuppföljning -​Du kan bara spåra annonser inuti enadBreak.
Om adBreakStart och adBreakComplete "bokstöd" saknas runt annonser ignoreras adStart- och adComplete-händelser och motsvarande annonslängd spåras som innehållslängd. Detta kan ha en betydande inverkan på de aggregerade data som kommer att bli tillgängliga i Adobe Analytics.

Svar

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-svarskoder

HTTP-svarskod
Beskrivning
Klientåtgärdsobjekt
204
Inget innehåll.

Anropet till pulsslag lyckades.
Ej tillämpligt
400
Ogiltig begäran.

Begäran hade ett felaktigt format.
Kontrollera JSON-valideringsscheman för begärandetypen.
404
Hittades inte.

Sessions-ID:t för mediesessionen hittades inte i back end-tjänsten.
Klientprogrammet bör använda API:t för sessionsbegäran för att skapa en annan mediesession och rapportera spårning för den.
410
Borta.

Mediesessionen hittades i back-end-tjänsten, men klienten kan inte längre rapportera aktivitet på den.
Klientprogrammet bör använda API:t för sessionsbegäran för att skapa en annan mediesession och rapportera spårning för den.
500
Serverfel
Ej tillämpligt
recommendation-more-help
media-analytics-help