Follow

Reports Section

The AerServ 'Reports' section is designed to give you quick, at-a-glance insights, as well as deep and granular metrics.

 

 

 

The reporting console is broken into two main sections:

  • Default or Canned Reports
  • Saved or Custom Reports

 

And is broken down by the following two filters:

  • All Ad Events
  • SDK Events (this is only available for publishers that have integrated AerServ's SDK)

 

 

Click the toggles below to learn more about both reporting from filters. 

 

 

Default/Canned Reports


The default reporting view within AerServ allows you to view inventory delivery and performance trends by date. The default metrics include ad attempts, delivered impressions, fill rate %, click through rate (CTR), view through rate (VTR), revenue, and eCPM.  

    • Above the report graphs and data tables, you’ll find four drop downs that allow you to easily filter the reports: (1) date range, (2) ad source, (3) app, and (4) placement. Make a selection within one or more of these drop downs and press "Run Report" to refresh the data and charts below. 
    • Below the filters, you’ll see a data table that aggregates metrics for the filters defined. Clicking on one of the metrics in this table will refresh the chart below to give you a quick visual of the trends. 
    • We included "Canned Reports" and "Saved Reports" in the top righthand corner for easy access to commonly viewed reports. These include reports by date, ad source, GEO, operating system, and placement (PLC).
    • From this view, you’ll also be able to export your report to a CSV file by clicking the button at the bottom of the page.

 

Here is more information regarding each of the metrics you’ll find in the reports:

 

METRIC
DEFINITION
Opportunities

This is the unique count of how many times a placement ID (PLC) was requested.

Impressions

The total number of ads that were delivered.  

Revenue

The total NET revenue for all ads in USD.

Ad Requests

The total number of times the ad server makes an attempt to an ad source to a fill an ad opportunity.

Fill Rate %

A calculation of your "fill rate" for ads. Fill rate is an important metric to measure advertising performance and calculates the percentage of delivered ads against the number of ad opportunities. A simple calculation: ad impressions / ad opportunities.

CTR

Click through rate, or CTR, measures the percentage of users that click on an ad. The calculation for CTR is: clicks / ad impressions.

VTR

View through rate, or VTR, measures the percentage of users that view the entire video ad, or 100% completion of the ad. The calculation for VTR is: 100% views / ad impressions.

eCPM

eCPM stands for "effective cost per mille," or cost per thousand impressions. The eCPM shows you the US dollar amount earned per thousand impressions delivered.

 
 

 

Custom Reports


You can also customize and save your own report by clicking on the “ADD NEW REPORT” link in the upper right hand corner. This allows you to create a report specific to your needs, label it, and save it for easy, one-click access in the future. Within the Create a Report wizard, you will be able to select the date range, filters that are most relevant for your needs, and compare them to the performance metrics that you want to view. 

 

 

Here is more information regarding each of the filters and metrics you’ll find in the create a report wizard:

 

FILTER KEYS
DEFINITION

App

The name of the App that was defined by the publisher during the on-boarding process  

Placement

The name of the Placement that was defined by the publisher. These are placements associate to the app that has been defined by the publisher

Date

Month / Day / Year

Priority

This metric will only make sense in context with Ad Sources. This will determine which priority an ad source was in when it was able to fill the request.

Ad Source

The name of the mediated Ad Source

OS

The Operating System of the mobile device used: either iOS or Android

Device Type

This filter key will help differentiate activity derived from Mobile vs Desktop

Country

This filter key will help differentiate activity by countries 

Country Code

 This filter key will help differentiate activity by countries using the two-digit country code

 

METRIC
DEFINITION

Opportunities

This is the unique count of how many times a placement ID (PLC) was requested 

Impressions

The total number of ads that were delivered

Revenue

The total NET revenue for all ads in USD

Requests

The total number of attempts to an ad source to retrive an ad opportunity.

Video Complete

The total number of video ads that were viewed to completion

Video Terminated

The total number of videos that were started but never viewed to completion (calculation: Video Complete - Video Started)

Fill Rate %

A calculation of your "fill rate" for ads. Fill rate is an important metric to measure advertising performance and calculates the percentage of delivered ads against the number of ad opportunities. A simple calculation: ad impressions / ad opportunities

CTR %

Click through rate, or CTR, measures the percentage of users that click on an ad. The calculation for CTR is: clicks / ad impressions

Video VTR %

View through rate, or VTR, measures the percentage of users that view the entire video ad, or 100% completion of the ad. The calculation for VTR is: 100% views / ad impressions

CPM

Cost per Mille or cost per thousand impressions. The CPM shows you the set US dollar amount per thousand impressions delivered

eCPM

eCPM stands for "effective cost per mille", or cost per thousand impressions. The eCPM shows you the US dollar amount earned per thousand impressions delivered

Timezone

 The timezone we report in is UTC

 

 

Update Regarding Our Reporting Service

AerServ has recently implemented a throttling mechanism to the reporting service that powers the platform dashboard page, platform reporting console, and reporting APIs. To help with the overall stability of our platform AerServ implemented a threshold for each publisher account on how much data can be extracted in a 10 second duration. If there are too many simultaneous reporting queries coming from the platform or the API that exceeds our threshold during that 10 second interval, the UI will alert the publisher to try again shortly. Within the API, you will receive an error message that would look like the following:

{"error": "Request has been throttled. Publisher 214 has requested to use 30 of maximum 20 RSUs in the time range of 10s"} A status code of "429" will be returned as a response from the reporting API if the publisher has reached their reporting threshold.

 

 

Default/Canned Reports


The by 'SDK Events' reporting view within AerServ allows you to view inventory delivery and performance trends by SDK specific placement. The flow of events when using the SDK are different than those via API or tags, and we're able to give publishers a deeper look into their metrics.  The default metrics include ad opportunities, preload ready, buyer fill rate, show ad attempts, user ad rate, impressions, inventory fill rate, ad use rate, CPM, and revenue.  

    • Above the report graphs and data tables, you’ll find four drop downs that allow you to easily filter the reports: (1) date range, (2) ad source, (3) app, and (4) placement. Make a selection within one or more of these drop downs and press "Run Report" to refresh the data and charts below. 
    • Below the filters, you’ll see a data table that aggregates metrics for the filters defined. Clicking on one of the metrics in this table will refresh the chart below to give you a quick visual of the trends. 
    • We included "Canned Reports" and "Saved Reports" in the top righthand corner for easy access to commonly viewed reports. Currently, AerServ only supports viewing 'SDK Events' reporting by the 'Placement' filter for canned reports.
    • From this view, you’ll also be able to export your report to a CSV file by clicking the button at the bottom of the page.

 

Here is more information regarding each of the metrics you’ll find in the reports:

 

METRIC
DEFINITION
Opportunities

This is the unique count of how many times a placement ID (PLC) was requested.

Preload Ready

The number of unique preload ready events for the PLC.  A "valid" ad was delivered back to the app.

Buyer Fill Rate

The percentage of time that a buyer responded with an ad when a request is made; calculated as (preload ready / ad opportunities).

Show Ad Attempts

The number of unique show ad events for the PLC.  The app attempts to show the ad based on a user action (ex: clicks "watch video").

User Ad Rate

The percentage of time that a user made it to the point in the app where an ad could be shown; calculated as (show ad / ad opportunity)

Impressions

The total number of ads that were delivered.  

Revenue

The total NET revenue for all ads in USD.

Ad Use Rate

 The percentage of time that a valid ad was used; calculated as (impression / preload ready).

Inventory Fill Rate

A calculation of your "fill rate" for your inventory. Fill rate is an important metric to measure advertising performance and calculates the percentage of delivered ads against the number of opportunities to show a user an ad. A simple calculation: ad impressions / Show Ad Attempts.

eCPM

eCPM stands for "effective cost per mille," or cost per thousand impressions. The eCPM shows you the US dollar amount earned per thousand impressions delivered.

 
 

 

Custom Reports


You can also customize and save your own report by clicking on the “ADD NEW REPORT” link in the upper right hand corner. This allows you to create a report specific to your needs, label it, and save it for easy, one-click access in the future. Within the Create a Report wizard, you will be able to select the date range, filters that are most relevant for your needs, and compare them to the performance metrics that you want to view. 

 

 

Here is more information regarding each of the filters and metrics you’ll find in the create a report wizard:

 

FILTER KEYS
DEFINITION

App

The name of the App that was defined by the publisher during the on-boarding process  

Placement

The name of the Placement that was defined by the publisher. These are placements associate to the app that has been defined by the publisher

Date

Month / Day / Year

Priority

This metric will only make sense in context with Ad Sources. This will determine which priority an ad source was in when it was able to fill the request.

Ad Source

The name of the mediated Ad Source

OS

The Operating System of the mobile device used: either iOS or Android

Device Type

This filter key will help differentiate activity derived from Mobile vs Desktop

Country

This filter key will help differentiate activity by countries 

Country Code

 This filter key will help differentiate activity by countries using the two-digit country code

 

METRIC
DEFINITION

Opportunities

This is the unique count of how many times a placement ID (PLC) was requested 

Impressions

The total number of ads that were delivered

Revenue

The total NET revenue for all ads in USD

Requests

The total number of attempts to an ad source to retrive an ad opportunity.

Video Complete

The total number of video ads that were viewed to completion

Video Terminated

The total number of videos that were started but never viewed to completion (calculation: Video Complete - Video Started)

Fill Rate %

A calculation of your "fill rate" for ads. Fill rate is an important metric to measure advertising performance and calculates the percentage of delivered ads against the number of ad opportunities. A simple calculation: ad impressions / ad opportunities

CTR %

Click through rate, or CTR, measures the percentage of users that click on an ad. The calculation for CTR is: clicks / ad impressions

Video VTR %

View through rate, or VTR, measures the percentage of users that view the entire video ad, or 100% completion of the ad. The calculation for VTR is: 100% views / ad impressions

CPM

Cost per Mille or cost per thousand impressions. The CPM shows you the set US dollar amount per thousand impressions delivered

eCPM

eCPM stands for "effective cost per mille", or cost per thousand impressions. The eCPM shows you the US dollar amount earned per thousand impressions delivered

Timezone

 The timezone we report in is UTC

Preload Ready

The number of unique preload ready events for the PLC.  A "valid" ad was delivered back to the app.

Show Ad Attempts

The number of unique show ad events for the PLC.  The app attempts to show the ad based on a user action (ex: clicks "watch video").

 

 

Update Regarding Our Reporting Service

AerServ has recently implemented a throttling mechanism to the reporting service that powers the platform dashboard page, platform reporting console, and reporting APIs. To help with the overall stability of our platform AerServ implemented a threshold for each publisher account on how much data can be extracted in a 10 second duration. If there are too many simultaneous reporting queries coming from the platform or the API that exceeds our threshold during that 10 second interval, the UI will alert the publisher to try again shortly. Within the API, you will receive an error message that would look like the following:

{"error": "Request has been throttled. Publisher 214 has requested to use 30 of maximum 20 RSUs in the time range of 10s"} A status code of "429" will be returned as a response from the reporting API if the publisher has reached their reporting threshold.

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk