агрегированные данные Pull API

Для:
маркетологов маркетологов разработчиков
Последнее обновление:

Краткий обзор. Использование Pull API для получения агрегированных отчетов AppsFlyer в виде файлов CSV.

PullAPIAverage_us-en.png

 Вам нужны сырые данные Pull API?

Узнайте все о них здесь.

агрегированные данные Pull API

  • Pull API позволяет получать агрегированные отчеты по привлечению пользователей (UA) и ретаргетингу в виде файлов CSV.
  • Показатели актуальности данных такие же, как в аналогичном отчете на странице «Экспорт данных» и на обзорном дэшборде. Обратите внимание, что затраты могут обновляться с задержкой в несколько часов, в зависимости от партнера, предоставляющего данные о затратах.
  • Доступна фильтрация по медиа-источнику и диапазону дат.
  • Дополнительные возможности в Pull API:
    • Добавление типа взаимодействия для атрибуции
    • Выбор часового пояса 

Сводный отчет об эффективности доступен через Pull API

Категория  UA Ретаргетинг*
Партнеры (медиаисточник) ✓ ✓

Партнеры — по датам

 ✓ ✓

Ежедневно

 ✓ ✓

Геоданные

 ✓ ✓

Отчеты по геоданным — по датам

 ✓ ✓

* Для отчетов по ретаргетингу добавьте в URI атрибут &reattr=true. 

Использование Pull API для агрегированных данных 

Чтобы использовать Pull API для агрегированных данных:

  1. AppsFlyerAdmin_us-en.pngПолучите токен API. Получить токен должен админ.
  2. Дайте разработчику токен API, который будет использоваться в заголовке аутентификации.
  3. Предоставьте разработчикам параметры, которые они должны ввести при вызове API, как описано в следующем разделе. Параметры определяют, что содержится в отчете, как он организован, а также устанавливают временные рамки отчетности.
  4. Скажите разработчику, чтобы он следовал инструкциям по Pull API для агрегированных данных в хабе для разработчиков.

Параметры

Параметр Описание
app_id Идентификатор приложения
from
  • Диапазон дат задается параметрами fromи to . Под диапазоном понимается диапазон дат LTV (установки).
  • Формат: yyyy-mm-dd, 
  • Пример: 2010-01-01
to Дата окончания. Так же, как и параметр from
media_source

Используйте для ограничения (фильтрации) по определенному медиа-источнику.

  • Например:media_source=facebook
attribution_touch_type

Установите этот параметр, как показано в примере, чтобы получить ключевые показатели эффективности атрибуции (VTA). 

Пример: attribution_touch_type=impression

Некоторые ключевые показатели эффективности VTA, такие как клики, показы и API затрат, не имеют связанных значений и отображают значение N/A. 
currency

Валюта дохода и затрат.

Агрегированные отчеты Pull API всегда используют валюту приложения.
reattr

Получить данные по конверсии ретаргетинга.

  • [По умолчанию] Если установлено значение false, возвращаются кампании с данными о пользователях (UA).
  • Если установлено значение true, возвращаются данные по конверсии ретаргетинга.
  • Пример:reattr=true
Time Zone (Часовой пояс)

[По умолчанию] Данные предоставляются по часовому поясу UTC.

  • Шаблоны URI заполняются с помощью параметра часового пояса, установленного для часового пояса приложения. 
  • [По умолчанию] Если параметр не передан, данные предоставляются по часовому поясу UTC.
  • Если вы отправляете timezone=[Joda-Time], данные предоставляются с использованием часового пояса приложения.

Примечания о выборе часового пояса

  • Формат часового пояса Joda-Time учитывает переход на летнее время.
  • Значение Joda-Time должно совпадать со значением в настройках приложения. Например, если установлен часовой пояс Парижа, значение часового пояса в Pull API URL должно быть таким:  timezone=Europe%2fParis.
  • Данные в выбранном часовом поясе доступны для извлечения только с даты установки этого часового пояса. Данные, предшествующие дате изменения, отображаются в часовом поясе UTC. 

Ограничения и особенности

Специфика Комментарии 
Необходимый тип токена API AppsFlyerAdmin_us-en.pngТокен V2.0
Доступ рекламной сети N
Доступ агентств Y
Прозрачность агентства Y
Валюта приложения Y
Часовой пояс приложения Y
затраты Данные о затратах доступны только по кампаниям UA и не доступны по ретаргетинговым и неактивным кампаниям (кампаниям без установок).
Актуальность данных Непрерывно
Исторические данные 5 лет
Неорганические данные Y
органические данные Y
Ограничение предоставления данных

Ограничения
Ограничения на размер
  • Вызов API возвращает максимум 200 тысяч строк.
  • Если в отчете ровно 200 тысяч строк, стоит предположить, что какие-то строки отсутствуют.
  • Сделайте несколько API-вызовов, используя параметры from/to с указанием времени.  

Внимание! Pull API поддерживает до 1 млн строк сырых данных. Отчеты с агрегированными данными ограничены 200 тыс. строк. 
Изменения названия кампании Отчеты через Pull API не поддерживают изменения названия кампании

См. также