Effectuer le suivi des publicités sur Roku track-ads-on-roku
Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.
Constantes de suivi des publicités
AdBreakStart
AdBreakComplete
AdStart
AdComplete
AdSkip
Procédure de mise en œuvre
-
Identifiez le moment où la limite de coupure publicitaire commence, y compris preroll, et créez un
AdBreakObject
à l’aide des informations de coupure publicitaire.Référence
AdBreakObject
: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 Nom de variable Description Obligatoire name
Nom de la coupure publicitaire tel que pre-roll, mid-roll et post-roll. Oui position
Position du nombre au début de la coupure publicitaire commençant par 1. Oui startTime
Valeur du curseur de lecture au début de la coupure publicitaire. Oui code language-none ‘ Create an adbreak info object adBreakInfo = adb_media_init_adbreakinfo() adBreakInfo.name = <ADBREAK_NAME> adBreakInfo.startTime = <START_TIME> adBreakInfo.position = <POSITION>
-
Appelez
trackEvent()
avecAdBreakStart
dans l’instanceMediaHeartbeat
pour commencer le suivi de la coupure publicitaire :code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
-
Déterminez le moment où la ressource de publicité commence, puis créez une instance
AdObject
à l’aide des informations sur la publicité.code language-none adInfo = adb_media_init_adinfo(ad.title, ad.id, ad.position, ad.duration)
-
Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi multimédia par le biais de variables de données contextuelles.
-
Métadonnées de publicité personnalisées - Pour les métadonnées personnalisées, créez un objet de variable pour les variables de données personnalisées et renseignez les données de la ressource de publicité actuelle :
code language-none contextData = {} contextData["adinfo1"] = "adinfo2" contextData["adinfo2"] = "adinfo2"
-
Appelez
trackEvent()
avec l’événementAdStart
dans l’instanceMediaHeartbeat
pour commencer le suivi de la lecture de publicité :code language-none ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
-
Lorsque la lecture de la ressource de publicité atteint la fin de la publicité, appelez
trackEvent()
avec l’événementAdComplete
.code language-none standardAdMetadata = {} contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
-
Si la lecture de la publicité ne s’est pas terminée car l’utilisateur a choisi d’ignorer la publicité, suivez l’événement
AdSkip
:code language-none contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
-
S’il existe d’autres publicités dans le même
AdBreak
, répétez les étapes 3 à 7. -
Lorsque la coupure publicitaire est terminée, utilisez l’événement
AdBreakComplete
pour en effectuer le suivi :code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
Consultez le scénario de suivi Lecture VOD avec publicités preroll pour en savoir plus.