DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Nachverfolgen von Anzeigen auf Roku track-ads-on-roku

Last update: Fri Feb 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.

IMPORTANT
Wenn Sie Version 1.x des SDK implementieren möchten, können Sie sich hier die Entwicklerhandbücher herunterladen: SDKs herunterladen.

Anzeigen-Tracking-Konstanten

Konstantenname
Beschreibung
AdBreakStart
Konstante für die Verfolgung des AdBreak Start-Ereignisses
AdBreakComplete
Konstante für die Verfolgung des AdBreak Complete-Ereignisses
AdStart
Konstante für die Verfolgung des Ad Start-Ereignisses
AdComplete
Konstante für die Verfolgung des Ad Complete-Ereignisses
AdSkip
Konstante für die Verfolgung des Ad Skip-Ereignisses

Implementierungsschritte

  1. 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 Anzeigenunterbrechung, z. B. Pre-roll, Mid-roll und 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>

  2. Rufen Sie trackEvent() mit AdBreakStart in der MediaHeartbeat-Instanz auf, um das Tracking der Werbeunterbrechung zu starten:

    code language-none 
    contextData = {}
ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)

  3. 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)

  4. Optional können Standard- und/oder Anzeigenmetadaten über Kontextdatenvariablen an die Medien-Tracking-Sitzung angehängt werden.

    • Standard-Anzeigenmetadaten in Roku implementieren ​

    • 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"

  5. Rufen Sie trackEvent() mit dem AdStart-Ereignis in der MediaHeartbeat-Instanz auf, um das Tracking der Anzeigenwiedergabe zu starten:

    code language-none 
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)

  6. Wenn die Wiedergabe des Anzeigen-Assets das Ende der Anzeige erreicht, rufen Sie trackEvent() mit dem AdComplete-Ereignis auf.

    code language-none 
    standardAdMetadata = {}
contextData = {}
ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)

  7. 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

  8. Wiederholen Sie die Schritte 3 bis 7, wenn dieselbe AdBreak weitere Anzeigen enthält.

  9. 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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb