Post Message Integration for analytics

Post Message Integration for analytics

Post Message Integration for analytics

Ivory Studio makes it easy to push the analytics data of interactive videos via Post Message to the next layer of the website. This provides insight in the performance and impact of the interactive video. Moreover, this allows users to collect data to their own source and combine different datasets for the best possible interpretation of data.  


Use PostMessage 

To use PostMessage into your website first add a PostMessage listener to your website where the interactie video is embedded.
For additional information about PostMessage please check this article. 

Parameters

The following parameters are available.


Event
Explanation
Data
iv.playerLoad
Is activated as soon as the Ivory Player is loaded
n.a.
iv.playerUnload
for internal use only
n.a.
iv.videoLoad

Is activated as soon as the video is made available on the concerning webpage / device.

n.a.
videoLoaded
for internal use only
n.a.
iv.videoUnload
Is activated as soon as the browser is closed
viewed playing, seeking
iv.playIs activated as soon as the interactive video is played.
n.a.
iv.pause
Is activated as soon as the interactive video is paused
n.a.
timeupdate
Heartbeat of the timeline
duration, playing, time
iv.eleOn
Is activated as soon as an element is shown within the interactive video.
ivElementId, ivElementLabel
iv.interaction
Is activated as soon as a viewer interacts with an element.
ivElementId, ivElementLabel, ivInteraction
iv.eleoff
Is activated as soon as the element is passed.
ivElementId, ivElementLabel
iv.seek
Is activated as soon as the player is seeking / buffering after a jump in the timeline
ivElementId, ivElementLabel

Explanation Data

Data
Explanation
ivElementId
id of an element that is assigned by Ivory Studio
ivElementLabel

Label of an element that is assigned by the video‚Äôs creator. 

ivInteraction
The action that is performed by the viewer. The following interactions can be activated by the viewer: [click, mouseover] 
duration
Duration of timeline in miliseconds
playing / seeking
true or false
time
playtime in miliseconds
viewedThe time between iv_start and iv_videoUnload. Attention! not all browser will send the iv_videoUnload event by closing browser

Helpfull tools

This script will help you to show the data in the developers console of your browser. This will help you to find out which interaction is needed.

With timeupdate event
window.addEventListener('message', function(ev) {
   const message = JSON.parse(ev.data); 
    {
      console.log(message); 
   }
});

Without timeupdate event
window.addEventListener('message', function(ev) {
   const message = JSON.parse(ev.data); 
   if (message.type != 'timeupdate') {
      console.log(message); 
   }
});



    • Related Articles

    • Analytics report

      An analytics report is a digital printout (.pdf) of the user statistics of a specific project over a period of time. The report-function is used to save periodic statistics of a project and, if you wish to do so, to share these statistics with ...
    • Analytics dashboard

      Statistics for interactive video Analytics helps you gain insight in the click- and view behavior of your target audience. It is a display for user statistics that are collected by the player. By actively monitoring these statistics, you can gain ...
    • Google Tag Manager Integration

      Google Tag Manager Integration Ivory Studio makes it easy to send user data of interactive video’s to Google Tag Manager (GTM). This provides insight in the performance and impact of the interactive video. Moreover, this allows users to combine ...
    • Sending a WhatsApp message from a video

      Send a WhatsApp message from a video How cool is that! You can now send a WhatsApp message directly from a video. 1. Create an interaction You can set up an interaction on any component. Click on the blue ‘plus’ to create the interaction 2. Select ...
    • Quiz component

      The quiz component is a ready-to-go element that allows you to quickly and easily create a quiz video.   Step 1 You can add a quiz component in the components menu. Drag the component ‘quiz question’ to the timeline or to the canvas. You can also ...