Политика использования API

  • Рекламодатели
  • Разработчики

Введение

Данные AppsFlyer можно передать на серверы операционно-учетного подразделения с помощью различных интерфейсов API. Чаще всего для передачи данных используются API извлечения (Pull) и отправки (Push). Чтобы качественно обслуживать пользователей API системы AppsFlyer и не допустить злоупотребления сервисом, AppsFlyer использует политику регулирования количества запросов API.

В статье описана эта политика для 3 групп данных:

  1. Агрегированные отчеты с использованием Pull API.
  2. Отчеты о необработанных данных с использованием Pull API.
  3. Push API (необработанные данные в режиме реального времени).

1. Агрегированные отчеты с использованием Pull API

Пользователи с учетной записью любого уровня могут загрузить сводные отчеты об эффективности AppsFlyer вручную на странице Export data ("Экспорт данных"). Аналогично, сводные отчеты об эффективности, получаемые с помощью Pull API, также доступны учетным записям любого уровня.

Получение сводных отчетов об эффективности с помощью Pull API регулируется такими правилами:

  • Вызовы API можно совершать не чаще 1 раза в минуту.
  • Количество вызовов API, в которых запрашиваются данные за период более 2 дней, ограничено 24 вызовами в день на приложение и 120 вызовами в день на учетную запись.
  • Запросы сводных данных не ограничены по времени, то есть можно запрашивать данные от первой интеграции SDK до текущего момента.

2. Отчеты о необработанных данных с использованием Pull API

Необработанные данные, получаемые на странице Export data ("Экспорт данных") или с помощью Pull API, — это премиум-функция AppsFlyer, доступная только для пакетов высших уровней.

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

 Совет

Прежде чем пытаться извлечь необработанные данные, убедитесь, что они доступны для пакета вашего уровня:
1. Перейдите на страницу Export data ("Экспорт данных") и попробуйте загрузить отчеты о необработанных данных установок (Installations) или внутренних событий приложения (In-App Events) за последние 7 дней.
2. Если загрузка будет успешной, у вас будет возможность извлечь необработанные данные с помощью Pull API.
3. Если нет, обратитесь в службу поддержки AppsFlyer по поводу перехода на уровень пакета, поддерживающий доступ к необработанным данным.

Максимальное количество вызовов API на извлечение необработанных данных начинается с 10 вызовов API в день на приложение и возрастает при переходе на пакеты более высоких уровней.

Отчеты об установке и удалении

  • Данные можно запрашивать за период до 60 дней в рамках последних 90 дней.
  • Ограничение составляет 120 вызовов в день на учетную запись.

Отчет о внутренних событиях

  • Данные можно запрашивать за период до 31 дня в рамках последних 90 дней.
  • Ограничение составляет 60 вызовов в день на учетную запись и 12 вызовов на приложение.
  • Подробные сведения см. здесь.

 Совет

Учетные записи пакета "Корпоративный" могут запрашивать необработанные данные об установках и внутренних событиях приложения за последние 180 дней.

3. Push API

Push API отправляет данные об установках и внутренних событиях приложения в режиме реального времени, причем информацию как об органических, так и о неорганических событиях. Push API — это премиум-функция AppsFlyer, доступная только для пакетов высших уровней.

Рекомендуем занести IP-адреса AppsFlyer в список разрешенных на серверах операционно-учетного подразделения, чтобы успешно принимать сообщения Push API от AppsFlyer.
Перейдите по этой ссылке, чтобы просмотреть обновленный список IP-адресов.

Предельный размер отчета

Размер любого отчета ограничен 200 тысячами строк.
При попытке загрузить отчеты, содержащие больше строк, появляется сообщение об ошибке, в котором сообщается о том, что размер отчета ограничен 200 тысячами строк.

В таком случае рекомендуем выполнить любое из следующих действий:

  • Разделите диапазон данных на несколько меньших интервалов времени и запрашивайте данные по этим интервалам по отдельности.
  • Используйте вызов API с параметрами даты, чтобы извлечь строки за определенный интервал времени (день и час). Подробные сведения см. здесь.
  • Обратитесь по адресу support@appsflyer.com, если у вас возникнут какие-либо вопросы по этой теме.
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 7 из 7

Комментарии

0 комментариев

Войдите в службу, чтобы оставить комментарий.