Timeline 3: capitoli

VOD, annunci pre-roll, messa in pausa, buffering, visualizzazione del contenuto alla fine

I seguenti diagrammi illustrano la timeline della testina di riproduzione e la corrispondente timeline delle azioni di un utente. Di seguito sono riportati i dettagli di ciascuna azione e le relative richieste.

Dettagli azione

Azione 1 - Avvia sessione

Dettagli di implementazione

Questa chiamata segnala l'intenzione dell'utente di riprodurre un video. Restituisce un ID sessione ( {sid} ) al client utilizzato per identificare tutte le chiamate di tracciamento successive all’interno della sessione. Lo stato del giocatore non è ancora "in riproduzione", ma è invece "in partenza". I parametri di sessione obbligatori devono essere inclusi nella params mappa nel corpo della richiesta. Nel backend, questa chiamata genera una chiamata di avvio Adobe Analytics.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:sessionStart, params: {
        "media.playerName": "sample-html5-api-player",
        "analytics.trackingServer": "[ _YOUR-TS_ ]",
        "analytics.reportSuite": "[ _YOUR_RSID_ ]",
        "analytics.visitorId": "[ _YOUR_VISITOR_ID_ ]",
        "media.contentType": "VOD",
        "media.length": 60.3333333333333,
        "media.id": "VA API Sample Player",
        "visitor.marketingCloudOrgId": "[YOUR_MCID]",
        "media.name": "ClickMe",
        "media.channel": "sample-channel",
        "media.sdkVersion": "va-api-0.0.0",
        "analytics.enableSSL": false
    }
}

Azione 2 - Avvio del timer di ping

Dettagli di implementazione

Avvia il timer ping. Il primo evento ping dovrebbe quindi attivarsi di 1 secondo in se ci sono annunci pre-roll, 10 secondi in caso contrario.

Azione 3 - Avvio dell'interruzione dell'annuncio

Dettagli di implementazione

Gli annunci possono essere tracciati solo all’interno di un’interruzione pubblicitaria.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.podIndex": 0, "media.ad.podSecond": 0
    }
}

Azione 4 - Avvio dell'annuncio

Dettagli di implementazione

Inizia a tenere traccia del primo annuncio pre-roll, che è lungo 15 secondi. Inclusione di metadati personalizzati con questo adStart .

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 1",
        "media.ad.id": "001",
        "media.ad.length": 15,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "1",
        "media.ad.creativeId": "42",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz_creative.com",
        "media.ad.placementId": "sample_placement"
    },
    customMetadata: {
        "myCustomData1": "CustomData1",
        "myCustomData2": "CustomData2"
    }
}

Azione 5: ping di annunci

Dettagli di implementazione

Eseguire il ping del backend ogni 1 secondo. (Gli annunci successivi non vengono visualizzati nell’interesse della brevità.)

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 6 - Annuncio completo

Dettagli di implementazione

Monitora la fine del primo annuncio pre-roll.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

Azione 7 - Avvio dell'annuncio

Dettagli di implementazione

Tieni traccia dell’inizio del secondo annuncio pre-roll, che è lungo 7 secondi.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 2",
        "media.ad.id": "002",
        "media.ad.length": 7,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "2",
        "media.ad.creativeId": "44",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

Azione 8 - Elementi ad ping

Dettagli di implementazione

Eseguire il ping del backend ogni 1 secondo. (Gli annunci successivi non vengono visualizzati nell’interesse della brevità.)

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 9 - Annuncio completo

Dettagli di implementazione

Monitora la fine del secondo annuncio pre-roll.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

Azione 10 - Completamento dell’interruzione dell’annuncio

Dettagli di implementazione

La pausa pubblicitaria è finita. Durante la pausa pubblicitaria, lo stato di gioco è rimasto "play".

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

Azione 11 - Riprodurre il contenuto

Dettagli di implementazione

Dopo l'evento adBreakComplete , inserisci il lettore nello stato di "riproduzione" utilizzando l'evento play .

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:play
}

Azione 12 - Inizio capitolo

Dettagli di implementazione

