Nachverfolgen von Anzeigen auf Android
Erstellt für:
- Benutzende
- Admin
- Entwickler
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Anzeigen-Tracking-Konstanten
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 |
Implementierungsschritte
-
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()
mitAdBreakStart
in derMediaHeartbeat
-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:VariablennameBeschreibungerforderlichname
Der Anzeigename der Werbeanzeige.JaadId
Eindeutige Kennung für die Anzeige.Japosition
Positionsnummer der Anzeige in der Werbeunterbrechung, beginnend bei 1.Jalength
AnzeigenlängeJaErstellung 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.
help/use-cases/track-ads/impl-std-ad-metadata/impl-std-ad-metadata-android.md
-
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 demAdStart
-Ereignis in derMediaHeartbeat
-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 demAdComplete
-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.