Словарь полей в отчетах по необработанным данным (Спецификация необработанных данных V5.0)

Краткий обзор: Cловарь полей данных (спецификация необработанных данных) содержит поля, которые включаются в отчеты по необработанным данным.

Поля дат в файлах формата CSV. Поля дат в CSV-файлах имеют формат гггг-мм-дд. При открытии CSV-файла в Excel поля даты форматируются в соответствии с настройками даты и времени на компьютере. Обязательно выберите соответствующий формат отображения даты в Excel

Поля необработанных данных на платформе 

О словаре данных

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

  • API Name (Имя API): имя, которое используют Push API и Data Locker
  • Display Name (Отображаемое имя): имя поля, которое используется в отчетах — например, CSV, Pull API,
  • Источник :место, откуда получено содержимое поля, а именно:
  • Описание
    • Некоторые поля имеют разные значения в зависимости от контекста события. Значение присваивается в результате привлечения пользователя или кампании ретаргетинга.
  • Контекст: Если поле доступно в конкретных отчетах или имеет немного другое значение в зависимости от контекста отчета, то это указывается здесь следующим образом:
    • Ретаргетинг. Эти поля имеют особое значение в контексте кампании ретаргетинга.
    • Data Locker: доступно только в Data Locker.
    • Protect360: доступно только в отчетах Protect360
    • Поля, добавленные после декабря 2019 года, дата добавления поля
  • Тип и длина поля:
    • String (Строка): максимальная длина строки. Обычно мы не применяем ограничения длины поля при получении данных, но превышающие данные могут быть обрезаны. Не превышайте установленную длину поля.
    • Дата и время: 
      • Строка в формате yyyy-mm-dd hh:mm:ss. Например, 2019-09-17 00:09:25 Часовой пояс, используемый для отображения данных, зависит от способа доставки данных, а именно:
        • Страница экспорта данных: часовой пояс, выбранный приложением.
        • Push API: у полей времени есть опция selected_time_zone, которая означает часовой пояс для конкретного приложения. 
        • Mater API: по умолчанию — часовой пояс, который можно выбрать для приложения.
        • Data Locker: UTC
      • Внимание: При открытии файлов CSV в Excel это поле отображается в соответствии с региональными настройками по умолчанию. Вы можете изменить формат отображения в Excel. Чтобы посмотреть значение поля без форматирования, откройте файл в редакторе.
      • Push API:
        • Для полей меток времени в UTC формат таков: yyyy-mm-dd hh:mm:ss.sssНапример, 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

Список полей

Словарь полей данных (спецификация необработанных данных)

Имя параметра API

Имя поля

Источник

Описание


Context

Тип поля

af_ad

Реклама

Ссылка

Также включена информация Facebook

 

Строка 100

af_ad_id

ID рекламы.

Ссылка

Также включена информация Facebook

 

Строка 24

af_ad_type

Тип рекламы

Ссылка

Тип рекламы (баннер, нижний колонтитул и т. д.)

 

Строка 24

af_adset

Блок рекламы

Ссылка

Также включена информация Facebook

 

Строка 100

af_adset_id

ID блока рекламы

Ссылка

 Adset ID

 

Строка 24

af_c_id

ID кампании

Ссылка

Кампания   Строка 24

af_channel

Канал

Ссылка

Канал медиаисточника, например: YouTube для Google, Instagram для Facebook и т. п.   Динамическое перечисление строка 20

af_cost_
currency*

Валюта расходов

Ссылка

Валюта затрат (список)   Перечисление 3 символа

af_cost_model

Модель затрат

Ссылка

CPC/CPI/CPM/другое. В настоящее время все расходы считаются по CPI независимо от этого значения.

 

Строка 20

af_cost_value

Величина затрат

Ссылка

Затраты в исходной валюте. Допустимый формат: до 4 знаков после десятичного разделителя. Пример: 320.5095   Строка 20

af_keywords

Ключевые слова

Ссылка

Получено из рекламной сети

 

Строка 100

af_attribution_
lookback

Attribution Lookback (Ретроспективная атрибуция) Ссылка

UA: Окно ретроспективного обзора для атрибуции по кликам. Продолжительность этого окна соответствует максимальному значению CTIT (время от клика до установки) для новых пользователей, которые атрибутируются источнику, отображающему рекламу или ссылку. Внимание: соответствующий параметр в ссылке атрибуции — af_click_lookback

Ретаргетинг: Атрибуция ретаргетинга по клику

 Ретаргетинг

 

 

До 3 символов

af_prt

Партнер

Ссылка

Агентство или PMD

 

Строка 50

af_reengagement
_window

Окно повторного вовлечения

Ссылка

Окно атрибуции после повторного вовлечения — это период, в течение которого событие можно атрибутировать ретаргетинговой кампании.

Ограничение: Для ретаргетинговых кампаний поле не заполняется.

Ретаргетинг До 3 символов

af_siteid

ID сайта

Ссылка

Идентификатор издателя   Строка 24

af_sub_siteid

ID субсайта

Ссылка

Идентификатор субиздателя

 

Строка 50

af_sub1

Cубпараметр 1

Ссылка

Дополнительный настраиваемый параметр, задаваемый рекламодателем   Строка 100

af_sub2

Cубпараметр 2

Ссылка

Дополнительный настраиваемый параметр, задаваемый рекламодателем   Строка 100

af_sub3

Cубпараметр 3

Ссылка

Дополнительный настраиваемый параметр, задаваемый рекламодателем   Строка 100

af_sub4

Cубпараметр 4

Ссылка

Дополнительный настраиваемый параметр, задаваемый рекламодателем   Строка 100

af_sub5

Cубпараметр 5

Ссылка

Дополнительный настраиваемый параметр, задаваемый рекламодателем   Строка 100

campaign

Кампания

Ссылка

Название кампании

 

Строка 100

is_retargeting

Is Retargeting (Ретаргетинг)

Ссылка

UA: FALSE

Ретаргетинг: TRUE для конверсий и событий ретаргетинга

Ретаргетинг

Перечисление 5 символов булево

media_source

Медиа-источник

Ссылка

Медиа-источник, которому атрибутируется событие   

Строка 50

original_url

Original URL (Исходный URL-адрес)

Ссылка

UA: использованный URL для клика/показа

Ретаргетинг: содержит одно из следующих данных — ссылка ретаргетинга, данные о диплинкинге, пусто для SRN.

Ретаргетинг Строка 2083 (URL)

user_agent

Агент пользователя

Ссылка

Агент пользователя для URL-адреса   Строка 200

advertising_id

ID рекламы

SDK

Идентификатор рекламы — это уникальный анонимный идентификатор для рекламы, предоставляемый сервисами Google Play (GAID), который может сбросить пользователь.   Строка 40

android_id

Android ID

SDK

Идентификатор устройства Android   Строка 20

amazon_aid

Идентификатор Amazon Fire

SDK

Рекламный идентификатор Amazon Fire TV

 

Строка 40

app_id Идентификатор приложения

SDK

Идентификатор приложения:
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
 

для iOS: строка 12

для Android: строка 100

app_name

Имя приложения

SDK

Имя приложения   Строка 100

app_version

Версия приложения

SDK

Версия приложения   До 8 символов

appsflyer_id

Идентификатор AppsFlyer ID

SDK

UA: уникальный идентификатор установки Уникальный идентификатор, генерируемый AppsFlyer при первом запуске приложения. Идентификатор является уникальным для каждого приложения и каждой установки. Это означает, что если приложение было удалено, а затем установлено снова, то назначается новый идентификатор. См. также идентификатор клиента.

Ретаргетинг:
повторная атрибуция: назначается новый идентификатор, идентификатор повторного взаимодействия не изменяется 

Ретаргетинг

для iOS: строка 24

для Android: строка 33

bundle_id

Идентификатор пакета

SDK

Идентификатор одного приложения или группы приложений (для iOS)   Строка 100

carrier

carrier

SDK

Имя оператора, предоставленное Android getSimCarrierIdName   Строка 50

country_code

Код страны

SDK

Код страны в соответствии с ISO 3166 (alpha-2) Пример: US, CN.

Для Великобритании используется код UK, а не GB. 

  Перечисление строка 2

custom_data

Пользовательские данные

SDK

  • Данные, которые отправляются с помощью SDK.
  • См. Android и iOS.
  Строка 1024

customer_user_id

Идентификатор клиента

SDK

Уникальный идентификатор, установленный владельцем приложения.    Строка 100
deeplink_url

Deep Link URL (URL-адрес глубинной ссылки)

SDK

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

Доступно с января 2020 года

Строка 1024

device_category

Категория устройства

SDK

  • Возможные значения: phone, tablet и др.
  • Поддержка SDK Android начиная с версии 4.8.8.
  Строка 20

device_type

Тип устройства

SDK

