Show Menu
TOPICS×

Requête events

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

Paramètre URI

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

Corps de requête

Le corps de requête doit être JSON et doit avoir la même structure que le corps de cet exemple de corps de requête :
{ "playerTime": { "playhead": 0, "ts": 1509045324153 }, "eventType": "{event-type}", "params": {}, "qoeData": {}, "customMetadata": {} }
  • playerTime
    (Obligatoire)
    • playhead
       : Doit être spécifié en secondes, mais peut être une valeur flottante.
    • ts
       : Horodatage ; doit être spécifié en millisecondes.
  • eventType
    (Obligatoire)
  • params
    (Facultatif)
  • customMetadata
    (Facultatif ; envoyer uniquement avec les types d’événements
    adStart
    et
    chapterStart
    )
  • qoeData
    (Facultatif)
Pour obtenir la liste des types d’événement valides pour cette version, reportez-vous à la rubrique Types et descriptions d’événement.
**
Suivi des publicités -**Vous pouvez uniquement suivre les publicités dans un
adBreak
.
En l’absence des « serre-livres »
adBreakStart
et
adBreakComplete
autour des publicités, les événements
adStart
et
adComplete
sont simplement ignorés, et la durée de publicité correspondante est suivie en tant que durée de 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 du client
204
Aucun contenu.
L’appel Heartbeat a réussi.
S.O.
400
Demande incorrecte.
Le format de la requête est incorrect.
Cherchez le type de requête dans les schémas de validation JSON .
404
Introuvable.
L’ID de session pour la session multimédia n’a pas été trouvé dans le service principal.
L’application du client doit utiliser l’API de la requête sessions pour créer une autre session multimédia et générer des rapports de suivi sur celle-ci.
410
Supprimé.
La session multimédia a été trouvée dans le service principal, mais le client ne peut plus générer de rapports d’activité sur celle-ci.
L’application du client doit utiliser l’API de la requête sessions pour créer une autre session multimédia et générer des rapports de suivi sur celle-ci.
500
Erreur interne du serveur
S.O.