Словарь полей сырых данных

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

Краткий обзор. В словаре данных (спецификации сырых данных) описано содержание полей. В нем даются пояснения, что означают поля, как они форматируются и когда они доступны. Отчеты с сырыми данными, инструменты и API.

Словарь полей в отчетах по сырым данным 

Следующая таблица представляет собой словарь, в котором перечислены поля сырых данных, доступные в различных отчетах AppsFlyer. Таблица постоянно обновляется по мере добавления в AppsFlyer дополнительных полей сырых данных.

Столбцами таблицы словаря являются: 

  • Группа полей: логическая группировка полей на основе их использования Внимание! Поля в группе доходов от рекламы отображаются в отчетах по сырым данным либо как собственные столбцы, либо как часть Значения события.  
  • Имя поля:
    • Имя поля, которое используется в отчетах, можно получить на странице Export (Экспорт) или через Pull API.
    • Обозначение [n] означает, что существует несколько экземпляров одного поля, отличающихся по номеру. Например, Sub Param [n] означает Sub Param 1, Sub Param 2, ..., Sub Param 5. Диапазон значений n обозначается как (n=1-5).
  • Имя API:
    • Имя поля в том виде, в котором оно отображается в отчетах Data Locker и Push API.
    • Обозначение [n] означает, что существует несколько экземпляров одного поля, отличающихся по номеру. Например, Sub Param [n] означает Sub Param 1, Sub Param 2, ..., Sub Param 5. Диапазон значений n обозначается как (n=1-5).
  • Источник: место, откуда получено содержимое поля, например:
  • Описание
    • Некоторые поля имеют разные значения в зависимости от контекста события. Значение присваивается в результате привлечения пользователя или кампании ретаргетинга.
  • Формат: тип и длина поля.
    • Строка: максимальная длина строки. Обычно мы не применяем ограничения длины поля при получении данных, но превышающие данные могут быть обрезаны. Не превышайте установленную длину поля.
    • Дата и время: 
      • Строка в формате yyyy-mm-dd hh:mm:ss. Например, 2019-09-17 00:09:25 Часовой пояс, используемый для отображения данных, зависит от способа доставки данных, а именно:
        • Страница экспорта данных: часовой пояс, выбранный приложением.
        • Push API: у полей времени есть опция selected_time_zone, которая означает часовой пояс для конкретного приложения, отличающийся от UTC.
        • Mater API: по умолчанию — часовой пояс, который можно выбрать для приложения.
        • Data Locker: UTC
      • Поля дат в CSV-файлах имеют формат гггг-мм-дд. При открытии CSV-файла в Excel поля даты форматируются в соответствии с настройками даты и времени на компьютере. Вы можете изменить отображаемый формат в Excel. Чтобы увидеть неформатированное значение, откройте файл в редакторе.
      • Push API:
        • Для полей меток времени в UTC формат таков: гггг-мм-дд чч:мм:сс.ссс. Например, 2019-09-17 00:09:25.123 
        • Для полей меток времени в выбранном часовом поясе формат таков: yyyy-mm-dd hh:mm:ss.±th:tm. Например, 2019-01-20 04:51:16.000+0000
    • Перечисление n символов: Поля Enum (перечисление) могут содержать только определенные значения. Например, поле валюты расходов содержит 3 символа и может содержать только определенные коды валют.
    • Перечисление 5 символов булево: Это поле может принимать значение TRUE или FALSE

 Совет

  • Чтобы отсортировать таблицу, нажмите заголовок столбца.
  • Вы также можете скачать таблицу.
  • Скачиваемый CSV содержит дополнительные поля к указанным выше:
    • Часть основной схемы отчета AppsFlyer:
      • Большинство отчетов AppsFlyer строятся на основе одной и той же схемы и содержат одни и те же поля.
      • Некоторые поля могут быть заполнены нулевыми или пустыми значениями в зависимости от отчета, а также от того, собираются ли данные от рекламных сетей, рекламодателей, платформ устройств и т.д. 
      • При настройке систем бизнес-аналитики лучше всего настраивать все основные поля по схеме AppsFlyer, даже если в конкретном отчете они всегда возвращаются в виде нулевых (null) или пустых значений. Это позволяет легко вводить данные в систему, когда они становятся доступными. 
      • Если какое-либо поле не входит в основную схему отчетов AppsFlyer, то оно содержится только в определенных отчетах. Например, в отчетах SKAN.
    • Способ доставки отчета: указывает, доступно ли данное поле через Push API, экспорт данных/Pull API и Data Locker. Примечание. Даже если поле входит в основную схему отчетов AppsFlyer, оно может не входить в состав отчетов, доставляемых определенным способом. Например, поле размещения является частью основной схемы AppsFlyer, но оно отображается только в отчетах, предоставляемых через Data Locker, Pull API или страницу экспорта данных, но не через Push API.
Группа полей Имя поля Имя API Источник Описание Формат
Атрибуция Реклама af_ad Ссылка Имя рекламы Строка 100
SKAN ID рекламы. ad_network
_ad_id		 Рекламная сеть ID рекламы. Строка
Атрибуция ID рекламы. af_ad_id Ссылка ID рекламы. Строка 24
SKAN Имя рекламы ad_network
_ad_name		 Рекламная сеть Имя рекламы Строка
SKAN Идентификатор рекламной сети skad_ad
_network_id		 iOS Идентификатор рекламной сети, куда был отправлен постбэк Строка
SKAN Название рекламной сети ad_network
_name		 Рекламная сеть
  • Название рекламной сети, сообщаемое рекламной сетью в AppsFlyer.
  • Если это поле пустое, значит, рекламная сеть не заполнила (не смогла заполнить) его.
  • Название рекламной сети можно определить с помощью skad_ad_network_id. Для этого используйте эту таблицу.
