Статистика показов и состояние счета

Интерфейсы управления рекламой

Интерфейс используется для получения статистики показов сайтов и состояния счета.

Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:

Action: http://go.jetswap.com/api
Method: POST
PAY_ACTION: stat
Поля, передаваемые в форме:

Параметр
Обязательный
Описание

idst Да Может содержать:
ID сайтов, для которых требуется выполнить команду. Содержит ID сайтов, разделенные двоеточием, например 123:234:456.

Ключевое слово all, в этом случае выдается весь список сайтов рекламодателя, однако такой запрос не может быть повторен чаще чем раз в 5 минут, в противном случае будет выдано сообщение об ошибке limitexceeded=>true

geo Нет Выдать статистику распределения IP посетителей по направлениям геотаргетинга за последние сутки (сутки считаются по GMT+3 с учетом сдвига времени, задаваемого в настройках сайта). Возможные значения:
0 (по умолчанию) - выдать статистику показов и состояние счета

1 - выдать статистику распределения посетителей по направлениям геотаргетинга (вычисляется только при включении геотаргетинга), нулевые значения не выдаются

Ответ: передается в формате URL Encoded массив, содержащем результаты выполнения операции для каждого переданного в idst сайта (см. пример ответа).

При geo=0 выдаются следующие поля:

Параметр	Описание
notexists	Выдается значение 1 при отсутствии доступа к сайту с заданным ID или если сайт с таким ID не существует.
cr	Количество кредитов на счету сайта
vip	Количество VIP-показов на счету сайта
pkh	Количество показов за час.
pkd	Количество показов за день.
pk	Общее количество показов.
lp	Время последнего показа в формате UNIX Timestamp.

Пример: сервером может быть выдан например ответ !647730[cr]=1.00&647730[vip]=0&647730[pkh]=0&647730[pkd]=0&647730[pk]=0&647730[lp]=0.
После устранения ! перед ответом и обработки текста ответа функцией php parse_str выходной массив примет вид:

Array
(
    [647730] => Array
        (
            [cr] => 1.00
            [vip] => 0
            [pkh] => 0
            [pkd] => 0
            [pk] => 0
            [lp] => 0
        )
)

Массив статистики выдается отдельно для каждого ID сайта, переданного в параметре idst.

При geo=1 для каждого ID сайта, указанного в idst, выдается массив такого формата:

Array
(
    [SiteID1] => Array
        (
            [ObjectID1] => 10
            [ObjectID2] => 30
        )
)

Где SiteID1 - идентификатор первого сайта, переданного в параметре idst, ObjectID1 и ObjectID2 - идентификаторы объектов геотаргетинга (стран, регионов, городов), с которых были зафиксированы показы, 10 и 30 - количество показов.

Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"