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

Премиум

Для:

маркетологов

Последнее обновление: 16/12/2024 09:56

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

altPullAPIRaw_us-en.pngalt

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

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

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

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

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

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

Получите токен API. Администратору необходимо получить токен.
Передайте вашему разработчику токен API для использования в заголовке аутентификации.
Предоставьте разработчикам параметры, которые они должны ввести при вызове API, как описано в следующих разделах. Параметры определяют, что содержится в отчете, как он организован, а также устанавливают временные рамки отчетности.
Попросите своего разработчика следовать их инструкциям по Pull API для необработанных данных в центре для разработчиков.

Параметры

Параметр	Описание
от	Диапазон дат состоит из параметров и . Даты относятся к дате активности. Формат: , или Примечание: Пробел необходимо закодировать, как показано здесь `from=2020-04-01%2001:00:00`. Обычно браузеры кодируют пробел. Пример: 2010-01-01 или 2010-01-01 20:15 (параметры часов и минут доступны для отчетов по необработанным данным).
до	Дата окончания. Что касается `fromfrom`
media_source	`media_source`: Чтобы ограничить вызов конкретным медиа-источником. Установите параметры и следующим образом: Для Meta ads установите category и media source на facebook Для X Ads установите category и media source на twitter Для всех других медиа-источников установите category как standard, а media source — по названию медиа-источника. Примеры
maximum_rows	Максимальное количество строк, возвращаемых за один вызов API. [По умолчанию] если значение не указано, до 200 тыс. строк 200000: До 200 тыс. строк 1000000: До 1 млн строк Пример: допускает до 1 млн строк.
event_name	Фильтрация событий внутри приложения по указанным событиям. Выберите несколько событий, используя список, разделённый запятыми. Пример:
reattr	Установите данные атрибуции ретаргетинга. [По умолчанию] Если false, возвращаются кампании с данными о привлечении пользователей (UA). Если true, возвращаются данные ретаргетинговой атрибуции. Пример:
additional_fields	Чтобы получить дополнительные поля вдобавок к полям по умолчанию. Пример:
валюта	Валюта доходов и расходов [По умолчанию] Если параметр не указан, данные возвращаются в долларах США. Это означает, что ничего не делайте, и результаты будут предоставлены в USD. Если вы отправляете, используется валюта , специфичная для приложения. Речь идет о валюте, установленной в настройках приложения. Пример: Если валютой приложения является евро, отправив `currency=preferred`, значения возвращаются в евро.
часовой пояс	[По умолчанию] Данные возвращаются, используя UTC. Чтобы получить данные в часовом поясе , специфичном для приложения, добавьте , как показано в этом разделе, к вызову: `timezone=[Numerical value]` Пример: Для часового пояса UTC+10:00 используйте Примечание: Кодированию подлежат , и `:`. Пример: +10:00 кодируется как `%2B10%3A00`
геоданные	Отфильтруйте данные по коду страны. Ограничение: Вы можете указать только один фильтр кода страны на один вызов API. Пример:
время установки	Диапазон дат состоит из параметров и . Даты относятся к дате активности. Формат: Пример: 2010-01-01
время установки	Дата окончания. Что касается
агентство	Чтобы ограничить вызов конкретным агентством.

Поля Protect360

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

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

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

от/до: гггг-мм-дд чч:мм
от:
- Только дата = с начала (00:00) выбранной даты
- Дата и время = с 00:00 включительно
Параметр до:
- Только дата = до конца (24:00) выбранного дня
- Дата и время = до, но не включая указанное время

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

API вызов

От

До

Первый вызов API

от=гггг-мм-дд

Пример:

от=
Начинается в эту дату с начала дня в 00:00

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

Пример:

до=
Продолжается до 11:59:59, но не 12:00

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

Пример:

Начало в полдень 29 декабря 2019 года
Окончается в полночь 29 декабря 2019 года

от=гггг-мм-дд 12:00

Пример:

из=
Начинается с 12:00 и включает

до=yyyy-mm-dd

Пример:

до=
Заканчивается в полночь

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

от=гггг-мм-дд 12:00

Пример:

из=
Начинается с 12:00 и включает

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

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

Пример:

до=
Означает "до того, как началось 30 декабря".

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

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

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

Укажите поле только один раз.
См. список доступных полей.
Пример:

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

Поля Pull API по умолчанию
Тип атрибутированного взаимодействия
Время атрибутированного взаимодействия
Время установки
Время события
Название события
Значение события
Выручка от события
Валюта выручки от события
Выручка от события в USD
Источник события
Проверено ли получение
Партнер
Источник медиа
Канал
Ключевые слова
Кампания
Идентификатор кампании
Блок рекламы
идентификатор адсета
Реклама
идентификатор рекламы
Тип рекламы
Идентификатор сайта
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
Wi-Fi
Оператор
carrier
Язык
AppsFlyer ID
ID рекламы
IDFA
Android идентификатор
Идентификатор клиента
IMEI
IDFV
Платформа
Тип устройства
Версия ОС
Версия приложения
Версия SDK
Идентификатор приложения
Имя приложения
Идентификатор пакета
Ретаргетинг
Тип конверсии ретаргетинга
Период атрибуции
Окно повторного вовлечения
Is Primary Attribution (Основная атрибуция)
user agent
Источник ссылки HTTP
Исходный URL-адрес

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

Характеристики и ограничения

Специфика	Комментарии
Необходимый тип токена API	Токен версии 2.0
Доступ к рекламной сети	Нет
Доступ агентств	Да
Прозрачность агентства	Да. Однако, пожалуйста, обратите внимание, что если вы используете одновременно фильтры агентства и медиа-источника, то фильтры медиа-источника не применяются для непрозрачных агентств. Это значит, что для непрозрачных агентств учитываются все данные, а не только данные из отфильтрованных медиа-источников.
Валюта приложения	Да
Часовой пояс приложения	Да
Обновление данных	Эквивалент доступности данных на обзорном дэшборде. Отчеты, которые обновляются с задержкой в несколько часов: Органические события внутри приложения Отчеты, которые обновляются ежедневно: Удаления События в приложении после атрибуции Доход от рекламы
Исторические данные	Да. В соответствии с политиками хранения данных и ограничениями по скорости передачи.
Неорганические данные	Да
Органические данные	Да
Ограничение предоставления данных	API ограничения для сырых данных.
Ограничения на размер	Вызов API возвращает максимум 200 тысяч / 1 млн строк. Если в отчете ровно 200 тысяч / 1 млн строк, стоит предположить, что какие-то строки отсутствуют. Используйте параметр maximum_rows для выбора максимального количества строк. Сделайте несколько API-вызовов, используя параметры from/to с указанием времени.
Install_date from и install_date_to	Диапазон дат установки должен быть более ранним, чем диапазон дат активности.

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

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

См. также

Выбор подходящего инструмента доставки и отчётности данных через API