Сырые данные Pull API

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

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

PullAPIRaw_us-en.png

Сырые данные Pull API

  • Pull API позволяет получать отчеты по сырым данным в виде файлов CSV. Подробнее об отчетах по сырым данным
  • Доступны фильтры по параметрам: медиа-источник, диапазон дат, название внутреннего события, гео. 
  • Дополнительные возможности в Pull API:
    • Выберите валюту
    • Выбор часового пояса

Отчеты по сырым данным, доступные через Pull API

Отчет Описание Частота обновления
Отчеты по сырым данным (неорганические)
Установки Регистрирует неорганические установки. Запись создается, когда пользователь впервые открывает приложение.
 В реальном времени
Внутренние события приложений Регистрирует события, выполненные пользователями.
 В реальном времени
Кол-во удалений приложения Регистрирует, когда пользователь удаляет приложение.
 Ежедневно
Повторные установки
 Регистрирует пользователей, которые после удаления приложения взаимодействуют с медиа-источником UA и повторно устанавливают приложение во время окна реатрибуции. В реальном времени
Отчеты по сырым данным (органические)
Органические установки
 Регистрирует момент первого открытия приложения пользователем.
 Непрерывно
Органические события внутри приложения
 Регистрирует сведения о событиях, совершенных пользователями.
 Непрерывно
Органические удаления
 Регистрирует пользователей, удаливших приложение.
 Ежедневно
Органические повторные установки
 Регистрирует доходы от рекламы от пользователей, атрибутированных медиа-источнику ретаргетинга во время окна повторного вовлечения.
 Ежедневно
Сырые данные по доходу от рекламы
Атрибутированный доход от рекламы
 		Регистрирует доходы от рекламы от пользователей, атрибутированных медиа-источнику. Ежедневно
Органический доход от рекламы Регистрирует доходы от рекламы от пользователей, не атрибутированных медиа-источнику. Ежедневно
Защита от мошенничества Protect360
Установки Регистрирует установки, признанные мошенническими и не атрибутированные какому-либо медиа-источнику. В реальном времени
Установки после атрибуции Регистрирует внутренние события, происходящие из мошеннических установок и поэтому не атрибутированные. В реальном времени
Внутренние события приложений Регистрирует внутренние события, признанные мошенническими в Protect360. Ежедневно
Внутренние события после атрибуции Регистрирует внутренние события, происходящие из установок, которые признаны мошенническими после их атрибуции медиа-источнику, или считающиеся мошенническими независимо от установки. Ежедневно
Clicks (Клики) Регистрирует клики от пользователей, заблокированных Protect360. Ежедневно
Постбэки по заблокированным установкам Регистрирует копии постбэков, отправленных в медиа-источник, в результате чего установка была заблокирована. В реальном времени
Постбэки
Постбэки по установкам Регистрирует события установки, возникающие, когда пользователь впервые открывает приложение. Ежедневно
Постбэки внутренних событий приложений. Регистрирует постбэки по внутренним событиям, отправленные в медиа-источник. Ежедневно
Постбэки о внутренних событиях в рамках ретаргетинга Регистрирует внутренние события приложения, выполненные пользователями во время окна повторного вовлечения. В реальном времени
Постбэки по конверсиям ретаргетинга Регистрирует внутренние события приложения, выполненные пользователями во время окна повторного вовлечения. В реальном времени

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

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

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

Параметры

Параметр Описание
from
  • Диапазон дат задается параметрами from и to . Под диапазоном понимается диапазон дат активности.
  • Формат: гггг-мм-дд, гггг-мм-дд чч:мм или гггг-мм-дд чч:мм:сс Примечание: Пробел нужно закодировать следующим образом: from=2020-04-01%2001:00:00 — Как правило, браузеры сами кодируют пробел. 
  • Например: 2010-01-01 или 2010-01-01 20:15 (Часы и минуты доступны для отчетов по необработанным данным). 
to Дата окончания. Так же, как и параметр from

