Skip to end of metadata
Go to start of metadata

Introduction

The Publisher Analytics Dashboard allows publishers and advertisers to view performance and payment data on a daily basis.

Login

Dashboard UI

For access to the Publisher Analytics Dashboard, you will need an account with Verve.

Note: Login credentials will be supplied during integration. Publishing groups with multiple sites will be assigned a group-level login, so specified users can easily access all sites with one login. Site-level logins will also be supplied for distribution to site-level contacts. If you need a login, contact your account manager or send an inquiry to publisher-support@verve.com.

API

For access to the API, you will need to retrieve a token.

Tokens are for clients who want to consume our APIs. Because HTTP browsers/libraries/curl all support the schema://user:pass@host format, one can simply use https://TOKEN:x@api.vervemobile.com/ URLs to access reports.

An authentication token will look like this:

To encode to Base64

API Usage documentation can be found directly on the API


Publisher Revenue

This section will walk you through how to leverage the dashboards and query building tools within the Revenue reports section.

Dashboards

A quick, visual way to see how your Properties perform on a daily basis.

1) Filter

There are two filters available on the dashboard: Publisher and Property.

2) Date Range

There are two options for selecting a date range: Dynamic range (Last 7, 14, 30 days, This Month or Last Month) or Custom range. 

3) Plot

Plot allows you to view trend data and gives you the option to display a variety of metrics based on what you select from the Plots drop-down menus.

The available metrics are: 

    • Total Estimated Publisher Revenue
    • Total Estimated Net eCPM
    • Total Clicks
    • Total Impressions
    • Total Requests
    • Total Fill Rate
    • Total CTR

To see daily statistics, hover over the graph.  A vertical line will appear circling the two points on the graph. Next to it a box will appear with detailed information about the two plots you are currently viewing.

4) Summary 

Displays the daily average for 5 different metrics: Total Requests, Total Impressions, Total Fill Rate, Total Estimated Publisher Revenue and Total CTR. These averages will change based on the selected date range.

5) Totals

Displays the totals for the 4 metrics: Total Impressions, Total Clicks, Total CTR, Total Estimated Publisher Revenue. These totals will change based on the selected date range.

6) Table

The table shows a breakdown of totals by Day, Month or Property.  

Day, Month or Property

This drop down defaults to By Day, which will show you data aggregated at the daily level. You can also select to view data By Month which will roll up the data by month, or By Property which will remove the dates and only break the table down by Property. 

Show Columns  

By default, all columns are shown. Remove certain columns by clicking on the X of the field to be removed.

7) Export

You can export the data from this table in three different formats: CSV, JSON, and Excel.

Queries

When you need information that's not available from a dashboard, you can build a custom query. Queries are the best option when you want to build multi-dimensional reports, recurring reports, or reports with over 1,000 rows of data. To create a new query, click "All Queries" from the left menu, then click "New Query" on the top right.

1) Query Name

Required. The default displayed is the date and time of query creation (YYYY-MM-DD HH:MM)

2) Query Description

Optional. Describes the contents of the query. When looking at a list of Queries, the description can be helpful to find the one you need. 

3) Date Range

Allows the users to chose a Dynamic range or a Fixed Date range. 

Dynamic - Includes: Yesterday, Last 7 Days, Last 14 Days, Last 30 Days, Last 6 Months, Last Week, Last Month, Week to Date, Month to Date, Quarter to Date, Year to Date

Fixed A custom date range

Note: Date ranges larger than a month will take more time to run. If possible, use the filter to select a shorter date range.

4) Filters 

Allows the user to filter by any of the dimensions

5) Dimensions

At least one dimension must be selected in your query. If you select more than one, you can re-arrange the order in which they appear in your report on the right hand side where the dimensions are listed.

6) Metrics

At least one metric must be selected in your query. If you select more than one, you can re-arrange the order in which they appear in your report on the right-hand side where the metrics are listed.

Total Revenue

    • Total Clicks
    • Total Requests
    • Total Impressions
    • Total Fill Rate = Total Impressions/Total Requests*100
    • Total Estimated Publisher Revenue
    • Total Estimated Net eCPM = (Total Estimated Publisher Revenue*1000)/Total Billable Units
    • Total CTR = Total Clicks/ Total Billable Units

Revenue Breakout 

    • Partner Clicks
    • Partner CTR
    • Partner Estimated Net eCPM
    • Partner Estimated Publisher Revenue
    • Partner Fill Rate
    • Partner Impressions
    • Verve Clicks
    • Verve CTR
    • Verve Estimated Net eCPM
    • Verve Estimated Publisher Revenue
    • Verve Fill Rate
    • Verve Impressions

Publishers who Advertise with Verve have access to the Revenue Breakout fields

7) Schedule

A query can be scheduled to run daily, weekly, or monthly, allowing users to get reports automatically via the Publisher Analytics Dashboard or email. 

8) Email

A query can also be emailed or shared out to other people. 

Send email when report runs - This lets a user step away from their computer and receive an email notification when the report has completed. When this is selected, another option will appear to attach the report to the email. 

Also notify shared to users - Selecting this option will notify the shared user, if you have shared your query with other emails. 

Share report to emails -  Allows the user to enter one or more email addresses to send the report to. These emails can be internal or external.

Download report when finished automatically - Selecting this option will download the report automatically to your computer. 

9) Actions

Multiple actions can be taken when running a query. 

Save - Allows you to save the query for later without running it. The Saved Query will be found on the left menu under "Owned by Me"

Run - Allows you to run the query without saving it. This would be used for one off reports that you will not need to run again.

Save and Run - Allows you to save the query for later used and run the query right then.

Save as and Run - When editing an existing query, you will have the option to save the new query as a different name to differentiate the two. Otherwise, be sure to "Save and Run" your query so that your changes are updated.

 

Once you have Saved your query you will see it in the All Queries section. 

Hovering over a query name will display the query description, date range, dimensions, metrics, filters, and sort options selected on your query. 

Tools:

[Run Now] will allow a user to run the query again if no changes need to be made

[X] will delete the query 

[->] shares the query

[Copy] duplicates the query

All Reports

When a query runs, it generates a report to show the results. You can find the reports by clicking on "Reports" then "All Reports" from the left menu. 

The All Reports section allows users to open an unsaved report for up to 1 week, and a saved report forever. This report is cached and will generate very quickly. If a report is under 1000 rows, it will display in the browser. Otherwise the browser will prompt you to download the report. 

Status

Success - The report successfully ran, and you can go directly to the cached report by clicking on the report name or click the download button. 

Processing - The report is taking a longer time to process. You may want to save your report and come back to the UI in a few minutes. 

Unsaved - Save the report if you will want to come back to the pre-generated report after 7 days. 

Error - There was an issue processing the report. Try refreshing your browser, adding in a filter, or contact Publisher Support for help. 

Tools

[X] - To delete the report

[Save] - Allows the user to come back to the pre-generated report after 7 days

[Share] - If the report is saved, the share option is available. A user can either share the hyperlink or send the report to emails. 

[Download] - To download the file (.csv) to your computer

 


  • No labels