DocumentatieAnalyticsHandleiding voor Streaming Media-services

Verzoek om gebeurtenissen events-request

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

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

URI-parameter

sid: Sessieidentiteitskaart die van het verzoek van a ​ Sessies ​ is teruggekeerd.

Indieningsinstantie

De aanvraaginstantie moet JSON zijn en dezelfde structuur hebben als deze instantie die het verzoek indient:

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

  • playerTime (verplicht)

    • playhead - Moet in seconden zijn, maar het kan een zwevende waarde zijn.
    • ts - Tijdstempel; moet in milliseconden zijn.

  • eventType (verplicht)

  • params (optioneel)

  • customMetadata (Optioneel; alleen verzenden met gebeurtenistypen adStart en chapterStart )

  • qoeData (optioneel)

Voor een lijst van geldige gebeurtenistypen voor deze versie, zie {de types en de beschrijvingen van 0} Gebeurtenis.🔗

IMPORTANT
Advertentie die - ​volgt kunt slechts advertenties binnen eenadBreak volgen.
Als de gebeurtenissen adBreakStart en adBreakComplete "bookends" rondom advertenties ontbreken, worden adStart en adComplete gewoon genegeerd en wordt de bijbehorende duur van de advertentie bijgehouden als de duur van de hoofdinhoud. Dit kan een aanzienlijke invloed hebben op de geaggregeerde gegevens die in Adobe Analytics beschikbaar zullen zijn.

Antwoord

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

HTTP-antwoordcode
Beschrijving
Client-actiepunten
204
Geen inhoud.

De hartslagvraag was succesvol.
N.v.t.
400
Onjuist Verzoek.

Verzoek had onjuist formaat.
Controleer de ​ JSON bevestigingsschema's ​ voor het verzoektype.
404
niet gevonden.

Sessie-id voor de mediasessie is niet gevonden in de back-end service.
De cliënttoepassing zou het ​ verzoek van Sessies ​ API moeten gebruiken om een andere media zitting tot stand te brengen en het volgen op het te melden.
410
Gone.

de media zitting werd gevonden in de achterste-einddienst maar de cliënt kan activiteit niet meer op het melden.
De cliënttoepassing zou het ​ verzoek van Sessies ​ API moeten gebruiken om een andere media zitting tot stand te brengen en het volgen op het te melden.
500
fout van de Server
N.v.t.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb