Nachverfolgen von Anzeigen auf Roku track-ads-on-roku
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Anzeigen-Tracking-Konstanten
AdBreakStart
AdBreakComplete
AdStart
AdComplete
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, beginnend bei 1. Ja startTime
Abspielpositionswert bei Start der Werbeunterbrechung. Ja code language-none ‘ Create an adbreak info object adBreakInfo = adb_media_init_adbreakinfo() adBreakInfo.name = <ADBREAK_NAME> adBreakInfo.startTime = <START_TIME> adBreakInfo.position = <POSITION>
-
Rufen Sie
trackEvent()
mitAdBreakStart
in derMediaHeartbeat
-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
-
Ermitteln Sie, wann das Anzeigen-Assets beginnt, und erstellen Sie die
AdObject
-Instanz mithilfe dieser Anzeigeninformationen.code language-none adInfo = adb_media_init_adinfo(ad.title, ad.id, ad.position, ad.duration)
-
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 das aktuelle Anzeigen-Asset:
code language-none contextData = {} contextData["adinfo1"] = "adinfo2" contextData["adinfo2"] = "adinfo2"
-
Rufen Sie
trackEvent()
mit demAdStart
-Ereignis in derMediaHeartbeat
-Instanz auf, um das Tracking der Anzeigenwiedergabe zu starten:code language-none ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
-
Wenn die Wiedergabe des Anzeigen-Assets das Ende der Anzeige erreicht, rufen Sie
trackEvent()
mit demAdComplete
-Ereignis auf.code language-none standardAdMetadata = {} contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
-
Wenn die Anzeigenwiedergabe nicht abgeschlossen wurde, weil der Benutzer die Anzeige überspringt, verfolgen Sie das
AdSkip
-Ereignis:code language-none contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
-
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-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
Weitere Informationen finden Sie im Tracking-Szenario VOD-Wiedergabe mit Pre-roll-Anzeigen.