DocumentationAnalyticsGuide des services des médias en streaming

Requête events events-request

Dernière mise à jour : 19 mai 2026

Créé pour :

  • User
  • Admin
  • Developer

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

Paramètre URI

sid : ID de session renvoyé à partir d’une requête Sessions.

Corps de la requête

Le corps de la requête doit être JSON et doit avoir la même structure que cet exemple de corps de requête :

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

  • playerTime (obligatoire)

    • playhead - Doit être en secondes, mais il peut s’agir d’un flottant.
    • ts - Date et heure ; doit être en millisecondes.

  • eventType (obligatoire)

  • params (facultatif)

  • customMetadata (facultatif ; envoyer uniquement avec les types d’événements adStart et chapterStart)

  • qoeData (facultatif)

Pour obtenir une liste des types d’événements valides et des exemples d’implémentation par SDK, voir Présentation des événements.

IMPORTANT
Suivi des annonces publicitaires -​vous pouvez uniquement effectuer le suivi des annonces publicitaires dans unadBreak.
En l’absence de adBreakStart et adBreakComplete « fins de livre » autour des publicités, les événements adStart et adComplete seront simplement ignorés et la durée de la publicité correspondante sera suivie en tant que durée du contenu principal. Cela pourrait avoir un impact significatif sur les données agrégées qui seront disponibles dans Adobe Analytics.

Réponse

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

Codes de réponse HTTP

Code de réponse HTTP
Description
Éléments d’action client
204
Pas de contenu.

L’appel Heartbeat a réussi.
S.O.
400 ​​
Requête incorrecte.

Le format de la demande n’était pas correct.
Vérifiez le Schémas de validation JSON pour le type de requête.
404 ​​
Introuvable.

L’ID de session de la session multimédia est introuvable dans le service principal.
L’application cliente doit utiliser l’API Sessions request pour créer une autre session multimédia et effectuer le suivi sur celle-ci dans des rapports.
410 ​​
Parti.

La session multimédia a été trouvée dans le service principal, mais le client ne peut plus y signaler d’activité.
L’application cliente doit utiliser l’API Sessions request pour créer une autre session multimédia et effectuer le suivi sur celle-ci dans des rapports.
500 ​​
Erreur du serveur
S.O.
recommendation-more-help
media-analytics-help