Request Reporting

Owned by JB Martinez
Last updated: Apr 20, 2022
4 min read

Overview

Request reporting and set up subscriptions for a specified cadence utilizing Pub Maestro. To request reporting utilizing the publisher reporting API, please follow the setup requirements and request body details here.

Reporting Guide

  1. Select ‘Reporting’ in the top nav of the Pub Maestro dashboard

  2. Fill out the ‘New Report’ form for the following fields (*denotes required field/option):

    1. Recipients* - Include an email address to deliver the report

    2. Metrics*

    3. Group By (Dimensions)

  3. Filters - optional

    1. Filter options

  4. Settings

    1. Timezone - If no timezone is selected, UTC will be defaulted

    2. Subscription

      1. Toggle the 'Subscribed report' option

      2. Select a delivery cadence for ‘Repeats’ - the following delivery schedules are available:

        1. daily

        2. weekly

        3. monthly

      3. Select when the subscribed report 'Ends'

        1. Never (Indefinite subscriptions - the option to cancel ongoing subscriptions is available in ‘Subscriptions’.

        2. On - Select the date for when the subscribed report to complete the requested subscription.

          1. Cancelling subscriptions - Refer to ‘Actions’ in the Subscriptions page

        3. Summary - Use the summary details to confirm the subscription. This box will deliver when the last delivery email for the recipient will be.

          1. Sample Detail: “Emails will be sent weekly starting Monday, February ** at 9AM in UTC timezone. The last email will be on Monday, March **.

    3. Report Name - Title the ‘Report Name’ as a unique identifier for the report. This will be the name of the reporting subscription title in the email for the report and for the list of ongoing subscriptions.

Filters

  1. Filters - optional (*denotes required field/option)

    1. Select ‘+ Add new filter’

    2. Select a *Field to filter by:

      1. Advertiser Domain

      2. Brand

      3. Bundle ID

      4. Country

      5. Creative Type

      6. DSP Name

      7. Device Type

      8. Floor Price

      9. Inventory Type

      10. Is Instream Video

      11. Notable Domain

      12. OS Type

      13. Placement Domain Key

      14. Placement Key

      15. Placement Name

      16. Placement Size

      17. Site Name

      18. Site Type

      19. Supply Name

    3. Select an *Operator to delineate by:

      1. Is

      2. Is not

      3. Contains

      4. Is one of

      5. Is not one of

    4. Select a *Value to filter to:

      1. This field will vary pending on what the chosen *field to filter by:

        1. If selected Country the following options contains:

          1. United States

          2. Canada

          3. Australia

          4. United Kingdom

          5. France

          6. Spain

          7. Italy

          8. Germany

          9. Belgium

          10. Finland

        2. If selected Creative Type the following options contains:

          1. Outstream

          2. Banner

          3. Article

          4. Clickout

        3. If selected DSP Name the following options contains:

          1. Stack Adapt - Native

          2. PulsePoint

          3. Outbrain (Zemanta)

          4. BidSwitch - Native

          5. Xandr

          6. Criteo

          7. The Trade Desk

          8. AdMaxim

          9. MediaMath

          10. Storygize

          11. DataXu

          12. Verizon Media DSP

          13. Adobe - Native

          14. Basis (Centro)

          15. Conversant

          16. Bidtellect

          17. Index Exchange

          18. SpotX

          19. Pubmatic - Video

          20. Rubicon - Native

          21. Rubicon - Video

          22. OpenX - Video

          23. Basis DSP - Native

          24. StackAdapt - Video

          25. Adobe - Video

          26. Quantcast - Native

          27. Index Exchange - Display

          28. Rubicon - Display

          29. Quantcast - Display

          30. Quantcast - Video

          31. Adobe - Display

          32. OpenX - Display

          33. RTB House

          34. PubMatic - Display

          35. 33Across

          36. DV360 - Native

          37. DV360 - Video

          38. DV360 - Display

          39. BidSwitch - Video

          40. BidSwitch - Display

          41. Smaato - Native

          42. Beeswax

          43. Smaato - Display

          44. Smaato - Video

          45. Consumables

          46. Conversant - Display

          47. Conversant - Video

          48. Criteo - Display

          49. DynAdmic - Display

          50. DynAdmic - Video

          51. ClueP

          52. Crimtan

          53. StackAdapt - Display

        4. If selected Device Type the following options contains:

          1. Desktop

          2. Tablet

          3. Smartphone

        5. If selected Notable Domain:

          1. a list of notable domains for the selected publisher will be available to chose from.

        6. If selected OS Type the following options contains:

          1. Android

          2. iOS

          3. Roku

        7. If selected Placement Domain Key the following options contains:

          1. a list of PD keys will be available for the selected publisher will be available to chose from.

        8. If selected Placement Key the following options contains:

          1. a list of placement keys will be available for the selected publisher will be available to chose from.

        9. If selected Placement Name the following options contains:

          1. a list of placements will be available for the selected publisher will be available to chose from.

        10. If selected Site Name the following options contains:

          1. a list of sites will be available for the selected publisher will be available to chose from.

        11. If selected Site Type the following options contains:

          1. App

          2. Web

        12. If selected Supply Name the following options contains:

          1. Tag on Page

          2. Prebid Client-side

          3. Index Exchange

          4. Prebid Server

          5. media.net

          6. pubfood

          7. addkt+

          8. Rubicon

          9. Direct Sell

          10. Google OB

          11. Verizon

          12. Microsoft

          13. Samsung

          14. Amazon TAM

          15. DMX

          16. Purch

          17. Mediavine

          18. TappX

          19. Dailymotion

          20. Rise

Please note that when generating data with the DSP filter applied, an error is expected. Requesting DSP related data is a down stream bid request after the auction/win. The DSP filter is only compatible with the following metrics/rates:

  • Earnings

  • Rendered Impressions

  • Viewable Impressions

  • Wins

  • Viewability Rate

  • CTR

Subscriptions

For current or to create a subscription(s), navigate to the left hand rail. The subscriptions page allows you to:

  1. Create a new report (subscription or not)

  2. View current subscriptions for the account by:

    1. Name

    2. Frequency

    3. Recipients

    4. Expiry

    5. Created At

    6. Action - Cancel

      1. To cancel an ongoing subscription, select ‘Cancel’ and Pub Maestro will ask to you confirm the cancellation prior to completing the request.