Ooyala IQ User Guide

OOYALA IQ USER GUIDE
CONTENTS
COPYRIGHT NOTICE
4
RELEASE NOTES
5
INTRODUCTION TO OOYALA IQ
9
How Ooyala IQ Works
Key Concepts
Three Steps of Ooyala IQ
Recording Metric Data
Aggregating and Summarizing Data
Reporting, Analyses, and Data Visualization
Data Retention
Conclusion
Common Metric Definitions and Examples
Browsers Supported By Ooyala IQ
Accessing Ooyala IQ
BUSINESS USE CASE EXAMPLES OF ANALYSES
Generalized Approaches to Analyses
What Type of Content is Performing the Best on Mobile Devices?
Online Media: How Are My Different Brands Performing?
What Geographies Are Driving My Content Traffic?
How Do I Optimize My Targeting of Ad Campaigns?
How Do I Uncover Videos With High Potential?
OOYALA IQ WORKSPACE REFERENCE
Ooyala IQ Dashboard
Business Intelligence Reports
Common Controls for Tables and Graphs
Analytics and Labels
Setting the Date Range on the Business Intelligence Page
Examining Videos Across Different Dimensions
Using Filters
Viewing Performance Metrics
Viewing Engagement Metrics
Viewing Reach Metrics
Viewing Playthrough Metrics
Viewing Expanded Table
Business Intelligence Error Handling
Video Details
MIGRATING FROM V2 ANALYTICS
v2/v3 Fundamental Difference: Multidimensional Analysis
Data Migration
9
9
11
11
12
13
13
13
14
18
18
20
20
21
22
22
23
24
25
26
27
27
28
29
30
30
34
35
35
36
37
37
38
40
40
40
OOYALA IQ USER GUIDE | TOC | 2
WWW.OOYALA.COM • [email protected] • 1-877-3-OOYALA
How to Export Your Data With the v2 Analytics API
Potential Differences in the Data
Analytics Graphical User Interface (GUI) Differences
v3 Analytics Application Programming Interface (API)
Certain "Unique" Metrics Confusing in v2 Analytics
ANALYTICS GLOSSARY
40
43
44
46
47
48
OOYALA IQ USER GUIDE | TOC | 3
WWW.OOYALA.COM • [email protected] • 1-877-3-OOYALA
COPYRIGHT NOTICE
Copyright Ooyala 2008-2015
Ooyala, Backlot, Ooyala Actionable Analytics, the Ooyala logo, and other Ooyala logos and product and
service names are trademarks of Ooyala, Inc. (“Ooyala Marks”). Company agrees not to remove any
Ooyala Marks that are contained within and/or affixed to the Services as provided to Company. Except
with respect to the foregoing, Company agrees not to display or use in any manner the Ooyala Marks
without Ooyala’s prior written permission. All contents of the Ooyala website and Services are: Copyright
2008-2015. Ooyala, Inc. All rights reserved. Ooyala and Backlot are registered trademarks of Ooyala, Inc.
in the United States, Japan, and European Community. All rights reserved.
For complete information on terms of service, see: http://www.ooyala.com/tos
All other trademarks are the property of their respective companies.
This content was last updated on 2015-04-02.
OOYALA IQ USER GUIDE | COPYRIGHT NOTICE | 4
RELEASE NOTES
FEATURES
Ooyala IQ is Ooyala's new analytics product. Features in Ooyala IQ allow for in-depth analysis of your
content. New features in Ooyala IQ include:
•
Multidimensional analysis: You can now analyze more than one set of data at a time. For example,
you can analyze your data for the month of July and see what videos had the most plays in Canada on
the iPhone device.
•
Consolidated reporting: Instead of having to switch between dimension sub-report views, you now
have a consolidated view of all of the dimensions in one place.
•
Redesigned user experience: The new Ooyala IQ UI is more insightful and focuses on minimizing the
clicks involved to view the data you care the most about.
New dimension: Ooyala IQ has a player dimension. In this case, player refers to a Backlot player
with its own embed code. For example, if you deploy different players for each of your brands, this
dimension would let you separate the traffic coming from your different players.
•
OOYALA IQ USER GUIDE | RELEASE NOTES | 5
•
•
New metric: There is a new metric called video_starts. video_starts represents the number of times the
actual video (non-ad) content begins playback.
Video Details page: A new page for each video you have. This page gives you a 360 degree view of
a video, including key performance indicators, statistics on performance across dimensions, and depth
around a single video.
OOYALA IQ USER GUIDE | RELEASE NOTES | 6
FULL RELEASE NOTES
UI
Reports
•
•
•
•
•
Different reports are no longer contained on separate pages. All dimension data is located on one page
(the Business Intelligence page).
Performance metrics, called the performance report in v2 Analytics, can be found on the Business
Intelligence page and the Analytics Dashboard.
Engagement metrics, called the engagement report in v2 Analytics, can be found on the Business
Intelligence page and the Video Details page.
There is no sharing report in the UI. Data are available via the Ooyala IQ API. Most users have sharing
mechanisms on their own sites outside of the Ooyala Player, so be aware that the sharing data you see
in the API is only the sharing that has happened through the Ooyala Player.
There is no direct equivalent to the External Publishing report found in v2 Analytics.
Note: The algorithms used to compute various metrics in Ooyala IQ might differ slightly from those used in
v2 for the Analytics Dashboard. A comparison of numbers might reveal slight differences.
Metrics
•
•
plays_requested: We have improved our calculation of this metric. You may see the number
of plays requested from your HTML5 and SDK players increase after 11/11/2014 due to this
implementation. This may also affect your data for play conversion rate, which is calculated as
plays_requested/displays.
video_starts: We have improved our calculation of this metric. You may see the number
of video starts from your HTML5 and SDK players decrease after 11/11/2014 due to this
implementation. This may also affect your data for video conversion rate, which is calculated as
video_starts/plays_requested.
Dimensions
•
•
The v2 Analytics platforms dimension has been replaced in Ooyala IQ with device_type, os, and
browser.
The v2 Analytics dimension called Domain has been renamed in the Ooyala IQ GUI as Traffic Source.
This represents the sites where a video has been viewed.
v3 Analytics API
The v3 Analytics (Ooyala IQ) API is a new analytics API. For general differences between v2 Analytics and
v3 (Ooyala IQ), see Reporting Application Programming Interface (API). For details on potential differences
in the data from v2 Analytics to v3 (Ooyala IQ), see Potential Differences in the Data on page 43.
Metrics
•
•
•
•
We renamed the following metrics to align the metric name with the metric definition:
• plays is now plays_requested.
• avg_time_watched_per_play is now avg_time_watched_per_video.
• start_conversion_rate is now video_conversion_rate.
• All unique_[string] metrics are now uniq_[string].
• unique_plays is now uniq_plays_requested.
• avg_plays_per_viewer is now avg_plays_per_user.
player_conversion_rate has been redefined as the ratio of plays requested to displays.
video_conversion_rate has been redefined as the ratio of video starts to plays requested.
The initial_plays_requested metric is no longer shown in the UI and is not accessible through
the API.
OOYALA IQ USER GUIDE | RELEASE NOTES | 7
•
•
•
•
The player_loads metric is no longer shown in the UI. You can only access this metric through the
API.
The daily, weekly, and monthly uniques have been consolidated into a single unique metric.
You will now use uniq_plays_requested as a measure of Unique Users.
Due to low customer usage, the following metrics are not supported in Ooyala IQ (they are
no longer accessible through the UI or API): unique_replays, unique_autoplays, and
unique_player_loads.
Dimensions
•
•
To manage the size of the datacubes, we have removed the city, tag, and url dimensions.
The domain dimension is used to capture internet domains.
OOYALA IQ USER GUIDE | RELEASE NOTES | 8
INTRODUCTION TO OOYALA IQ
WHERE TO START?
Here are some pointers to get you started.
If you would like to...
Look here
See examples of investigating Business Use Case Examples of Analyses on page 20
business problems with the
Ooyala IQ graphical user
interface (GUI)
Explore all the features,
mechanics, and details of the
Analytics dashboard and
other parts of the Ooyala IQ
GUI
Ooyala IQ Workspace Reference on page 25
Start programming with
Ooyala IQ
Ooyala IQ Developer Guide and Reference
Understand the technology
underneath Ooyala IQ
How Ooyala IQ Works on page 9
Learn about migrating from
Migrating from v2 Analytics on page 40
Ooyala v2 Analytics to Ooyala
IQ
Learn the answers to
frequently asked questions
about Ooyala IQ
Analytics FAQ
HOW OOYALA IQ WORKS
During playback, video players send event-based metrics that are recorded along various dimensions,
summarized, and aggregated for reporting and analysis.
After presenting some key concepts, this overview describes the major components of Ooyala IQ.
Key Concepts
The simplified conceptual diagram below explains three ideas that are essential to understanding Ooyala
IQ: 1) facts, 2) events, and 3) dimensions. These points are described in the table below.
1.
All information measured by Ooyala IQ is tied to an
asset (usually a video or live stream). In traditional
analytics terminology, the video is called a fact.
Every video has a unique identifying number, called
an identifier.
2.
As a video is played, video players record events
(such as “display”, “playStarted”, or “complete”)
over time in the life of the video. Your videos (facts)
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 9
and their associated events are the basis for all
metrics. (Not all possible events are shown in this
drawing.)
3.
Every event/video combination also has predefined
aspects called dimensions (or attributes)
that relate to the fact, such as traffic source,
player, geography, and device. (Not all possible
dimensions are shown in this drawing.)
Ooyala IQ records data from events over time along the following predefined dimensions during playback.
Dimension
Description
Device
What kinds of devices the video was played on,
such as mobile, tablet, iPhone, iPod, and more.
Geography
Where the video was played, such as country,
state, and designated marketing area.
Player
Which video players it was played on. You can
define these players' names yourself.
Traffic Source
Where the video was served from.
Time
Time is a “hidden” dimension that represents when
events occur. All events have an explicit time stamp
recorded by the system.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 10
Three Steps of Ooyala IQ
Ooyala IQ has three primary parts. You do parts 1 and 3 and Ooyala IQ does part 2.
1. Recording Metric Data on page 11
2. Aggregating and Summarizing Data on page 12
3. Reporting, Analyses, and Data Visualization on page 13
Each step is discussed in the remainder of this section.
Recording Metric Data
In the first step, to collect metrics, certain events that happen during playback are recorded by the video
player as they occur, such as "playStarted", "pause", and others. These events are "data ticks" sent via
a Representational State Transfer (REST) application programming interface (API) over the Hypertext
Transport Protocol (HTTP). A single event or group of events sent in a single request is sometimes called a
ping.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 11
Events are recorded in a database called the event store.
Aggregating and Summarizing Data
In the second step, throughout the day, Ooyala IQ summarizes and aggregates these event-driven metrics
into various time “chunks” (or segments), such as daily, monthly, or yearly.
"Aggregation" means that the intersections among the various dimensions are precomputed so reports are
faster. For instance, aggregation anticipates that you will want to ask questions like “Which devices were
used in which geographies?” or “Which players were used on which devices?” These “overlaps” are the
overlapping parts of the diagram above.
Other data transformations can also occur, such as calculating other metrics based on the raw data.
The end result of aggregation, summarization, and other transformations is datacubes that store these
precomputed intersections.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 12
Reporting, Analyses, and Data Visualization
In the third step, after the metrics have been gathered, summarized, and aggregated, and the datacubes
created, the data is ready for you to use.
So you can zero in on the particular relationship of the data that you are most interested in, you can access
analytics data in several different ways:
1. The GUI, which includes the following:
•
•
The Dashboard for near real-time analysis.
The Business Intelligence page, where data can be filtered by the various dimensions or
manipulated in other ways.
• The Video Details page, where you can look at detailed metric breakdowns for a specific video.
2. A REST-over-HTTP API, which can be used for data downloading or for feeding into your own
reporting systems.
You can create multidimensional analyses to visualize intersections of the data. Multidimensional means
more than one dimension. As mentioned in the previous section, you might want to answer the question
“Which devices were used in which geographies?” or “Which players were used on which devices?” Both
questions are answered with multi-dimensional analyses.
Analyses with dimensions rely on the precomputed datacubes described above.
You can also constrain the data by filters (such filtering is sometimes known as slicing and dicing). You can
apply filters such as date, geography, and so on, so that the amount of data you view becomes more and
more sharply focused. You can thus view only the subsets of the data that interest you.
Data Retention
Ooyala will only retain up to 37 months of your data. This is calculated as the current month along with the
past 36 months. For example, if today is Jan 29, 2015, you have data from current month up to now (Jan
1, 2015 - Jan 29, 2015) and the past 36 full months (Jan 1, 2012 - Dec 31, 2014). Ooyala will only present
and allow queries on the most recent 37 months of valid data for you in UI and API. The rest of your data
will be archived. For information on how much historical data will be migrated from v2 Analytics to Ooyala
IQ, please see Data Migration on page 40.
Conclusion
This conceptual introduction has explained the key ideas and components that underpin Ooyala IQ:
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 13
1. Event-driven metrics.
2. Data aggregation and summarization.
3. Reporting, analyses and data visualization.
You should now have enough understanding of Ooyala IQ to be able to begin useful work with it, whether
you are a programmer or business analyst.
COMMON METRIC DEFINITIONS AND EXAMPLES
COMMON METRIC BREAKDOWN
Here are descriptions of some of the common metrics utilized in Ooyala IQ. This is not an inclusive list.
Displays: Measures the number of times that a piece of video content is loaded and displayed within the
player before it gets played. Displays are related to each individual video. Each time an embed code is
changed, this event gets triggered.
Plays Requested: Measures the number of times that the "Play" button is triggered either manually or
automatically. The requested content could be ad content or the actual video content. A plays requested
is counted regardless of which type of content is requested to play. Plays Requested currently doesn’t
include the Replay event.
Video Starts: Measures the number of times that actual non-ad video content starts playing. If the user
initiates the playback experience and only watches a pre-roll ad without continuing on to the actual video
content, a Play Requested count is reported, but not a Video Start. Video Starts is only recorded if the user
waits until the actual video starts playing back.
Average Time Watched per Video: The average time watched across all the users viewing this content
across the different platforms. Today, we compute Average Time Watched (per video) = hours watched/
video starts, converted to HH:MM:SS format.
Note: This number will be smaller than the duration of the video in most cases. However, seeks within the
player can influence this number. If the user seeks back and forth during a playback, this will push up the
time watched and can potentially cause the average time watched to be greater than the duration of the
video.
Playthrough
•
•
•
•
Playthrough 25%: The number of video plays for the selected video assets that reached the state of
25% of completion.
Playthrough 50%: The number of video plays for the selected video assets that reached the state of
50% of completion.
Playthrough 75%: The number of video plays for the selected video assets that reached the state of
75% of completion.
Playthrough 100%: The number of video plays for the selected video assets that reached the state of
100% of completion.
Note: No matter how many times the user rewinds within the same view session, once the "state" is
reached it won't be counted again.
Segments Watched: The number of times each segment of a piece of video content is watched. 1
segment is defined as 2.5% of video length.
Note: If a user rewinds and watches the same segment N times, Segments Watched for that segment will
count as N times.
Unique Users:
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 14
•
•
•
Ooyala mobile SDK for iOS: The Ooyala mobile SDK for iOS generates and stores a random unique
ID which is application-specific. The unique ID is generated in the "OOClientID" class and is stored in
the "standardUserDefaults" object. The unique ID is valid until the application is deleted. This unique ID
cannot be erased or reset by the end user without deleting the app. The application developer can store
a different ID than the generated ID by erasing the existing ID [OOClientID resetID] and setting a new
ID [OOClientID setID:New_ID].
Ooyala mobile SDK for Android: The Ooyala mobile SDK for Android generates and store a
random unique ID which is application-specific. The unique ID is generated in the "OOClientID" class
and is stored in the "SharedPreferences" file. The unique ID is valid until the application is deleted.
This unique ID cannot be erased or reset by the end user without deleting the app. The application
developer can store a different ID by erasing the existing ID [ClientID.resetID(context)] and setting a
new ID [ClientID.resetID(NEW_ID)].
All other environments (HTML5, Flash, Chromecast): In other environments, a unique user is
identified by local storage or cookie. To generate the GUID, Flash players use the timestamp of when
the GUID is generated and append random data to it. The string is then converted to base64. To
generate the GUID, HTML5 players use the current time, browser information, and random data and
hash it and convert it to base64. Within the same browser on desktop, once a GUID is set by one
platform it is used for both platforms for the user. If a user clears their browser cache, that user/device's
ID will get regenerated next time they watch video. Incognito modes will track a user for a single
session, but once the browser is closed the GUID is erased.
The generated IDs are completely random and don't include any user-identifiable information. When such
information is not available for a user (there is no local storage or cookie), a new unique identifier will
be created for that user. We de-duplicate when calculating the number of unique users over time. For
example, day 1 has users A, B, C; day 2 has users B, E., then when you pick date range = day 1 and day
2, then total unique users = 4 (A, B, C, E), Daily Avg. Unique Users = (3+2) / 2 = 3 (2.5 is converted to the
closed integer).
EXAMPLES
The following examples show how many displays, plays requested and video starts Ooyala IQ would
record in different situations.
Example 1: Pre-roll Ads
The publisher has pre-roll ads delivered during playback.
User A begins watching video X with 2 pre-roll ads but leaves after the first ad. User B begins watching
video X (again with 2 pre-roll ads), and leaves after both ads and one minute of play time.
Table 1: Metric Tallies for Example 1
Displays
Plays Requested
Video Starts
Avg. Time
Watched/Video
User A
1
1
0
00:00:00
User B
1
1
1
00:01:00
Video X in total
(User A + User B)
2
2
1
00:01:00
Example 2: Replays
The user clicks replay to play the content again during the same viewing experience.
User A begins watching Video X with 1 pre-roll ad, watches the ad and the content all the way through and
then hits re-play and watches it all the way again. Alternatively, User B, in the second replay, watches the
ad and then exits.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 15
Table 2: Metric Tallies for Example 2
Displays
Plays Requested
Video Starts
User A
1
1
1
User B
1
1
1
Example 3: Mid-roll Ads
The publisher also delivers mid-roll ads during the content playback experience.
User A begins watching Video X with 2 pre-roll ads, watches the ads, starts watching the content, sees a
mid-roll ad and exits the video. User B begins watching Video X with 2 pre-roll ads, watches the ads, starts
watching the content, watches the mid-roll ads and completes the video.
Table 3: Metric Tallies for Example 3
Displays
Plays Requested
Video Starts
User A
1
1
1
User B
1
1
1
Video X in total (User A
+ User B)
2
2
2
Example 4: Seeks
The user can also seek through content back and forth during a single viewing experience within the
player.
User A begins watching Video X with 2 pre-roll ads, watches both ads, starts watching the content,
watches a mid-roll ad, continues watching and then seeks back to the beginning and plays the content.
The user is now shown the mid-roll ad again. This results in 1 display, 1 play requested, 1 video start.
Table 4: Metric Tallies for Example 4
User A
Displays
Plays Requested
Video Starts
1
1
1
Example 5: Autoplays
The publisher has autoplay turned on - this means that the video player starts playing the content
automatically when the user visits the page containing the player.
User A visits the page (where autoplay is turned on) with 1 pre-roll ad, watches the ad and exits before the
video begins playing. User B visits the page (where autoplay is turned on) with 1 pre-roll ad, and exits the
page halfway through the video content.
Table 5: Metric Tallies for Example 5
Displays
Plays Requested
Video Starts
User A
1
1
0
User B
1
1
1
Video X in total (User A
+ User B)
2
2
1
Example 6: Playthrough
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 16
This example shows how playthrough is counted. The video in this example is 4 minutes in length.
User A watches the video content from its beginning to 2 minutes and 30 seconds and then stops
watching.
User B watches the video content from its beginning to 3 minutes and 30 seconds, then rewinds to the
beginning and watches all the way to 1 minute and 30 seconds, then stops watching.
User C seeks to 2 minutes directly and watches from there to 2 minutes and 30 seconds then stops
watching.
Table 6: Metric Tallies for Example 6
Playthrough 25%
Playthrough 50%
Playthrough 75%
Playthrough 100%
User A
1
1
0
0
User B
1
1
1
0
User C
1
1
0
0
Example 7: Segments Watched, Percentage Watched
In this example a video is 20-minutes in length. This video has 40 buckets assigned to it, where each
bucket is 30 seconds in length. Percentage watched is calculated as (buckets watched/total number of
buckets) * 100.
User A plays the video and watches it through 1 minute.
User B plays the video and watches it through 1 minute, then rewinds to 40 seconds and watches through
1 minute again during the same video view session (the user didn't reload the player).
User C plays the video and watches it through 1 minute, then fast-forwards to 3 minutes and 31 seconds of
the video content and watches through the end from there.
Table 7: Metric Tallies for Example 7
User A
Segments Watched
Percentage Watched
1st bucket has 1 play
5%
2nd bucket has 1 play
User B
1st bucket has 1 play
5%
2nd bucket has 2 plays
User C
1st bucket has 1 play
7.5%
2nd bucket has 1 play
40th bucket has 1 play
In User B's scenario, the second bucket has 2 plays because the user rewinded within the second bucket.
This is because segments watched captures the total number of plays each specific segment incurs in
order to measure its popularity (no matter if it's from the same user rewinding or from different users
watching it). So within the same video view session the segments watched number could increase if a
user rewinds. Percentage watched is still 5% for user B because the user still only watched 2 buckets (1st
and 2nd). Percentage watched is used to measure the percentage of the whole video content that ever
got watched (the count won't increase if the same user rewinds within the bucket that already got watched
during the same video view session).
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 17
Percentage watched measures how many percentages of the whole video content ever got watched (40%
watched could mean the first 40% of the content got watched or it could mean first 20% of the content got
watched and last 20% of the content got watched).
Example 8: Unique Users
This illustrates how unique users are counted. You have a video on your website “myExampleSite.com”.
Situation A: User W watches your video on their iPhone with application 1. Later in the day they decide to
watch the video again on their iPhone with application 1.
Situation B: User X watches your video on their laptop. They leave the browser window up and go about
their day. Twelve hours later they come back to their laptop and re-watch the video.
Situation C: User Y watches your video on their tablet. They then watch the video on their laptop, while still
using the same wifi network as before.
Situation D: User Z watches your video on their laptop in Browser 1. After the video finishes they clear their
cookies. They then watch the video again in Browser 1 on their laptop.
Table 8: Metric Tallies for Example 8
Unique Users
Situation A
1
Situation B
1
Situation C
2
Situation D
2
BROWSERS SUPPORTED BY OOYALA IQ
Any of the following web browsers can be used with Ooyala IQ.
•
•
•
•
Google Chrome version 32 or later
Mozilla Firefox version 29 or later
Apple Safari version 6.2 or later
Microsoft Internet Explorer version 10 or later (without Chrome Frame)
For the most pleasant and productive experience with Ooyala IQ, we recommend that you maximize your
browser window.
ACCESSING OOYALA IQ
Existing customers will be migrated in 4 batches, with the first set of migrations beginning on May 5th; the
second set beginning in June; the third in July and the final batch in August. Customers will be contacted
by their CSM to schedule and manage migration.
Before you are fully migrated over to Ooyala IQ, to access Ooyala IQ through Backlot, log into Backlot and
click ANALYZE (new). Once you are fully migrated to Ooyala IQ, and your grace period is over, log into
Backlot and click ANALYZE.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 18
OR
Once enabled, you can access Ooyala IQ at http://analytics.ooyala.com and login with your Backlot
credentials.
Forgotten Username or Password
Contact your Ooyala Customer Success Manager if you forget your Backlot username. See Changing Your
Password if you forget your password.
OOYALA IQ USER GUIDE | INTRODUCTION TO OOYALA IQ | 19
BUSINESS USE CASE EXAMPLES OF ANALYSES
Here are examples of creating various kinds of analyses.
This section presents a generalized approach to analyses and several examples based on hypothetical
business use cases.
This is not a complete description of everything that can be done with Ooyala IQ, but it should help you
see your business problems in terms of investigating analytical data. These examples will also help you
understand how to approach your own particular questions and answers. If you want a detailed description
of all parts of Ooyala IQ, see Ooyala IQ Workspace Reference on page 25.
GENERALIZED APPROACHES TO ANALYSES
These generalized best practices can help you start making inferences about your data.
All approaches start with the first basic step: Look at your data.
DATA ANOMALIES
1. Look for dips or spikes (which we call "anomalies") in a broad view of your data, on the Business
Intelligence page, for example.
2. Focus on one of the anomalies.
3. Reduce the time range of your view into the anomaly.
4. Filter the view by each of the various dimensions.
5. Look for correspondences among the dimensions, such as other dips or spikes that occurred near the
same time as your target anomaly.
6. Plot the anomaly against other dimensions in the same time period.
7. Ask yourself many questions about the data, not limited to the following:
•
•
•
•
What conclusions can you draw?
What correspondences with other dimensions caught your eye?
What major public events happened during the same time period, such as sports or political events?
What events happened in your business that could have caused the anomalies?
AREAS OF INTEREST
This is the method we use in our examples.
1.
2.
3.
4.
Study the list of Ooyala IQ's dimensions in the Overview to Ooyala IQ.
Which areas of your business are you interested in? Engagement? Sales? Device coverage?
Of the predefined dimensions, which most closely match your areas of interest?
Follow one of the examples, but investigate the dimensions you are interested in, rather than those
given in the example.
OOYALA IQ USER GUIDE | BUSINESS USE CASE EXAMPLES OF ANALYSES | 20
WHAT TYPE OF CONTENT IS PERFORMING THE BEST ON
MOBILE DEVICES?
Context: You want to know what type of content is performing best on mobile devices. To monitor different
content types, such as clips, sports videos, and fashion videos, you can differentiate the content from each
provider with labels. What type of content has the best performance?
HOW TO IN OOYALA IQ
Filter the Business Intelligence page to show only metrics for content you purchase from outside providers,
then look at how each provider's content performed in the past month.
1. Go to the Business Intelligence page.
2. To filter all metrics on the content page by date, click Month in the "Breakdown by" selector at the top
right of the page.
3. Investigate your content by filtering by label.
a. Go to the Asset dimension panel.
b.
Click the Filter icon at the top right of the Asset panel (
c. Select Filter by Label.
).
A tree of your labels appears.
d. Click the arrow to expand the tree and view your labels.
e. Click on a label.
f.
The label name appears with a selected checkbox next to it.
Click Apply.
The video list populates with all videos that have the selected label as part of their metadata.
4. Apply filters on the Device dimension.
a. Go to the Device dimension panel.
b.
Click the Filter icon at the top right of the Device panel (
c. Check the checkbox next to "Phone".
d. Click Apply.
5. See which asset provided the most plays in the Asset panel.
).
OOYALA IQ USER GUIDE | BUSINESS USE CASE EXAMPLES OF ANALYSES | 21
ONLINE MEDIA: HOW ARE MY DIFFERENT BRANDS
PERFORMING?
Context: Your company has many different brands, so you use a different player for each brand. You want
to see how each brand is performing.
HOW TO IN OOYALA IQ
Filter the Business Intelligence page by player and then analyze the metrics for each player.
1. Go to the Business Intelligence page.
2. Scroll down to the Player dimension panel.
3.
Select List mode
.
4.
5.
6.
7.
8.
9.
10.
Click the Filter icon at the top right of the Player panel (
).
Select the checkbox next to the first player (brand) you want to analyze.
Click Apply.
Look at the top video content for this player in the Asset panel.
See what country had the top number of plays for the player in the Geography panel.
Observe any other relevant metrics.
Deselect the player (brand) and repeat steps 2-10 for each player you want to analyze.
WHAT GEOGRAPHIES ARE DRIVING MY CONTENT TRAFFIC?
Context: Your content reaches viewers in multiple countries. You want to see what portion of your traffic is
driven by each geography your content reaches.
HOW TO IN OOYALA IQ
1. Go to the Business Intelligence page.
2. Scroll down to the Traffic Source dimension panel.
3. Identify the domains you are interested in studying.
4.
Click the Filter icon at the top right of the Traffic Source panel (
).
5. Select the checkboxes next to the domains you want to analyze.
6. Click Apply.
7. Look at the geography dimension panel and note what countries are providing the most plays for the
traffic to your domains.
8. To filter the geography information by device type:
a. Go to the Device dimension panel.
b.
Click the Filter icon at the top right of the Device panel (
).
c. Select the checkboxes next to the devices you want to analyze.
d. Click Apply.
OOYALA IQ USER GUIDE | BUSINESS USE CASE EXAMPLES OF ANALYSES | 22
9. Note what geographies are responsible for the most plays to your traffic sources on the specified
devices.
HOW DO I OPTIMIZE MY TARGETING OF AD CAMPAIGNS?
As an Ad Sales manager you are tasked to provide targeting information (e.g., geography, device, label)
to an advertiser, agency, or ad provider to maximize CPMs. You know where your average user is
coming from (geography) and the device he uses (device). You are looking for the untapped user base
viewing your videos. Specifically, you want to identify the device and the geography that are generating
a significant amount of traffic, and understand which videos they are watching to sell that inventory to
advertisers.
You want to answer these questions: What dimensions are available for targeting purposes? What are the
number of plays requested for a particular combination of device and geography? What is the most popular
content for this same combination?
HOW TO IN OOYALA IQ
1.
2.
3.
4.
5.
6.
Go to the Business Intelligence page.
Set the date range to one month.
Expand the breakdown view to 1 month at the upper right of the Performance tab.
Hover your mouse over a specific day with a significant amount of traffic.
Re-adjust the breakdown view to encompass the week that contains the day you've chosen.
Find the best un-monetized content by device.
a. Scroll down to the Devices dimension panel.
b.
Select List mode
.
You notice that mobile has the most number of plays, followed by tablet. Tablet is the undermonetized platform.
c. Expand tablet.
You notice the significant plays in iOS tablets.
7.
Click the Filter icon at the top right of the Devices panel (
8. Select the checkbox next to iOS.
9. Click Apply.
10. Drill down on the geography dimension.
).
a. Go to the geography dimension panel.
You notice a significant number of plays in the US and Canada.
b.
Select List mode
.
c.
Click the Filter icon at the top right of the geography panel (
d. Select the checkbox next to "Canada".
e. Click Apply.
).
You can use this information to determine the videos on iOS tablets playing content in Canada which have
meaningful number of plays.
OOYALA IQ USER GUIDE | BUSINESS USE CASE EXAMPLES OF ANALYSES | 23
HOW DO I UNCOVER VIDEOS WITH HIGH POTENTIAL?
The number of plays you get throughout a day varies a great deal with time of day and across time periods.
You need a quick snapshot of the best performing videos and videos which are not in your radar but should
be noticed.
Are there trends in performance? Do they consistently appear at the same time of day? How can I get an
overview of the performance of all the videos in my portfolio, to get a sense of the standout anomalies?
What additional information can you uncover about that video?
HOW TO IN OOYALA IQ
1. Go to the Dashboard.
2. Point out a trending video that is not the most popular (a video that is top content).
3. Click on the video from the Trending Past Hour panel. This will take you to the Video Details view for
the video.
4. Review the Device tab at the bottom of the Video Details page.
This shows that the video was viewed on mobile devices much more than on desktop. You may wish to
elevate the visibility of the video on the mobile site while leaving it alone on the desktop site.
5. Review the Geography tab at the bottom of the Video Details page.
This shows that the video was not played often in the US but received a significant number of plays
in the UK. You may wish to make modifications to your UK website to elevate the prominence of the
video asset, but leave the asset where it was on the US website.
OOYALA IQ USER GUIDE | BUSINESS USE CASE EXAMPLES OF ANALYSES | 24
OOYALA IQ WORKSPACE REFERENCE
Your workspace in Ooyala IQ has several parts.
This section is a reference for all the features in the Ooyala IQ user interface. The visible workspace
in Ooyala IQ is divided into several sections, each dealing with a different kind of data, view of data, or
function.
•
•
•
Ooyala IQ dashboard: Gives a complete view of current video activity and daily and historical
benchmark comparisons. The dashboard also shows real-time trending content.
Business Intelligence page: Displays data about your content. This is one of your primary pages
for analyses. You can see a historical drill-down by audience engagement, syndication partner
performance, geography, device, and other dimensions.
Video Details page: Useful for investigating specific videos individually, this page is ideal for long-form
content understanding.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 25
OOYALA IQ DASHBOARD
Use the analytics dashboard, an enhancement of Ooyala IQ, to see what is happening with your content in
real time so you can make decisions and take immediate action.
The dashboard has the following sections:
•
Key performance indicator metrics across the top, including:
•
•
•
•
•
•
•
•
•
•
•
Current Users
Users Today
Displays Today
Plays Requested Today
Video Starts Today
Play Conversion Rate
Video Conversion Rate
Note: Current Users is calculated in realtime. In contrast, Users Today is generated with batch
processing, which may cause Users Today to appear lower than Current Users. The KPI metrics on the
dashboard are updated every minute with latency of 2-4 hours.
Popular Now: The Popular Now subsection lists the content that has the largest number of users
watching it right now. Use the paging buttons to move from page to page.
Top 10 Countries by Current Viewers: A real-time global heat map. The global heat map shows
where your content is being viewed in the world. The darker the shade of blue is, the more viewers you
have. The orange dots show cities with the highest viewership. Use the slider on the left to zoom in or
out.
Underneath the map, the top ten country list scrolls through the top ten countries, displaying the number
of current viewers in each and the percentage the country represents out of the current total viewers.
Trending Past Hour: A list of the top videos, with the number of users who viewed them, that have
had the largest percentage increase in engagement (momentum) in the most recent 60 minutes.
This display has multiple pages. Use the numbers in the upper right corner to switch between pages.
Momentum is calculated using a combination of time watched and the hourly increase of a video's
performance against its baseline. Ooyala supports different time window sizes, and the baseline will
always be the next larger time window (in the case of a time window of the past day, the baseline would
be the past week). A video that was watched for 1000 minutes during the last hour and an average of
500 minutes for the day has a higher momentum than a video that was watched for 500 minutes during
the current hour and an average of 500 minutes for the day. This section is updated every 20 to 40
minutes.
Top Content: Contains two subsections: a graph and a list of top content. The graph shows plays
requested, displays, or hours of play for the period of time you specify. The top content list shows
content with the most plays requested, displays, or hours of play during the same period.
WHAT'S CHANGED FROM OOYALA NOW TO THE DASHBOARD
The dashboard has been updated. Formerly known as the Ooyala Now page, the dashboard received
cosmetic and functional improvements. A functional improvement is that Ooyala Now could only show up
to three top popular videos based on the total concurrent users. The new dashboard can show up to ten of
the top popular videos based on the total concurrent users.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 26
BUSINESS INTELLIGENCE REPORTS
Use the Business Intelligence page to view details in your data filtered in various ways to isolate specific
points of interest.
The Business Intelligence page gives you insight into your videos, what devices are watching
them, where people are watching them and much more. You can also easily drill down on your video
performance and other metrics.
The Business Intelligence page is divided into two main regions:
1. The upper panels of Performance, Engagement, Reach, and Playthrough
2. Individual dimensions
To export reports on the Business Intelligence page as CSV files, click the download icon.
Common Controls for Tables and Graphs
All of the dimension tables on the Business Intelligence and Video Details pages have similar controls
for affecting the display.
In this section, the geography dimension is used to illustrate these common controls.
Icon/Widget
Meaning/Use
For the Geography and Devices dimensions, use
the pulldown menu in the upper left-hand corner of
the dimension box to select the level of the data to
display.
Dimension
Levels
Geography
•
•
Show by Countries
Show by DMA
Devices
•
•
Show by Devices
Show by OS
(Operating System)
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 27
Icon/Widget
Meaning/Use
(The dimensions other than Geography and
Device do not have hierarchical levels, and so do
not have this selection menu.)
In list mode, sort the data in the column by clicking
the column heading.
Switch between a text view and graphical view of
the current dataset.
Filter, or limit the amount of data displayed for the
dimension. See discussion in Using Filters on page
30.
This control displays the dimension data in an
expanded table view. See discussion in Viewing
Expanded Table on page 37.
This exports reports as CSV files.
Analytics and Labels
Analytics data will only be returned for non-deleted videos that are associated with the label at report query
time. This means that if you remove a label from a video or delete a video, analytics reports will not return
data for the video when a label filter is applied.
Example:
•
•
•
•
•
June 1: Video ‘Movie Trailer’ is uploaded to Backlot, label ‘A’ is added, and the video is published.
June 2: Video has 10 plays.
June 3: Label ‘B’ is added to the video.
June 4: Video has 5 plays.
June 5: Label ‘C’ is added to the video.
At this point, if a report is run for the month of June, you will get the following results when applying filters.
Table 9: Plays Returned
Filter
Plays for the video 'Movie Trailer'
Label 'A'
15
Label 'B'
15
Label 'C'
15
At this point, if Label ‘A’ is removed from the video and a report is run for the month of June, you will get
the following results when applying filters.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 28
Table 10: Plays Returned After Label A Removed
Filter
Plays for the video 'Movie Trailer'
Label 'A'
No results returned as Label ‘A’ is no longer
associated with the video ‘Movie Trailer'
Label 'B'
15
Label 'C'
15
Setting the Date Range on the Business Intelligence Page
When you first access the Business Intelligence page the date range of the data is set for the current
day. With the date selection tool in the upper left you can set the date ranges for all data displayed on the
Business Intelligence page. You can select specific dates up to 37 months in range or use presets for
relative date ranges.
Note: The maximum date you can select is the current date in the provider's time zone. This may appear
as the future or past if you are looking at the IQ interface in a different time zone than the provider's time
zone.
1. Click in the Start Date and End Date fields and use the calendars to set the date range.
2. If desired, instead of specific dates, from the pulldown for Select from Presets, choose one of the
following. A week is defined as Monday - Sunday.
Note: The following are based on the provider's time zone, which may differ from your current time
zone. Today means today for the provider's time zone, Yesterday means yesterday for the provider's
time zone, and so on.
•
•
•
•
•
•
•
•
•
•
Today
Yesterday
This Week
Last Week
Last Business Week
This Month
Last Month
This Year
Last Year
Last 12 Months
To clear a preset date range, from the select list, choose Custom, and then select the desired dates.
3. Click Apply to accept the settings or Cancel to discard them.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 29
The Business Intelligence page is redisplayed with data constrained by the date/settings you applied.
Examining Videos Across Different Dimensions
Use the dimension panels on the Business Intelligence page to examine your videos across the different
dimensions.
In the lower portion of the Business Intelligence page, data points for all dimensions are displayed,
including Asset, Device, Geography, Player, and Traffic Source.
You can apply filters to any dimension that will apply across the entire Business Intelligence page.
Note: To filter the content on the Business Intelligence page by label, use the Asset dimension. The Asset
dimension can be filtered by label or name (these filters apply across the entire Business Intelligence
Page). For a detailed explanation of how to filter the asset dimension, see Filtering the Asset Dimension by
Label or Name on page 31.
Note: By default, the dimension values are shown for all videos, unless you filters by one or a couple of
videos. You have the ability to filter within the asset module (or other modules like geography, device, etc.)
in the Business Intelligence page.
TROUBLESHOOTING TIPS
The Ooyala mobile SDKs (Android and iOS) currently do not send a player_id, so the Player name for the
mobile SDKs is attributed as "unknown".
For the "Show by Country" option, to view first-level administration divisions for each country, select list
view and click the small arrow next to each country name. If states or provinces are not available for a
country, "none" or "unknown" are shown.
Using Filters
Use filters to drill down on certain dimensions on the Business Intelligence page.
FILTERS ON THE BUSINESS INTELLIGENCE PAGE
You can apply filters to dimension panels on the Business Intelligence page that will apply to the entire
Business Intelligence page. For example, you can filter the entire Business Intelligence page to show only
data for your mobile devices by applying a filter in the Device panel.
You can apply up to 3 dimension filters at a time to the Business Intelligence page along with a date
range filter. For example, you can filter the Business Intelligence page to only show information relating
to tablets and Canada within the last week. For this example you would apply filters to the Device and
Geography dimensions and select Week at the upper right portion of the UI.
DATE RANGES FOR FILTER QUERIES
To ensure that you experience a reasonable load time in the UI:
•
•
You can apply 3 dimension filters for date ranges up to 1 month (31 days) in the Ooyala IQ UI or with
the v3 Analytics API.
You can apply 2 or fewer dimension filters for date ranges up to 1 year (366 days) in the Ooyala IQ UI
or with the v3 Analytics API.
QUERYABLE DATA
For information on Ooyala's data retention policy, please see the Data Retention section of How Ooyala
IQ Works on page 9.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 30
For information on how much historical data will be migrated from v2 Analytics to Ooyala IQ, please see
Data Migration on page 40.
Applying Filters to the Business Intelligence Page
Use filters to drill down on certain dimensions on the Business Intelligence page. You can apply up to 3
dimension filters at a time.
To apply filters to the Business Intelligence page:
1. Start with the unfiltered view of the dimension.
2. Click the filter icon on the far right top of the dimension box.
The icon changes color and the filtering options appear.
3. Along the left side, click the checkboxes for items you want to filter by.
As you select items, they are moved to the top of the list and sorted.
4. In the text box at the top, if desired, enter additional filter terms, and hit enter. These search terms are
case-insensitive.
The results of the search terms will be listed beneath the items you selected by checkbox.
5. Click Apply.
The results of the filtering are displayed in table format. The filter is applied across the entire Business
Intelligence Page.
Additional possible actions you can take:
6. To cancel the filter, click the X in the area that says "x items selected".
7. You can see the data in an expanded table view by clicking the diagonally point arrows in the upper
right of the table. See Viewing Expanded Table on page 37.
8. Set the date range on the Business Intelligence page.
Note:
•
•
You can apply 3 dimension filters for date ranges up to 1 month (31 days) in the Ooyala IQ UI or
with the v3 Analytics API.
You can apply 2 or fewer dimension filters for date ranges up to 1 year (366 days) in the Ooyala IQ
UI or with the v3 Analytics API.
Filtering the Asset Dimension by Label or Name
You can filter the asset dimension by label or asset name.
This allows you to see dimension data for content with specific names or labels you've applied. For
example, you might want to look at the metrics for only videos you've tagged as "sports" videos or for only
videos with "replay" in the title. As explained in Applying Filters to the Business Intelligence Page on page
31, whatever filters you apply to the asset dimension will apply to the entire Business Intelligence
page.
Note: The search results will show all videos that match the search query, but you can only select videos
that have analytics data for the selected date range. If the video does not have any analytics data for the
selected date range, you will not be able to select it.
To filter by name, follow the procedure outlined in Applying Filters to the Business Intelligence Page on
page 31, using the checkboxes or the search bar to identify the asset names you want to filter by.
Note: The string you search for must start with at least 3 alphanumeric characters.
Make sure that Filter by Name is selected at the top of the asset dimension box.
To filter by label:
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 31
Note: Data will only be returned for non-deleted assets that are associated with the label at report query
time. This means that if you remove a label from an asset or delete an asset, analytics reports will not
return data for the asset when a label filter is applied.
1. Start with the unfiltered view of the dimension table.
2.
Click the filter icon on top right of the dimension box.
The icon changes color and the filtering options appear.
3. Select Filter by Label.
A tree hierarchy of your labels appears.
4. Click the arrow arrow at the top of the tree to view your labels.
5. Click on the label(s) you want to filter by.
The label name appears with a checkbox checked next to it.
6.
Click Apply.
The video list populates with all videos that have the selected label as part of their metadata.
Additional possible actions you can take:
7. To cancel the filter, click the X in the area that says "x Labels Filtered".
Alternatively, you could click the filter icon, deselect the selected filter, then click Apply to apply your
changes.
8. To select a different label, click the filter icon > Select a Different Label listbox > the new label and
click Apply.
9. Set the date range on the Business Intelligence page.
Note:
•
•
You can apply 3 dimension filters for date ranges up to 1 month (31 days) in the Ooyala IQ UI or
with the v3 Analytics API.
You can apply 2 or fewer dimension filters for date ranges up to 1 year (366 days) in the Ooyala IQ
UI or with the v3 Analytics API.
EXAMPLE: FILTERING THE BUSINESS INTELLIGENCE PAGE BY ASSET LABEL
AND GEOGRAPHY
You may wish to filter the Business Intelligence page so that the only data shown is the
data for the past week for your content that contains the "Clint Eastwood" label in Canada.
This example explains how you would go about applying these filters.
1. Set the date range on the top left of the Business Intelligence page.
2. Filter the Business Intelligence page by the Canada Geography:
a. Click the filter icon on the far right top of the Geography dimension box.
The icon changes color and the filtering options appear.
b. Along the left side, click the checkbox next to "Canada".
c. Click Apply. The filter is applied across the entire Content panel.
3. Filter the Business Intelligence page by assets with the "Clint Eastwood" label:
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 32
a. In the asset dimension box, click the filter icon on top right of the dimension box.
The icon changes color and the filtering options appear.
b. Select Filter by Label.
Your label heirarchy appears.
c. Click the arrow next to a label to view your sub-labels.
d. Click on the "Clint Eastwood" label.
The label name appears with a checkbox checked next to it.
e. Click Apply at the bottom right of the window.
The video list populates with all videos that have the selected label as part of their
metadata.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 33
The Business Intelligence page is now filtered by label and Geography.
Viewing Performance Metrics
The Performance tab highlights common performance metrics: displays, plays requested, video starts, and
conversion rates.
The items in the legend on the left of the tab are color-coded to the lines on the chart.
To hide a metric from the chart, deselect the check box to the left of the metric's name in the legend.
The metrics shown on the Performance tab include:
•
•
Displays: This is a count of the occurrences of the display event, which means the embed code has
changed (new content loaded).
Plays Requested: The number of times the "play" button is triggered either manually or automatically.
This is a count of the occurrences of the playRequested event, which means that any video content
(including ad video content) was requested.
•
Note: We have improved our calculation of this metric. You may see the number of plays requested
from your HTML5 and SDK players increase after 11/11/2014 due to this implementation.
Video Starts: The number of times users started watching actual video content (non-ad content).This is
a count of the occurrences of the playStarted event, which means that the requested video content (not
ad content) has begun actual playback.
•
•
Note: We have improved our calculation of this metric. You may see the number of video starts from
your HTML5 and SDK players decrease after 11/11/2014 due to this implementation.
Play Conversion Rate: Ratio of plays requested events to displays events. The Play Conversion Rate
view is useful for any publisher trying to understand the CTR (click-through-rate) between videos being
presented to a consumer on their site or app, and the consumer's willingness to clickthrough and play.
Autoplay players interfere with this ratio.
Note: We have improved our calculation of plays requested. You may see the play conversion rate
metric from your HTML5 and SDK players increase after 11/11/2014 due to this implementation.
Video Conversion Rate: Ratio of video starts events to plays requested events. The Video Conversion
Rate view is useful for any publishers that provide some form of "bumpers" before the video starts or
runs pre-roll ads to track the abandonment rate of consumers that exit the player before the requested
video begins.
Note: We have improved our calculation of video starts and plays requested. You may see the number
of video starts from your HTML5 and SDK players change after 11/11/2014 due to this implementation.
Refer to the conceptual overview for a graphic depiction of the displays, plays, and video starts (and other
events) for a typical video. The first three events in the graphic equate to display, play requested, and
video start.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 34
ABOUT TIME SEGMENTS
On the upper right of the chart is a series of buttons you can use to change the granularity (the level of
detail) of the displayed data:
The following time segments are available:
•
•
•
day segmented data is available for one year.
week segmented data is available for one year. A week is defined as Monday - Sunday.
month segmented data is available for three years.
Viewing Engagement Metrics
The Engagement tab highlights averages of two user-related metrics (hours watched and average time
watched per video starts).
Click the Engagement tab to see metrics related to user engagement.
To hide a metric from the chart, in the legend, deselect the check box to the left of the metric's name.
The metrics shown in the Engagement tab include:
•
•
Hours Watched: The amount of time (in hours) all users spent playing back the selected video
asset(s).
Average Time Watched per Video: The average time all users watched the selected video asset(s)
per the number video starts for that asset (Hours Watched/Video Starts) converted to HH:MM:SS
format.
Note: We have improved our calculation of video starts. You may see the number of video starts from
your HTML5 and SDK players decrease after 11/11/2014 due to this implementation.
ABOUT TIME SEGMENTS
On the upper right of the chart is a series of buttons you can use to change the granularity (the level of
detail) of the displayed data:
The following time segments are available:
•
•
•
day segmented data is available for one year.
week segmented data is available for one year. A week is defined as Monday - Sunday.
month segmented data is available for three years.
Viewing Reach Metrics
The Reach tab highlights how widely your videos are getting watched, regardless of plays.
Click the Reach tab to see metrics related to the reach of your content.
To hide a metric from the chart, in the legend, deselect the check box to the left of the metric's name.
The metrics shown in the Reach tab include:
•
•
Unique Users: The number of unique users who request to play the selected video asset(s).
Average Plays Requested per User: The total number of plays requested per total number of unique
users for the selected asset(s) for the selected date range (Total Plays Requested/Total Unique Users).
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 35
Note: We have improved our calculation of plays requested. You may see the number of plays
requested from your HTML5 and SDK players increase after 11/11/2014 due to this implementation.
ABOUT TIME SEGMENTS
On the upper right of the chart is a series of buttons you can use to change the granularity (the level of
detail) of the displayed data:
The following time segments are available:
•
•
•
day segmented data is available for one year.
week segmented data is available for one year. A week is defined as Monday - Sunday.
month segmented data is available for three years.
Viewing Playthrough Metrics
The Playthrough tab highlights the percentage of completion of video plays.
Click the Playthrough tab to see metrics about percentage of completion of videos.
To hide a metric from the chart, in the legend, deselect the check box to the left of the metric's name.
The metrics shown in the Playthrough tab include:
•
•
•
•
Playthrough 25%: The number of video plays for the selected video assets that reached the state of
25% of completion.
Playthrough 50%: The number of video plays for the selected video assets that reached the state of
50% of completion.
Playthrough 75%: The number of video plays for the selected video assets that reached the state of
75% of completion.
Playthrough 100%: The number of video plays for the selected video assets that reached the state of
100% of completion.
Note: Regardless of how many times the user rewinds within the same view/play session, once the "state"
is reached it won't be marked/counted again.
You can see total values and daily averages for each of these metrics in the legend. Total values are
shown on the chart.
ABOUT TIME SEGMENTS
On the upper right of the chart is a series of buttons you can use to change the granularity (the level of
detail) of the displayed data:
The following time segments are available:
•
•
•
day segmented data is available for one year.
week segmented data is available for one year. A week is defined as Monday - Sunday.
month segmented data is available for three years.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 36
Viewing Expanded Table
Use the double-arrow icon see your data in table layout.
If you want to see dimension data in table view, click the expand icon (
any dimension panel on the Business Intelligence page.
) in the upper right corner of
Note: Applying Filters to the Business Intelligence Page on page 31 prior to viewing the expanded
table.
With the displayed table, you can:
•
•
•
•
Use the page options on the bottom of the table to look through different pages of the data.
Add or remove table columns. By default, all metrics are visible in the table.
1. Click Edit Table Columns.
2. To remove metric columns from the table, deselect the checkbox next to the metrics you want to
hide. Only selected metrics will be shown as columns in the table.
3. To add metric columns to the table, select the checkbox next to the metrics you want to show.
4. To export to CSV format, click Export to CSV. The exported table can contain up to 1,000 items.
Adjust column width by dragging column borders.
Adjust data order by clicking on column titles (for example, you can have data arranged in ascending or
descending order).
Business Intelligence Error Handling
Use error messages on the Business Intelligence page to troubleshoot issues.
The following errors can appear in the Business Intelligence page:
Error Message
Troubleshooting Tips
NO DATA AVAILABLE FOR DISPLAY
This error message occurs when there is no data
available for display. To resolve this error, try the
following:
•
•
UNABLE TO COMPLETE THE REQUEST.
PLEASE TRY AGAIN LATER
Make sure the date range set at the upper left
of the Business Intelligence page is set to a
range that contains data (and data that can be
analyzed by Ooyala IQ routes).
Relax the filters you have set on the data.
This error message occurs when your request fails
or takes longer than expected. To resolve this error,
contact Technical Support.
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 37
VIDEO DETAILS
Use the Video Details page to investigate video performance.
The Video Details page is part of the larger collections on the Business Intelligence page. Any time you
click the name or title of a video (or any asset), you are shown the Video Details page.
The Video Details page has performance and engagement data for the video.
To export reports on the Video Details page as CSV files, click the download icon.
s
The Video Details page is divided into four main regions:
1. The video section, which contains the key performance indicator (KPI) bar, the video itself, and video
information.
2. The Segments Watched section, which shows the plays requested count plotted against the video
duration. 1 segment is defined as 2.5% of video length.
Note: If a user rewinds and watches the same segment N times, Segments Watched for that segment
will count as N times.
3. The middle panels of Unique Users, Plays, Time Watched, and Playthrough.
a. Unique Users: Graphically shows the number of unique users over time (the date range you set at
the top of the page).
b. Plays Requested: Graphically shows the number of plays requested over time (the date range you
set at the top of the page).
c. Hours Watched: Graphically shows the time watched over time (the date range you set at the top
of the page).
d. Playthrough: Shows percentages of completion of playing assets, 25%, 50%, 75%, plotted against
the count of plays requested.
4. The metric section, which shows information in either graph or list form for the following information
about the video:
•
•
•
•
Device: Shows the plays requested, time watched, and playthrough of the devices the video was
played on.
Geography: Shows the plays requested, time watched, and playthrough of the different
geographies the video was played in.
Player: Shows the plays requested, time watched, and playthrough of the different video players
the video was played on.
Traffic Source: Shows the plays requested, time watched, and playthrough of the different traffic
sources the video was played through.
SETTING A DATE RANGE
With the Select Date Range pull down you can change the date range for the plotted graph and displayed
metrics. You can choose from the following options. Please note that a week is defined as Monday Sunday.
•
•
•
Today
Yesterday
This Week
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 38
•
•
•
•
•
•
•
Last Week
Last Business Week
This Month
Last Month
This Year
Last Year
Last 12 Months
OOYALA IQ USER GUIDE | OOYALA IQ WORKSPACE REFERENCE | 39
MIGRATING FROM V2 ANALYTICS
Here are some considerations for when you migrate from v2 Analytics to v3 Analytics (Ooyala IQ).
V2/V3 FUNDAMENTAL DIFFERENCE: MULTIDIMENSIONAL
ANALYSIS
In v3 Analytics (Ooyala IQ), data are stored and presented multi-dimensionally.
In v2 Analytics, the data are shown uni-dimensionally (that is, a single dimension). This means that in
v2 you could investigate only one type of data at a time; for example, by domain, or by geography, or by
device, and so on.
In v3 Analytics, however, the data are presented multi-dimensionally (that is, more than a single
dimension). What this means is that you can do analyses of more than one set of data at a time. For
example, instead of looking at data only by geography OR by domain type, in v3 Analytics you can look at
data by geography AND by domain (the intersection between these two dimensions). You can apply up to
3 dimension filters at a time.
In v3 Analytics (Ooyala IQ), multidimensional analysis is supported in both the GUI and the REST-based
APIs.
DATA MIGRATION
All customers will have reprocessed data starting from January 1, 2014.
For at least 6 months after the start of your migration to Ooyala IQ, you will still be able to use the v2
Analytics API for single dimensional queries on all of your historical data. However, for Ooyala IQ, all
customers will have data starting from January 1, 2014 to query.
To save your historical data from Backlot as CSV using the Backlot UI:
1.
2.
3.
4.
Log in to Backlot.
Click the ANALYZE tab.
Set filters and dimensions so that your report contains the desired content.
Click Save as CSV next to the date selector in the upper right portion of the UI.
To save your historical data from Backlot as CSV using the Backlot API, please see How to Export Your
Data With the v2 Analytics API on page 40.
HOW TO EXPORT YOUR DATA WITH THE V2 ANALYTICS API
INTRODUCTION
The following information will guide you on retrieving and saving your analytics v2 data.
As we migrate customers from v2 Analytics to Ooyala IQ (v3 Analytics), you need to know the following:
•
All customers will have access to data starting from January 1, 2014.
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 40
•
You will continue to have access to the old v2 Analytics API until about 6 months after the start of your
migration to Ooyala IQ.
This means that if you need access to more than 1 year of historical analytics data, you need to export the
data using the v2 APIs while they are still active.
OVERVIEW: THE OOYALA V2 ANALYTICS API
With the Ooyala v2 Analytics API you can easily create a report that will provide you with your analytics
data. The results will be in JSON format. (JSON is a lightweight data-interchange format that is easy to
read and write.)
To retrieve analytics results from a specific date range you simply need to define the type of result you
need with the api call /v2/analytics/reports/, either in a terminal emulator such as Terminal on a Mac or in
the Ooyala Scratchpad.
What is an API?
In computer programming. API (Application Programming Interface) is the name of a set of routines and
protocols for software applications. An API expresses a software component in terms of its operations and
results.
Where can I locate my API Credentials?
You can locate your API Key and Secret in the Backlot UI. Please use your API v2 credentials located in
Backlot under the ACCOUNT>Developers tab.
Figure 1: Finding Your API Keys
How Does the API Work?
An Ooyala API call requires 4 basic elements: API Key, API Secret, a Signature and an Expiration time.
API calls are made via HTTP methods. The GET API call is used to retrieve data without directly modifying
it and allows you to get a typed JSON document response based on the id of the object.
What are the Available Results I can Retrieve with the Ooyala v2 Analytics API?
On the v2 Analytics API there are 4 key qualifiers that you need to identify in order to retrieve your results:
asset_id: This value is referred to by different names depending on where you look for it. In the Backlot
API, asset_id is the identifier for a specific asset. asset_id has the same value as the content ID found in
the Backlot UI that represents a piece of content. The value is the same for all scenarios. asset_id can
be used if you want to retrieve results for a specific asset. Alternatively, you can retrieve results for your
account, which would include all of your assets.
date_range: Defines the date range for this report. Analytics is based on dates. You can define the date
following the format (YYYY-MM-DD) or you can define a date range with (YYYY-MM-DD...YYYY-MM-DD).
Report Request: Defines the type of report you want to retrieve. Valid values include performance,
sharing, engagement, and delivery.
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 41
Dimension: Dimensions are common criteria that are used to aggregate data, such as the date when
the user activity occurred or the country where the users were located. Every Dimension also has
“Drilldowns”, which allow you to filter your results by specific values for each dimension.
Common query string parameters and attributes can be found at Common Attributes and Query String
Parameters.
HOW TO RETRIEVE YOUR V2 ANALYTICS DATA
What is the API Call Format?
The v2 Analytics API follows a specific order on the body of the API.
For example, the API call: /v2/analytics/reports/account/performance/
[:dimension/:drilldown]/:date_range
Should appear like the following if you want to get a performance report from 2011-01-01 to 2014-01-01:
Figure 2: API Call For Performance Report
How Can I Use the Scratchpad to Save Reports?
The Scratchpad is a tool created by Ooyala that allows you to make API queries in your browser.
To retrieve an analytics report with the Scratchpad:
1. Go to https://api.ooyala.com/docs/api_scratchpad?url=.
2. Select “Your Account” in the Credentials section in the upper right corner of the page.
3. Enter your v2 API credentials (API Key and Secret) in the Credentials section in the upper right corner
of the page.
4. In the Query field located on the left side of the page, enter your Analytics query. For example, if
you would like to get the performance report from 2011 to 2014, copy and paste this query: /v2/
analytics/reports/account/performance/total/2011-01-01...2014-01-01
5. Select GET.
6. Click Submit.
Note: Your response appears in the response field.
7. If you prefer to see your results in a larger browser window, copy the API URL shown in
green above the Submit button into your browser. In this case, the URL would be https://
api.ooyala.com/v2/analytics/reports/account/performance/total/2011-01-01...2014-01-01?
api_key=yourApiKey&signature=yourSignature&expires=1418771221.
8. Save the JSON by selecting File > Save As… in your browser. For information on how to convert
JSON to CSV, see Converting Analytics JSON to CSV
Additional Query Examples
For more details on how to form queries in Scratchpad and for specific analytics report types, see:
•
•
•
•
Performance query examples
Sharing query examples
Engagement query examples
Delivery query examples
Note: To retrieve all data for a report type for your account, use the “total” query string parameter. You
can find examples using “total” in each of the query example links mentioned above. “total” is used to
retrieve all data for that particular report type for your account.
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 42
For example, the following query retrieves all performance data for the account over the date range
2011-08-01...2011-08-02.
[GET]/v2/analytics/reports/account/performance/total/2011-08-01...2011-08-02
How can I Create my own API Report?
You should only create your own API script if you are comfortable with the Ooyala API and have created
scripts before or if you have the technical resources available who can modify the pre-made query to
retrieve the data for you.
If you check the following snippet from our sample code that shows a terminal, you will be able to identify
that we send the request of the API call using cURL. cURL makes http request where you can modify the
parameters and the headers.
Figure 3: Sample API Report
Note: For more script examples, please check our support site documentation at Sample Code for Signing
Requests.
POTENTIAL DIFFERENCES IN THE DATA
There may be differences in the data in v3 Analytics (Ooyala IQ) when compared to data in v2 Analytics
due to the following:
•
•
•
•
Due to the re-processing of data to accommodate the multi-dimensional capabilities, the aggregation
of the data may result in slightly different values than in v2 Analytics. We are also using a new robust
architecture in Ooyala IQ which results in better error handling.
Ooyala IQ uses Quova, a more accurate geo provider than in v2 Analytics.
Ooyala IQ uses a more accurate device profiling provider than v2 Analytics, so the aggregation across
devices and operating systems may differ. We are now using UADetector along with WURFL to
optimize mobile and desktop coverage.
The metrics are defined more accurately. Metrics with new definitions or bug fixes in calculation include:
•
Playthrough: v2 Analytics calculated playthrough on the server side based on the segments
watched. There are 40 segments for each video. If the 10th segment got watched, Playthrough 25%
was triggered; if the 30th segment got watched, Playthrough 75% was triggered. This behavior is
problematic when people rewind and/or fast-forward. This calculation method did not always take
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 43
•
•
•
deduplicating into account and did not report segments that users skipped, which at times led to
playthrough 75% appearing higher than playthrough 25%, for example. The new analytics has a
more accurate definition of playthrough, which is calculated on the client-side to indicate the furthest
quartile point a user has reached within one viewing session. The new calculation deduplicates,
reports for the segments that the user skipped, and has a more accurate measure of when the 100%
mark is reached. This change in calculation provides more accurate metric data for playthrough.
Data after August 1, 2014 is calculated using the new playthrough logic.
Uniques: The calculation of unique metrics in v2 Analytics involved looking for cookies on the
client side based on event timestamps. The new calculation of uniques is server-side and involves
an algorithm called hyperloglog (HLL) and a guid that identifies browsers within a device. If the
player does not see a guid a new guid is generated. This new calculation method reduces bugs,
deduplicates, and is more accurate. You may see differences in your “unique” data, but the values
should be similar, and any change is due to increased accuracy in “unique” calculation.
Plays Requested: We have improved our calculation of this metric. You may see the number
of plays requested from your HTML5 and SDK players increase after 11/11/2014 due to this
implementation.
Video Starts: We have improved our calculation of this metric. You may see the number of video
starts from your HTML5 and SDK players decrease after 11/11/2014 due to this implementation.
ANALYTICS GRAPHICAL USER INTERFACE (GUI) DIFFERENCES
Here are general differences in the GUI.
1. The major difference between the GUIs for v2 Analytics and Ooyala IQ is that Ooyala IQ allows much
richer investigation because of multidimensional analysis. In v2 Analytics you have multiple pages in
the GUI where analysis has to be done, such as the geography page, the domain page, and others.
In Ooyala IQ, you also have different pages to work with, but you should concentrate primarily on the
Business Intelligence page, which gives you an at-a-glance view of all your dimensions.
2. UI reports
v2 Analytics
Ooyala IQ
The reports for dimensions (by device, by
geography, and so on) across the top each have
a separate page. You are essentially looking at a
single dimension on each page.
The Business Intelligence page centralizes the
investigation of all dimensions on a single page.
When you filter by a dimension, the data for the
other dimensions are constrained by that filter.
Thus the reports are by nature multi-dimensional.
For concrete examples, see Business Use
Case Examples of Analyses on page 20, which
illustrate how filtering works.
Performance
The Analytics Dashboard shows performance
metrics, which you can also see on the Business
Intelligence page.
Engagement
The Business Intelligence page Performance
tab shows average time watched and other
engagement-related metrics. The Video Details
page gives a full view of the engagement metrics.
Sharing
No direct equivalent in GUI. Most users have
sharing mechanisms on their own sites outside of
the Ooyala Player, so be aware that the sharing
data you see in the API is only the sharing that
has happened through the Ooyala Player. Data
are available via Ooyala IQ Reporting API.
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 44
v2 Analytics
Ooyala IQ
External Publishing
No direct equivalent.
The reports in V2 were all contained on their own page:
In Ooyala IQ you can look at data for all of the dimensions at once:
3. The v2 Analytics platforms dimension has been replaced in Ooyala IQ with the following:
device_type, os, and browser.
4. In Ooyala IQ you filter the report results by label using the Asset dimension box. To filter the Business
Intelligence page by label, click the filter icon at the top right of the Asset dimension box and select
"Filter by label". You can then select which label filter you want to apply to the entire Business
Intelligence page.
5. The v2 Analytics dimension called Domain has been renamed in the Ooyala IQ GUI as Traffic
Source. This represents the sites where an asset has been viewed. Use the Traffic Source dimension
in lieu of the old Domain dimension.
6. Within the geography dimension panel in the Business Intelligence page you can filter your data by
country. When you select a country you can filter even further by states or provinces. If states or
provinces are not available for a country, "none" or "unknown" are shown.
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 45
7. To manage the size of the datacubes, we have removed the city, tag, and url dimensions.
V3 ANALYTICS APPLICATION PROGRAMMING INTERFACE (API)
Here are the major differences in the programming interfaces between v2 Analytics and v3 Analytics
(Ooyala IQ).
1. The major difference in the APIs between v2 Analytics and v3 Analytics is that v3 allows much richer
investigation because of multidimensional analysis. This has certain ramifications on syntax, as
described below.
2. The v2 Analytics API positionally expresses many options or filters directly on the route itself, often
making the route difficult to parse. In addition, in v2 no more than a single dimension could be
requested on the route. In the v3 Analytics API, however, query string parameters (name/value pairs)
are used for greater clarity and up to 3 dimensions can be included in a request. For example, for the
performance report:
•
•
3.
4.
5.
6.
7.
8.
In v2 Analytics: /v2/analytics/reports/level/performance/total/date_range
In v3 Analytics: /v3/analytics/reports/?
report_type=performance&start_date=beginning date
In v3 Analytics, for queries with query parameters that would exceed the HTTP GET specification limit
of 230 characters, please use a POST request. Some browsers and http clients may support more
than 230 characters, but we will not provide official support for queries that violate the HTTP GET
specification.
In general, in v2 Analytics, a date range to filter the data can be specified at the end of the route, which
is confusing. Instead, in v3 Analytics, use the start_date query string parameter and (if desired) the
end_date parameter.
In v2 Analytics, the breakdown_by parameter forces the response to show values by day, week,
or month. In v3 Analytics there is no direct equivalent; all values are returned. You can limit the time
segment returned with the time_segment parameter.
v3 Analytics features with no equivalents in v2: filters=, metrics=, dimensions=, and other
query string parameters.
To manage the size of the datacubes, we have removed the city, tag, and url dimensions.
API reports. The following table correlates the general syntax of the v2 Analytics report types with their
v3 Analytics general equivalents or near equivalents. This is not intended to be a thorough treatment of
all syntactical possibilities, but a general view of the differences.
Note: The engagement, sharing, and unique reports have been combined and included in the
performance report.
Report Type
v2 Analytics Report Route
v3 Analytics Equivalent or Near
Equivalent
Performance
/v2/analytics/reports/level/
performance/
/v3/analytics/reports/?
report_type=performance
Sharing
/v2/analytics/reports/
account/sharing/videos/
/v3/analytics/reports/?
report_type=performance
Engagement
/v2/analytics/reports/asset/
asset_id/engagement
/v3/analytics/reports/?
report_type=performance
Unique
No equivalent
/v3/analytics/reports/?
report_type=performance
Delivery
/v2/analytics/reports/level/
delivery/
No equivalent at this time.
9. Equivalences in query string parameters
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 46
v2 Analytics Query String
Parameter
v3 Analytics Equivalent
Description
page_token
page
Specify desired page of next
response
breakdown_by
time_segment
Categorize the data according to
times
limit
limit
Limit the number of records in
the response
order_by
sort
Sort the returned data
10. For even more examples of equivalences, see API Requests: v2 Analytics and v3 Analytics
Comparison in the Analytics Developer Guide.
CERTAIN "UNIQUE" METRICS CONFUSING IN V2 ANALYTICS
In v2 Analytics, certain "unique" metrics were unexpectedly returned in responses.
In the v2 Analytics API, you can request that the system return the "daily uniques" (unique viewership
details) for a given date. Unfortunately, the API response included not just the "daily uniques" but
sometimes unexpectedly the "weekly" and "monthly" uniques. This presented difficulty to the user, who
had to determine exactly which metric was the one he wanted among those he had requested and those
not expected in the response. These metrics are shown in the snippet of a v2 Analytics response shown
below:
.
.
.
"metrics": {
"video": {
"uniq_replays": {
"monthly_uniqs": "40",
"daily_uniqs": "45",
"weekly_uniqs": "40"
},
.
.
.
In Ooyala IQ, this behavior has been corrected such that only a single "unique" metric is returned in the
response. The single unique metric corresponds to the time frame specified on the request (daily, weekly,
and so forth).
OOYALA IQ USER GUIDE | MIGRATING FROM V2 ANALYTICS | 47
ANALYTICS GLOSSARY
For definitions of other terms, see also the following reference material in the Ooyala IQ Developer Guide:
•
•
Dimensions
Metrics
Term
Definition
asset
Ooyala term for content of various kinds, typically videos.
cardinality
The maximum number of possible values of a dimension. For
example, a dimension named "color" might have three possible
values: red, green, and gold. This dimension has a cardinality of
three.
completion
Amount (usually a percentage) of assets actually watched. See
also playthrough (%). Applies only to video-on-demand, not live
assets.
conversion rate
In Ooyala v2 Analytics terminology, the change from a "display"
event to a "play" event; that is, how many times the video was
actually played, not simply displayed. (Note that in common
industry understanding, "conversion rate" can mean many different
things, such as conversion of a user from viewing an advertisement
to actually making a purchase.) In Ooyala IQ there are two
conversion rates; see conversion rate, play and conversion rate,
video.
conversion rate, play
Ratio of plays requested to display events. Videos that are
displayed on high traffic pages, but are not played, will have low
conversion rates.
conversion rate, video
Ratio of start events to plays requested events. The Video
Conversion Rate is useful for any publisher that provides some
form of "bumpers" before the video starts or runs pre-roll ads to
track the abandonment rate of consumers that quit before the
requested video begins.
derived metric
A metric that is calculated from other, primary metrics.
device
Dimension to record the type of device the user operates to plays
your asset. This is derived from the USER_AGENT web server
environment variable.
dimension
An aspect or attribute of a video. All videos have the predefined
dimensions described in Dimensions in the Analytics Developer
Guide.
displays
A count of the number of display events for a given asset. A display
event is triggered each time a new video asset is loaded by the
player.
DMA
Dimension to record Designated Marketing Area.
domain
Dimension to record the fully qualified domain name (FQDN).
engagement
A word used to classify metrics related to how much time people
spent watching a video. See the "playthrough" metrics described in
Metrics in the Analytics Developer Guide.
OOYALA IQ USER GUIDE | ANALYTICS GLOSSARY | 48
Term
Definition
event
A defined occurrence of a phenomenon in the "life of an asset",
such as display, playRequested, or playStarted.
filter
"Constrain", decrease the amount of data by excluding some
metrics to focus on specific aspects of the data. Noun: an instance
of such filtering.
geography
Dimension to record the geographic location. Calculated by the
system based on the IP address of the user's device. Geography
actually consists of three separate dimensions: country, region, and
DMA.
identifier
The unique value that identifies any given object, such as a video.
Sometimes called a "key."
kpi
Key performance indicator.
metric
A measurement.
location
An old term from Analytics v2, now called "Geography".
os
The operating system (OS) dimension of devices.
player loads
The number of times a video player has been loaded on a page or
device.
players
Video playing software with a defined name. All Ooyala players
have defined names. Also, the dimension to record this.
plays requested
The number of times the "play" button is triggered either manually
or automatically. A count of the number of playRequested events
for a given asset (this could be playing an ad or the actual video
content). Plays requested does not include replays.
playthrough (%)
Percentages of completion of playing assets, 25%, 50%, 75%.
Applies only to video-on-demand, not live assets. This is a measure
of the furthest point a user has reached during one video view
session. There will only ever be one count of each playthrough
% per video view session per user (for example, even if the user
rewinds and re-watches the first quarter of the video three times
during the same video view session, there will only be one count
of 25% playthrough). See the "playthrough" metrics described in
Metrics in the Analytics Developer Guide.
slice-and-dice
(verb) To filter, to constrain, to limit the analyzed data by
constraining it in various ways.
summarize
(verb) To calculate totals of lower order items in "buckets" or
defined groups. Sometimes called "roll up". For example, the count
of all devices of type "iOS" is the "iOS rollup."
total hours watched
Sum of the time all videos were watched.
traffic source
Recorded in the domain dimension, the site that referred or
redirected the user's player to your asset. Derived from the
HTTP_REFERER web server environment variable. Note that this is
not the site the user "came from" to reach the location where the
player is. This is the site where the player is embedded.
trending
Most popular videos are measured as videos with the most
momentum during the time window. Momentum is calculated using
OOYALA IQ USER GUIDE | ANALYTICS GLOSSARY | 49
Term
Definition
a combination of time watched and the hourly increase of a video's
performance against its baseline.
user, unique user
In many cases, a synonym for plays_requested. Unique users are
calculated in the following ways:
•
•
•
video starts
Ooyala mobile SDK for iOS: The Ooyala mobile SDK for iOS
generates and store a random unique ID which is applicationspecific. The unique ID is generated in the "OOClientID" class
and is stored in the "standardUserDefaults" object and is
valid until the application is deleted. This unique ID cannot be
erased or reset by the end user without deleting the app. The
application developer can store a different ID than the generated
ID by erasing the existing ID [OOClientID resetID] and setting a
new ID [OOClientID setID:New_ID].
Ooyala mobile SDK for Android: The Ooyala mobile SDK
for Android generates and store a random unique ID which
is application-specific. The unique ID is generated in the
"OOClientID" class and is stored in the "SharedPreferences"
file and is valid until the application is deleted. This unique ID
cannot be erased or reset by the end user without deleting
the app. The application developer can store a different ID by
erasing the existing ID [ClientID.resetID(context)] and setting a
new ID [ClientID.resetID(NEW_ID)].
All other environments (HTML5, Flash, Chromecast):
In other environments, a unique user is identified by local
storage or cookie. To generate the GUID, Flash players use
the timestamp of when the GUID is generated and append
random data to it. The string is then converted to base64.
To generate the GUID, HTML5 players use the current time,
browser information, and random data and hash it and convert
it to base64. Within the same browser on desktop, once a GUID
is set by one platform it is used for both platforms for the user. If
a user clears their browser cache, that user/device's ID will get
regenerated next time they watch video. Incognito modes will
track a user for a single session, but once the browser is closed
the GUID is erased.
The number of times users started watching actual video content
(non-ad content). Recorded via the playStarted event.
OOYALA IQ USER GUIDE | ANALYTICS GLOSSARY | 50