Cloudinary Video Analytics

The Cloudinary Video Analytics package allows you to track analytics for your Cloudinary videos using video players other than the Cloudinary Video Player. The library targets the HTML5 video tag and is designed to work with any video player that use this tag. For more information view the documentation.

Usage

1. Install the package:

npm i cloudinary-video-analytics

2. Import the library:

import { connectCloudinaryAnalytics } from 'cloudinary-video-analytics';

3. Connect the analytics::

Connect the analytics by calling the connectCloudinaryAnalytics method and provide the video element as a parameter. For example, if your video element has the id ‘video-player’:

const videoElement = document.getElementById('video-player');
const cloudinaryAnalytics = connectCloudinaryAnalytics(videoElement);

4. Start tracking:

Start tracking analytics for any Cloudinary video by calling the startAutoTracking method:

cloudinaryAnalytics.startAutoTracking();

Alternatively, to track each video manually, call the startManualTracking method, providing your Cloudinary cloud name and the public id of the video you want to manually track:

cloudinaryAnalytics.startManualTracking({
  cloudName: 'demo',
  publicId: 'cld-sample',
})

Auto and manual tracking cannot be used together for the same video element. Manual tracking should only be used in cases where you need to track certain videos, you want to track a video tag element which is dynamic, or you have custom domains which require providing cloudName and publicId.

CodeSandbox examples

Native HTML Video Tag - Auto tracking
Native HTML Video Tag - Manual tracking