Строка
SKAN Идентификатор исходного приложения рекламной сети ad_network_source_app_id Рекламная сеть ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Приложение издателя дает основу для этих данных.  Строка
SKAN Временная метка рекламной сети ad_network
_timestamp		 Рекламная сеть
  • Время получения постбэка рекламной сетью.
  • В случае с Google Ads это поле не заполняется.
 Временная отметка
Атрибуция Место размещения рекламы ad_placement Ссылка Заполняется для размещения рекламы на CTV Строка 64
Атрибуция Тип рекламного объявления af_ad_type Ссылка Например, баннер, нижний блок Строка 24
Доходы от рекламы Рекламный блок ad_unit API доходов от рекламы Название сегмента дохода от рекламы при проведении A/B-тестирования Строка 1024
Атрибуция Блок рекламы af_adset Ссылка Название группы объявлений, идентифицирует группу, содержащую одно или несколько объявлений Строка 100
SKAN ID блока рекламы ad_network
_adset_id		 Рекламная сеть ID блока рекламы Строка
Атрибуция ID блока рекламы af_adset_id Ссылка Идентификатор группы объявлений, идентифицирует группу, содержащую одно или несколько объявлений Строка 24
SKAN Название блока рекламы ad_network
_adset_name		 Рекламная сеть Название блока рекламы Строка
Информация об устройстве Advertising ID для устройств Android advertising_id SDK
  • Идентификатор устройства, который пользователь может сбросить, он же GAID.
  • Для CTV это идентификатор CTV, например, RIDA или VIDA.
 Строка 40
SKAN Флаг атрибуции AF af_attribution
_flag		 AF Когда включен механизм единого источника истины (SSOT): Если true, установка была атрибутирована и AppsFlyer, и SKAN. Если false, установка не была атрибутирована AppsFlyer. Если значение skad_conversion_value равно null, флаг будет true или false (на основе моделирования). Логическое значение
Информация об устройстве Идентификатор Amazon Fire amazon_aid SDK Идентификатор рекламного объявления, который может быть сброшен пользователем, на устройствах Amazon Строка 100
SKAN Неоднозначное событие skad_ambiguous
_event		 AF Если true, то постбэк iOS был получен в течение первых 72 часов после того, как рекламодатель изменил настройки SKAN на дэшборде.
Из-за различных таймеров, используемых SKAN, AppsFlyer не может точно сопоставить событие.		 Логическое значение
Информация об устройстве Android ID android_id SDK Постоянный идентификатор устройства Строка 20
Загрузка Идентификатор приложения app_id SDK Уникальный идентификатор приложения в AppsFlyer. Пример:
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
 iOS: Строка 12
Android: Строка 100
SKAN Идентификатор приложения skad_app_id iOS Идентификатор приложения Строка
Загрузка Имя приложения app_name SDK Устанавливает рекламодатель Строка 100
Загрузка Тип приложения app_type App Clip (мини-приложение) Значения: app_clip, full_app Строка
Загрузка Версия приложения app_version SDK Устанавливает рекламодатель До 8 символов
Информация об устройстве Идентификатор AppsFlyer ID appsflyer_id SDK
  • Уникальный идентификатор, генерируемый SDK при установке приложения на устройство. Он используется для атрибуции внутренних событий приложения в процессах LTV, получения данных о конверсиях и партнерских внутренних событий приложения.
  • Если приложение было удалено, а затем установлено снова, генерируется новый идентификатор. Восстановление приложения из резервной копии iCloud не считается установкой.
  • Для CTV это поле заполняется значением custom_device_id (идентификатор устройства, управляемого рекламодателем).
 iOS: Строка 24
Android: Строка 33
Информация об устройстве ATT att SDK
  • ATT, также att_status, доступен в iOS 14+ и заполняется значениями, которые: возвращаются ATTrackingManager, отправляются из S2S или определяются AppsFlyer.
  • Значения ATT могут быть следующими: not_determined (не определено), restricted (ограничено), denied (отклонено), authorized (авторизовано), af_unknown (неизвестно), af_authorized (авторизовано), af_unavailable (недоступно).
Строка 20
Атрибуция Атрибутированное время касания attributed_touch
_time		 AF
  • UA: Время атрибутированного нами касания.
  • Ретаргетинг: время интеракции, по которой выполнена атрибуция.
 Дата/Время
Атрибуция Атрибутированный тип взаимодействия attributed_touch
_type		 AF
  • UA: Возможные значения: click, impression, pre-installed (клик, показ, предустановлено)
  • Ретаргетинг: click, impression (клик, показ).
 Перечисление 10 символов максимум
Атрибуция Окно атрибуции lookback window af_attribution
_lookback		 Ссылка
  • Максимальный период времени, в течение которого установку можно атрибутировать рекламному объявлению.
  • UA: для атрибуции по кликам задайте параметр ссылки атрибуции af_click_lookback.
  • Ретаргетинг: настройте для внутренних событий Окно атрибуции ретаргетинга по клику.
 До 3 символов