media_source

media_source: Чтобы ограничить (отфильтровать) вызов конкретным медиа-источником.

Установите параметры media_source и category следующим образом:

  • Для Meta Ads установите category и media_source на facebook.
  • Для Twitter установите category и media_source на twitter.
  • Для всех прочих медиа-источников установите category на standard, а media_source на имя конкретного медиа-источника.
  • Примеры
    • media_source=facebook&category=facebook
    • media_source=abc_example&category=standard
maximum_rows (максимум строк)

Максимальное количество строк, возвращаемых за один вызов API.

  • [По умолчанию] если значение не отправлено, до 200K строк
  • 200000: возвращается до 200K строк
  • 1000000: возвращается до 1M строк
  • Пример: maximum_rows=1000000 позволяет получить до 1M строк. 
event_name

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

Пример: event_name=af_purchase,ftd 
reattr

Получить данные по атрибуции ретаргетинга.

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

Чтобы получить дополнительные поля наряду с полями по умолчанию. 

Пример: additional_fields=device_download_time,deeplink_url
валюта

Валюта выручки и стоимость

  • [По умолчанию] Если параметр не передан, данные предоставляются по часовому поясу UTC. Это означает, не делайте ничего, и результаты будут возвращаться в USD.
  • Если вы отправите currency=preferred, будет использоваться валюта приложения. То есть валюта, установленная в настройках приложения.

Пример: Если валюта приложения EUR, отправьте currency=preferred, и вы получите данные в евро.
Time Zone (Часовой пояс)

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

  •  timezone=[Числовое значение] 
  • Пример: Для часового пояса UTC+10:00 используйте timezone=+10:00 Внимание! Символы +,- и : должны быть закодированы. Например: +10:00 кодируются как  %2B10%3A00
страны

Отфильтруйте данные по коду страны.

Ограничение: вы можете установить только один фильтр кода страны на один вызов API. 

Пример: geo=ZA
from_install time
  • Диапазон дат задается параметрами from и to . Под диапазоном понимается диапазон дат активности.
  • Формат: гггг-мм-дд
  • Пример: 2010-01-01
to_install_time

Дата окончания. Так же, как и параметр from_install time
agency

Чтобы ограничить (отфильтровать) вызов конкретным агентством.

Поля Protect360

См. руководство по сырым данным Protect360

Поля временных рамок

Если результаты API превышают максимальное количество строк, разделите отчет с помощью часов и минут. Примените следующее:

  • from/to: yyyy-mm-dd hh:mm 
  • from: 
    • Только дата = с начала (00:00) выбранной даты
    • Дата и время = от и включая 00:00
  • Параметр to: 
    • Только дата = до конца (24:00) выбранной даты
    • Дата и время = до, но не включая выбранное время

Пример: У владельца приложения в день производится 1,3 млн установок из всех источников. Чтобы превысить лимит в 1М строк, владелец приложения разбивает день на два вызова URI, каждый по 12 часов. Смотрите следующую таблицу. 

Вызов API From  To 
Первый вызов API 

from=гггг-мм-дд

Пример:

  • from=2019-12-29
  • Начинается в эту дату с началом дня в 00:00.

to=гггг-мм-дд 12:00

Пример:

  • to=2019-12-29 12:00
  • Захватывает данные до 11:59:59, не 12:00 

Вариант A: Второй вызов API 

 

Пример: 

&from=2019-12-29 12:00&to=2019-12-29

  • Начало в полдень, 29 декабря 2019
  • Окончание в полночь, 29 декабря 2019
  

from=гггг-мм-дд 12:00

Пример:

  • from=2019-12-29 12:00
  • Начинается с 12:00 и включает 12:00

 

to=yyyy-mm-dd

Пример:

  • to=2019-12-29
  • Заканчивается в полночь

 
Вариант В: Второй вызов API

from=гггг-мм-дд 12:00

Пример:

  • from=2019-12-29 12:00
  • Начинается с 12:00 и включает 12:00

