# Videos

Umbraco Engage gathers video statistics for the following types of videos:

* HTML5 videos (videos provided via the `<video>` element)
* Embedded YouTube videos

{% hint style="info" %}
Make sure the embed URL contains `?enablejsapi=1` as part of the full URL to enable tracking. The `src` property of the iframe should be something like: `https://www.youtube.com/embed/&lt;CODE&gt;?enablejsapi=1`.

The <https://www.youtube.com/iframe_api> is loaded for this purpose.
{% endhint %}

* Embedded Vimeo videos

{% hint style="info" %}
The <https://player.vimeo.com/api/player.js> is loaded for this purpose.
{% endhint %}

## The Data

For the videos, the following information is gathered:

* Video URL
* Video name
  * For YouTube and Vimeo the name can be retrieved.
  * For HTML5 we record the file name.
* Total Time Watched (seconds)
* Total Percentage Watched
* In Viewport
  * True if the video was in the user's viewport.
* Watched
  * True if the video played for at least 1 second.

Apart from the metadata above we also track actions performed on the video player. These actions are:

| Action   | Description                                    |
| -------- | ---------------------------------------------- |
| Autoplay | If the video was started automatically.        |
| Play     | When the video starts playing.                 |
| Pause    | When the video is paused.                      |
| Resume   | When the video is resumed from a Paused state. |
| Ended    | When the video is ended.                       |
| Seek     | When a seek operation is performed.            |

## The Report

By collecting this data, you can visualize different reports about the videos. You will find these reports in the Videos tab of the Analytics section.

![Reports in the Videos tab of the Analytics section](https://1498851568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeiQnEGdbGIoA0IQ3nJUK%2Fuploads%2Fgit-blob-1ed84a8d464b4bf5d81db4fe3ce10db0719f4cd0%2Fengage-analytics-videos.png?alt=media)

Here you find all the videos that are displayed on the website. For each video you can see the following:

* How often was the video played?
* The total playtime of the video.
* The average video playtime of the video.

From here you can also drill down on a specific video to see more details about that video. You can do that by clicking on the video itself.

![View detailed analytics for a specific video](https://1498851568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeiQnEGdbGIoA0IQ3nJUK%2Fuploads%2Fgit-blob-04f9c5940d9001ad2600f6bf25e89101c60afaf6%2Fenage-analytics-video-details.png?alt=media)

You see how often the video was started and paused, how often it was resumed, and how often visitors sought within the video.