Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginContact Sales

Create Custom Reports

Suggest Edits


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


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.


🚧

  • 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.

Create a new 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, 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 Metrics 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 dimension 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 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.

FAQs

Why am I not seeing video-level data in my Custom Reports?

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.


How do I create a Custom Report to assess the performance of my Apps?

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

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.



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.



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.


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.



Updated 5 months ago