Create or reuse a custom report

Prerequisites

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

  • The ability to set future dates as end dates needs to be enabled for your account. Contact your Account Manager if you are interested in this functionality.
  • You should understand which filters, dimensions, and metrics cannot be used together in the same report, and which depend on a specific combination. For more information, see Invalid combinations.
  1. Open Custom Reporting from the menu Custom Reporting access tab.
  2. Click Create a Report, or click MORE ACTIONS (…) button of the report you want to reuse, and select Reuse Report.

    The form opens:

    Create a Report page
    Part Name
    1 Report title
    2 Filters. By default, the time filter is entered with the last seven days. When setting up the filters, your changes are saved automatically.
    3 Dimensions. By default, the time dimension with a breakdown by day is selected.
    4 Metrics. By default, the impressions metric is selected.
    5 Warning/informational messages
    6 Create Report button
  3. Fill in the following fields:
    1. Title: insert a descriptive title for the report. For example, Revenue per Category in 2017. Use up to 255 characters.
    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. Also see Invalid combinations.

      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:

      The following limitations apply to the time filter:

      • You can only select a start date no more than 25 months in the past from the current date and including the current date.
      • The time span cannot be longer than twelve months.
      Note:

      If the refreshable reports functionality is enabled in your account, then you can enter a future date for the end date, which allows you to refresh the report results up until three days after that future date has passed. However, this functionality is only available for reports created through the user interface.

      Setting a future date can be particularly useful when you share a report for campaigns with the associated advertiser, because the advertiser is able to refresh the report results and monitor the progress without the need for an operator in Pulse to share new reports at set intervals.

      For more information on refreshing reports, see Refresh date and refresh button on the View a custom report page.

      Note: For static reports, it is recommended to set the end date at least 24 hours in the past from the current time, due to data availability reasons (see Data availability).
      Device Group Select the device groups you would like to filter on.
      Format Type Select the ad formats you would like to filter on.
      Flag Select the flags you would like to filter on.
      • No commercials
      • No pre-rolls
      • No mid-rolls
      • No post-rolls
      • No overlays
      • No flags set
      Goal Type Select the goal types you would like to filter on.
      Goal Mode Select the goal mode you would like to filter on. Either Normal or Sponsor.
      Error Code Select the error codes you would like to filter on. For more information and a list of all possible error codes and their descriptions, see Pulse Error Tracking.
      Content ID

      Filter the content you served ads for based on the content's recorded ID. This is a free text field, type and press enter for each content ID you want to add.

      Note:

      Content IDs are available for reporting in Pulse from March 7, 2018, if you are sending this information to Pulse in your integrations through:

      • the content ID parameter in the content metadata object, when using the Pulse SDKs, HTML5 Ad Player or HTML5 Pulse SDK derived plugins, or
      • the content ID parameter, when using direct VAST or VMAP requests.
      Content Partner Select the content partners you want to filter on.
      Advertiser Select the advertisers 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 (legacy)

      Select the audience provider you want to filter on. Also see Invalid combinations.

      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management for more information.
      Audience Segment Filter on a specific segment in an audience segmentation. You can only filter for segments within one segmentation. However, when using both the audience segment filter and the audience segmentation dimension in one report, you can break down the data by segments from a segmentation that is different than the one you filtered on, but it must belong to the same audience provider.
      • Provider: select the audience provider
      • Segmentation: select the audience segmentation belonging to the selected audience provider
      • Segment: select the audience segment belonging to the selected audience segmentation
      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management for more information.

      Also see Invalid combinations.

      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.
      Campaign Select the campaigns you would like to filter on.
      Goal Select the goals you would like to filter on.
      Tag Select the tags you want to filter on.
      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.

      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. You must select at least one dimension. Time dimension is selected by default with a breakdown by day. A maximum of eight dimensions can be selected. Hover over the selected dimensions to deselect them, or move them up or down to adjust their order, which influences how the data is broken down in the resulting report. Also see Invalid combinations. 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 breakdown by day.

      Ad The ad. Also see Invalid combinations.
      Advertiser The advertiser associated with a campaign.
      Agency The agency associated with a campaign.
      Audience (legacy)

      Break down the data based on the segments from the audience data provider you are filtering on.

      The resulting column contains the key and value in the following format: segmentation key label (segmentation name): segmentation value label (segment name). For example: Age: 18-25.

      Any missing mappings resolve to segmentation key label (segmentation name): undefined in your reports, for example Age: undefined.

      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management for more information.

      Also see Invalid combinations.

      Audience Segmentation Break down the data based on a specific audience segmentation. When using both the audience segment filter and the audience segmentation dimension in one report, you can break down the data by segments from a segmentation that is different than the one you filtered on, but it must belong to the same audience provider.
      You might find the following segment values in your segmentation breakdowns:
      • undefined - 'SegmentationId-SegmentId' not found, for example undefined ´1-0´not found: this means you passed in an unknown segment in the ad request and Pulse recorded events for it (segmentId=0 in our example). You should make sure you are passing in correct values in your ad requests. This does not occur if you filter and breakdown on the same segmentation.
      • undefined - Missing value: this means events were recorded, but are not associated with the requested segmentation dimension. For example, you are breaking down today's data by gender, and there are events on male and female segments, but there are also events that are not associated with the gender segmentation. This does not occur if you filter and breakdown on the same segmentation.
      Note: Only create reports on audience if you have an integration with an audience data provider. See Pulse Audience Management for more information.

      Also see Invalid combinations.

      Brand The brand associated with a campaign.
      Campaign The campaign. Also see Invalid combinations.
      Category
      When selecting the category dimension, you can also select to which level in the tree you want to break down the data. Breakdown of data based on category is limited to:
      • five levels in the category tree, where the first level corresponds to the category selected in the filter or the root category of your account, in case it is not set in the filter.
      • maximum the seventh level of the category tree, counting the root category as the first level.
      For example, your account category tree looks as follows:
      • Root Category
        • Sports
          • Football
          • Basketball
        • TV Shows
          • Kids Shows
          • Reality Shows
            • Idol
              • Idol Season 1
              • Idol Season 2
            • Masterchef
        • ...

      You select to filter on TV Shows and set Category as a dimension with 3 levels breakdown. The report breakdown looks as follows:

      Category 1 Name* Category 2 Name Category 3 Name Metric Name
      TV Shows undefined** undefined Direct count*** for selected metric for TV Shows category.
      TV Shows Kids Shows undefined Direct count for selected metric for Kids Shows category.
      TV Shows Reality Shows Idol Total count**** for selected metric for Idol category and all its child categories, which are Idol Season 1 and Idol Season 2.
      TV Shows Reality Shows Masterchef Direct count for selected metric for Masterchef category.
      Note:

      *The category column names correspond to the levels the categories represent in the category tree. The root category is marked 'Category 0'. All level one categories are marked 'Category 1', all level two categories are marked 'Category 2', and so on. As the selected category in our example is level one in the category tree, its column name is 'Category 1'.

      **When breaking down categories to multiple levels, each category is assigned a row based on its level. When a metric is recorded for a category of a higher level than what the report reaches, the remaining levels are marked as 'undefined'.

      ***Direct count is displayed for categories that do not have any more levels for breaking down the data.

      ****Total count is displayed for categories that have more levels, but the report does not reach them. In that case, child categories are included in the metric count.

      City The city targeted by a specific campaign or goal.
      Content ID

      The ID of the content where ads were served.

      Note:

      Content IDs are available for reporting in Pulse from March 7, 2018, if you are sending this information to Pulse in your integrations through:

      • the content ID parameter in the content metadata object, when using the Pulse SDKs, HTML5 Ad Player or HTML5 Pulse SDK derived plugins, or
      • the content ID parameter, when using direct VAST or VMAP requests.
      Content Partner The content partner targeted by a specific campaign or goal.
      Country The country targeted by a specific campaign or goal.
      Custom Ad ID

      The custom ID entered for an ad.

      Note: The custom ad ID is a free text field, which means that the values may not be unique or even present for each ad.
      Custom Campaign ID

      The custom ID entered for a campaign.

      Note: The custom campaign ID is a free text field, which means that the values may not be unique or even present for each campaign.
      Custom Goal ID

      The custom ID entered for a goal.

      Note: The custom goal ID is a free text field, which means that the values may not be unique or even present for each goal.
      Device Group The device group indicates which devices were targeted by a specific campaign or goal. For example, "Android tablets and phones" could be a device group.
      Error Code

      For more information and a list of all possible error codes and their descriptions, see Pulse Error Tracking.

      To create meaningful reports, you should 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
      Flag The flags used in Pulse to mark and remove monetisation from specific content items. Specified by the f request parameter in an ad request to Pulse.
      Format Type Ad format type, like "Pre-roll", "Mid-roll", and so on.
      Goal The goal. Also see Invalid combinations.
      Goal Mode The mode of a goal, which can be either Normal or Sponsor.
      Goal Type The goal type, like "Impressions", "Click-throughs", "Share of Voice (%)", and so on.
      Metro Area The metro area targeted by a specific campaign or goal.
      Region The region targeted by a specific campaign or goal.
      Tag Text representing the tags. Also see Invalid combinations.
    4. Metrics: select the metrics you want to see in the report. You must select at least one metric. Impressions metric is selected by default. Hover over the selected metrics to deselect them, or move them up or down to adjust their order, which influences how the data is presented in the resulting report. Also see Invalid combinations. These are the available metrics for Custom Reporting:
      Metric Description and Options
      Impressions Selected by default. The amount of successfully shown ads. Success is reported as soon as the first frame of the ad is shown.
      Ad 25% The amount of times an ad was viewed to at least 25% completion.
      Ad 50% The amount of times an ad was viewed to at least 50% completion.
      Ad 75% The amount of times an ad was viewed to at least 75% completion.
      Ad Completed The amount of times an ad was viewed to completion.
      Ad Started The amount of time an ad was started, which is the same as impression count for Pulse.
      Click-throughs The amount of times a click-through link was activated.
      Close The amount of times the viewer closed an ad.
      Companion Click-throughs The amount of times a companion banner associated with a linear ad was clicked by a viewer.
      Companion Impressions The amount of times a companion banner associated with a linear ad was successfully shown to the viewer.
      Completion Rate The amount of times an ad was viewed to completion in comparison to the amount of times an ad was started (=Ad Completed/ Impressions).
      Content Start The amount of times that video content was started.
      CTR (Click-through Rate) The proportionate amount of times a click-through link was activated (=click-throughs/times a click-through is available).
      Errors The amount of times errors or a specific error occurred.
      To create meaningful reports, you should 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
      Fill Rate

      The amount of impressions in comparison to the amount of inventory (=Impression/Inventory). Also see Invalid combinations.

      Interaction The amount of times that the viewer interacted in a way with an ad.
      Interaction Rate The amount of interactions in comparison to the amount of impressions.
      Inventory

      The amount of opportunities to show an ad. Also see Invalid combinations.

      Requesting inventory metrics only yields meaningful results for the following dimensions, because they are part of the ad request (directly or indirectly):
      • Audience (legacy)
      • Audience segmentation
      • Category
      • Content ID
      • Content partner
      • Device group
      • Flag
      • Format type
      • Geography dimensions
      • Tag
      Revenue The amount of revenue.
      Skip The amount of times an ad was skipped by the viewer.
      Unique Impressions The amount of successfully shown ads to unique viewers, meaning that a viewer who has seen the ad more than once is only counted one time.
      Unique Inventory The amount of opportunities to show an ad to unique viewers.
      View Rate A complex calculation based on quartile view-through rates in comparison to the amount of impressions. This calculation is explained in the following article: How is view-through rate calculated in Custom Reporting?
  4. Click Create Report to add the report to the queue for generating.