Panoramica

L'API Media Collection è Adobe alternativa RESTful all'SDK multimediale lato client. Con l’API Media Collection, il lettore può tenere traccia degli eventi audio e video mediante chiamate RESTful HTTP.

L'API Media Collection è essenzialmente una scheda che agisce come una versione lato server dell'SDK Media. Ciò significa che alcuni aspetti della documentazione di Media SDK sono pertinenti anche per l'API di Media Collection. Ad esempio, entrambe le soluzioni utilizzano gli stessi parametri per lo streaming dei file multimediali e i dati per il tracciamento dei file multimediali in streaming raccolti portano allo stesso Reporting and Analysis.

Flussi di dati di tracciamento file multimediali

Un lettore multimediale che implementa l’API Media Collection effettua chiamate RESTful di tracciamento API direttamente al server back-end di tracciamento dei contenuti multimediali, mentre un lettore che implementa l’SDK di Media effettua chiamate di tracciamento alle API SDK all’interno dell’app lettore. Uno degli effetti delle chiamate sul Web è che il lettore che implementa l’API di Media Collection deve gestire in modo automatico alcune delle elaborazioni gestite dall’SDK di Media. (Dettagli in Implementazione della raccolta multimediale.)

I dati di tracciamento acquisiti con l’API Media Collection vengono inviati e inizialmente elaborati in modo diverso rispetto ai dati di tracciamento acquisiti in un lettore SDK Media, ma lo stesso motore di elaborazione sul back-end viene utilizzato per entrambe le soluzioni.

Panoramica API

URI: ottenete questo risultato dal rappresentante del Adobe .

Metodo HTTP: POST, con il corpo della richiesta JSON.

Chiamate API

  • sessions- Stabilisce una sessione con il server e restituisce un ID sessione utilizzato nelle events chiamate successive. L’app esegue questa chiamata una volta all’inizio di una sessione di tracciamento.

    {uri}/api/v1/sessions
    
  • events- Invia i dati di tracciamento dei supporti.

    {uri}/api/v1/sessions/{session-id}/events
    

Corpo della richiesta

{
    "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 - Obbligatorio per tutte le richieste.

  • eventType - Obbligatorio per tutte le richieste.

  • params - Obbligatorio per alcuni eventTypes; verificare lo schema di convalida JSON per determinare quali eventTypes sono obbligatori e quali sono facoltativi.

  • qoeData - Facoltativo per tutte le richieste.

  • customMetadata - Facoltativo per tutte le richieste, ma solo inviato con sessionStart, adStarte i tipi di chapterStart evento.

Per ogni eventType, è disponibile al pubblico uno schema di convalida JSON da utilizzare per verificare i tipi di parametro e se un parametro è facoltativo o obbligatorio per un particolare evento.

Tipi di evento

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

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now