Show Menu
TOPICS×

Aperçu

L’API Media Collection constitue l’alternative RESTful d’Adobe au kit SDK Media côté client. Grâce à l’API Media Collection, votre lecteur peut effectuer le suivi des événements audio et vidéo à l’aide d’appels HTTP RESTful. L’API Media Collection offre le même suivi en temps réel que le SDK Media, ainsi qu’une fonctionnalité supplémentaire :
  • Suivi du contenu téléchargé
    Cette fonctionnalité vous permet d’effectuer le suivi du média lorsqu’un utilisateur est hors ligne, par le biais du stockage local de données d’événement jusqu’à ce que l’appareil de l’utilisateur soit à nouveau en ligne. (Consultez la rubrique Suivi du contenu téléchargé pour en savoir plus.)
L’API Media Collection est essentiellement un adaptateur, agissant comme une version côté serveur du kit SDK Media. Cela signifie que certains aspects de la documentation du SDK Media sont également pertinents pour l’API Media Collection. Par exemple, les deux solutions utilisent les mêmes paramètres audio et vidéo , et les données de suivi audio et vidéo collectées conduisent aux mêmes rapports et analyses.

Flux de données de suivi multimédia

Un lecteur multimédia mettant en œuvre l’API Media Collection effectue des appels de suivi d’API RESTful directement au serveur principal de suivi multimédia, tandis qu’un lecteur mettant en œuvre le kit SDK Media effectue des appels de suivi aux API SDK dans l’application de lecteur. L’un des effets des appels sur le Web est que le lecteur mettant en œuvre l’API Media Collection doit gérer une partie du traitement que le kit SDK Media gère automatiquement. (Détails dans Mise en œuvre de Media Collection. )
Les données de suivi capturées avec l’API Media Collection sont envoyées et traitées initialement différemment des données de suivi capturées dans un lecteur SDK Media, mais le même moteur de traitement sur le serveur principal est utilisé pour les deux solutions.

Présentation de l’API

URI :
Procurez-vous cette information auprès de votre représentant Adobe.
Méthode HTTP :
POST, avec corps de requête JSON.

Appels API

  • sessions
    -
    Établit une session avec le serveur et renvoie un ID de session utilisé dans les appels
    events
    suivants. Votre application appelle ceci une fois au début d’une session de suivi.
    {uri}/api/v1/sessions
  • events
    -
    Envoie des données de suivi multimédia.
    {uri}/api/v1/sessions/{session-id}/events

Corps de requête

{ "playerTime": { "playhead": {playhead position in seconds}, "ts": {timestamp in milliseconds} }, "eventType": {event-type}, "params": { {parameter-name}: {parameter-value}, ... {parameter-name}: {parameter-value} }, "qoeData" : { {parameter-name}: {parameter-value}, ... {parameter-name}: {parameter-value} }, "customMetadata": { {parameter-name}: {parameter-value}, ... {parameter-name}: {parameter-value} } }
  • playerTime
     : Obligatoire pour toutes les requêtes.
  • eventType
     : Obligatoire pour toutes les requêtes.
  • params
     : Obligatoire pour certains
    eventTypes
     ; vérifiez le schéma de validation JSON pour déterminer quels eventTypes sont obligatoires et lesquels sont facultatifs.
  • qoeData
     : Facultatif pour toutes les requêtes.
  • customMetadata
     : Facultatif pour toutes les requêtes, mais uniquement envoyé avec les types d’événement
    sessionStart
    ,
    adStart
    et
    chapterStart
    .
Pour chaque
eventType
, il existe un schéma de validation JSON disponible publiquement que vous devez utiliser pour vérifier les types de paramètre et savoir si un paramètre est facultatif ou obligatoire pour un événement particulier.

Types d’événement

  • sessionStart
  • play
  • ping
  • pauseStart
  • bufferStart
  • adStart
  • adComplete
  • adSkip
  • adBreakStart
  • adBreakComplete
  • chapterStart
  • chapterSkip
  • chapterComplete
  • sessionEnd
  • sessionComplete