DocumentatieAnalyticsHandleiding voor Streaming Media-services

Advertenties bijhouden op Roku track-ads-on-roku

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

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

De volgende instructies bieden richtlijnen voor implementatie met behulp van de 2.x SDK's.

IMPORTANT
Als u een 1.x versie van SDK uitvoert, kunt u 1.x de Gidsen van Ontwikkelaars hier downloaden: ​ Download SDKs.

Constanten voor bijhouden van advertenties

Naam van constante
Beschrijving
AdBreakStart
Constante voor het bijhouden van de gebeurtenis AdBreak Start
AdBreakComplete
Constante voor het bijhouden van de gebeurtenis AdBreak Complete
AdStart
Constante voor het bijhouden van de gebeurtenis Ad Start
AdComplete
Constante voor het bijhouden van de gebeurtenis Advertentie voltooid
AdSkip
Constante voor het bijhouden van de gebeurtenis Advertentie overslaan

Implementatiestappen

  1. Bepaal wanneer de grens van de advertentieruimte begint, met inbegrip van pre-rol, en creeer AdBreakObject door de informatie van de advertentierak te gebruiken.

    AdBreakObject reference:

    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
    Naam variabele Beschrijving Vereist
    name De naam van het invoegpunt, zoals pre-roll, mid-roll en post-roll. Ja
    position De getalpositie van het advertentiespoor dat met 1 begint. Ja
    startTime Waarde van afspeelkop aan het begin van het advertentieeinde. 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. Roep trackEvent() aan met AdBreakStart in de MediaHeartbeat -instantie om het ad-einde te volgen:

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

  3. Bepaal wanneer het advertentie-element begint en maak een AdObject -instantie met behulp van de advertentie-informatie.

    code language-none 
    adInfo =
  adb_media_init_adinfo(ad.title,
                        ad.id,
                        ad.position,
                        ad.duration)

  4. Voeg desgewenst standaard- en/of advertentiemetagegevens toe aan de mediatraceringssessie via de variabelen van de contextgegevens.

    • Standaard en metagegevens implementeren op Roku

    • Douane en meta-gegevens - voor douanemetagegevens, creeer een veranderlijk voorwerp voor de variabelen van douanegegevens en bevolk met de gegevens voor het huidige ad activa:

      code language-none 
      contextData = {}
contextData["adinfo1"] = "adinfo2"
contextData["adinfo2"] = "adinfo2"

  5. Roep trackEvent() aan met de gebeurtenis AdStart in de instantie MediaHeartbeat om het afspelen van de advertentie te starten:

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

  6. Wanneer het afspelen van de advertentie het einde van de advertentie heeft bereikt, roept u trackEvent() aan met de gebeurtenis AdComplete .

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

  7. Als het afspelen van de advertentie niet is voltooid omdat de gebruiker de advertentie heeft overgeslagen, houdt u de gebeurtenis AdSkip bij:

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

  8. Herhaal stap 3 tot en met 7 opnieuw als er extra advertenties binnen dezelfde AdBreak zijn.

  9. Wanneer het ad-einde is voltooid, gebruikt u de gebeurtenis AdBreakComplete om bij te houden:

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

Zie het volgende scenario ​ de playback van VOD met pre-roladvertenties ​ voor meer informatie.

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