How can we help?

Поиск

агрегированные данные 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 не поддерживают изменения названия кампании

См. также

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

Share article: