Logo

Getting started

How to setup an Integration through Tealium

To integrate a Datazoom collector through Tealium’s management interface, the customer should perform the following two steps:

  • Create a Tealium Generic Tag

  • Create a Javascript Code Extension (tag scoped to the tag above)

Create a Tealium Generic Tag with the following configurations:

Title

A string to represent this tag, for example: My Collector

Type

Script

Base URL

The Datazoom SDK URL excluding the query string, for example: https://platform.datazoom.io/beacon/v1/config

Query String

The query string of the Datazoom SDK URL, for exampe: configuration_id=b379c263-92f1-445d-b63e-06d87c1005f0

Request Script Once

Enable (see notes below)

Bundle Flag

Off (see notes below)

Use default values for the remaining configuration fields.

Request Script Once - Works only with Script Type. Enable this feature to request the base script only once. When enabled, the script will be requested once per page load and all subsequent virtual calls will go straight to the callback.

Bundle Flag - Determines if the tag code is bundled into utag.js. This will reduce the number of server requests.

Create a Javascript Code Extension (located under the Advanced tab) with the following configurations:

Title

A string to represent this extension, for example: My Collector JS Extension

Scope

Tag Scoped Extensions; select the tag to associate with (e.g., My Collector)

Configuration

Enter Javascript code snippet such as:

u.callback = function() {
    datazoom.createContext(player);
    datazoom.setMetadata({ test: 123 });
}

The code inside u.callback() will run after the main library has loaded.

Line 2 assumes that the video player instance is stored in a global variable named player

The calling of datazoom.createContext() is a required step to set up data collection from the player instance. The other calls such as datazoom.setMetadata() are optional.