Requête events events-request

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.

IMPORTANT
Suivi des publicités -  Vous pouvez uniquement suivre les publicités dans unadBreak.
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 client
204
Aucun contenu.

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

Le format de la requête est incorrect.
Recherchez les schémas de validation JSON pour le type de requête.
404
Non trouvé.

L’ID de session pour la session multimédia n’a pas été trouvé dans le service principal.
L’application client doit utiliser l’API de demande Sessions pour créer une autre session multimédia et en effectuer le suivi dans les rapports.
410
Parti.

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 client doit utiliser l’API de demande Sessions pour créer une autre session multimédia et en effectuer le suivi dans les rapports.
500
Erreur du serveur
S.O.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb