API отчетности версии 1.0 для публикаторов

Общие сведения

Примечание. API отчетности версии 1.0 является устаревшим API. Используйте его для отчетов по операциям, имевшим место до 5 июля 2017 г. Для операций, выполнявшихся 5 июля 2017 г. и позже, используйте API отчетности 2.0, документация по которому представлена здесь.

API отчетности предоставляет публикаторам программный способ доступа к данным, находящимся на панели управления. Ключ API отчетности будет одним и тем же для всех ваших приложений. У каждого приложения будет уникальный идентификатор API отчетности, который можно найти на соответствующей странице приложения.

Хост Заголовки запросов API
https://ssl.vungle.com Content-Type: application/json Безопасность регулируется посредством передачи ключа API в качестве параметра запроса. Ваш ключ API автоматически создается на панели управления Vungle.  
Если его у вас еще нет, см. статью How can I request a Reporting API Key? (Запрос ключа API отчетности)

Ресурсы и примеры

Ресурс Параметры Описание
GET /api/applications key=[API Key]
geo=[Country_Code] or geo=all
Возвращает список принадлежащих вам приложений.

Пример ответа:

{
    "id": "51896d9c3436ae313c3939b8",
    "appId" : "com.amazingGames.ProjectComet",
    "name" : "Project Comet", 
    "installs" : 1372,
    "platform" : "iOS",
    "connection" : "all", 
    "status" : "a"
}

Обратите внимание, что значения id и appId будут такими же для вновь создаваемых приложений.

Ресурс Параметры Описание
GET /api/applications/[REPORTING API ID] key=[API Key]
date=[YYYY-MM-DD] or start=[YYYY-MM-DD] end=[YYYY-MM-DD]
geo=[Country_Code] or geo=all
Возвращает список статистик для указанного приложения на указанную дату (даты).

Пример ответа:

{
    "date" : "2012-08-16",
    "impressions" : 5165,
    "views" : 5156,
    "completes" : 1686,
    "revenue" : 16.86,
    "eCPM" : 3.26
}

Имейте в виду, что при отсутствии данных, доступных для вашего запроса, будет возвращен пустой ответ 200. Это означает, что запрос выполнен, но данных, доступных для возврата, нет.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии