Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Wenn Sie Version 1.x des SDK implementieren möchten, können Sie sich hier die Entwicklerhandbücher herunterladen: SDKs herunterladen.
Konstantenname | Beschreibung |
---|---|
MediaHeartbeat.Event.AdBreakStart |
Konstante für die Verfolgung des AdBreak Start-Ereignisses |
MediaHeartbeat.Event.AdBreakComplete |
Konstante für die Verfolgung des AdBreak Complete-Ereignisses |
MediaHeartbeat.Event.AdStart |
Konstante für die Verfolgung des Ad Start-Ereignisses |
MediaHeartbeat.Event.AdComplete |
Konstante für die Verfolgung des Ad Complete-Ereignisses |
MediaHeartbeat.Event.AdSkip |
Konstante für die Verfolgung des Ad Skip-Ereignisses |
Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein AdBreakObject
mithilfe dieser Pauseninformationen.
AdBreakObject
-Referenz:
Variablenname | Beschreibung | erforderlich |
---|---|---|
name |
Name der Werbeunterbrechung, z. B. Pre-Roll, Mid-Roll oder Post-Roll. | Ja |
position |
Positionsnummer der Werbeunterbrechung innerhalb des Inhalts, beginnend bei 1. | Ja |
startTime |
Abspielpositionswert bei Start der Werbeunterbrechung. | Ja |
Erstellung von Werbeunterbrechungsobjekten:
MediaObject adBreakInfo =
MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
<POSITION>,
<START_TIME>);
Rufen Sie trackEvent()
mit AdBreakStart
in der MediaHeartbeat
-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:
public void onAdBreakStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
adBreakInfo,
null);
}
Ermitteln Sie, wann die Anzeige startet und erstellen Sie die AdObject
-Instanz mithilfe dieser Anzeigeninformationen.
AdObject
-Referenz:
Variablenname | Beschreibung | erforderlich |
---|---|---|
name |
Der Anzeigename der Werbeanzeige. | Ja |
adId |
Eindeutige Kennung für die Anzeige. | Ja |
position |
Positionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1. | Ja |
length |
Anzeigenlänge | Ja |
Erstellung von Anzeigenobjekten:
MediaObject adInfo =
MediaHeartbeat.createAdObject(<AD_NAME>
<AD_ID>,
<POSITION>,
<LENGTH>);
Optional können Standard- und/oder Anzeigenmetadaten über Kontextdatenvariablen an die Medien-Tracking-Sitzung angehängt werden.
Anwenderspezifische Anzeigenmetadaten: Erstellen Sie für anwenderdefinierte Metadaten ein variables Objekt für die anwenderspezifischen Datenvariablen und füllen Sie es mit den Daten für aktuelle Anzeigen:
// Setting Ad Metadata
HashMap<String, String> adMetadata = new HashMap<String, String>();
adMetadata.put("affiliate", "Sample affiliate");
adMetadata.put("campaign", "Sample ad campaign");
Rufen Sie trackEvent()
mit dem AdStart
-Ereignis in der MediaHeartbeat
-Instanz auf, um das Tracking der Anzeigenwiedergabe zu starten.
Fügen Sie als dritten Parameter im Ereignisaufruf eine Referenz auf Ihre anwenderdefinierte Metadatenvariable (oder ein leeres Objekt) ein:
public void onAdStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
adInfo,
adMetadata);
}
Wenn die Wiedergabe der Anzeige das Ende der Anzeige erreicht, rufen Sie trackEvent()
mit dem AdComplete
-Ereignis auf:
public void onAdComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
}
Wenn die Anzeigenwiedergabe nicht abgeschlossen wurde, weil der Benutzer die Anzeige überspringt, verfolgen Sie das AdSkip
-Ereignis:
public void onAdSkip(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null);
}
Wiederholen Sie die Schritte 3 bis 7, wenn dieselbe AdBreak
weitere Anzeigen enthält.
Wenn die Werbeunterbrechung abgeschlossen ist, verwenden Sie zum Tracking das AdBreakComplete
-Ereignis:
public void onAdBreakComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null);
}
Weitere Informationen finden Sie im Tracking-Szenario VOD-Wiedergabe mit Pre-roll-Anzeigen.