> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/ru/publichnyi-api-exoclick/api-manual-global-stats.md).

# API глобальной статистики

Этот раздел описывает параметры запроса и данные результата API глобальной статистики.

{% hint style="info" %}
Маршруты API статистики были переименованы:

* `/statistics/advertiser/...` -> `/statistics/a/...`
* `/statistics/publisher/...` -> `/statistics/p/...`
  {% endhint %}

{% hint style="info" %}
API глобальной статистики показывает пропущенные RTB-запросы только для Date, Sites, Zones, Countries, Regions и Sub IDs.
{% endhint %}

| Параметр     | Описание                                                                      | Примечания  | Тип            |
| ------------ | ----------------------------------------------------------------------------- | ----------- | -------------- |
| количество   | Возвращать только общее количество результатов.                               | целое число | необязательный |
| подробный    | Получить больше подробностей, если возможно.                                  | целое число | необязательный |
| часовой пояс | Настройка часового пояса для фильтра 'hour' и 'group\_by'                     | строка      | необязательный |
| итоги        | Указывает, добавлять ли итоги в ответ или нет.                                | целое число | необязательный |
| фильтр       | Фильтры для ограничения возвращаемых значений запроса статистики              | объект      | необязательный |
| group\_by    | Список значений group\_by, применяемых к данным. Допускается максимум четыре. | массив      | обязательный   |
| order\_by    | Сортировка результатов по определённым полям. Допускается максимум два.       | массив      | необязательный |
| projection   | Отдельные подструктуры, которые пользователь хочет получить в ответе.         | массив      | необязательный |
| limit        | Количество записей, которые нужно вернуть в этом ответе.                      | целое число | необязательный |
| offset       | Позиция, с которой нужно получить записи.                                     | целое число | необязательный |

## Параметр count

|                       |                                                 |
| --------------------- | ----------------------------------------------- |
| Свойство              | количество                                      |
| Тип                   | необязательный                                  |
| Тип переменной        | целое число                                     |
| Значение по умолчанию | 0                                               |
| Доступные значения    | \[0, 1]                                         |
| Описание              | Возвращать только общее количество результатов. |

#### Пример:

```json
{
    "count": 1
}
```

## Параметр detailed

|                       |                                          |
| --------------------- | ---------------------------------------- |
| Свойство              | подробный                                |
| Тип                   | необязательный                           |
| Тип переменной        | целое число                              |
| Значение по умолчанию | 0                                        |
| Доступные значения    | \[0, 1]                                  |
| Описание              | Возвращать подробную информацию или нет. |

#### Пример:

```json
{
    "detailed": 1
}
```

## Параметр timezone

Настройка часового пояса для `hour` фильтра и `group_by`.

|                       |                                                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Свойство              | часовой пояс                                                                                                              |
| Тип                   | необязательный                                                                                                            |
| Тип переменной        | строка                                                                                                                    |
| Значение по умолчанию | America/New\_york                                                                                                         |
| Доступные значения    | Установить поле часового пояса из /collections/timezones                                                                  |
| Описание              | ПРИМЕЧАНИЕ: часовые пояса актуальны только при запросах на основе почасовых данных; для данных не по часам это не влияет. |

#### Пример:

```json
{
    "timezone": "Europe/Dublin"
}
```

## Параметр totals

|                       |                                                |
| --------------------- | ---------------------------------------------- |
| Свойство              | итоги                                          |
| Тип                   | необязательный                                 |
| Тип переменной        | целое число                                    |
| Значение по умолчанию | 0                                              |
| Доступные значения    | \[0,1]                                         |
| Описание              | Указывает, добавлять ли итоги в ответ или нет. |

#### Пример:

```json
{
    "totals": 1
}
```

## Параметр filter

|                                      |                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Свойство                             | фильтр                                                                                                                                                                                                                                                                                                                                                                                                         |
| Тип                                  | необязательный                                                                                                                                                                                                                                                                                                                                                                                                 |
| Тип переменной                       | объект                                                                                                                                                                                                                                                                                                                                                                                                         |
| Доступный вариант для рекламодателей | \[”adblock”, ”advertiser\_ad\_type\_id”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “size”, “sub”, “zone\_id”, “campaign\_group\_id”, “campaign\_id”, “exclude\_deleted”, “offer\_id”, “offer\_landing\_page\_id”, “variation\_id”] |
| Доступный вариант для издателей      | \[”adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date\_from”, “date\_to”, “device\_id”, “device\_type\_id”, “hour”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_hostname”, “site\_id”, “zone\_id”, “publisher\_ad\_type\_id”, “size”, “sub”]                                                                                                                      |
| Описание                             | Фильтровать по определённым параметрам.                                                                                                                                                                                                                                                                                                                                                                        |

### Фильтр: `country_iso`

|                       |                                                      |
| --------------------- | ---------------------------------------------------- |
| Свойство              | country\_iso                                         |
| Тип                   | необязательный                                       |
| Тип переменной        | строка                                               |
| Значение по умолчанию | -                                                    |
| Доступные значения    | См. свойство iso3 в эндпоинте /collections/countries |
| Описание              | Список кодов ISO 3                                   |

#### Пример:

```json
{
    "filter": {
        "country_iso": ["ESP", "IRL"]
    }
}
```

### Фильтр `date_from`, `date_to`

Этот `date_from` и `date_to` параметры управляют окном, за которое вы хотите получить информацию о статистике.

* date\_from: дата начала диапазона для статистики (по умолчанию — начало месяца),
* date\_to: дата окончания диапазона для статистики (по умолчанию — сегодня)

|                       |                                                      |
| --------------------- | ---------------------------------------------------- |
| Свойство              | date\_from, date\_to                                 |
| Тип                   | необязательный                                       |
| Тип переменной        | строка                                               |
| Значение по умолчанию | По умолчанию даты относятся к текущему месяцу.       |
| Доступные значения    | YYYY-mm-dd                                           |
| Описание              | Диапазон дат от/до для статистики. Формат YYYY-mm-dd |

#### Пример:

```json
{
    "filter": {
        "date_from": "2019-02-25",
        "date_to": "2019-02-28"
    }
}
```

Часовые пояса актуальны только при запросах на основе почасовых данных; для данных не по часам это не влияет.

### Фильтр: advertiser\_ad\_type\_id, campaign\_group\_id, campaign\_id, browser\_id, carrier\_id, category\_id, device\_id, device\_type\_id, language\_id, offer\_id, offer\_landing\_page\_id, operating\_system\_id, hour, region\_id, site\_id, sub, variation\_id, zone\_id, publisher\_ad\_type\_id

|                       |                                                                                                                                                                                                                                                                                                                          |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Свойство              | advertiser\_ad\_type\_id, campaign\_group\_id, campaign\_id, browser\_id, carrier\_id, category\_id, device\_id, device\_type\_id, language\_id, offer\_id, offer\_landing\_page\_id, operating\_system\_id, hour, region\_id, site\_id, sub, variation\_id, zone\_id, advertiser\_ad\_type\_id, publisher\_ad\_type\_id |
| Тип                   | необязательный                                                                                                                                                                                                                                                                                                           |
| Тип переменной        | массив                                                                                                                                                                                                                                                                                                                   |
| Тип элементов         | целое число                                                                                                                                                                                                                                                                                                              |
| Значение по умолчанию | -                                                                                                                                                                                                                                                                                                                        |
| Доступные значения    | Относительные свойства ИЛИ коллекции                                                                                                                                                                                                                                                                                     |
| Описание              | Список ID сущностей                                                                                                                                                                                                                                                                                                      |

#### Пример:

```json
{
    "filter": {
        "campaign_id": [123, 456],
        "browser_id": [789]
    }
}
```

### Фильтр: `exclude_deleted`

|                       |                                       |
| --------------------- | ------------------------------------- |
| Свойство              | exclude\_deleted                      |
| Тип                   | необязательный                        |
| Тип переменной        | целое число                           |
| Значение по умолчанию | 0                                     |
| Доступные значения    | \[0, 1]                               |
| Описание              | Исключать удалённые кампании или нет. |

#### Пример:

```json
{
    "filter": {
        "exclude_deleted": 1
    }
}
```

### Фильтр: `adblock`

|                       |                                |
| --------------------- | ------------------------------ |
| Свойство              | adblock                        |
| Тип                   | необязательный                 |
| Тип переменной        | строка                         |
| Значение по умолчанию | "all"                          |
| Доступные значения    | "adblock", "all", "standard"   |
| Описание              | Включать зоны adblock или нет. |

#### Пример:

```json
{
    "filter": {
        "adblock": "standard"
    }
}
```

### Фильтр: `site_hostname`

|                       |                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------ |
| Свойство              | site\_hostname                                                                       |
| Тип                   | необязательный                                                                       |
| Тип переменной        | строка                                                                               |
| Значение по умолчанию | -                                                                                    |
| Доступные значения    | Допустимые символы для имён хостов: буквы от a до z, цифры от 0 до 9, дефис и точка. |
| Описание              | Фильтр по имени хоста сайта.                                                         |

#### Пример:

```json
{
    "filter": {
        "site_hostname": ["www.example.com", "www.example-site.org"]
    }
}
```

### Фильтр: `size`

|                       |                                                                          |
| --------------------- | ------------------------------------------------------------------------ |
| Свойство              | size                                                                     |
| Тип                   | необязательный                                                           |
| Тип переменной        | строка                                                                   |
| Значение по умолчанию | -                                                                        |
| Доступные значения    | Допустимые символы для size — цифры от 0 до 9 и символ x. Пример 300x100 |
| Описание              | Фильтр по размеру                                                        |

#### Пример:

```json
{
    "filter": {
        "size": ["300x100"]
    }
}
```

## Параметр group\_by

|                                       |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Свойство                              | group\_by                                                                                                                                                                                                                                                                                                                                                                                                  |
| Тип                                   | обязательный                                                                                                                                                                                                                                                                                                                                                                                               |
| Тип переменной                        | массив                                                                                                                                                                                                                                                                                                                                                                                                     |
| Тип элементов                         | строка                                                                                                                                                                                                                                                                                                                                                                                                     |
| Значение по умолчанию                 | -                                                                                                                                                                                                                                                                                                                                                                                                          |
| Доступные значения для рекламодателей | \[”adblock”, “advertiser\_ad\_type\_id”, browser\_id”, “idcampaign\_group“, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “hour”, “device\_id”, “device\_type\_id”, “language\_id”, “operating\_system\_id”, “region\_id”, “site\_id”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”, “offer\_id”, “offer\_landing\_page\_id”, “site\_hostname”, “size”, “variation\_id”] |
| Доступные значения для издателей      | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “date”, “device\_id”, “device\_type\_id”, “hour”, “language\_id”, “operating\_system\_id”, “publisher\_ad\_type\_id” “region\_id”, “site\_id”, “size”, “sub”, “zone\_id”, “week”, “month”, “quarter”, “year”]                                                                                                                   |
| Описание                              | Список подзапросов для включения дополнительных данных в ответ.                                                                                                                                                                                                                                                                                                                                            |

#### Пример:

```json
{
  "group_by": [
    "browser",
    "date"
  ]
}
```

## Параметр order\_by

| Свойство                                                                 | order\_by                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Тип                                                                      | необязательный                                                                                                                                                                                                                                                                                                                                                   |
| Тип переменной                                                           | массив                                                                                                                                                                                                                                                                                                                                                           |
| Тип элементов                                                            | строка                                                                                                                                                                                                                                                                                                                                                           |
| Значение по умолчанию                                                    | -                                                                                                                                                                                                                                                                                                                                                                |
| Доступные значения полей метрик                                          | \[“cpc”, “cpc”, “cpm”, “cpv”, “ctr”, “clicks”, “impressions”, “video\_impressions”, “video\_views”, “vtr”, “rtb\_win\_ratio”, “rtb\_avg\_total\_time”, “rtb\_skipped”, “rtb\_bid\_response\_ratio”, “rtb\_avg\_cpm”, “rtb\_timeouts\_ratio”, “rt\_errors\_ratio”, “rtb\_no\_bid\_ratio”, “rtb\_skipped\_ratio”]                                                  |
| Доступные значения полей, зависящие от \`group\_by\`, для рекламодателей | \[”adblock”, “browser\_id”, “campaign\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id”, “hour”, “ecpa1”, “g1”,“language\_id”, “month”, “offer\_id”, “offer\_landing\_page\_id”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_hostname”, “site\_id”, “sub”, “variation\_id”, “week”, “year” ,“zone\_id”] |
| Доступные значения полей, зависящие от \`group\_by\`, для издателей      | \[“adblock”, “browser\_id”, “carrier\_id”, “category\_id”, “country\_iso”, “device\_id”, “date”, “device\_type\_id” , “hour”, “language\_id”, “month”, “operating\_system\_id”, “quarter”, “region\_id”, “site\_id”, “sub”, “week”, “year”, “zone\_id”]                                                                                                          |
| Доступные значения сортировки                                            | \[“asc”, “desc”]                                                                                                                                                                                                                                                                                                                                                 |
| Описание                                                                 | Список доступных вариантов сортировки                                                                                                                                                                                                                                                                                                                            |

{% hint style="info" %}
**Подсказки**:

* Поля метрик всегда доступны для использования в качестве поля сортировки.
* Чтобы сортировать по конкретному значению (например, по “browser\_id”), его нужно включить в параметр “group\_by”.
  {% endhint %}

Значения “g1”, “ecpa1” доступны только при наличии у пользователя отслеживания конверсий (Goals). Все цели связаны с серийным номером (g1, g2, …gx). Значения eCPA соответственно ecpa1, ecpa2, …ecpax.

#### Пример:

```json
{
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
}
```

Чтобы упорядочить результаты кампании хронологически, “date” нужно включить и в “group\_by”, и в “order\_by”:

```json
{
  "group_by": [
    "campaign_id",
    "date"
  ],
  "order_by": [
    {
      "field": "date",
      "order": "asc"
    }
  ]
}
```

## Параметр projection

Параметр projection определяет, что будет возвращено в результирующем payload. Если не указано, будут возвращены все подструктуры.

| Свойство                                    | projection                           |
| ------------------------------------------- | ------------------------------------ |
| Тип                                         | необязательный                       |
| Тип переменной                              | объект                               |
| Тип элементов                               | массив                               |
| Значение по умолчанию                       | все варианты, см. ниже               |
| Доступные значения полей для рекламодателей | \[“base”, “rtb”, “video”, “goals\*”] |
| Доступные значения полей для издателей      | \[“base”, “rtb”, “video”, “wpn”]     |

\*Некоторые поля "goal", такие как "profit" и "roi", рассчитываются на основе стоимости кампании, поэтому вам также нужно использовать поле "base", если вы хотите получать корректные метрики "goals".

#### Примеры:

Чтобы получить все возможные метрики как рекламодатель, используйте:

```json
{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "goals": ["*"],
      "rtb": ["*"]
    }
}
```

Чтобы получить все возможные метрики как издатель, используйте:

```json
{
    "projection": {
      "base": ["*"],
      "video": ["*"],
      "wpn": ["*"],
      "rtb": ["*"]
    }
}
```

Вы также можете указать метрики внутри каждого поля projection:

```json
{
    "projection": {
      "base": ["impressions","clicks","cost","revenue","cpc","cpm","ctr"],
      "video": ["impressions","views","cpv","vtr"],
      "rtb": ["total_time","queries","value","success","no_bid","skipped","errors","timeouts","wins","win_ratio"],
      //только для издателей
      "wpn": ["subscriptions","unsubscriptions","sent"]
    }
}
```

Единственное поле, которое не позволяет указывать конкретные метрики projection, — это "goals"

## Параметр limit

Количество записей, которые нужно вернуть в этом ответе.

|                       |                |
| --------------------- | -------------- |
| Свойство              | limit          |
| Тип                   | необязательный |
| Тип переменной        | целое число    |
| Значение по умолчанию | 50             |

#### Пример:

```json
{
    "limit": 25
}
```

## Параметр offset

Позиция, с которой нужно получить записи.

|                       |                |
| --------------------- | -------------- |
| Свойство              | offset         |
| Тип                   | необязательный |
| Тип переменной        | целое число    |
| Значение по умолчанию | 0              |

#### Пример

```json
{
    "offset": 150
}
```

## Пример 1

Статистика кампании рекламодателя с фильтрацией.

#### Запрос:

```json
{
    "detailed": true,
    "totals": 1,
    "filter": {
      "date_from": "2019-03-10",
      "date_to": "2019-03-11",
      "country_iso": ["USA"]
    },
    "group_by": ["campaign_id"],
    "order_by": [
      {
        "field": "campaign_id",
        "order": "desc"
      }
    ]
    "projection": {
        "base": ["*"],
        "video": ["*"],
        "rtb": ["*"]
      },
    "limit": 2,
    "offset": 0
  }
```

#### Ответ:

```json
{
  "request_metadata": {
    "count": 4,
    "limit": 2,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 1.3302,
      "cpc": 0,
      "cpm": 0.45586017820425,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "1234567",
          "name": "Ron Mainstream Campaign "
        }
      },
      "impressions": 2918,
      "rtb": {
        "avg_cpm": 0.15582967823432,
        "avg_total_time": 89.522714492492,
        "errors": 112,
        "errors_ratio": 0.011368411650186,
        "no_bid": 870594,
        "no_bid_ratio": 88.368490823053,
        "queries": 985186,
        "response_ratio": 11.57101298638,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 984590,
        "timeouts": 484,
        "timeouts_ratio": 0.049127778916875,
        "total_time": 88196525,
        "value": 1776.396,
        "win_ratio": 0.29842080581738,
        "wins": 2940
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 18.1621655,
      "cpc": 0,
      "cpm": 1.8273634671496,
      "ctr": 0,
      "group_by": {
        "campaign_id": {
          "active": "1",
          "campaign_ad_type_name": "Popunders",
          "id": "7654321",
          "name": "Ron Mainstream Campaign Test"
        }
      },
      "impressions": 9939,
      "rtb": {
        "avg_cpm": 1.4753505300475,
        "avg_total_time": 88.777190144965,
        "errors": 46,
        "errors_ratio": 0.0014192869995779,
        "no_bid": 3209674,
        "no_bid_ratio": 99.031490893114,
        "queries": 3241064,
        "response_ratio": 0.8964340105595,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 3238728,
        "timeouts": 2290,
        "timeouts_ratio": 0.070655809326814,
        "total_time": 287732555,
        "value": 4286.48343,
        "win_ratio": 0.30665855410445,
        "wins": 9939
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ],
  "result_total": {
    "clicks": 0,
    "cost": 74.0473595,
    "cpc": 0,
    "cpm": 2.0864288391096,
    "ctr": 0,
    "impressions": 35490,
    "rtb": {
      "avg_cpm": 0.23441613972984,
      "avg_total_time": 87.995789332859,
      "errors": 539,
      "errors_ratio": 0.0049868154705264,
      "no_bid": 9771471,
      "no_bid_ratio": 90.405422546568,
      "queries": 10808501,
      "response_ratio": 9.5135301370653,
      "skipped": 0,
      "skipped_ratio": 0,
      "success": 10799741,
      "timeouts": 8221,
      "timeouts_ratio": 0.07606050089647,
      "total_time": 951102577,
      "win_ratio": 0.32861171035651,
      "wins": 35518
    },
    "video": {
      "cpv": 0,
      "impressions": 0,
      "views": 0,
      "vtr": 0
    }
  }
}
```

## Пример 2

Статистика рекламодателя по датам за текущий месяц, отсортированная по числу показов.

#### Запрос:

```json
{
  "group_by": ["date"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ]
  "projection": {
      "base": ["*"],
      "video": ["*"],
      "rtb": ["*"]
    }
}
```

#### Ответ:

```json
{
  "request_metadata": {
    "count": 3,
    "limit": 50,
    "offset": 0
  },
  "result": [
    {
      "clicks": 0,
      "cost": 624.2439917,
      "cpc": 0,
      "cpm": 1.0978015474007,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-02"
        }
      },
      "impressions": 568631,
      "rtb": {
        "avg_cpm": 0.31273156270632,
        "avg_total_time": 114.34705591799,
        "errors": 4143,
        "errors_ratio": 0.0076578188576312,
        "no_bid": 48085697,
        "no_bid_ratio": 88.8804144989,
        "queries": 54101567,
        "response_ratio": 10.971772776933,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 54021598,
        "timeouts": 75826,
        "timeouts_ratio": 0.14015490530986,
        "total_time": 6186354907,
        "value": 185634.35958,
        "win_ratio": 1.1633248996281,
        "wins": 629377
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 622.1688691,
      "cpc": 0,
      "cpm": 1.1800128762878,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-01"
        }
      },
      "impressions": 527256,
      "rtb": {
        "avg_cpm": 0.27775587567531,
        "avg_total_time": 118.91585420372,
        "errors": 2954,
        "errors_ratio": 0.0078196779097434,
        "no_bid": 32641750,
        "no_bid_ratio": 86.407573260111,
        "queries": 37776492,
        "response_ratio": 13.412992397494,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 37708708,
        "timeouts": 64830,
        "timeouts_ratio": 0.17161466448499,
        "total_time": 4492223815,
        "value": 140737.73563,
        "win_ratio": 1.4077723257099,
        "wins": 531807
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    },
    {
      "clicks": 0,
      "cost": 441.843491,
      "cpc": 0,
      "cpm": 0.96186339096399,
      "ctr": 0,
      "group_by": {
        "date": {
          "date": "2019-03-03"
        }
      },
      "impressions": 459362,
      "rtb": {
        "avg_cpm": 0.26462497173837,
        "avg_total_time": 116.9210100884,
        "errors": 2183,
        "errors_ratio": 0.0059889808787451,
        "no_bid": 32174177,
        "no_bid_ratio": 88.268681100486,
        "queries": 36450275,
        "response_ratio": 11.500815837466,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 36366256,
        "timeouts": 81836,
        "timeouts_ratio": 0.22451408116948,
        "total_time": 4261802971,
        "value": 110932.87869,
        "win_ratio": 1.2852029237091,
        "wins": 468460
      },
      "video": {
        "cpv": 0,
        "impressions": 0,
        "views": 0,
        "vtr": 0
      }
    }
  ]
}
```

## Пример 3

Статистика издателя по date и region\_id, отсортированная по impressions.

#### Запрос:

```json
{
  "detailed": true,
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["date", "region_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  }
  "limit": 30,
  "offset": 0
}
```

#### Ответ:

```json
{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 3087,
      "cpc": 0.033842716164561,
      "cpm": 0.069188574849649,
      "ctr": 0.20444155402072,
      "group_by": {
        "date": {
          "date": "2019-03-11"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Соединённые Штаты Америки",
          "country_short_name": "Соединённые Штаты",
          "id": 5332921,
          "name": "California"
        }
      },
      "impressions": 1494954,
      "revenue": 104.4724648,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.038451404048583,
        "impressions": 15013,
        "views": 2717,
        "vtr": 18.097648704456
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 3071,
      "cpc": 0.03151133555845,
      "cpm": 0.066658890819906,
      "ctr": 0.21153940205505,
      "group_by": {
        "date": {
          "date": "2019-03-10"
        },
        "region_id": {
          "country_iso": "USA",
          "country_long_name": "Соединённые Штаты Америки",
          "country_short_name": "Соединённые Штаты",
          "id": 5332921,
          "name": "California"
        }
      },
      "impressions": 1436818,
      "revenue": 96.7713115,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036216808196108,
        "impressions": 14921,
        "views": 2672,
        "vtr": 17.907646940554
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}
```

## Пример 4

Статистика издателя по site\_id с проекцией.

#### Запрос:

```json
{
  "detailed": true,
  "projection": {
    "base": ["*"],
    "video": ["*"],
    "wpn": ["*"],
    "rtb": ["*"]
  },
  "filter": {
    "date_from": "2019-03-10",
    "date_to": "2019-03-11",
    "country_iso": ["USA"]
  },
  "group_by": ["site_id"],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "limit": 30,
  "offset": 0
}
```

#### Ответ

```json
{
  "request_metadata": {
    "count": 2,
    "limit": 30,
    "offset": 0
  },
  "result": [
    {
      "clicks": 14320,
      "cpc": 0.028298959692737,
      "cpm": 0.057945765404939,
      "ctr": 0.20476288186597,
      "group_by": {
        "site_id": {
          "id": "11223344",
          "name": "nice-example.com"
        }
      },
      "impressions": 6916414,
      "revenue": 405.2411028,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.031519102652252,
        "impressions": 77041,
        "views": 12857,
        "vtr": 16.688516504199
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    },
    {
      "clicks": 14148,
      "cpc": 0.028769196296296,
      "cpm": 0.063791981699323,
      "ctr": 0.22173710048179,
      "impressions": 6314909,
      "revenue": 407.0265892,
      "rtb": {
        "avg_cpm": 0,
        "avg_total_time": 0,
        "bid_response_ratio": 0,
        "errors": 0,
        "errors_ratio": 0,
        "no_bid": 0,
        "no_bid_ratio": 0,
        "queries": 0,
        "skipped": 0,
        "skipped_ratio": 0,
        "success": 0,
        "timeouts": 0,
        "timeouts_ratio": 0,
        "total_time": 0,
        "value": 0,
        "win_ratio": 0,
        "wins": 0
      },
      "video": {
        "cpv": 0.036406671663685,
        "impressions": 65620,
        "views": 11180,
        "vtr": 17.037488570558
      },
      "wpn": {
        "subscriptions": 0,
        "unsubscriptions": 0
      }
    }
  ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/ru/publichnyi-api-exoclick/api-manual-global-stats.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.