Прежде чем начать
API для статистики
Affise API предоставляет вам различные методы для получения статистических данных по различным типам или срезам. Это абсолютно те же данные, которые вы видите в вашей панели администратора.
⚠️ Вы можете использовать некоторые методы только с ключом API пользователя с типом "генеральный менеджер". Некоторые методы доступны только с API-ключом аффилиата.
Список кликов
Используйте этот метод для получения списка офферов в соответствии с их свойствами, которые вы можете указать в своем API-запросе.
⚠️ Вы можете получить данные только за последние семь дней.
Метод: GET /3.0/stats/clicks
Запрос для получения кликов по определенному офферу:
https://api-rocketcompany.affise.com/3.0/stats/clicks?api-key=4sdf87fsdfd8723lkjhrn324&date_from=2022-12-01&date_to=2022-12-05&offer[]=1441584
Конверсии
На Affise вы можете управлять конверсиями через API точно так же, как и в панели администратора. Смотрите статистику, редактируйте конверсии или импортируйте их.
Список конверсий
Используйте этот метод, чтобы получить список конверсий за определенный период и с определенными свойствами, такими как статус, цель, страна, доход и т. д.
Метод: GET /3.0/stats/conversions
Запрос для получения конверсий за ноябрь 2022 года, со статусом Одобрено и значением цели "1":
https://api-rocketcompany.affise.com/3.0/stats/conversions?api-key=4sdf87fsdfd8723lkjhrn324&date_from=2022-11-01&date_to=2022-11-30&status[]=1&goal[]=1
Редактирование конверсии
Используйте этот метод, чтобы отредактировать конверсию: ее статус, валюту, выплату или доход. В одном запросе можно обновить несколько конверсий.
⚠️ Идентификатор конверсии, используемый в запросе, является внутренним идентификатором конверсии. Вы можете найти его, щелкнув по определенной конверсии в Статистике или сделав запрос на список конверсий.
Метод: POST /3.0/admin/conversion/edit.
Запрос cURL для изменения статуса конверсий с Declined на Approved и валюты с USD на EUR.
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/conversion/edit \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'ids[0]=634eb220f09cdc2d1b5cf49d' \ -...-data 'ids[1]=634eb21af09cdc2d1b5cf49a'\ --data 'ids[2]=634eb215f09cdc2d1b5cf497'\ --data status=confirmed \ --data currency=eur
Импорт нескольких конверсий
Используйте этот метод для импорта нескольких конверсий в вашу панель администратора. Вы можете импортировать конверсии как для существующих, так и для несуществующих кликов.
Метод: POST /3.0/admin/conversions/import.
Запрос cURL для импорта двух конверсий для несуществующих кликов, разных офферов:
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/conversions/import \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'list[0][offer]=1441586' \ -...-data 'list[0][pid]=2' \ --data 'list[0][action_id]=6666666' \ --data 'list[0][goal]=install' \ -...-data 'list[0][status]=confirmed' \ --data 'list[1][offer]=7777777' \ --data 'list[1][pid]=2' \ --data 'list[1][action_id]=87654321' \ --data 'list[1][goal]=install' \ --data 'list[1][status]=confirmed'
Запрос cURL для импорта двух конверсий для двух существующих кликов, одинаковых офферов:
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/conversions/import \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'list[0][offer]=1441586' \ --data 'list[0][pid]=2' \ -...-data 'list[0][action_id]=11111' \ --data 'list[0][click_id]=6388a7c9fe1fe60001a98910' \ --data 'list[0][goal]=install' \ -...-data 'list[0][status]=confirmed' \ --data 'list[1][offer]=22222' \ --data 'list[1][pid]=2' \ --data 'list[1][action_id]=87654321' \ -...-data 'list[1][click_id]=6388bfb5b10ff500010c749b' \ --data 'list[1][goal]=install' \ --data 'list[1][status]=confirmed'
Пользовательская статистика
Используйте этот метод для работы с разными типами данных в одном API-запросе, как в пользовательском срезе статистики в вашей панели администратора.
Если вы хотите упорядочить данные по какому-то типу, вам нужно добавить соответствующий срез/ Например: упорядочить по аффилиатам, срез по аффилиатам.
Метод: GET /3.0/stats/custom
Запрос на получение данных о трафике по офферам и аффилиатам за десять дней. Данные упорядочены по офферу и аффилиату.
https://api-rocketcompany.affise.com/3.0/stats/custom?api-key=4sdf87fsdfd8723lkjhrn324&filter[date_from]=2022-11-25&filter[date_to]=2022-12-04&slice[]=day&slice[]=offer&slice[]=affiliate&order[]=offer&order[]=affiliate
По всем возникающим вопросам обращайтесь в службу поддержки клиентов Affise по электронной почте: [email protected].