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

Для:

маркетологов разработчиков

Последнее обновление: 07/06/2023 18:31

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

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

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

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

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

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

Категория	UA	Ретаргетинг*
Партнеры (медиаисточник)	✓	✓
Партнеры — по датам	✓	✓
Ежедневно	✓	✓
Геоданные	✓	✓
Отчеты по геоданным — по датам	✓	✓
* Для отчетов по ретаргетингу добавьте в URI атрибут `&reattr=true`.

Материал по теме:

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

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

Получите токен API. Получить токен должен админ.
Дайте разработчику токен API, который будет использоваться в заголовке аутентификации.
Предоставьте разработчикам параметры, которые они должны ввести при вызове API, как описано в следующем разделе. Параметры определяют, что содержится в отчете, как он организован, а также устанавливают временные рамки отчетности.
Скажите разработчику, чтобы он следовал инструкциям по 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	Токен V2.0
Доступ рекламной сети	N
Доступ агентств	Y
Прозрачность агентства	Y
Валюта приложения	Y
Часовой пояс приложения	Y
затраты	Данные о затратах доступны только по кампаниям UA и не доступны по ретаргетинговым и неактивным кампаниям (кампаниям без установок).
Актуальность данных	Непрерывно
Исторические данные	5 лет
Неорганические данные	Y
органические данные	Y
Ограничение предоставления данных	Ограничения
Ограничения на размер	Вызов API возвращает максимум 200 тысяч строк. Если в отчете ровно 200 тысяч строк, стоит предположить, что какие-то строки отсутствуют. Сделайте несколько API-вызовов, используя параметры from/to с указанием времени. Внимание! Pull API поддерживает до 1 млн строк сырых данных. Отчеты с агрегированными данными ограничены 200 тыс. строк.
Изменения названия кампании	Отчеты через Pull API не поддерживают изменения названия кампании