User Guide - Anvato Video Analytics Plugin for Adobe Flash© video players

Version 1.3

Introduction:

Anvato Video Analytics is the enterprise-class video analytics solution. It provides rich insights into your video traffic, user engagement, and marketing effectiveness. Powerful, flexible and easy-to-use features now let you see and analyze your video traffic data in an entirely new way. With Anvato Analytics, you will not only learn more about your audience, who they are and where they come from, but also learn how they consume and interact with your video.Equipped with powerful insights, you are more prepared to write better-targeted ads and strengthen your marketing initiatives.

Features

Anvato Analytics provides video-centric metrics such as:

  • Playtime and play count,
  • Playthrough statistics (what percentage of the video has been played),
  • Hotspot analysis (which part of your video is watched the most),
  • User engagement (e.g., play, pause, rewind, seek, and replay actions),
  • Viral distribution statistics (e.g., sharing and embedding sites),
  • In-video ads impressions and ad revenue (Requires Anvato Ads plug-in)

The interactive reporting allows you to:

  • Overlay user engagement statistics on the video as the video plays
  • Overlay traffic on a map and analyze the geographic distribution of your audience
  • Analyze data by content, audience, geography and time

Integration

Integrating the Analytics to your players should take just a few minutes:

  • If you are using one of supported players, you have ready made plugins, just change a couple of variables and you are ready to go.
  • If you have a custom player, follow our directions to insert a couple of lines of code inside your player and recompile.

We also provide you all the test tools so that you can test before you deploy. If you have any questions you can always visit us at http://support.anvato.com and contact us via email or phone.

Requirements:

  • Anvato analytics plug-in
  • Flash video player
  • Anvato Analytics account

Getting Started with Anvato Analytics

1. Get an analytics account at http://analytics.anvato.com

Once you complete the sign-up process, you will receive an email to activate your account. You need to verify your email to activate your account.

2. Add a new tracker in your account:

Anvato Analytics uses unique trackers (embedded keys) to track each video and associated user statistics.

Once activated, login into your account. You need to create your first tracker.

You will enter the tracker name and your preferred time zone. Anvato analytics will report the statistics according to your time zone. Site URL is optional, it helps us get to know you.

When you add a tracker, the server will provide a unique tracker key and shows the status of your tracker key. Initially as there is no data submitted to the server, therefore, the status should be "no data"

3. Installing tracker key in to your player:

You need to install the tracker key in your player to start receiving video and user analytics. Select "Install Tracker" link to learn how to install your tracker into various different types of flash players.

  • If you use one of the popular open source video players or a player which was derived from one of the open source video players such as JW Player and Flow Player, you can use the appropriate plug-in provided by Anvato. Integrating analytics plug-in for these players is super easy, just add couple of parameters into "flashvars" in your HTML code.
  • If you use a custom video player that use standard Adobe classes to display video, such as FLVPlayback, NetStream, Video Display or Video Classes, you will integrate analytics with your player using Anvato Analytics ActionScript API. This is easier than it sounds: All you need to do is add a small piece of code to your player, download and initialize the plug-in. If you need help integrating Anvato analytics your player, please contact us.

The Anvato Analytics Plugin for flash is a small flash module (17kB, swf) that tracks both user engagement and video player statistics. Any flash video player can load this module dynamically. Once activated, it will collect statistics and deliver them to the Anvato Analytics server farm so that you can view analytics online at http://analytics.anvato.com . Because the plug-in sends data silently to your Anvato analytics account, you will not notice anything different about your player after it is installed.

3.1. Installing the tracker in JW Player:

If your player is a JW Player 4.1 or above, set your 'plugins' flashvar to include 'anvanalytics'. JW Player will automatically load Anvato analytics plug-in from Long Tail Video plug-in site.

Note that, JW player uses (http://longtail.com/plugins) as the default plugin directory to load Plugins, if your player does not use default plugin directory, you need to download the Anvato Analytics plug-in for JW flash player and place it in your site's plug-in directory.

Here are some examples of how to use the Anvato Video Analytics plugin with your JW player.

SWFObject 1.5 Code:

	
<script type="text/javascript"> var so = new SWFObject('player.swf','single','700','450','9'); so.addParam("allowfullscreen","true"); so.addParam("flashvars","file=video.flv&plugins=anvanalytics&anvanalytics.anavato_tracker=XXXXXXXX;"); so.write('mydiv'); </script>
	
<embed src="http://www.yoursite.com/player.swf" width="400" height="320" allowscriptaccess="always" allowfullscreen="true" flashvars="plugins=anvanalytics&anvanalytics.anvtracker=XXXXXXXX;" />

3.2. Installing Anvato analytics tracker key in Flow Player:

If your player is a Flowplayer 3.1 or above, all you need to do is configure your 'plugins' to include 'anvanalytics'. It will load the plugin automatically.

Here are examples of how to use the Anvato Video Analytics plugin with your Flow player. Note that flowplayer does not have title property in default configuration, however you can pass title information using custom property in the flow javascript embed code.

	
<script> <div id="player" style="width:480px;height:270px"></div> flowplayer("player", "flowplayer.swf", { plugins: { anvanalytics: { url: '../swf/anvato_analytics.swf', config: { anvtracker:'xxxxxxxx', } } }, playlist: [ { url: Ôyourvideo.flvÕ, autoPlay: true, title: 'Popeye The Sailor Ancient Fantasy', } ] }); </script>

3.3. Installing Anvato analytics key in other Flash/Flex players:

To install Anvato Analytics tracker in flash players that use standard video player components such as FLVPlayback, Netstream, Video Display, Video Display classes, you need to go through two steps:

Insert the standard plug-in loading code (swfloader) to load the Anvato Analytics plug-in

Initialize the tracker.

Analytics API has examples and source code to show how this is done.

Security settings for trackers:

To improve security and integrity of the analytics data, Anvato not only uses flash player security standards but also filters the data by the video player. This way, it will be much harder for people to hack or pollute your analytics data.

To improve the security of your data, login to Anvato Analytics and add the URL of your player.

Here are step by step instructions:

Click "Manage Filters" and add the URL of your player(s).


After you add the player, your player should show up in the list. The server will only use the analytics data that is generated by the player(s) from this site and this player.

Why is this more secure? If you do not verify your player, server would accept the analytics data that is generated by any player that has your tracker key. Malicious people may write players and embed your tracker key to pollute your analytics data. By verifying your player, you protect yourself against such attacks.

Viewing Reports

Anvato Analytics aggregates data generated by players into reports, each of which can help to answer specific questions about your viewers.

You can access analytics reports for each of your trackers using Òview reportÓ link in the action section of your trackers.

Once you click the Òview reportsÓ link, it will take the Dashboard. You can see the a summary of views, visits, unique visitors, top five videos, video play through statistics and geo-locations of the viewers.

There are five main views that provide you more details: You can use left menu to access them.

  • Dashboard: What is the summary of my video analytics?
  • Videos: What are my statistics per video, such as number of views, visits, play time, unique visitors etc.?
  • Traffic Sources: Which web pages does my traffic originate from?
  • Visitors: How loyal are my visitors? What percentage are new users?
  • Locations: Where are my users (e.g., by city)?

Dashboard summary

Dashboard summarizes video analytics data. It shows the views/visits/unique visitors, their trends graphs, top five videos that generates the most views and visits, video play through analytics and geo-locations of your viewers. The default date interval is two weeks, you can set the date range for any interval.

Videos summary

Video view shows the aggregate analytics for your videos. It uses video title  (if the video title is not provided, video URL is used) to report the data per video. It is important to give titles to your videos for intuitive reporting. Click to individual video to see detailed analytics for selected video.

Video details

Video details shows the video analytics for individual videos, such as viewership, geo-locations of viewers, user engagement and hot spot analysis, and traffic resources for this particular video. Video hot spot analysis shows how user engages with the video and which part of your video is watched the most. The video play through statistic shows what percentage of the video has been played. If your video is delivered via RTMP (i.e., streamed), you can jump to any point in the video on the hotspot graph by clicking with your mouse.

Traffic sources:

Traffic source panel lets you know which web pages generate your views and viewers. If you allow embedding your player in to different sites, you will see which sites and domains generate the most of the visitors/ unique visitors.This can give you an idea about the effectiveness of your marketing and syndication efforts.

Visitors:

You can look at visitor royalty and new versus returning users to learn how your site/video attract viewers and how long they stay on your site to view your videos.

Locations:

Analyze the geo-locations of your viewers and views. Use the interactive map to drill down to city level information. Use top navigation menu to select the zoom level (e.g. city, country or world )



Changing the reporting time interval:

Anavato analytics uses last two weeks of data as the default interval. You can change the time interval by clicking "date range picker" area. It will open a date-picker that you can either select a pre defined range or any range from date picker press "Apply". Note that analytics severs updates the statistics every 15 minutes.

Changing chart type:

Selecting chart type will shown the trend graph data type.

Exporting reports:

Anvato analytics allow you to export the data shown he the view into either Microsoft Excel or in PDF format using export buttons on top-right of the views.

Customizing table columns:

You ca customize the table columns using "customize" button. This will open a box where you can select which analytic data that you want to be included in the table. It will dynamically update the table based on the selecting on check boxes.