Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginContact Sales

<img src="https://img.shields.io/badge/%20-ALL-%2300B180" style="float:left"/><br />

Custom Reports are a powerful way to turn your JWP data into actionable insights. With Custom Reports, you can run reports based on a default report or a custom report you have created.

Any report denoted as a default report provides useful data about video playback over time and by source to showcase the types of reports that can be generated. Default reports cannot be deleted or modified.

1502


Custom Reports list page

<br />

Additionally, a preview all your generated reports are displayed as a tiled list on the Custom Reports list page. This enables you to quickly view the data generated by each report and share that data from in a centralized location:

  • Search for a specific report by name from the search bar at the top of the page

  • View report details

  • Share reports

Read the following sections below to learn how to create your Custom Reports.

<br />



  • In order to keep query response times performant, only 90 days of data can be included within a custom report.

  • With the exception of near real time data, data in the Analytics dashboard are updated in 20-40 minute intervals.

  • All data is reported in Eastern (UTC -4 / UTC -5) time. The reporting time is affected by whether daylight saving time or standard time is in effect.

<br /> <hr />

## Create a new report

  1. From the <a href="https://dashboard.jwplayer.com/p/custom-reports" target="_blank">Custom Reports list page</a>, click **Create Report**. The report creation page appears.

  2. Click **Untitled Report** and name the report.

  3. In the **Report Settings** section, choose a predefined date range or define a custom range from the **Date Range** dropdown menu. By default, **Custom** is selected. This allows you to choose the start and end of the date range.

  4. (OTT only) Select the data **Source** for the report.

    • The **JW Player** option provides aggregated reporting for your web and mobile SDK players.

    • The **OTT Apps** option provides aggregated reporting for your OTT Apps.

      

      This option appears if you are an OTT Apps user.

  5. Select up to five <a href="/platform/docs/jw-player-analytics-reference#metrics" target="_blank">Metrics</a> to display in the report. The metrics can be selected from one or multiple of the metric category dropdown menus.

    

    The metrics available depend upon the license you have and enabled features.

  6. (Optional) In the **Group by** section, select a <a href="/platform/docs/jw-player-analytics-reference#analytics-definitions" target="blank">dimension</a> by which to group the report results. The metrics can be selected from one or multiple of the dimension category dropdown menus.

    • If **Media** is chosen as a **Group by** in the **Content Dimension Group** it can be clicked in the result table to navigate directly to the **Media Details Page**

      

      If you have an Enterprise license, you can select up to two dimensions. If you do not have an Enterprise license, you can select only one dimension.

  7. (Optional) In the **Filter** section, define a filter to examine a segment of the data:

    1. Click **+ Add**. A category dropdown menu appears.

    2. Choose a category. The field, operator, and value fields appear.

    3. Choose a field from the dropdown menu.

    4. Choose an operator from the dropdown menu.

    5. Enter a value for the field. When entering multiple values, separate each with a comma. Values may be suggested to you as you type.

  8. (Enterprise only) Click **+ Add** to set additional filters.

    

    If you have an Enterprise license, you can select up to ten filters. If you do not have an Enterprise license, you can select only one filter.

  9. Click **Run Report**. After the report completes, the results are displayed. To the left of **Run Report** a last run time indicator is displayed. This indicates when the report was last run or refreshed and does not have any relationship to the **Date Range** filter.

  10. (Optional) To refine the columns in the table beneath the graph visualization, click <img src="https://files.readme.io/faadd9b-custom_reports_gear.png" width="15"> and uncheck the columns you don't want to appear.

  11. Click **Save**.

  12. (Optional) The report can be downloaded in two formats.

    • From the graph visualization click **⋯ > Export as CSV** to download a .csv file of the graph’s data into table format.

    • From the table below the graph visualization, click **Download Table** to directly download the displayed results table.

<br /> <hr />

## FAQs

<details><summary><strong>Why am I not seeing video-level data in my Custom Reports?</strong></summary>

<br />

If you have players operating on your site but see no data in the Analytics section of your dashboard, there could be an issue with how you've set up your custom player embed. The most common cause of [data capture issues](🔗) is that an external URL is used without a reference to a JWP media ID.

<br />

</details>

<details><summary><strong>How do I create a Custom Report to assess the performance of my Apps?</strong></summary>

<br />

Each publisher uses different metrics to assess performance. The following Custom Reports explain how to generate reports for three common performance indicators for Apps:

  • [Usage by Video](🔗)

  • [Usage by Platform](🔗)

  • [Usage by Playlist](🔗)

<br />

<a name="video"></a> **Usage by Video**

Discover which videos your viewers are watching. The results of this report will help you decide what content you should focus on acquiring or promoting.

Use the following steps to create a **Usage by Video** report:

  1. From the [Custom Reports list page](🔗), click **Create Report**. The report creation page appears.

  2. Click **Untitled Report** and name the report.

  3. In the **Report Settings** section, for the Source of data, select **OTT Apps**. This option provides aggregated reporting for your apps.

  4. From the **Date Range** dropdown menu, select Last Month.

  5. Under **Metrics**, choose:

    • Under **Performance**: **Ad Impressions, Plays**, and **Time Watched**

    • Under **Viewers**: **Unique Viewers**



If you are not monetizing your apps with ads, omit Ad Impressions.

  1. Under **Group By**, choose **Media** under **Content**.

  2. Click **Run Report**. After the report completes, the results are displayed.

  3. Click **Save**.

After running this report for the first time, you can [schedule your report](🔗).

<br /> <hr />

<a name="platform"></a> **Usage by Platform**

Learn which platforms – for example, Roku, Fire, Apple, Android, and Web – are most popular or whether there is an impact from specific marketing campaigns.

Use the following steps to create a **Usage by Platform** report:

  1. From the [Custom Reports list page](🔗), click **Create Report**. The report creation page appears.

  2. Click **Untitled Report** and name the report.

  3. In the **Report Settings** section, for the Source of data, select **OTT apps**. This option provides aggregated reporting for your apps.

  4. From the **Date Range** dropdown menu, select Last Month.

  5. Under **Metrics**, choose:

    • Under **Performance**: **Ad Impressions, Plays**, and **Time Watched**

  6. Under **Group By**, choose **Platform** under **Device**.

  7. Click **Run Report**. After the report completes, the results are displayed.

  8. Click **Save**.

After running this report for the first time, you can [schedule your report](🔗).

<br /> <hr />

<a name="playlist"></a> **Usage by Playlist**

Learn how viewers navigated to your content. Use this to update and assess the contents of the home page and menu bar.



A `NULL` playlist in your report results indicates that viewers navigated directly to your content from external sources like social media or search engines.

<br />

Use the following steps to create a **Usage by Playlist** report:

  1. From the [Custom Reports list page](🔗), click **Create Report**. The report creation page appears.

  2. Click **Untitled Report** and name the report.

  3. In the **Report Settings** section, for the Source of data, select **OTT Apps**. This option provides aggregated reporting for your apps.

  4. From the **Date Range** dropdown menu, select Last Month.

  5. Under **Metrics**, choose:

    • Under **Performance**: **Ad Impressions, Time Watched**, and **Unique Viewers**

  6. Under **Group By**, choose **Playlist** under **Content**.

  7. Click **Run Report**. After the report completes, the results are displayed.

  8. Click **Save**.

After running this report for the first time, you can [schedule your report](🔗).

<br />

</details>

<br />

<!--\\-->

<!-- Removes the automatic page-to-page navigation at the bottom of the page -->

<style> .rm-Pagination { display: none; } </style>