SKAN Подпись атрибуции skad_attribution
_signature		 iOS Сигнатура, добавляемая рекламной сетью к постбэкам SKAN Строка
Protect360 Причина блокировки blocked_reason AF Protect360: причина, по которой установка была заблокирована. Например: install_hijacking, bots (перехват установки, боты) Строка 100
Protect360 Правило, которое вызвало блокировку (устарело) blocked_reason
_rule		 AF Устаревшее Строка 100
Protect360 Значение причины блокировки blocked_reason
_value		 AF Protect 360: дополнительная информация о блокировке. Например, ID сайта, имена правил проверки Строка 100
Protect360 Подпричина блокировки blocked_sub
_reason		 AF Protect 360: частная причина, по которой установка была заблокирована. Пример. Причина: install_hijacking (перехват установки). Частная причина: referer hijack (перехват реферера), CTIT_anomalies (аномальное значение CTIT), validation_rules (правила валидации) Строка 100
Загрузка Идентификатор пакета bundle_id SDK Строка 100
SKAN Кампания ad_network
_campaign
_name		 Рекламная сеть Название кампании, сообщенное рекламной сетью в AppsFlyer Строка
Атрибуция Кампания campaign Ссылка Название кампании Строка 100
SKAN ID кампании ad_network
_campaign_id		 Рекламная сеть Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer Строка
Атрибуция ID кампании af_c_id Ссылка ID кампании Строка
SKAN ID кампании skad_campaign
_id		 iOS Идентификатор кампании, используемый для публикации объявления. Диапазон: 0–100 Целое число
Атрибуция Тип кампании campaign_type AF Источник, из которого пришел пользователь:
  • UA
  • Органика
  • Ретаргетинг
  • Неизвестно (1)
(1) Внутренние события / сессии не атрибутируются какому-либо медиа-источнику. Альтернативный вариант: данные удаляются по требованию политики конфиденциальности или GDPR.		 Строка
Информация об устройстве carrier carrier SDK Имя оператора, предоставленное Android с помощью getSimCarrierIdName(). См. также сопоставление операторов. Строка 50
SKAN Канал ad_network
_channel		 Рекламная сеть Поле добавляется в отчеты, но не обязательно будет заполнено. Строка
Атрибуция Канал af_channel Ссылка Канал медиа-источника. Примеры: YouTube для Google, Instagram для Meta ads Динамическое перечисление строка 20
Местонахождение устройства city city AF Наиболее детальное местоположение пользователя на основе IP-адреса устройства. Как правило, значение содержит название города, но также может включать районы, округа, то есть более точные данные. Строка 100
SKAN Приблизительное значение конверсии skad_coarse
_conversion
_value		 iOS
  • Значение может быть низкое, среднее или высокое.
  • Для SKAN 3 значение равно null.
 Строка
Атрибуция Кампания контрибутора [n] contributor[n]
_campaign
(n=1-3)		 AF Кампания ассистента Строка 100
Атрибуция Тип совпадения контрибуции [n]

contributor[n]
_match_type
(n=1-3)

 AF Возможные значения такие же, как тип соответствия. Строка 50
Атрибуция Медиаисточник контрибутора [n] contributor[n]
_media_source
(n=1-3)		 AF Медиа-источник ассистента Строка 50
Атрибуция Партнер контрибуции [n] contributor[n]
_af_prt
(n=1-3)		 AF Агентство или PMD — всегда преобразуется в нижний регистр Строка 50
Атрибуция Тип касания контрибуции [n] contributor[n]
_touch_time
(n=1-3)		 AF Время взаимодействия с ассистентом Дата/Время
Атрибуция Contributor[n] touch Type contributor[n]
_touch_type
(n=1-3)		 AF Возможные значения: click, impression (клик, показ) Перечисление 10 символов максимум
Атрибуция Тип конверсий conversion_type AF

Тип конверсии:

  • Установка
  • Повторная установка (1)
  • Повторное вовлечение 
  • Неизвестно (2)

(1) Если conversion_type=reinstall и campaign_type=retargeting, то это эквивалентно retargeting_conversion_type=re-attribution

(2) Внутренние события / сессии не атрибутируются какому-либо медиа-источнику.

 Строка
SKAN Значение конверсии skad_conversion
_value		 iOS
  • Значение конверсии, сообщаемое iOS. Диапазон 0–63.
  • Если null, iOS не заполнила поле
 Целое число
Атрибуция Валюта расходов af_cost_currency Ссылка Трехбуквенный код валюты (USD, EUR), соответствующий стандарту ISO-4217. По умолчанию USD. Строка 3 симв.
Атрибуция Модель затрат af_cost_model Ссылка Модель затрат, сообщается по ссылке атрибуции. CPC/CPI/CPM/другое. В настоящее время все расходы считаются по CPI независимо от этого значения. Строка 20
Атрибуция Числовое значение величины затрат. af_cost_value Ссылка Размер затрат в валюте приложения. Допустимый формат: до 4 знаков после десятичного разделителя. Пример: 320.5095 Строка 20
Местонахождение устройства Код страны country_code AF
  • Код страны в соответствии с ISO 3166 (alpha-2). Пример: US, CN.
  • Для Великобритании используется код UK, а не GB.
 Перечисление строка 2
SKAN Креатив ad_network
_creative		 Рекламная сеть
  • Значение основано на обогащении данных, полученных от рекламной сети.
  • Для SKAN 3 значение равно null.
 Строка
Подписка CUID af_cuids Коннектора SDK AppsFlyer для измерения дохода от покупок
  • В контексте ARS этот параметр содержит массив со всеми CUID.
  • Массив CUID отображается независимо от идентификаторов устройств. Таким образом, одни и те же CUID могут отображаться для нескольких идентификаторов устройства.
  
Атрибуция Пользовательские данные custom_data SDK Данные устанавливаются S2S или рекламодателем в SDK и чаще всего используются для интеграции со сторонними организациями, аудиториями и т. д. См. Android и iOS Строка 1024
Атрибуция Настраиваемый параметр custom
_dimension 		SDK Зарезервировано AppsFlyer для использования в будущем Строка
Информация об устройстве Идентификатор клиента customer
_user_id		 SDK Уникальный идентификатор пользователя приложения, установленный владельцем приложения. Строка 100
Информация об устройстве Deep Link URL (URL-адрес глубинной ссылки) deeplink_url SDK Путь к действию в приложении, на которое направляются пользователи с помощью диплинка. Используется для диплинкинга и отложенного диплинкинга.
Содержит значение af_dp из ссылки атрибуции.		 Строка 1024
Protect360 Detection date (Дата обнаружения) detection_date AF Дата пост-атрибуционного выявления фрода. Строка 100
Информация об устройстве Категория устройства device_category SDK Возможные значения: phone, tablet (телефон, планшет) и др. Строка 20
Информация об устройстве Время скачивания на устройство device_download
_time		 SDK Время завершения скачивания приложения по часам устройства Android/iOS, переведенное в часовой пояс UTC. Значение всегда отображается как UTC.
Формат: гггг-мм-дд чч:мм:сс.ссс 		Дата/Время
Информация об устройстве Тип идентификатора устройства device_id_type SDK Заполняется для CTV, указывается тип идентификатора платформы CTV. Например, RIDA для Roku. Перечисление 4
Информация об устройстве Модель устройства device_model SDK Коммерческое название модели устройства. Например, xiaomi::Redmi или iPhone7 Строка 100
Информация об устройстве Тип устройства device_type SDK
  • Коммерческое название модели устройства.
  • [Со 2 февраля 2022 это поле больше не заполняется]
  • Вместо этого поля используйте поле Device model (Модель устройства), заполняемое аналогичным образом.
  • Пример:
    • Модель устройства: xiaomi::Redmi Note 8
    • Тип устройства: xiaomi-Redmi Note 8
    • Модель устройства: iPhone7
    • Тип устройства: iPhone 7
 Строка 100
SKAN Основная кампания skad_did_win iOS Логическое значение
IAP
Подписка		 ID скидки af_discount_id Коннектора SDK AppsFlyer для измерения дохода от покупок Идентификатор предложения, представленный пользователю во время первоначальной покупки. Идентификатор заполняется только при наличии кода скидки.  
Подписка Тип скидки af_discount_type Коннектора SDK AppsFlyer для измерения дохода от покупок Тип скидки, примененной пользователем. Возможные значения:
  • IOS:
    • вводный
    • подписка
  • Android:
    • предварительная цена
    • one_time_code (одноразовый код)
    • vanity_code (уникальный код)
  
Местонахождение устройства DMA dma AF Расчетная рыночная территория или географические зоны, определенные компанией Nielsen. Определение местоположения пользователя. Строка 10
IAP
Подписка		 Среда af_environment Коннектора SDK AppsFlyer для измерения дохода от покупок Среда, из которой получены данные, — производственная или песочница.  
Событие Время события (час) event_time Постбэк Время события, округленное в меньшую сторону до ближайшего часа Дата/Время
Событие Имя события event_name AF/SDK
  • Тип события атрибуции или имя внутреннего события приложения, отправленные приложением. Примеры типов событий атрибуции: install (установка), re-engagement (повторное вовлечение) и др.
  • В Data Locker в контексте отчетов по ретаргетингу имя события указывается следующим образом: retargeting (ретаргетинг) — это повторное вовлечение, install (установка) — реатрибуция. Для отчетов SKAN имя события в приложении соответствует настройкам в AppsFlyer.
  • Для отчета SKAN по SRN это имя события в приложении, настроенное в Meta Ads.
 Строка 100
Событие Доход от события event_revenue SDK
  • Выручка в валюте, определенной для выручки событий.
  • Суммы за пределами диапазона от $-10000 до $+10000 (или в эквиваленте) отображаются в отчетах по сырым данным, но не в агрегированных отчетах.
 Строка 20
SKAN Доход от события event_revenue AF Формула: [сумма значений для конкретного события в USD] / [Количество событий, произошедших в конкретный день] Переменное число
Событие Валюта выручки от события event_revenue
_currency		 SDK Код валюты дохода от события, переданной в SDK. Строка 20
Событие Выбранная валюта выручки от события event_revenue
_xxx		  
  • Сумма дохода. Выбор валюты зависит от используемого инструмента.
  • Предпочитаемый / выбранный означает валюту, установленную для приложения в его настройках.
  • Data Locker: всегда USD
  • Страница экспорта: выбранная валюта
  • Pull API варианты: USD или выбранная валюта в параметре &currency=preferred.
  • Push API: всегда включает оба поля, USD и выбранную валюту
 Строка 20
Событие Выручка от события в USD event_revenue
_usd*		 AF
  • Сумма дохода. Выбор валюты зависит от используемого инструмента.
  • Предпочитаемый / выбранный означает валюту, установленную для приложения в его настройках.
  • Data Locker: всегда USD
  • Страница экспорта: выбранная валюта
  • Pull API варианты: USD или выбранная валюта в параметре &currency=preferred.
  • Push API: всегда включает оба поля, USD и выбранную валюту
 Строка 20
