DocumentazioneAnalyticsGuida a Streaming Media Collection

Richiesta eventi events-request

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

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.

IMPORTANT
**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
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb