Reports Tab: MoPub Reports

Reports provide a convenient way of tracking metrics on factors such as your revenue, number of impressions, or number of clicks. You can set reports to run periodically and send them to designated email addresses.

Currently MoPub retains reporting data for 13 months. Reporting data older than 13 months is not available.

Run an Existing Report Ad-Hoc

To run an existing report without waiting for its scheduled run:

  1. Navigate to the the Reports tab and click the report Name.

  2. In the report page, click Save. This runs the report and saves changes, if there are any. (Back in the Reports tab, your report’s status changes to ‘Pending’ while the report runs.)

Edit an Existing Report

To change any of the parameters in an existing report:

  1. Navigate to the the Reports tab and click the report Name.

  2. In the report page, make your changes (refer to the section below for an explanation of the fields).

  3. Click Save. This runs the report and saves your changes. (Back in the Reports tab, your report’s status changes to ‘Pending’ while the report runs.)

Create and Run a MoPub Report

To create and run a MoPub report:

  1. Navigate to the the Reports tab and click New MoPub report.

  2. In the New MoPub report page, designate a report Name and enter the email addresses of any Recipients, separated by commas.

  3. Specify a Date range: ‘Yesterday’, ‘Last 7 days’, ‘Last month’, or use the calendars to define a ‘Custom’ range.

    • Reports delivery SLA is 10:00am UTC (3:00am PST).

    • You can’t use today’s date as the end date for your report, because the data will not be available yet.

    • While reporting data is available for up to 18 months back, you can only pull three months of data at once. If more than three months of data is required, then you must pull and aggregate multiple reports.

  4. Specify the report Frequency. This is optional (you can select ‘Don’t schedule’). You can have the report run automatically on a ‘Daily’, ‘Weekly’, ‘Monthly’, or ‘Quarterly’ schedule.

  5. Select between one and six categories (dimensions) to report on (for example, ‘App’, ‘Ad Unit’, ‘Creative’).

    New Report - Category Dropdown

    You can choose from these categories:

    • App Categories: App, Ad Unit
    • Order Categories: Order, Ad Group (Line Item), Ad Group Type (Line Item Type), Ad Group Network Type (Network Type), Priority, Creative
    • Time Categories: Month, Week, Day
    • Additional Categories: Country, OS, Device Model, SDK Version

    For example, if you want to report on a single line item, select ‘Line Item’ as a category, then specify the line item you want to report on.

    New Report - Category Dropdown Selected

  6. Select desired metrics:

    • Attempts/Requests: When an ad is called, a request is logged within MoPub. An attempt is logged every time MoPub attempts an ad network.

    • Impressions: The number of times an ad is served.

    • Fills: Fills (for example, Successful Loads) is the total number of creatives that successfully loaded on the device. This is before the Impression renders on the device.

    • Clicks: The number of times an ad is clicked on.

    • Revenue: Estimated revenue reported by the MoPub ad server for all demand sources (network, Direct Serve, Marketplace).

    • CTR: The click-through rate of an ad (the number of times the click is made on the ad divided by the number of impressions).

    • Fill Rate (Inventory): The proportion of Fills to Ad Requests. This represents how often Ad Requests end up in Fills. Formula: Fills / Requests.

    • Fill Rate (Demand): The proportion of Attempts that resulted in Fills. Formula: Fills / Attempt Responses.

    • Show Rate (Inventory): The Inventory show rate metric measures the number of times an ad was shown to users (impressions) compared to the number of times an ad was requested from a specific ad unit (requests). Formula: Impressions / Requests.

    • Show Rate (Demand): The proportion of Attempt Responses that result in Impressions. Formula: Impressions / Attempt Responses.

  7. Click Run Report at the bottom right to send a CSV file to all recipients. Clicking Run and Save sends this report to all recipients, and saves it directly in the Reports tab.

Changelog

To review any changes to the data fields between old and new reporting systems for both MoPub scheduled reports and API reports, refer to the changelog.


Last updated July 14, 2021

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2021 MoPub (a division of Twitter, Inc.)