Documentazione Analytics Guida ai servizi Streaming Media

Panoramica overview

Ultimo aggiornamento: 23 maggio 2026

Creato per:

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.x.

IMPORTANT

Se implementi una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.

La riproduzione degli annunci include il tracciamento delle interruzioni, gli avvii, i completamenti e i salti degli annunci. Utilizza l’API del lettore multimediale per identificare gli eventi chiave del lettore e popolare le variabili di annuncio obbligatorie e facoltative.

Eventi del lettore player-events

All’avvio dell’interruzione dell’annuncio

NOTE

Inclusione del pre-roll

Crea un’istanza dell’oggetto adBreak per l’interruzione dell’annuncio. Ad esempio, adBreakObject.
Esegui la chiamata trackEvent per l’avvio dell’annuncio con adBreakObject.

A ogni avvio di risorse annuncio

Crea un’istanza di oggetto annuncio per la risorsa annuncio. Ad esempio, adObject.
Popola i metadati dell’annuncio, adCustomMetadata.
Esegui la chiamata trackEvent per l’avvio dell’annuncio.

A ogni annuncio completato

Esegui la chiamata trackEvent per l’annuncio completato.

Al salto dell’annuncio

Esegui la chiamata trackEvent per il salto dell’annuncio.

All’interruzione annuncio completata

Esegui la chiamata trackEvent per l’interruzione annuncio completata.

Implementare il tracciamento degli annunci implement-ad-tracking

Costanti di tracciamento degli annunci

Nome costante

Descrizione

AdBreakStart

Costante per il tracciamento dell’evento di avvio AdBreak

AdBreakComplete

Costante per il tracciamento dell’evento AdBreak Complete

AdStart

Costante per il tracciamento dell’evento Ad Start

AdComplete

Costante per il tracciamento dell’evento Ad Complete

AdSkip

Costante per il tracciamento dell’evento Ad Skip

Passaggi di implementazione

Identifica quando inizia il limite dell’interruzione dell’annuncio, incluso il pre-roll, e crea un AdBreakObject utilizzando le informazioni sull’interruzione dell’annuncio.

Specifihe di AdBreakObject:

table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center
Nome variabile	Descrizione	Obbligatorio
`name`	Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll.	Sì
`position`	La posizione numerica dell’interruzione pubblicitaria all’interno del contenuto, a partire da 1.	Sì
`startTime`	Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria.	Sì

Esegui la chiamata trackEvent() con AdBreakStart nell’istanza MediaHeartbeat per iniziare a tracciare l’interruzione dell’annuncio.

Identifica quando inizia l’annuncio e crea un’istanza AdObject utilizzando le informazioni sull’annuncio.

Specifihe di AdObject:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
Nome variabile	Descrizione	Obbligatorio
`name`	Nome descrittivo dell’annuncio.	Sì
`adId`	Identificatore univoco per l’annuncio.	Sì
`position`	La posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, a partire da 1.	Sì
`length`	Lunghezza annuncio	Sì

Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento tramite variabili di dati di contesto.
- Metadati degli annunci standard: per i metadati standard degli annunci, crea un dizionario di coppie di valori chiave di annunci standard utilizzando le chiavi per la piattaforma.
- Metadati degli annunci personalizzati: per i metadati personalizzati, crea un oggetto variabile per le variabili di dati personalizzate e popolalo con i dati dell’annuncio corrente.
Esegui la chiamata trackEvent() con l’evento AdStart nell’istanza MediaHeartbeat per iniziare a tracciare la riproduzione dell’annuncio.

Includi un riferimento alla variabile di metadati personalizzata (o a un oggetto vuoto) come terzo parametro nella chiamata dell’evento. Durante la riproduzione dell’annuncio, mantenere la testina di riproduzione del contenuto (l:event:playhead) fissa nella posizione in cui è iniziata l’interruzione pubblicitaria; se si avanza durante la riproduzione dell’annuncio, il tempo trascorso per il contenuto viene sovrascritto.
Quando la riproduzione dell’annuncio ne raggiunge la fine, esegui la chiamata trackEvent() con l’evento AdComplete.
Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltarlo, traccia l’evento AdSkip.
Se ci sono annunci aggiuntivi all’interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.
Al termine dell’interruzione pubblicitaria, utilizza l’evento AdBreakComplete per tracciarla.

IMPORTANT

Annunci pre-roll: non chiamare trackPlay prima di AdBreakStart e AdStart. Il primo ping play sugli incrementi di contenuto principale Inizia il contenuto. Se trackPlay viene chiamato prima che gli eventi dell'annuncio pre-roll si attivino e il visualizzatore si abbandona durante l'annuncio, il contenuto inizia a essere incrementato anche se non è mai stato riprodotto alcun contenuto principale. Per gli scenari pre-roll, ritardare trackPlay fino a dopo l'invio di AdBreakStart e AdStart.

NOTE

Il valore della testina di riproduzione segnalato durante la riproduzione dell'annuncio rappresenta la posizione del visualizzatore all'interno del contenuto principale, non all'interno dell'annuncio. Per un annuncio pre-roll che precede un video di 10 minuti, la testina di riproduzione è 0 in tutto l'annuncio. Per un annuncio mid-roll che inizia con il segno dei 5 minuti, la testina di riproduzione rimane a 300 (secondi) per la durata dell’annuncio.

Il codice di esempio seguente utilizza l’SDK JavaScript 2.x per un lettore multimediale HTML5.

/* Call on ad break start */

if (e.type == "ad break start") {
    var adBreakObject = MediaHeartbeat.createAdBreakObject("mid-roll", 2, 500);
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject);
};

/* Call on ad start */
if (e.type == "ad start") {
    var adObject = MediaHeartbeat.createAdObject("PepsiOne", "123456ab", 1, 30);
    /* Set custom context data */
    var adCustomMetadata = {
        affiliate:"Sample affiliate",
        campaign:"Sample ad campaign",
        creative:"Sample creative"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata);
};

/* Call on ad complete */
if (e.type == "ad complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete);
};

/* Call on ad skip */
if (e.type == "ad skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip);
};

/* Call on ad break complete */
if (e.type == "ad break complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete);
};

recommendation-more-help

media-analytics-help