Skip to main content
Version: 7.12.0

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.