Коммерческое наименование модели устройства. Например: SM-GM284 или iPhone7

 

Строка 100

device_download_
time

Время скачивания на устройство

SDK

Время завершения скачивания приложения, по часам устройства (Android, iOS). 

Доступно в Data Locker с октября 2019 года. Доступно везде с января 2020 года Дата/Время

event_name

Имя события

SDK

Имя произошедшего события.   Строка 100

event_revenue

Выручка от события

SDK

Выручка в определенной для выручки событий валюте   Строка 20

event_revenue_

currency*

Валюта выручки от событий

SDK

Валюта дохода от события, переданная в SDK.   Строка 20

event_time

Event Time (Время события)

SDK

UA: время, когда произошло событие

В ретаргетинге оно совпадает со временем установки.

Ретаргетинг Дата/Время

event_value

Значение события

SDK

Значение события.

Примечание: Не отправляйте более 1000 символов из SDK, так как в зависимости от типа отчета мы можем их урезать.

  Строка 1000

idfa

IDFA

SDK

iOS: Идентификатор рекламодателя   До 40 символов

idfv

IDFV

SDK

Идентификатор уровня приложения для определенного поставщика   До 40 символов

imei

imei

SDK

IMEI устройства для Android и iOS   До 14 символов

install_app_store

Магазин приложений, использованный для установки

Ссылка

Обозначает магазин Android, из которого было загружено приложение (подробнее)   Строка 50

install_time

Install Time (Время установки)

SDK

UA: Время первого запуска после установки.

Ретаргетинг: первый запуск приложения после повторного вовлечения или реатрибуции

Ретаргетинг

Дата/Время

ip

IP

SDK

IP-адреса   Строка 15 для IP V4

is_lat

Is LAT

SDK

Ограничить отслеживание рекламы (LAT). Если задано значение true, пользователь включил LAT на своем устройстве, и AppsFlyer не может получить идентификатор рекламодателя.  Начиная с января 2020 года Перечисление 5 символов булево

language

language

SDK

Язык устройства   Строка 20

oaid

OAID

SDK

Android: Идентификатор рекламодателя доступен на некоторых устройствах в качестве альтернативы или в дополнение к идентификатору Android. Начиная с января 2020 года До 40 символов

operator

operator

SDK

Имя мобильного оператора, полученное из SIM MCCMNC, доступно, если пользователь зарегистрирован в сети с помощью Android getNetworkOperatorName   Строка 50

os_version

Версия ОС

SDK

Версия операционной системы.   Строка 8

platform

Платформа

SDK

Возможные значения: iOS, Android или Windows Mobile.

 

Перечисление строка 8

sdk_version

Версия SDK

SDK

Версия SDK   Строка 8

wifi

wifi

SDK

true / false

 

Перечисление 5 символов булево

store_reinstall

Переустановка из Apple Store

SDK

Для трафика, получаемого с помощью Apple Search Ads, использование идентификатора пользователя Apple определяет, о чем идет речь:

  • False: новый пользователь
  • True: переустановка существующим пользователем
Начиная с января 2020 года Перечисление 5 символов булево

amazon_aid

Идентификатор Amazon Fire

SDK

Рекламный идентификатор Amazon

  Строка 100

city

city

AF

Наиболее детальное местоположение пользователя на основе IP-адреса устройства. Как правило, значение содержит название города, но также может включать районы, округа, то есть более точные данные.

 

Строка 100

attributed_touch_

time

Атрибутированное время касания

AF

UA: Время атрибутированного нами касания.

Ретаргетинг: время вовлечения в кампании ретаргетинга

Ретаргетинг

Дата/Время

attributed_touch_

Тип

Attributed Touch Type (Атрибутированный тип касания)

AF

Тип взаимодействия, атрибутированный AppsFlyer. Возможные значения: click/impression/TV/pre-installed.

Повторное вовлечение: клик, показ (только реатрибуция)

Ретаргетинг

Перечисление 10 символов максимум

contributor_1_

af_prt

Партнер ассистента 1

AF

Агентство или PMD —
всегда преобразуется в нижний регистр

 

Строка 50

contributor_1_

campaign

Кампания ассистента 1

AF

Кампания ассистента   Строка 100

contributor_1_

match_type

Тип содействия ассистента 1

AF

Возможные значения:

gp_referrer, id_matching, srn

  Строка 50

contributor_1_

media_source

Исходная точка взаимодействия ассистента 1

AF

Исходная точка взаимодействия ассистента   Строка 50

contributor_1_

touch_time

Время касания ассистента 1

AF

Время взаимодействия.

 

Дата/Время

contributor_1_

touch_type

Тип касания ассистента 1

AF

Тип взаимодействия.

click, impression, TV

 

Перечисление 10 символов максимум

contributor_2_af_
prt

Партнер ассистента 2

AF

Агентство или PMD   Строка 50

contributor_2_

campaign

Кампания ассистента 2

AF

Кампания ассистента   Строка 100

contributor_2_

match_type

Тип содействия ассистента 2

AF

Возможные значения:

gp_referrer/id_matching/srn

  Строка 50

contributor_2_

media_source

Исходная точка взаимодействия ассистента 2

AF

Исходная точка взаимодействия ассистента   Строка 50

contributor_2_

touch_time

Время касания ассистента 2

AF

Время взаимодействия.   Дата/Время

contributor_2_

touch_type

Тип касания ассистента 2

AF

Тип взаимодействия.

(нажатие, показ, ТВ)

 

Перечисление 10 символов максимум

contributor_3_af_
prt

Партнер ассистента 3

AF

Агентство или PMD   Строка 50

contributor_3_

campaign

Кампания ассистента 3

AF

Кампания ассистента   Строка 100

contributor_3_

match_type

Тип содействия ассистента 3

AF

Возможные значения:

gp_referrer/id_matching/srn

  Строка 50

contributor_3_

media_source

Исходная точка взаимодействия ассистента 3

AF

Исходная точка взаимодействия ассистента   Строка 50

contributor_3_

touch_time

Время касания ассистента 3

AF

Время взаимодействия.   Дата/Время

contributor_3_

touch_type

Тип касания ассистента 3

AF

Тип взаимодействия.

(нажатие, показ, ТВ)

 

Перечисление 10 символов максимум

dma

DMA

AF

Назначенный район охвата — географические участки территории США, на которых просмотры ТВ измеряются компанией Nielsen.   Строка 10

event_revenue_usd

event_revenue_
selected_currency

 

Выручка от события в USD

Доход от события предпочитаемый

Доход от события XXX

AF

Сумма дохода. Выбор валюты зависит от используемого инструмента.

Предпочитаемый / выбранный означает валюту, установленную для приложения в его настройках.

Data Locker: USD

Страница экспорта: выбранная валюта 

Pull API варианты: USD или выбранная валюта (использует) &currency=preferred. 

Push API: всегда включает оба поля, USD и выбранную валюту

 

  Строка 20

event_source

Источник события

AF

Источник события — SDK или S2S   Перечисление 3 символа максимум

http_referrer

Источник ссылки HTTP

AF

Адрес веб-страницы с URL-адресом нажатия AppsFlyer. С помощью источника ссылки можно определить, откуда выполнен запрос.   Строка 2083 символа максимум

is_primary_
attribution

Is Primary Attribution (Основная атрибуция)

AF

UA: True

Ретаргетинг: В окне повторного вовлечения можно атрибутировать событие и первоначальному медиа-источнику (до повторного вовлечения), и медиа-источнику повторного вовлечения. Пока событие находится в интервале повторного вовлечения. Исходная точка взаимодействия будет иметь значение FALSE (не первичная атрибуция). Медиа-источник повторного вовлечения будет TRUE.

Ретаргетинг

Перечисление 5 символов максимум

is_receipt_
validated

Проверено ли получение

AF

значение True/False/Null, если реализовано в SDK, в ином случае пустое

 

Перечисление 5 символов максимум

match_type

Тип сопоставления

AF

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

gp_referrer (строка источника ссылки Google Play)

id_matching

Fingerprinting

srn (сеть с автоматическим предоставлением данных)

tv (ТВ-атрибуция)

preinstall (предустановка)

  Строка 50

postal_code

Почтовый индекс

AF

На основе IP-адреса SDK   Строка, до 10 симв.

Регион

Регион

AF

На основе IP-адреса из SDK

 

Строка 100

retargeting_

conversion_type

Retargeting Conversion Type (Тип конверсии ретаргетинга)

AF

UA: Н/Д

Ретаргетинг: повторное вовлечение, реатрибуция

Ретаргетинг

 

Перечисление 14 символов максимум

state

Состояние

AF

На основе IP-адреса из SDK

 

Строка 100

keyword_id

ID ключевого слова

Ссылка

Идентификатор ключевого слова, возвращенный рекламной сетью. Это идентификатор ключевого слова af_keyword   Строка 100

keyword_match_
type

Тип сопоставления ключевых слов

AF

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

Примечание: этот параметр для кампаний поиска возвращают только сети Google Ads и Apple Search Ads.

  Строка 100

network_
account_id

Идентификатор учетной записи сети

AF

Идентификатор учетной записи рекламодателя у партнера

 

Строка 100

rejected_reason_

значение

Причина отказа

AF

В отчетах о результатах применения правил проверки таргетинга : идентификатор набора правил, по которому был получен отказ

Проверка таргетинга

Строка 100

rejected_reason Причина отказа AF В отчетах о результатах применения правил проверки таргетинга — тип правила, по которому был получен отказ. Например, install-validation правило (правило проверки установки) Проверка таргетинга Строка 100
blocked_reason Причина блокировки AF В Protect360 — причина, по которой установка была заблокирована. Например: install_hijacking, боты Protect360  Строка 100
blocked_sub_
reason
Подпричина блокировки AF

В Protect 360 — частная причина, по которой установка была заблокирована. Пример: Причина: install_hijacking. Частная причина: перехват реферера, CTCT_anomalies

Protect360  Строка 100

blocked_reason_

значение

Значение причины блокировки AF Дополнительная информация по блокировке. Например: ID сайта. Protect360  Строка 100

blocked_reason_

rule

Правило, которое вызвало блокировку AF Это поле будет не рекомендовано для использования. До этого момента поле всегда имеет значение null.   Будет не рекомендованным для использования

gp_click_time

Время нажатия Google Play

Поле Google Play

Время загрузки страницы приложения в Google Play после нажатия на рекламу.

Источник времени: Google API.

Доступно в SDK Android версии 4.8.5 и выше.

Пример использования: сравнивая время install_time с временем gp_click, можно узнать, сколько проходит времени от начала загрузки приложения пользователем до момента открытия приложения. 

  Временная отметка

gp_install_begin

Время начала установки Google Play

Поле Google Play

Время начала установки. 
Источник времени: устройство пользователя. Подразумевается время, которое отображается на устройстве. 

Внимание:

Доступно в SDK Android версии 4.8.5 и выше.

  Временная отметка

gp_referrer

Google Play Referrer

Поле Google Play

URL-адрес источника ссылки установленного пакета.

Доступно в SDK Android версии 4.8.5 и выше.

  Строка 1024

gp_broadcast_
referrer

Инициатор GP Broadcast

Поле Google Play

Инициатор Google Play Broadcast

  Строка 1024

Коды валют.

Пример записи необработанных данных о событии внутри приложения

Пример файла события внутри приложения в формате CSV

Пример записи необработанных данных о событии внутри приложения
Имя поля значение
wifi true
Реклама 101548
Блок рекламы 18212447
ID рекламы 452c96af-7dc8-4d4c-9579-example
Идентификатор приложения abc.example
Имя приложения Пример: # 1 приложение для онлайн-шоппинга & предложения
Версия приложения 4.0.11
Идентификатор AppsFlyer ID 1570515992667-612279933540example
Атрибутированное время касания 2019-10-08 10:21.31
Attributed Touch Type (Атрибутированный тип касания) Клик
Attribution Lookback (Ретроспективная атрибуция) 7 дней
Идентификатор пакета abc.example
Кампания abc_ad_network_9999999
carrier example-carrier
city Johannesburg
Модель затрат CPI
Величина затрат 1900-01-00 07:12.00
Код страны ZA
Идентификатор клиента abc123xyz
Категория устройства телефон
Время скачивания на устройство 2019-10-07 19:52.23
Тип устройства vivo-vivo 1727
DMA Нет
Имя события af_purchase
Выручка от события 100
Валюта выручки от событий ZAR
Выручка от события в USD 13
Источник события SDK
Event Time (Время события) 2020-02-23 20:40.17
Значение события {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Поле значение
Install Time (Время установки) 2019-10-08 13:26.41
IP 192.0.2.1.1
Is Primary Attribution (Основная атрибуция) FALSE
Is Retargeting (Ретаргетинг) FALSE
language English
Тип сопоставления id_matching
Медиа-источник abc_ad_network_int
operator example-carrier
Версия ОС 9
Платформа Android;
Почтовый индекс 8100
Регион AF 
Версия SDK v5.1.1
ID сайта abc.example_1099548_35281
Состояние GAU
Cубпараметр 1 99999
ID субсайта 99999
Агент пользователя Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
Была ли эта статья полезной?