Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 2.x. Se stai implementando una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.
Nome costante | Descrizione |
---|---|
MediaHeartbeat.Event.AdBreakStart |
Costante per il tracciamento dell’evento AdBreak Start |
MediaHeartbeat.Event.AdBreakComplete |
Costante per il tracciamento dell’evento AdBreak Complete |
MediaHeartbeat.Event.AdStart |
Costante per il tracciamento dell’evento Ad Start |
MediaHeartbeat.Event.AdComplete |
Costante per il tracciamento dell’evento Ad Complete |
MediaHeartbeat.Event.AdSkip |
Costante per il tracciamento dell’evento Ad Skip |
Identificate quando inizia il limite di interruzione annuncio, incluso il pre-roll, e create un’interruzione AdBreakObject
utilizzando le informazioni di interruzione annuncio.
AdBreakObject
riferimento:
Nome della variabile | Descrizione | Obbligatorio |
---|---|---|
name |
Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll. | Sì |
position |
La posizione numerica dell’interruzione annuncio all’interno del contenuto, a partire da 1. | Sì |
startTime |
Valore dell’indicatore di riproduzione all’inizio dell’interruzione dell’annuncio. | Sì |
Creazione oggetto di interruzione annuncio:
MediaObject adBreakInfo =
MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
<POSITION>,
<START_TIME>);
Chiama trackEvent()
con AdBreakStart
nell’ MediaHeartbeat
istanza per iniziare a monitorare l’interruzione dell’annuncio:
public void onAdBreakStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
adBreakInfo,
null);
}
Identificare quando inizia l’annuncio e creare un’ AdObject
istanza utilizzando le informazioni sull’annuncio.
AdObject
riferimento:
Nome della variabile | Descrizione | Obbligatorio |
---|---|---|
name |
Nome descrittivo dell’annuncio. | Sì |
adId |
Identificatore univoco per l’annuncio. | Sì |
position |
La posizione del numero dell’annuncio all’interno dell’interruzione dell’annuncio, a partire da 1. | Sì |
length |
Lunghezza annuncio | Sì |
Creazione di oggetti annuncio:
MediaObject adInfo =
MediaHeartbeat.createAdObject(<AD_NAME>
<AD_ID>,
<POSITION>,
<LENGTH>);
Se necessario, allegate metadati standard e/o di annunci alla sessione di tracciamento dei supporti tramite le variabili dei dati contestuali.
Metadati annunci personalizzati - Per i metadati personalizzati, create un oggetto variabile per le variabili dati personalizzate e compilate con i dati per l’annuncio corrente:
// Setting Ad Metadata
HashMap<String, String> adMetadata = new HashMap<String, String>();
adMetadata.put("affiliate", "Sample affiliate");
adMetadata.put("campaign", "Sample ad campaign");
Chiamate trackEvent()
con l’ AdStart
evento nell’ MediaHeartbeat
istanza per iniziare a monitorare la riproduzione dell’annuncio.
Includete un riferimento alla variabile di metadati personalizzata (o a un oggetto vuoto) come terzo parametro nella chiamata dell’evento:
public void onAdStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
adInfo,
adMetadata);
}
Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, invoca trackEvent()
con l’ AdComplete
evento:
public void onAdComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
}
Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltare l’annuncio, tieni traccia dell’ AdSkip
evento:
public void onAdSkip(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null);
}
Se ci sono altri annunci all’interno dello stesso AdBreak
, ripeti di nuovo i passaggi da 3 a 7.
Al termine dell’interruzione dell’annuncio, utilizzate l’ AdBreakComplete
evento per tenere traccia:
public void onAdBreakComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null);
}
Per ulteriori informazioni, consulta lo scenario di tracciamento della riproduzione VOD con annunci pre-roll.