Атрибуция Источник события event_source AF Либо SDK, либо S2S Перечисление 3 символа максимум
Событие Event Time (Время события) event_time SDK Время события Дата/Время
Событие Тип события event_type AF/SDK Тип события атрибуции. Примеры типов событий атрибуции: install (установка), re-engagement (повторное вовлечение) и др. Строка 100
Событие PBA Event URL event_url Веб-SDK URL-адрес веб-страницы, на которой произошло событие (соответствует исходному URL-адресу в посещениях сайта) Строка
Событие Значение события event_value SDK Подробный контент события, отправленный из SDK. Примечание. Не отправляйте более 1000 символов, иначе данные могут быть урезаны. Строка 1000
SKAN Значение события event_value S2S
  • Значение по умолчанию: null
  • Содержит строку, задаваемую приложениями, указывающую на пользовательское декодирование или отправку событий S2S.
  • Рекламодатели употребляют это в своих системах. В AppsFlyer это не используется.
 Строка (JSON)
SKAN Тип достоверности fidelity_type  
  • Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом:
    • Просмотры рекламы (0)
    • Реклама с рендерингом StoreKit (1)
    • Не учитывайте значение поля, если версия SKAN старше 2.2.
 Целое число
SKAN Тип достоверности skad_fidelity
_type		 iOS
  • Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом:
    • Просмотры рекламы (0)
    • Реклама с рендерингом StoreKit (1)
    • Не учитывайте значение поля, если версия SKAN старше 2.2. Поле добавляется в отчеты, но не обязательно будет заполнено.
 Целое число
Protect360 Причина мошенничества fraud_reason AF Protect360: см. причину блокировки. Строка 100
Protect360 Частная причина мошенничества fraud_sub
_reason		 AF Protect360: см. частную причину блокировки. Строка 100
Атрибуция Инициатор Google Play Broadcast gp_broadcast
_referrer		 Магазин Google Play Инициатор Google Play Broadcast Строка 1024
Атрибуция Время нажатия Google Play gp_click_time Поле Google Play
  • Время загрузки страницы приложения в Google Play после нажатия на рекламу.
  • Источник времени: Google API.
  • Доступно в SDK Android версии 4.8.5 и выше.
  • Например: можно сравнить время install_time со временем gp_click_time. Это покажет, сколько проходит времени от начала загрузки приложения пользователем до момента открытия приложения.
 Временная отметка
Атрибуция Время начала установки Google Play gp_install_begin Магазин Google Play
  • Время начала установки
  • Источник времени: Google API.
  • Доступно в SDK Android версии V4.8.5 и выше
 Временная отметка
Атрибуция Google Play Referrer gp_referrer Магазин Google Play
  • URL-адрес источника ссылки установленного пакета.
  • Доступно в SDK Android версии V4.8.5 и выше
 Строка 1024
Атрибуция Источник ссылки HTTP http_referrer AF Адрес веб-страницы с URL-адресом нажатия AppsFlyer. С помощью источника ссылки можно определить, откуда выполнен запрос. Строка, до 10000 симв.
Информация об устройстве IDFA idfa SDK Идентификатор рекламного объявления, который может быть сброшен пользователем, на устройствах iOS. Если данные IDFA недоступны, обычно заполняется нулями. До 40 символов
Информация об устройстве IDFV idfv SDK Идентификатор поставщика, предоставленный iOS До 40 символов
Информация об устройстве imei imei SDK Постоянный идентификатор устройства До 14 символов
Доходы от рекламы Показы Показы API доходов от рекламы Сколько раз пользователь видел рекламу Строка 1024
Атрибуция Магазин приложений, использованный для установки install_app_store SDK Магазин Android, из которого было загружено приложение (подробнее) Строка 50
SKAN Дате установки install_date iOS Оценивается AppsFlyer на основе времени прибытия постбэка. Строка времени
Атрибуция Install Time (Время установки) install_time Постбэк
  • UA: первый запуск после установки.
  • Ретаргетинг: первый запуск после повторного вовлечения / реатрибуции.
 Дата/Время
SKAN Тип установки install_type iOS Новые установки Строка
SKAN Интервал interval AF Интервалы окна активности. Целое число
Местонахождение устройства IP ip AF IP-адрес: IPV4 или IPV6. По адресу AppsFlyer определяет местоположение пользователя. При необходимости рекламодатели могут маскировать IP-адрес в отчетах и постбэках. Строка
Protect360 Is organic (является органическим) is_organic AF Индикация того, связано ли внутреннее событие с органической установкой. Строка 100
Атрибуция Is Primary Attribution (Основная атрибуция) is_primary
_attribution		 AF UA: True

Ретаргетинг: в течение окна повторного вовлечения событие атрибутируется и первоначальному медиа-источнику (до повторного вовлечения), и медиа-источнику повторного вовлечения. Пока событие выполняется в интервале повторного вовлечения. Исходный медиа-источник будет иметь значение FALSE (не основная атрибуция). Медиа-источник повторного вовлечения будет иметь значение TRUE. Подробнее. 		Перечисление 5 символов максимум
Событие Проверено ли получение is_receipt
_validated		 AF значение True/False/Null, если реализовано в SDK, в ином случае пустое Перечисление 5 символов максимум
Атрибуция Is Retargeting (Ретаргетинг) is_retargeting Ссылка Перечисление 5 симв. булево
Атрибуция ID ключевого слова keyword_id Ссылка Идентификатор ключевого слова, возвращенный рекламной сетью. Это идентификатор ключевого слова af_keyword Строка 100
Атрибуция Тип сопоставления ключевых слов keyword_match
_type		 AF
  • Тип сопоставления ключевых слов предоставляется только Google AdWords.
  • Начиная с 15 февраля 2021 года, это поле больше не заполняется в отношении Apple Search Ads.
 Строка 100
