Banner statistics

Documentation for all functionality to retrieve banner statistics using the Revive Adserver REST API, with breakdowns by dayby publisher, or by zone. There are also a number of helpful notes about date ranges.

getBannerDailyStatistics

Description: Returns banner’s statistics grouped by day, for a specified date range

Implementation: URL/bnn/[bannerId]/statistics/daily/[start_date]/[end_date]

Method: GET

Json example

Method: 
    GET http://api.example.com/bnn/12/statistics/daily/2018-06-13/2018-06-14

Response example

{
    "id": 12,
    "start_date": "2018-06-13",
    "end_date": "2018-06-14",
    "days": {
        "data": [
            {
                "impressions": 42,
                "clicks": 0,
                "requests": 59,
                "revenue": 0.0319,
                "day": "2018-06-13"
            },
            {
                "impressions": 55,
                "clicks": 0,
                "requests": 60,
                "revenue": 0.0415,
                "day": "2018-06-14"
            }
        ]
    }
}

getBannerPublisherStatistics

Description: Returns banner’s statistics grouped by publishers, for a specified date range

Implementation: URL/bnn/[bannerId]/statistics/publisher/[start_date]/[end_date]

Method: GET

Json example

Method: 
    GET http://api.example.com/bnn/12/statistics/publisher/2018-06-08/2018-06-14

Response example

{
    "id": 12,
    "start_date": "2018-06-08",
    "end_date": "2018-06-14",
    "publishers": {
        "data": [
            {
                "impressions": "261",
                "clicks": "4",
                "requests": "323",
                "revenue": "0.1978",
                "publisherid": "4",
                "publishername": "Demo Statistics Website"
            }
        ]
    }
}

getBannerZoneStatistics

Description: Returns banner’s statistics grouped by zone and publisher, for a specified date range

Implementation: URL/bnn/[bannerId]/statistics/daily/[start_date]/[end_date]

Method: GET

Json example

Method: 
    GET http://api.example.com/bnn/1/statistics/daily/2018-06-08/2018-06-14

Response example

{
    "id": 12,
    "start_date": "2018-06-08",
    "end_date": "2018-06-14",
    "zones": {
        "data": [
            {
                "impressions": "261",
                "clicks": "4",
                "requests": "323",
                "revenue": "0.1978",
                "conversions": "0",
                "publisherid": "4",
                "publishername": "Demo Statistics Website",
                "zoneid": "11",
                "zonename": "Demo Statistics Zone"
            }
        ]
    }
}

Notes

  • The end date in the request is optional. If omitted, the response will consist of just one day (the start date)
  • If you omit both the start date and the end date, or use a invalid date notation for the start date, the end date, or perhaps even both, there will be a response indicating the problem, as follows, for example:
    {
        "error": {
            "type": "DateException",
            "message": "Start date is not valid"
        }
    }
  • Requesting statistics for a date range where the end date is earlier than the start date, results in the following response, for example:
    {
        "error": {
            "type": "Exception",
            "message": "The start date is after the end date"
        }
    }
  • Requesting statistics for a date range that does not have any data, results in the following response, for example:
    {
        "id": 1,
        "start_date": "2017-05-21",
        "end_date": "2017-05-27",
        "days": {
            "data": []
        }
    }
  • Requesting statistics for a banner that doesn’t exist results in the following response:
    {
        "error": {
            "type": "Exception",
            "message": "Unknown bannerId Error"
        }
    }

Current version

The most recently released version of the Revive Adserver REST API is v4.3.0 (publication date May 28, 2018).

See Release Notes

Compatibility

Revive Adserver REST API is compatible with all versions of Revive Adserver v4.0 and higher. It may also be compatible with Revive Adserver v3.x (and also with OpenX Source v2.8 and higher), but this can not be guaranteed.

Revive Adserver REST API is compatible with all supported versions of PHP, including PHP7.

Also see Technical Requirements, Product Content, and Installation Instructions.

Our Recent Tweets