Nachverfolgen von Anzeigen auf Android track-ads-on-android
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Anzeigen-Tracking-Konstanten
MediaHeartbeat.Event.AdBreakStart
MediaHeartbeat.Event.AdBreakComplete
MediaHeartbeat.Event.AdStart
MediaHeartbeat.Event.AdComplete
MediaHeartbeat.Event.AdSkip
Implementierungsschritte
-
Ermitteln Sie, wann die Werbeunterbrechung beginnt, einschließlich Pre-Roll, und erstellen Sie ein
AdBreakObject
mithilfe dieser Pauseninformationen.AdBreakObject
-Referenz: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 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:
code language-java MediaObject adBreakInfo = MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
-
Rufen Sie
trackEvent()
mitAdBreakStart
in derMediaHeartbeat
-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:code language-java 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: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 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:
code language-java 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:
code language-java // 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:
code language-java 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:code language-java 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:code language-java 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:code language-java 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.