Data field dictionary V5.0 (raw data specification)

At a glance: The data field dictionary contains the fields found in raw data reports.

Raw data is a premium feature and is delivered using:

  • CSV-файл: чтобы скачать, перейдите в Reports (Отчеты) > Export Data (Экспорт данных)
  • Pull API
  • Data locker: поместите файлы в свое хранилище данных. 
  • Push API: Attribution raw data in real-time 

Дополнительная информация о необработанных данных:

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

Data field dictionary 

The dictionary columns are: 

  • API Name: field name used by Push API
  • Display Name: field name found in reports (CSV, Data Locker, Pull API, etc) 
  • Источник :место, откуда получено содержимое поля, а именно:
  • Описание
  • Context: Where a field is available in specific reports/or has a slightly different meaning depending on the report context then this is indicated here as follows:
    • Retargeting: These fields, have a specific meaning in the context of a retargeting campaign.
    • Data Locker: Available only in Data Locker.
    • Protect360: Available only in Protect360 reports
  • Тип и длина поля:
    • String: The maximum length of the string.  We don't usually enforce field length limitations on receipt of the data but the data may be truncated thereafter. Don't exceed the field length specification
    • Дата / Время: Строка в формате yyyy-mm-dd hh:mm:ss (гггг-мм-дд чч:мм:сс). Например, 2019-09-17 00:09:25. Внимание: При открытии CSV-файлов в Excel это поле отображается в соответствии с региональными установками по умолчанию. Вы можете изменить формат отображения в Excel. Чтобы увидеть значение без форматирования, откройте файл в редакторе
    • Перечисление n символов: Поля Enum (перечисление) могут содержать только определенные значения. Например, поле Валюта расходов содержит 3 символа и может содержать только определенные коды валют.
    • Перечисление 5 символов булево: поле может иметь только значение TRUE либо FALSE
Data field dictionary V5.0 (raw data specification)

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

Имя поля

Источник

Описание

Context

Тип поля

af_ad

ad

Ссылка

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

 

Строка 100

af_ad_id

ID рекламы.

Ссылка

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

 

Строка 24

af_ad_type

Тип рекламы

Ссылка

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

 

Строка 24

af_adset

Блок рекламы

Ссылка

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

 

Строка 100

af_adset_id

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 (Ретроспективная атрибуция) Ссылка Окно ретроспективного обзора для атрибуции по кликам. Продолжительность этого окна соответствует максимальному значению 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

Кампания

Ссылка

Название кампании для особых интеграций (например с Facebook) возвращается через API, а не в ссылке.

 

Строка 100

is_retargeting

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

Ссылка

true / false

Ретаргетинг

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

media_source

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

Ссылка

В ссылку будут включены обычные сети (кроме Facebook).

 

Строка 50

original_url

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

Ссылка

URL-адрес нажатия/показа. Пример: http://your.url.com. Ретаргетинг Строка 2083 (URL)

user_agent

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

Ссылка

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

advertising_id

ID рекламы

SDK

Идентификатор рекламы — это уникальный анонимный идентификатор для рекламы, предоставляемый сервисами Google Play, который может сбросить пользователь.   Строка 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

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

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

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

bundle_id

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

SDK

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

carrier

carrier

SDK

Название оператора   Строка 50

country_code

Код страны

SDK

Код страны. Пример: GB, US   Перечисление строка 2

custom_data

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

SDK

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

customer_user_id

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

SDK

Устанавливается владельцем приложения с помощью SDK для использования в качестве уникального идентификатора пользователя.    Строка 100

device_category

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

SDK

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

device_type

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

SDK

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

 

Строка 100

device_download_time

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

SDK

  • Время завершения загрузки приложения с использованием часов устройства
  • Поле было добавлено 28 октября 2019
Data Locker Дата/Время

event_name

Имя события

SDK

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

event_revenue

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

SDK

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

event_revenue_

currency*

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

SDK

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

event_time

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

SDK

Время, когда произошло событие. Ретаргетинг Дата/Время

event_value

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

SDK

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

Note: Don't send more than 1000 characters from the SDK as depending on report type we may truncate these. 

  Строка 1000

idfa

IDFA

SDK

Для iOS — идентификатор устройства для рекламодателей   До 40 символов

idfv

IDFV

SDK

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

imei

imei

SDK

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

install_app_store

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

SDK

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

install_time

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

SDK

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

Ретаргетинг

Дата/Время

ip

IP

SDK

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

language

language

SDK

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

operator

operator

SDK

Название оператора   Строка 50

os_version

Версия ОС

SDK

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

platform

Платформа

SDK

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

 

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

sdk_version

Версия SDK

SDK

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

wifi

wifi

SDK

true / false

 

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

gp_broadcast_

Referrer

Инициатор GP Broadcast

SDK

  • Инициатор Google Play Broadcast
  • Для органических установок - Play

 

 

 

Строка 100

amazon_aid

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

 

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

  Строка 100

city

city

AF

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

 

Строка 100

attributed_touch_

time

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

AF

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

Ретаргетинг

Дата/Время

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

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

AF

Размер выручки от события в долларах США или предпочитаемой валюте, которую можно задать в настройках приложения.   Строка 20

event_source

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

AF

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

http_referrer

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

AF

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

is_primary_attribution

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

AF

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

Ретаргетинг

Перечисление 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

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

Ретаргетинг

 

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

state

Состояние

AF

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

 

Строка 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

Коды валют.

Была ли эта статья полезной?

Статьи в этом разделе