Reports by months

Parameters

HTTP method

Access rights

URL

Parameters

Note

GET statistics https://api.admitad.com/statistics/months/
  • offset **
  • limit **
  • date_start ***
  • date_end ***
  • website ***
  • campaign ***
  • subid ***
  • total****
  • order_by *****

Statistical data by months.*

  • * Returns the result in the JSON format.

  • ** Sets skipping and the number of records returned. For example limit=5&offset=2.

  • *** Filter by date, ad spaces, affiliate programs and subId, respectively. For example campaign=3&campaign=4&website=8&date_start=01.01.2011, where the values are identifiers of filtered categories or filtered data. The values for dates should be in format ‘%d.%m.%Y’ - ‘01.05.2012’.

  • **** The parameter that allows to obtain aggregated data for the entire request. Possible values: 1/0 - aggregated data/not aggregated result

  • ***** Sorting order. Possible values:
    • action
    • clicks
    • cr
    • ctr
    • date
    • ecpc
    • ecpm
    • leads
    • payment_sum
    • payment_sum_approved
    • payment_sum_declined
    • payment_sum_open
    • sales
    • views

    Sign ‘-‘ before the value means inverse sort order. For example, order_by=-clicks&order_by=cr.

Example of use

Example of a request with utility ``curl``:

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/statistics/months/?date_start=01.01.2011&limit=2&order_by=date&offset=1

Example of the response from the API server in the JSON format:

{
    "results": [
        {
            "leads_sum": 0,
            "ctr": 0.001,
            "views": 5153,
            "payment_sum_declined": 0.0,
            "clicks": 5,
            "payment_sum_approved": -1254.81,
            "currency": "RUB",
            "ecpm": 1731.626237,
            "sales_sum": 6,
            "date": "2011-02",
            "cr": 1.2,
            "ecpc": 1784.614,
            "payment_sum_open": 10177.88
        },
        {
            "leads_sum": 1,
            "ctr": 9.0,
            "views": 1,
            "payment_sum_declined": 0.0,
            "clicks": 9,
            "payment_sum_approved": 100.0,
            "currency": "RUB",
            "ecpm": 1887020.0,
            "sales_sum": 2,
            "date": "2011-03",
            "cr": 0.5556,
            "ecpc": 209.668889,
            "payment_sum_open": 1787.02
        }
    ],
    "_meta": {
        "count": 15,
        "limit": 2,
        "offset": 1
    }
}

Example of a request with utility ``curl``:

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/statistics/months/?date_start=01.01.2011&limit=2&order_by=date&offset=1&total=1

Example of the response from the API server in the JSON format:

[
    {
        "leads_sum": 21594304,
        "payment_sum": 3382089.02,
        "views": 7337610,
        "payment_sum_declined": 1705783.09,
        "actions_sum_total": 22023257,
        "payment_sum_approved": 1646173.57,
        "currency": "RUB",
        "sales_sum": 21694727,
        "payment_sum_open": 1735915.45,
        "clicks": 7064253
    }
]

Description of API server response fields

Name

Description

date

Report date

currency System currencies
leads_sum

Number of leads

sales_sum

Number of sales

payment_sum_declined

The amount related to the rejected actions

payment_sum_approved

The amount related to the confirmed actions

payment_sum_open

The amount related to the actions on hold

views

The number of impressions

clicks

The number of clicks

ctr CTR
ecpc eCPC
cr

Conversion rate

ecpm eCPM