Richiesta eventi

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

Parametro URI

sid: l’ID sessione restituito da una Richiesta sessioni.

Corpo della richiesta

Il corpo della richiesta deve essere in formato JSON e avere la stessa struttura del corpo della richiesta di esempio:

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}
  • playerTime (Obbligatorio)
    • playhead: deve essere in secondi, ma può essere in compensazione.
    • ts: marca temporale; deve essere in millisecondi.
  • eventType (Obbligatorio)
  • params (Facoltativo)
  • customMetadata (Facoltativo; invia solo con i tipi di evento adStart e chapterStart)
  • qoeData (Facoltativo)

Per un elenco dei tipi di evento validi per questa versione, consulta Tipi di eventi e descrizioni.

IMPORTANTE

**Tracciamento annunci:**puoi tenere traccia degli annunci solo all’interno di unadBreak.

In assenza di “bookend” adBreakStart e adBreakComplete intorno agli annunci, gli eventi adStart e adComplete verranno semplicemente ignorati e la corrispondente durata dell’annuncio verrà tracciata come durata del contenuto principale. Ciò potrebbe avere un impatto significativo sui dati aggregati che saranno disponibili in Adobe Analytics.

Risposta

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

Codici di risposta HTTP

Codice di risposta HTTP Descrizione Elementi azione client
204 Nessun contenuto.

Chiamata heartbeat riuscita.
N/D
400 Richiesta errata.

Formato della richiesta non corretto.
Controlla gli schemi di convalida JSON per il tipo di richiesta.
404 Non trovato.

Impossibile trovare l’ID sessione della sessione multimediale nel servizio back-end.
L’applicazione client deve utilizzare l’API Richiesta sessioni per creare un’altra sessione multimediale e segnalarne il tracciamento.
410 Perso.

La sessione multimediale è stata trovata nel servizio back-end, ma il client non può più segnalarne l’attività.
L’applicazione client deve utilizzare l’API Richiesta sessioni per creare un’altra sessione multimediale e segnalarne il tracciamento.
500 Errore del server N/D

In questa pagina