Reach & Frequency Reporting is now available in SpringServe by turning on the Reach & Frequency Reporting beta feature. With this feature, clients have the ability to run reports that show metrics the number of users they reach (namely the Reach) and how often they reach these users (namely Frequency) over time over supply & demand sources.

Reach & Frequency Reporting

Once this feature has been enabled for your account by your Account Manager, you will have the ability to run Frequency & Reach reports. On turning the beta feature for the account, users will see two new reporting templates available to run. These two reporting templates are called:

The Mechanics of the Reach & Frequency Report Templates

This section explains the details of these two templates with emphasis on time parameters, dimensions, filters, metrics and interpreting the data.

Reach Report

The Reach report shows the details of the number of unique users, devices, ips and the impressions that have been served to these users. This report addresses custom use-cases where users can choose to run these metrics by custom time periods like Days, Weeks, Months or Cumulative.

Listed below are the specific considerations to be cognizant of when running this report:

Time Parameters:

Dimensions:

Filters:

The screenshot shows the filters container for a reach report with the Cadence filter pre-selected and the value of “All Days” pre-populated.

Metrics:

Attached below is a screenshot highlighting all the metrics available to be selected in this report with the ones in teal being the default selections.

Numbers:

Calculations:

Financials:

Note that the financial metrics available to this report do not have third party fees and thus the financial metrics available are Revenue, Media Cost and their derivative financial calculations.

Conditions

Users can set conditions on this report to return only those lines which meet those conditions. For example, you can run a report to return data filtered by a condition where unique users >= 10.

Users can use the Quick Add buttons to select a metric or click the +New Condition button and a dropdown will appear. Select your desired metric from the dropdown and set the condition.

Below is a screenshot showing the first page of a results container for a report run on test data for the last month with the data broken out by day.

Frequency Report

The Frequency Report is almost entirely similar to the reach report with one key difference. All the mechanics detailed in the above section are applicable to this report and thus this section will highlight only the difference between this report and the reach report.

Time Parameters:

Dimensions:

Cadence is a set of pre-defined intervals for users who want to run these reports by the pre-defined Cadence Intervals. All possible values of the cadence intervals are displayed in the screenshot in the next section.

Interpreting Cadence

The screenshot below shows all applicable values for Cadence. Note that the values for cadence displayed will be dependent on the data range selected.

Note that “Days 1-2” implies that the metrics are being displayed for the current day and two days ago. “Days 3-4” implies that the metrics are being displayed for the time period from three days and including 4 days ago. Note that the lower and upper bounds for each cadence interval are inclusive, which means that Days 1-2 is inclusive of data up to 2 days ago from the end date of the date range selected.

To enunciate this logic, consider an example report that a user runs the frequency report for the last 30 days on March 30th at noon UTC.

If users run this report for a custom date range in the past, this logic still holds true. So, consider that a user runs a report for the month of January 2022 but runs this on March 30th at noon UTC, then these cadence intervals above will be run but the interpretation of the cadence interval in this report will be thus:

Running Frequency & Reach Reports

When users run either of these reports, a modal will appear that displays a large Frequency & Reach report Modal with the following details:

Modal Title: Large Frequency & Reach Report

Text: This report is very large and will take over 2 minutes to run. You will be able to view it at the Download Reports page when it is complete. It will continue to be processed if you navigate away from this page.

Additionally, users can choose to add a name to this report.

The main thing to note is that due to the volume of data that needs to be processed to run these reports, these reports have a data lag of 8 hours and they will almost always take more than 2 minutes to run. Please note that there is a note highlighting this specifically in the results container while this report is being processed.

Users must also be cognizant of the fact that adding more incremental parameters to this report will increase the complexity of the queries used to process the data thereby increasing the processing time needed to run these reports.

Frequency Reports Edge-Case

There is one edge-case to be aware of in some cases where users can see a value for Cadence called “Interval_unknown” on running custom reports. If users see a value called 'Interval_unknown” this is indicative of data for the last day of the date range for the hours that fall outside 365 hours in a custom report.

Consider a Frequency report and reach report run for a custom date range of 03/29/21 00:00 - 03/29/22 23:59

The Reach report will show data like this for the last day:

And if you correlate this data with the Unknown_interval shown in the frequency report, these numbers will match.

To enunciate this data, 365 days back in the UI is 03/29/21 00:00 - 03/29/22 23:59 since the start date of 03/29/21 00:00 falls out of the 365 days before 03/29/22 23:59, it falls into interval unknown. To explain it another way, it falls out of the cadence intervals but it's in the start and end dates and thus, we report on it.

Running Frequency & Reach Reports via the API

These reports are available to be run via the REST API. Here are the conditions to be aware of while running these reports via the REST API:

Here’s an example API Call in our test environment with the Auth token hidden for running these reports after users have received a valid Authorization token.

curl --location --request POST 'https://staging-admin-console.springserve.com/api/v0/report' \
--header 'Content-Type: application/json' \
--header 'Authorization: ________________' \
--data-raw '{
    "interval":"day",
    "timezone":"UTC",
    "start_date":"2021-08-26",
    "end_date": "2022-01-01",
    "demand_tag_ids":[24275],
    "async":true
}'

It is important to note that these reports will not work in the API when the flag "async":true is not set in the CURL call.