# 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](/files/wFtUW1KZPStnRPm1ClRe)

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](/files/mF1IzV0T6RFIVLCTVU6b)

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-engage/18.latest/marketers-and-editors/analytics/videos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.