Dopo l'evento di riproduzione, tenere traccia dell'inizio del primo capitolo.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:chapterStart, params: {
        "media.chapter.index": 1,
        "media.chapter.offset": 0, "media.chapter.length": 20, "media.chapter.friendlyName": "Chapter Uno"
    },
}

Azione 13 - Ping

Dettagli di implementazione

Esegui il ping del backend ogni 10 secondi.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 8,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 14 - Avvio del buffer

Dettagli di implementazione

Monitora lo spostamento allo stato di "buffering".

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 11,
        ts: <timestamp>
    },
    eventType:bufferStart
}

Azione 15 - Fine buffer (play)

Dettagli di implementazione

Il buffering termina dopo 3 secondi, quindi riportare il lettore allo stato di "riproduzione". Devi inviare un altro evento di riproduzione del brano che esce dal buffering. La play chiamata dopo una chiamata bufferStart deduce una chiamata "bufferEnd" al back-end, quindi non è necessario un bufferEnd evento.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 11,
        ts: <timestamp>
    },
    eventType:play
}

Azione 16 - Ping

Dettagli di implementazione

Esegui il ping del backend ogni 10 secondi.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 15,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 17 - Capo finale

Dettagli di implementazione

Il primo capitolo termina, subito prima della seconda interruzione pubblicitaria.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 20,
        ts: <timestamp>
    },
    eventType:chapterComplete
}

Azione 18 - Avvio ad break

Dettagli di implementazione

Media roll con una durata di 8 secondi: invia adBreakStart .

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod2",
        "media.ad.podIndex": 1, "media.ad.podSecond": 21
    }
}

Azione 19 - Inizio annuncio

Dettagli di implementazione

Tieni traccia dell’annuncio mid-roll.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod2",
        "media.ad.name": "Ad 3",
        "media.ad.id": "003",
        "media.ad.length": 8,
        "media.ad.podPosition": 2,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "7",
        "media.ad.creativeId": "40",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

Azione 20 - Ad Pings

Dettagli di implementazione

Eseguire il ping del backend ogni 1 secondo. (Gli annunci successivi non vengono visualizzati nell’interesse della brevità.)

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 21 - Annuncio completo

Dettagli di implementazione

L'annuncio mid-roll è completo.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adComplete
}

Azione 22 - Annuncio interrotto completato

Dettagli di implementazione

L'interruzione pubblicitaria è completa.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

Azione 23 - Inizio capitolo

Dettagli di implementazione

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 22,
        ts: <timestamp>
    },
    eventType:chapterStart, params: {
        "media.chapter.index": 2,
        "media.chapter.offset": 22, "media.chapter.length": 22, "media.chapter.friendlyName": "Chapter Dos"
    },
}

Azione 24 - Ping

Dettagli di implementazione

Esegui il ping del backend ogni 10 secondi.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 27,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 25 - Pausa

Dettagli di implementazione

L'azione dell'utente sposta lo stato di riproduzione su "messo in pausa".

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    },
    eventType:pauseStart
}

Azione 26 - Ping

Dettagli di implementazione

Esegui il ping del backend ogni 10 secondi. Il lettore è ancora nello stato "buffering"; l’utente rimane bloccato a 20 secondi di contenuto. Fumare…

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 27 - Riprodurre il contenuto

Dettagli di implementazione

Sposta lo stato di riproduzione su "riproduzione". La play chiamata dopo una chiamata pauseStart deduce una chiamata di "ripresa" al back-end, quindi non è necessario un resume evento.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    },
    eventType:play
}

Azione 28 - Ping

Dettagli di implementazione

Esegui il ping del backend ogni 10 secondi.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 37,
        ts: <timestamp>
    },
    eventType:ping
}

Azione 29 - Capo finale

Dettagli di implementazione

Traccia la fine del secondo e ultimo capitolo.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:chapterComplete
}

Azione 30 - Sessione completa

Dettagli di implementazione

Invia sessionComplete al backend per indicare che l'utente ha terminato di guardare l'intero contenuto.

Corpo della richiesta di esempio

{
    playerTime: {
        playhead: 45,
        ts: <timestamp>
    },
    eventType:sessionComplete
}