Administering Reports

A report identifies requests and the set of data that will be included upon being generated.

Learn how to:

• Create a report.
• Copy a report.
• Modify a report.
• Delete a report.
• Download report data.
• View sample report data.
• Schedule report delivery.

To create a report

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.
2. Click Add Report.
3. Under the Name option, assign a name to the report.

4. Define the report's time period by specifying a:

   • Relative Time Period: Click within the Date Range option and then select the desired relative time period (e.g., Today, Last 7 days, or Last 30 days).

     This predefined time period is relative to the date on which report data is generated.

   • Fixed Date Range: Click within the Date Range option and then select Custom Range. Click on the desired start date, click on the desired end date, and then click Apply.

     Report data is only available up to the last 90 days. Reports that reference dates older than 90 days will return partial or no data. This may occur inadvertently when downloading data for an old report that has been assigned a fixed date range.

5. Optional. Under the Granularity option, select a time interval (e.g., Hourly, Daily, or Weekly).

   The set of available time intervals varies according to the selected time period.

   If a time interval is not defined, then each record will cover the report's entire time period.

6. Optional. From the Row Limit option, select the maximum number of rows (e.g., 30,000) that may be included in a report.

   Data that exceeds the specified row limit will be excluded from the report. Include this data within a report by either specifying a smaller date range or by increasing the value assigned to the Row Limit option.

7. From the Metrics tab, select a metric from the Metric option.
8. Optional. Add another metric to the report by clicking Add another metric and then selecting the desired metric. Repeat this step as needed.
9. Optional. Add a dimension by clicking the Dimensions tab and then selecting a dimension from the Dimension option.
10. Optional. Add another dimension to the report by clicking Add another dimension and then selecting the desired dimension. Repeat this step as needed.

11. Optional. Filter the data that may be included in the report.

    1. Click the Filters tab.
    2. Under the Filter option, select the dimension by which report data will be filtered.
    3. Under the Operation option, choose the operation that will be applied to the value that will be specified in the next step.
    4. Under the Value option, type the desired value.

    Filter by delivery platform by setting the Filter option to Platform, the Operation option to In, and then selecting the desired delivery platform(s) from the Value option.

12. Click Save.
13. Optional. Click Download to download report data.

To copy a report

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.

2. Hover over the desired report and then click the copy icon.

   

   A copy of the selected report will be created and named using the following syntax:

   Copy of Report Name - #Represents a unique sequential number that starts at 1.

To modify a report

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.
2. Select the desired report.
3. Make the desired changes to the report.
4. Optional. Click Download to download report data.

5. Click Save to save your changes.

To delete a report

1. Navigate to the Report Builder pageHow?From the main menu, navigate to More | Report Builder.

2. Hover over the desired report and then click the delete icon.

   

3. Click OK to confirm the deletion.

To download report data

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.

2. Hover over the desired report and then click the download icon.

   

An alternative download method is to open the desired report and then click Download from the Details tab.

To view sample report data

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.
2. Select the desired report.
3. Verify the report's configuration.
4. Click Save to save changes to the report.
5. Click the Sample Data tab.

The Sample Data tab contains data sampled from your traffic. This data is not meant to be representative of your traffic and it will not match the data provided within our reports.

Scheduling Report Delivery

Reports may be generated and delivered via email on a recurring basis.

Key information:

• Each email will contain the following properties:

  • Subject Line

    We construct the subject line for each email upon generating the report. This subject line consists of a base subject line, as defined by the Subject option, followed by the report's start and end date/time as determined by the Date Range option.

    Subject line syntax:

    Base Subject LineAn email's base subject line is determined by the Subject option. Start Date/TimeThe report's start date/time is calculated during report generation according to the report's date range. - End Date/TimeThe report's end date/time is calculated during report generation according to the report's date range.

    Date/Time syntax:

    YYYY-MM-DDTIndicates a delimiter between date and time. hh:mm:ssZRepresents UTC time.

    Specify a subject line that is a 100 characters or less.

  • Body

    The email's body is determined by the Message option.

  • Attachment

    The report will be attached to the email as a JSON or a comma-separated values (CSV) file as determined by the Document Format option.

    Learn more.

    File name syntax:

    Base File NameAn email's base file name is determined by the Document Name option._Start Date/TimeThe report's start date/time is calculated during report generation according to the report's date range._End Date/TimeThe report's end date/time is calculated during report generation according to the report's date range..[csv|json]

    Date/Time syntax:

    YYYY-MM-DDTIndicates a delimiter between date and time. hh_mm_ssZRepresents UTC time.

    A report's file name will not exceed 255 characters.

• Deliver report data using one of the following frequencies:

  Frequency	Description
  Daily	Sends a report every day at the scheduled time (UTC).
  Weekly	Sends a report every Monday at the scheduled time (UTC).
  Bimonthly	Sends a report on the 1st and the 15th of the month at the scheduled time (UTC).
  Monthly	Sends a report on the 1st of the month at the scheduled time (UTC).

  Scheduling the delivery of a report whose date range is set to This Month may generate reports containing minimal or no data. For example, delivering this type of report on a bimonthly or monthly schedule will contain minimal or no data on the 1st of the month. Consider setting the report's date range to Last Month.
  Learn more. Reports are generated at midnight (UTC) according to the above schedule. If a report is scheduled to be delivered/generated on the 1st of the month, then a report whose date range is set to This Month will only report data for requests that completed at exactly midnight (UTC) on the first of the month.

• Schedule report delivery to continue indefinitely or define a specific date on which delivery will stop.
• Test your report delivery configuration by sending a test email.

To schedule report delivery via email

1. Navigate to the Report Builder page How?From the main menu, navigate to More | Report Builder.
2. Select the desired report.
3. Click the Share tab.

4. From the Subject option, type the email's base subject line.

   Specify a base subject line that is 100 or less characters.

5. From the Message option, type the email's body.

   Specify a message that is 100 or less words.

6. From the Sent To option, select each email address to which this report will be delivered on a regular basis.

   You may only select an email address associated with a MCC user account.

7. From the Document Name option, verify the base file name of the email attachment.

8. From the Document Format option, select whether report data will be formatted as CSV or JSON data.

9. Define a delivery schedule.

   1. From the Frequency of Report option, select how often reports will be generated and delivered via email.
   2. From the Delivery Time option, select the time (UTC) at which reports will be generated and delivered via email.
   3. From the Start option, select the start date (UTC) for report delivery.

   4. Determine whether report delivery will:

      • End on a specific date: Clear the Never option and then select the desired date from the End option.
      • Continue indefinitely: Mark the Never option.
10. Optional. Test your delivery configuration by selecting a recipient from the Test Email Address option and then clicking Send a Test Email.
11. Verify that the Share Status option is set to ON.
12. Click Save.
13. Click Cancel to return to the Report Builder landing page.