Datazoom is a high-availability real-time data collection solution. This document summarizes how to integrate your Akamai Adaptive Media Player with the Datazoom platform.
Login to Datazoom here: https://app.datazoom.io
Add a Collector as indicated here: How to add a Collector
CONFIG ID to be used in the subsequent steps
Akamai Player: Plugin Integration
Datazoom provides plugins for data collection through our Beacon Services. Integrate the Akamai Player plugin into your web application with the following snippet:
Insert this JS line into your HTML
Replace the CONFIG_ID value with collector configuration ID.
This inserts Datazoom's data collection SDK into the page.
Option 1: Activate Data Collection for an Existing Akamai Player Instance
This is the standard option for customers who only need to collect data from the video player and are not concerned with joining player events with CDN logs or sending CMCD data to a CDN.
To activate data collection for an Akamai player instance, create a Datazoom context which references the player instance with the following snippet:
Option 2: Have Datazoom Create an Akamai Player with Data Collection Activated
This option is necessary if you are joining Player & CDN Log data together or want to send CMCD data to a CDN. In this option, Datazoom will handle instantiation of the player with the necessary hooks required to insert parameters like Content Session ID & Request ID in every media request the player makes.
An Akamai player instance can be created with Datazoom data collection activated, using the following snippet:
By creating a player instance through the
datazoom.createContextAndPlayer() method, it enables Datazoom to collect more player information to assist QoE monitoring and distributed tracing.
Stop Data Collection
If the data collection must be stopped for any reason, for example after the destruction of the corresponding player instance, invoke the
destroy() method of the Datazoom context object as in the following example: