Create or Reuse a Custom Report

Note:

Error tracking reports only work if error tracking is enabled for your account, and you have an integration with at least one of the following SDKs:

  • HTML5 SDK (Core and Pulse) or any of its derivatives (HTML5 Ad Player and Plugins) for version 2.1.16.23.1 or higher
  • iOS Pulse SDK version 2.3.17.1.0 or higher
  • Android Pulse SDK version 2.3.16.25.0 or higher

No error tracking information is available for direct VAST or VMAP integrations.

  1. Open Custom Reporting from the menu Custom Reporting access tab.
  2. Click on the Create a Report button, or click on the ... button of the report you want to reuse, and select Reuse Report.

    The form opens:

    Create a Report page
    Part Name
    1 Title
    2 Filters. By default, the time filter is entered with the last seven days.
    3 Dimensions. By default, the time dimension with a break down by year, and the campaign dimension are selected.
    4 Metrics. By default, the impression metric is selected.
    5 Warning messages
    6 Create Report
  3. Fill in the following fields:
    1. Title: Insert a descriptive title for the report. For example, Revenue per Category in 2017
    2. Filters: filters can be combined in order to narrow down the data for the report. There is always a time filter enabled and pre-populated with the current week.
      Warning: When you have entered or changed any filters, you must click Save Changes for any of the filters to be applied. If you click anywhere outside the Filters box before clicking this button, your changes are lost.

      Available filters are:

      Filter Value
      Time

      Each report must have a time filter, which can be set by selecting specific start and end dates from the date picker, or through selecting a predefined time range which is always relative to the current date. For example, if today's date is 16 April 2017 and you select 'this month', then the time range is automatically set to start on 1 April 2017 and end on (including) 16 April 2017.

      Note: You can only select a time range within the past 25 months from the current date. Reports that fall completely or partially outside of the data retention period fail to run.
      Note: You cannot select dates in the future.
      Device Group Select the device groups you would like to filter on.
      Campaign Select the campaigns you would like to filter on.
      Format Type Select the ad formats you would like to filter on.
      Goal Type Select the goal types you would like to filter on.
      Error Code

      Filter on specific error codes. Possible error codes are:

      Code Name Description
      0 Unknown error  
      1 Start ad timeout The ad did not start playback within the specified time. Default timeout value is 4 seconds.
      2 Total passback timeout The passback chain did not result in successfully showing an ad, because the pasback timeout expired.
      100 XML parsing error An error in the XML of a third party VAST ticket was found.
      101 VAST schema validation error The third party VAST ticket contains data that is in violation of the VAST schema.
      102 VAST version of response not supported The video player cannot handle the VAST ticket, because its version is not supported.
      200 Ad type not supported The video player received an ad type that it was not expecting and/or cannot display.
      201 Ad linearity error The video player expected a different linearity.
      300 General VAST Wrapper error  
      301 Timeout of VAST URI An error occurred when retrieving a third party URI. Timeout of a VAST URI provided in Wrapper element, or of VAST URI provided in a subsequent Wrapper element. Includes request errors such as invalid URI, unreachable or request timeout for URI, and security or other exceptions related to requesting a VAST URI.
      303 No VAST response No VAST response after one or more Wrappers.
      Note: When using the HTML5 SDK or any of its derivatives, then this error is also reported each time an inventory ad is encountered. An inventory ad is a placeholder where a real ad could have been, but no eligible ad was available in Pulse.
      400 General Linear error The video player is unable to display the linear ad.
      401 File not found Unable to find a media file at the URI.
      402 MediaFile timeout Unable to retrieve the media file within the designated time.
      403 Could not find supported MediaFile Could not find a media file that is supported by the video player, based on the attributes of the MediaFile element.
      405 Problem displaying MediaFile The video player found a media file with a supported type according to the attributes of the MediaFile element and was able to retrieve the file, but could not display the media file. MediaFile may include: unsupported codecs, different MIME type than indicated in @type attribute, unsupported delivery method, and so on.
      500 General NonLinearAds error The video player is unable to display the non-linear ad.
      502 Unable to fetch NonLinearAds / NonLinear resource The resource for the non-linear ad cannot be fetched.
      503 Could not find NonLinear resource with supported type Could not find a resource that is supported by the video player.
      900 Undefined error  
      Category Select the category you would like to filter on. You can use the text field to search, or browse through the category tree. You are only allowed to select one category, when filtering on category. All child categories of the selected category are automatically included.
      Content Partner Select the content partners you want to filter on.
      Advertiser Select the advertiser you want to filter on.
      Agency Select the agencies you want to filter on.
      Brand Select the brands you want to filter on.
      Audience Provider

      Select the audience provider you want to filter on. You are only allowed to select one audience provider for filtering.

      Warning: Audience Provider filter must always be used in combination with Audience dimension and the other way around, otherwise your report fails to run.
      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management (PAM) and Ooyala Pulse Audience Management for more information.
      Geography

      Select the countries, regions, cities and metro areas you would like to filter on.

      Note: The geographical data is strictly hierarchical. This implies that when you select a country, all of its regions and cities are automatically included, or when you select a region, all of its cities are automatically included.
      Tag Select the tags you want to filter on.
      Goal Select the goals you would like to filter on.

      A text field is available for each filter, except the time filter, to help you search for specific values. When you enter three or more characters, suggestions appear that match the entered text. For example:

      Campaign Filter
    3. Dimensions: dimensions can be combined in order to create different breakdowns of data. A maximum of eight dimensions can be selected. The order of the dimensions influences how the data is broken down. For each selected dimension, you can also specify to sort in ascending or descending order. Available dimensions are:
      Dimension Description and Options
      Time For the Time dimension, you have a further option to break down the data for each:
      • Year
      • Month
      • Day
      • Hour

      This dimension is selected by default with a break down by year.

      Campaign This dimension is selected by default.
      Ad  
      Advertiser  
      Agency  
      Audience

      Select this dimension to break down the data based on the segments from the selected audience data provider. The resulting column contains the segment key and value in the following format: <segment key>: <segment value>. For example: Age Group: 18-25.

      Warning: Audience Provider filter must always be used in combination with Audience dimension and the other way around, otherwise your report fails to run.
      Warning: Tag and Audience dimensions cannot be used together in the same report, because the report result cardinality could be too high and surpass the 100000 row limit for Custom Reporting..
      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management (PAM) and Ooyala Pulse Audience Management for more information.
      Brand  
      Category When selecting the category dimension, you can also select to which level in the tree, counting from the selected category, you want to break down the data. The selected category is always level 1 and is the category set in the filter or the root category for your account, in case it is not set in the filter. For example:
      If this is the category tree for your account:
      • Root Category
        • Sports
          • Football
            • UEFA Champions League
            • FIFA World Cup
          • Tennis
          • Basketball
        • Kids TV
        • Reality shows
        • ...

      , you selected to filter on Sports, and set Category as a dimension with level 2, then the breakdown looks as follows:

      Dimensions Metrics
      Category Category X
      Sports   Direct count for metric X for Sports category.
        Football Total count for metric X for Football category and all its child categories, which are UEFA Champions League and FIFA World Cup.
        Tennis Direct count for metric X for Tennis category.
        Basketball Direct count for metric X for Basketball category.
      City  
      Content partner  
      Country  
      Device Group  
      Error Code

      See Error Code under Filters for the possible error codes.

      To create meaningful reports, you must always use the Error Code dimension in combination with the Error metric. You can also report on error counts for the following dimensions:
      • Campaign
      • Goal
      • Ad
      • Device Group
      • Geography (Country, Region, City and Metro Area)
      • Format Type
      • Category
      • Tag
      Format Type  
      Goal  
      Goal Type  
      Metro Area  
      Region  
      Tag
      Warning: Tag and Audience dimensions cannot be used together in the same report, because the report result cardinality could be too high and surpass the 100000 row limit for Custom Reporting..
    4. Metrics: select the metrics you want to see in the report. These are the available metrics for Custom Reporting:
      • Impressions (selected by default)
      • Ad 25%
      • Ad 50%
      • Ad 75%
      • Ad Completed
      • Ad Started
      • Click-throughs
      • Completion rate
      • CTR (Click-through Rate)
      • Errors
      • Fill Rate
      • Inventory

        Requesting inventory metrics only yields meaningful results for the following dimensions, because they are part of the ad request (directly or indirectly):
        • Device group
        • Format type
        • Tag
        • Content partner
        • Geography dimensions
        • Category
      • Revenue
      • Unique Impressions
      • Unique Inventory
      • View Rate

      For metric explanation, refer to Glossary.

  4. Click Create Report to add the report to the queue for generating.

Was this article helpful?