Атрибуция Ключевые слова af_keywords Ссылка Слова, появляющиеся в поисковых запросах пользователя. Их сообщает рекламная сеть. Строка 100
Информация об устройстве language language SDK Язык (местный), сообщается устройством, устанавливается ОС устройства. Обычно в виде ll-DD, где ll это язык, а DD диалект.  Например, en-ZA — это английский язык, используемый в Южной Африке. Строка 20
Информация об устройстве Ограничение отслеживания рекламы is_lat SDK

Ограничение отслеживания рекламы (LAT):

  • iOS: Начиная с iOS 14, Apple устраняет LAT. Определяйте статус конфиденциальности пользователя с помощью ATT. В этом случае проигнорируйте is_lat.
    До версии iOS 14, если установлено значение true, то IDFA не доступен и отображается 0.
  • Android: Если установлено значение true, пользователь отказался от рекламы по интересам. GAID не будет собирать данные и вместо них будет отображать нули.
Перечисление 5 символов булево
Атрибуция Тип сопоставления match_type AF

Тип метода атрибуции. Возможные значения:

 Строка 50
SKAN Макс. кол-во событий max_event
_counter		 AF Чтобы определить, сколько раз пользователь выполнил то или иное событие в приложении, используйте формулу [округление (min_event_counter + max_event_counter) / 2]. Внимание! Нужно округлить до ближайшего целого числа.
Пример:
A. Если min = 0 и max = 1, среднее равно 0,5; округление дает результат 1.
B. Если min = 5 и max = 10, среднее равно 7,5; округление дает результат 8.		 Целое число
SKAN Максимальная выручка max_revenue AF Доход всегда указывается в поле skad_revenue. Если вы используете SKAN 4 или пользовательский режим Custom, то диапазон корзины, связанной с событием и используемой для расчета skad_revenue, описывается в полях min_revenue и max_revenue. Вещественное число
SKAN Макс. время после установки max_time
_post_install		 AF
  • В пользовательской конверсии: AppsFlyer рассчитывает время установки как время прихода постбэка - 36ч. - среднее (min_time_post_install + max_time_post_install). Однако, если CV=0, то среднее (min_time_post_install + max_time_post_install) считается равным 0.
  • В декодированной конверсии: min_time_post_install на один час меньше, чем задано в max_time_post_install, что равно hours_from_install, установленному вами в сопоставлении декодированных конверсий.
 Целое число
Атрибуция PBA Медиа-канал media_channel Веб-SDK Медиа-канал, атрибутированный посещению сайта Строка
Атрибуция Медиа-источник media_source Ссылка Медиа-источник, атрибутированный событию или ограниченный Строка 50
Доходы от рекламы Сеть-посредник mediation
_network		 API доходов от рекламы Сеть-посредник, сообщающая о событии в AppsFlyer Строка 1024
SKAN Минимальное количество событий min_event
_counter		 AF Используется для подсчета количества раз, когда пользователь выполняет то или иное событие. Чтобы определить, сколько раз пользователь выполнил то или иное событие в приложении, используйте формулу [округление (min_event_counter + max_event_counter) / 2]. Внимание! Нужно округлить до ближайшего целого числа.
Пример:
A. Если min = 0 и max = 1, среднее равно 0,5; округление дает результат 1.
B. Если min = 5 и max = 10, среднее равно 7,5; округление дает результат 8.		 Целое число
SKAN Минимальный доход min_revenue AF Доход всегда указывается в поле skad_revenue. Если вы используете SKAN 4 или пользовательский режим Custom, то диапазон корзины, связанной с событием и используемой для расчета skad_revenue, описывается в полях min_revenue и max_revenue. Вещественное число
SKAN Минимальное время после установки min_time
_post_install		 AF
  • В пользовательской конверсии: AppsFlyer рассчитывает время установки как время прихода постбэка - 36ч. - среднее (min_time_post_install + max_time_post_install). Однако, если CV=0, то среднее (min_time_post_install + max_time_post_install) считается равным 0.
  • В декодированной конверсии: min_time_post_install на один час меньше, чем задано в max_time_post_install, что равно hours_from_install, установленному вами в сопоставлении декодированных конверсий.
 Целое число
Доходы от рекламы Сеть монетизации monetization
_network		 API доходов от рекламы Сеть, отправляющая рекламное объявление Строка 1024
IAP
Подписка		 Чистый доход af_net_revenue API для чистого дохода Чистый доход, рассчитанный с учетом всех повлиявших причин. См. af_net_revenue_factors.  
IAP
Подписка		 Страна получения чистого дохода af_net_revenue
_country		 API для чистого дохода
  • Двухбуквенный код страны по ISO, в отношении которой применяется налог.
  • Пример: GB
  
IAP
Подписка		 Факторы чистого дохода af_net_revenue
_factors		 API для чистого дохода
  • Массив, представляющий все повлиявшие причины, которые дают сумму af_net_revenue.
  • Пример значения: store_commission
  
IAP
Подписка		 Почтовый индекс места получения чистого дохода af_net_revenue
_postal_code		 API для чистого дохода
  • Строка букв и/или цифр
  • Пример: L4J8E3
  
IAP
Подписка		 Административное подразделение получения чистого дохода af_net_revenue
_subdivision		 API для чистого дохода
  • В некоторых странах может быть дополнительно указан штат/муниципальное образование. Это обозначение соответствует кодам муниципальных образований по ISO 3166-2.
  • Включает код страны и код муниципального образования.
  • Пример: US-CA
  
