THEOplayer Android SDK Nielsen Connector
The Nielsen connector provides a Nielsen integration for THEOplayer Android SDK.
Prerequisites
The THEOplayer Android SDK Nielsen Connector requires the application to import the THEOplayer Android SDK since the connector relies on its public APIs. For more details, check out our Getting started on Android guide.
Installation
After setting up the THEOplayer Android SDK, in your module level build.gradle
file add the THEOplayer
Android SDK Nielsen Connector and the Nielsen SDK dependencies:
implementation 'com.theoplayer.android-connector:nielsen:+'
implementation 'com.nielsenappsdk.global:ad:9.1.0.0'
Also in the build.gradle
file, specify the Nielsen maven repository inside the repositories section:
repositories {
maven { url 'https://maven.theoplayer.com/releases/' }
maven { url 'https://raw.githubusercontent.com/NielsenDigitalSDK/nielsenappsdk-android/master/'}
}
Usage
Setting up the Nielsen Connector
val theoplayerView: THEOplayerView
private fun setupNielsen() {
val appId = "your_nielsen_app_id"
val debug = true
nielsenConnector = NielsenConnector(applicationContext, theoplayerView.player, appId, debug)
}
Updating metadata
Whenever a new source is set on the player, update the current metadata as follows:
theoplayerView.player.source = sourceDescription
nielsenConnector?.updateMetadata(hashMapOf(
"assetid" to "C112233",
"program" to "programName"
))
Destroying / Cleaning up
To release listeners and resources, call destroy whenever the Nielsen Connector is no longer needed.
nielsenConnector?.destroy()
Note:
- After destroying a Nielsen Connector instance, it can no longer be used. If needed, a new instance should be created.