to=гггг-мм-дд+1 00:00

+1 = следующий день в 00:00

Пример:

  • to=2019-12-30 00:00
  • Означает «до того, как началось 30 декабря».

Примечание. Используйте вариант А или В, поскольку они дают одинаковые результаты. 

Дополнительные поля

Дополнительные поля отчета не добавляются в список полей по умолчанию, поэтому новые поля не влияют на имеющиеся процессы импорта и загрузки данных. Используйте параметр additional_fields, чтобы получить дополнительные поля. 

Поля по умолчанию

Поля Pull API по умолчанию
Атрибутированное время касания
Install Time (Время установки)
Event Time (Время события)
Имя события
Значение события
Выручка от события
Валюта выручки от событий
Выручка от события в USD
Источник события
Проверено ли получение
Партнер
Медиа-источник
Канал
Ключевые слова
Кампания
ID кампании
Блок рекламы
ID блока рекламы
Реклама
ID рекламы.
Тип рекламы
ID сайта
ID субсайта
Cубпараметр 1
Cубпараметр 2
Cубпараметр 3
Cубпараметр 4
Cубпараметр 5
Модель затрат
Величина затрат
Валюта расходов
Партнер ассистента 1
Исходная точка взаимодействия ассистента 1
Кампания ассистента 1
Тип касания ассистента 1
Время касания ассистента 1
Партнер ассистента 2
Исходная точка взаимодействия ассистента 2
Кампания ассистента 2
Тип касания ассистента 2
Время касания ассистента 2
Партнер ассистента 3
Исходная точка взаимодействия ассистента 3
Кампания ассистента 3
Тип касания ассистента 3
Время касания ассистента 3
Регион
Код страны
Состояние
city
Почтовый индекс
DMA
IP
wifi
operator
carrier
language
Идентификатор AppsFlyer ID
ID рекламы
IDFA
Android ID
Идентификатор клиента
imei
IDFV
Платформа
Тип устройства
Версия ОС
Версия приложения
Версия SDK
Идентификатор приложения
Имя приложения
Идентификатор пакета
Is Retargeting (Ретаргетинг)
Retargeting Conversion Type (Тип конверсии ретаргетинга)
Attribution Lookback (Ретроспективная атрибуция)
Окно повторного вовлечения
Is Primary Attribution (Основная атрибуция)
Агент пользователя
Источник ссылки HTTP
Original URL (Исходный URL-адрес)

Дополнительные сведения

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

Специфика Комментарии 
Необходимый тип токена API AppsFlyerAdmin_us-en.pngТокен V2.0
Доступ рекламной сети Нет
Доступ агентств Да
Прозрачность агентства Да. Однако обратите внимание, что если вы используете одновременно фильтр агентства и фильтры медиа-источников, фильтры медиа-источников не применяются к непрозрачным агентствам. Это означает, что для непрозрачных агентств включаются все данные, а не только данные из отфильтрованных медиа-источников. 
Валюта приложения Да
Часовой пояс приложения Да
Актуальность данных
  • Эквивалент доступности данных на обзорном дэшборде.
  • Отчеты, которые обновляются с задержкой в несколько часов:
    • Органические события внутри приложения
  • Отчеты, которые обновляются ежедневно:
    • Кол-во удалений приложения
    • Внутренние события после атрибуции
    • Доходы от рекламы
Исторические данные Да.  В соответствии с политиками удержания и ограничения предоставления данных. 
Неорганические данные Да
органические данные Да
Ограничение предоставления данных

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

Устранение неполадок

Симптом/сообщение Решение
Отчет не содержит данных, ожидаемых в соответствии с выбранным диапазоном времени, или имеется несоответствие между отчетом по сырым данным и отчетом по агрегированным данным. 

Проверьте, что вы установили параметр timezone. Если вы этого не сделаете, данные будут отправляться с использованием UTC, а не часового пояса вашего приложения. 

См. также