IAP
Подписка		 Расчет налога на чистый доход af_net_revenue
_tax_exclusive		 API для чистого дохода
  • Логическое значение, true или false.
  • False обозначает, что налог включен в общий доход.
  • True обозначает, что налог добавлен к общему указанному доходу. Например, в США или Канаде, где цена по прейскуранту не включает в себя налог с продаж.
  
IAP
Подписка		 Название налога на чистый доход af_net_revenue
_tax_name		 API для чистого дохода
  • Название, появляющееся в счете клиента и описывающее конкретный тип налога.
  • Пример: Продажи, НДС, Федеральный налог на товары и услуги
  
IAP
Подписка		 Ставка налога на чистый доход af_net_revenue
_tax_rate		 API для чистого дохода
  • Число с количеством десятичных знаков до 4, отображающее собранный налог в процентах.
  • Пример: 7.25
  
Атрибуция Идентификатор учетной записи сети network
_account_id		 Ссылка ID аккаунта рекламодателя в рекламной сети Строка 100
Информация об устройстве OAID oaid SDK Идентификатор, который может быть сброшен пользователем, на некоторых устройствах Android, обычно альтернатива GAID До 40 символов
Информация об устройстве operator operator SDK Имя мобильного оператора, полученное из SIM MCCMNC. Доступно, если пользователь зарегистрирован в сети с помощью Android getNetworkOperatorName() Строка 50
IAP
Подписка		 Код заказа af_order_id Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Идентификатор заказа для транзакции
  • Только для Android
  
IAP
Подписка		 Идентификатор исходной транзакции af_original
_transaction_id		 Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Идентификатор исходной транзакции
  • Только для iOS
  
Атрибуция Original URL (Исходный URL-адрес) original_url Ссылка
  • UA: использованный URL для клика/показа. Если ссылка брендирована: поле заполняется на основании брендированной ссылки.
  • Ретаргетинг: содержит одно из следующих данных — ссылка ретаргетинга, данные о диплинкинге, пусто для SRN.
 Строка 10000 (URL)
Информация об устройстве Версия ОС os_version SDK Версия операционной системы устройства Строка 8
Атрибуция Партнер af_prt Ссылка Идентификатор агентства. Для SKAN может быть не заполнен. Строка
Доходы от рекламы Placement placement API доходов от рекламы Где в приложении отображается реклама Строка 1024
Информация об устройстве Платформа platform SDK Платформа устройства: iOS, Android или Windows Mobile Перечисление строка 12
Местонахождение устройства Почтовый индекс postal_code AF На основании IP-адреса, предоставленного SDK. Для SKAN С 30 августа 2021 года значение всегда null  Строка, до 10 симв.
SKAN Индекс последовательности постбэков skad_postback
_sequence_index		 iOS
  • Значение представляет собой окно SKAN, либо 0, либо 1, либо 2.
  • Для SKAN 3 значение равно 0
 Целое число
IAP
Подписка		 Идентификатор товара af_product_id Коннектора SDK AppsFlyer для измерения дохода от покупок Идентификатор продукта подписки  
IAP
Подписка		 Дата покупки af_purchase
_date_ms		 Коннектора SDK AppsFlyer для измерения дохода от покупок Дата покупки для внутреннего события с записанным ID продукта  
IAP Статус покупки af_purchase_state Коннектора SDK AppsFlyer для измерения дохода от покупок Возможные значения:
  • Куплено
  • Отменено
  • В ожидании
  
IAP
Подписка		 Токен покупки af_purchase
_token		 Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Токен покупки для транзакции
  • Только для Android
  
PBA Параметр запроса query_params Ссылка

Параметры запроса в URL-адресе перенаправления (после ?)
Пример: https://www.brandpitt.com/signin?utm_source=Google
&utm_term=shoes
&utm_campaign=cool
&c=summer
&af_siteid=publisher
&af_sub1=helloworld
&af_keyword=shoes

Если в URL-адресе нет параметров запроса, это поле имеет значение null

 Строка
IAP
Подписка		 Причина af_reason Коннектора SDK AppsFlyer для измерения дохода от покупок

В событиях, связанных с отменой или оттоком, это причина, по которой пользователь отменил событие или ушел. Возможные значения:

  • iOS:
    • cancel_intent
    • billing_issue
    • declined_price_increase
    • product_unavailable
  • Android:
    • Я недостаточно часто пользуюсь этой услугой
    • Технические проблемы
    • Причины, связанные с затратами
    • Я нашел приложение лучше
    • Другое
  • В событиях возобновления подписки это причина, по которой пользователь возобновил подписку. Возможные значения: Android: (paused and resumed) приостановлено и возобновлено
    disabled and enabled auto-renew (отключено и включено автопродление)
  • В событиях, связанных с возвратом средств: причина, по которой пользователь получил возврат. Возможные значения: iOS: 1: проблема с вашим приложением
    0: другая причина
  
SKAN Повторные загрузки skad
_redownload		 iOS Если true, приложение было загружено повторно Логическое значение
Атрибуция Окно повторного вовлечения af_reengagement
_window		 Ссылка
  • Ретаргетинг: период, в течение которого события можно атрибутировать ретаргетинговой кампании
  • Примечание: для ретаргетинговых кампаний поле не заполняется.
 Строка, до 3 симв.
IAP
Подписка		 ID транзакции возврата af_refunded
_transaction_ids		 Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Массив идентификаторов всех транзакций с возвратом
  • Только для iOS
  
Местонахождение устройства Регион Регион AF На основании IP-адреса, предоставленного SDK. Для SKAN определяется в соответствии с кодом страны country_code Строка 100
Protect360 Причина отказа rejected_reason AF Protect360: планируется прекращение поддержки. На данный момент содержит причину блокировки. Строка 100
Protect360 Значение причины отклонения rejected
_reason_value
В Data Locker: validation
_reason_value		 AF
  • Protect360: отображается действительный ассистент (медиа-источник) для перехваченных установок / внутренних событий приложения, обнаруженных после атрибуции. Он может иметь значение contributor[1-3](ассистент [1–3]) или organic (органический)
  • В Data Locker он отображается как validation_reason_value (значение причины проверки).
 Строка 100
Атрибуция Retargeting Conversion Type (Тип конверсии ретаргетинга) retargeting
_conversion_type		 AF
  • Привлечение пользователей (UA): повторная установка
  • Ретаргетинг: повторное вовлечение, реатрибуция
  • Планируется прекращение поддержки: это поле в будущем поддерживаться не будет. Для определения контекста конверсии используйте conversion_type и campaign_type.
 Перечисление 14 символов максимум
SKAN Прибыль skad_revenue iOS Сумма выручки от события в USD. Переменное число
Загрузка Версия SDK sdk_version SDK Версия SDK AppsFlyer. Строка 8
Доходы от рекламы Сегмент segment API доходов от рекламы Название сегмента рекламы Строка 1024
Атрибуция ID сайта af_siteid Ссылка Идентификатор издателя Строка 24
SKAN Окно измерения SKAN measurement
_window		 AF Продолжительность окна активности. По умолчанию 24 часа. Целое число
SKAN Режим SKAN skad_mode AF Режим измерения конверсий, используемый для декодирования постбэка iOS. Варианты:
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
 Строка
SKAN Идентификатор транзакции SKAN skad
_transaction_id		 iOS ID постбэка, предоставленный Apple Строка
SKAN Версия SKAN skad_version iOS Версия SKAN Строка
SKAN ID исходного приложения ad_network
_source_app_id (1)		 Рекламная сеть ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Основой для этих данных служит приложение издателя. Поле добавляется в отчеты, но не обязательно будет заполнено. Строка
SKAN ID исходного приложения skad_source
_app_id		 iOS
  • ID сайта — приложение, разместившее объявление.
  • Заполнение полей зависит от пороговых значений конфиденциальности.
 Строка
SKAN Домен источника skad_source
_domain		 iOS
  • Значение представляет собой источник атрибутируемой веб-рекламы.
  • Для SKAN 3 значение равно null.
 Строка
SKAN Идентификатор источника skad_source
_identifier		 iOS
  • Значение может иметь до 4 цифр.
  • Для SKAN 3 значение равно null.
 Строка
Местонахождение устройства Состояние state AF На основании IP-адреса, предоставленного SDK Строка 100
IAP
Подписка		 Магазин af_store Коннектора SDK AppsFlyer для измерения дохода от покупок Магазин приложений, в котором был приобретен продукт подписки  
IAP
Подписка		 Комиссия магазина store_commission API для чистого дохода
  • Рассчитанный процент комиссионных, которые магазин получает с купленного товара.
  • Отображается в виде десятичного числа.
  • Пример: 30
  
Атрибуция Страница продукта в магазине store_product
_page		 AF Настраиваемая страница продукта в Apple App Store, на которую был перенаправлен пользователь. Доступно: iOS 15+ Строка 100
Информация об устройстве Переустановка из магазина приложений store_reinstall SDK
  • Магазин приложений Apple определяет по идентификатору пользователя Apple, отнести ли пользователя, привлеченного Apple Search Ads, к повторной установке:
  • Новый пользователь: false
  • Повторная установка имеющимся пользователем: true
 Перечисление 5 символов булево
Атрибуция Sub Param [n] af_sub[n] (n=1-5) Ссылка Параметр заполняется рекламодателем в ссылке атрибуции Строка 100
Атрибуция ID субсайта af_sub_siteid Ссылка Идентификатор субиздателя Строка 50
Подписка Дата истечения подписки af_expires
_date_ms		   Срок действия текущего платежного цикла подписки  
Подписка Тип владения подпиской af_subscription
_ownership_type		 Коннектора SDK AppsFlyer для измерения дохода от покупок FAMILY_SHARED означает, что пользователь использует через общий семейный доступ. PURCHASED означает, что платящий пользователь совершил покупку.  
Подписка Тип периода подписки af_period_type Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Тип подписки или пробного периода.
  • Возможные значения: trial, intro, normal (пробный, вводный, обычный)
  
SKAN Временная отметка timestamp Рекламная сеть Время получения постбэка AppsFlyer.
Для Google Рекламы и Meta Ads это время, когда AppsFlyer получает данные из API Google и Meta Ads соответственно.		 Временная отметка
IAP
Подписка		 Идентификатор транзакции af_transaction_id Коннектора SDK AppsFlyer для измерения дохода от покупок
  • Идентификатор транзакции
  • Только для iOS
  
Информация об устройстве Агент пользователя user_agent Ссылка Агент пользователя URL-адреса/устройства Строка 1024
Информация об устройстве wifi wifi SDK Значение TRUE или FALSE Перечисление 5 символов булево
IAP   af_cancelation
_date_ms		 Коннектора SDK AppsFlyer для измерения дохода от покупок Дата отмены  
SKAN   did_win iOS Логическое значение
SKAN   event_uuid AF Уникальный случайный идентификатор, позволяющий партнерам идентифицировать дублирующиеся постбэки Строка
SKAN   source_app_id AF ID сайта. Приложение, разместившее объявление. Это поле идентично полю skad_source_app_id Строка