Мы рады сообщить о новом инструменте, доступном для партнеров Propush.me - API. Он позволяет отслеживать статистику и удаленно управлять данными посредством команд.
Документацию и список доступных запросов можно найти по данной ссылке: https://ssp-api.propellerads.com/v5/docs/propush.html.
Для получения доступа к Propush.me API, необходимо связаться с нашей службой поддержки и предоставить информацию о том, как вы планируете работать с этим инструментом.
После получения доступа к API вы можете зайти в настройки профиля в личном аккаунте Propush.me и создать токен, который необходим для авторизации в Propush SSP API (доступно до 10 токенов).
Примеры запросов методом GET:
1. https://api.propush.me/v5/pub/statistics - глобально статистика по всему аккаунту за всё время
2. Добавляем ?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD, https://api.propush.me/v5/pub/statistics?date_from=2020-07-01&date_to=2020-07-08 - по всему аккаунту за выбранный период
3. С группировкой по зонам - group_by[]=zone_id , https://api.propush.me/v5/pub/statistics?group_by[]=zone_id&date_from=2020-07-01&date_to=2020-07-08
4. При необходимости группировать по нескольким параметром (до трёх одновременно) просто добавляем параметр в ендпойнт, например + группировка по гео group_by[]=geo - https://api.propush.me/v5/pub/statistics?group_by[]=zone_id&group_by[]=geo&date_from=2020-07-01&date_to=2020-07-08
5. Группировка по реквест_варам - group_by[]=request_var, https://api.propush.me/v5/pub/statistics?group_by[]=zone_id&group_by[]=geo&group_by[]=request_var&date_from=2020-07-01&date_to=2020-07-08
Пожалуйста, обратите внимание, что параметр {request_var} должен быть не более 40 символов в длину со следующим списком допустимых символов:
• a-z
• A-Z
• 0-9
• +!:/ ,?()$=.%[]_-
6. Можно (и нужно) при большом количестве зон запрашивать по каждой зоне или нескольким зонам, а не по всем сразу, это параметр zone_ids[]=ХХХ (если зон несколько, то добавить zone_ids[]=ХХХ несколько раз) - https://api.propush.me/v5/pub/statistics?group_by[]=zone_id&group_by[]=geo&group_by[]=request_var&date_from=2020-07-01&date_to=2020-07-08&zone_ids[]=123&zone_ids[]=111
7. https://api.propush.me/v5/pub/sites - возвращает список добавленных сайтов
8. https://api.propush.me/v5/pub/zones - возвращает список зон
Если вам нужна помощь с настройкой API, пожалуйста, свяжитесь с нашей службой поддержки через чаты, доступные 24/7