Отчеты SKAN по сырым данным

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

Краткий обзор. Отчеты SKAN по сырым данным содержат данные, созданные после преобразования и декодирования постбэков, полученных AppsFlyer от iOS, а также сырые постбэки SKAN. Данные доступны через Data Locker и Push API. Если ваш план подписки включает сырые данные, подписка на Data Locker не требуется. 

Отчеты SKAN по сырым данным

Принципы: 

  • Данные предоставляет:
    • Data Locker
      • Примечание! Доступно для аккаунтов, имеющих подписку на сырые данные. Т. е. подписка на Data Locker не требуется. Если в настоящее время вы не используете Data Locker, пользователь с правами администратора должен настроить Data Locker и включить отчеты SKAN. Для этого перейдите в раздел Интеграция > Data Locker. Выберите отчеты SKAN. 
      • Обновление данных: ежедневно. Данные содержатся в папке h=23 за дату получения постбэка в AppsFlyer. Например, если постбэк получен в понедельник, он будет обработан после окончания дня. Обработка завершится во вторник к 12:00 UTC, и данные запишутся в папку понедельника Monday h=23. 
    • Push API
  • Дата установки: Вычисляется по времени прибытия постбэка в AppsFlyer следующим образом:
    • Если для постбэков используется SKAN V4, формула даты установки такая: Дата установки = время прибытия постбэка - [аккумулированная длина окна] - [средняя задержка постбэка].
      • Постбэк 1: дата установки = время прибытия постбэка - 48ч. - 36ч.
      • Постбэк 2: дата установки = время прибытия постбэка - 168ч. - 84ч.
      • Постбэк 3: дата установки = время прибытия постбэка - 840ч. - 84ч.
    • Если для постбэков используется SKAN V3, формула даты установки такая: Дата установки = время прибытия постбэка - 36ч. - [средний диапазон последней активности]. 
      • По умолчанию [средний диапазон последней активности] составляет 12 часов.
      • Если значение конверсии равно 0, средний диапазон последней активности устанавливается равным 0.
    • Google самостоятельно оценивает время установки, а AppsFlyer использует это время. Примечание. Сообщение Google об установках может занять до 13 дней. Узнать больше

Доступные типы отчетов:

  • Постбэк устройства: 1 постбэк от устройства на каждую установку или повторную загрузку, полученную на устройстве iOS.
  • Сырые данные SKAN:
    • AppsFlyer декодирует и переводит постбэк устройства в записи сырых данных.
    • При каждом постбэке создается запись об установке или повторной загрузке и записи о событиях в приложении.
    • Количество записей о событиях в приложении зависит от значения конверсии (CV) следующим образом:
      • CV = 0, пусто или null: Записи о событиях в приложении не создаются. 
      • Диапазон CV:
        • 1-63: Для SKAN 3 и SKAN 4 окно 1 точное значение, это количество записей о событиях в приложении, в зависимости от ваших настроек измерения.
        • Низкий, средний или высокий: Для приблизительных значений SKAN 4 это количество записей о событиях в приложении, в зависимости от настроек измерения.

Почему некоторые поля пустые? Это происходит по любой из следующих причин:

  • Необязательные поля обогащения, такие как campaign_name, ad_network_campaign_id, ip, которые рекламная сеть не предоставила.
  • Apple скрывает эти данные из-за политики пороговых значений Apple. Такие поля, как source_app_id, skad_campaign_id, skad_conversion_value. 

Формат и содержание отчетов SKAN по сырым данным

Типы отчетов по сырым данным

Тип отчета Название отчета Описание
Постбэк Постбэки

Постбэки, отправленные iOS в рекламную сеть. После обогащения данных рекламной сетью постбэк направляется в AppsFlyer. Скачать пример постбэков (CSV).

Примечание: при did_win=false постбэки не отправляются.

Название темы в Data Locker: skad_postbacks
Постбэк Копия постбэков (напрямую от Apple)

Постбэки, отправленные iOS непосредственно в AppsFlyer.

Доступны начиная с iOS 15+ и требуют от рекламодателя настройки приложения, чтобы отправлять постбэки от основной сети (т.е. о конверсии) в AppsFlyer. Скачать пример копии постбэков (CSV).

Примечание: Эта тема содержит постбэки только от основной сети (принесшей конверсию).

Название темы в Data Locker: skad_postbacks_copy
Декодированное событие Установки

Первые установки приложений

SKAN сообщает redownload=false. Это означает, что пользователь, представленный через Apple ID, загрузил приложение впервые.
Скачать пример установок (CSV).

Название темы в Data Locker: skad_installs
Декодированное событие повторные загрузки

Установки приложений, которые не являются первыми установками

SKAN сообщает redownload=true. Это означает, что пользователь, представленный через Apple ID, загрузил приложение не первый раз.
Этот отчет имеет такую же структуру, как и отчет по установкам.

Название темы в Data Locker: skad_redownloads
Декодированное событие Внутренние события приложений

Внутренние события приложений

Начиная с 21 июля 2021 года вносятся изменения в порядок предоставления сырых данных о событиях в приложении, как указано в таблицах. 

Количество записей о событиях в приложении зависит от настроек измерения. 

Скачать пример событий в приложении (CSV).

Название темы в Data Locker: skad_inapps

Действует для постбэков iOS, полученных начиная с 21 июля 2021 года:

Тип измерения Описание
Прибыль
  • Доход от данного пользователя. Если доход > 0, запись содержит поля skad_revenue и event_name.
  • Поля min_revenue и max_revenue заполняются вашими пользовательскими значениями диапазона конверсии.  
Конверсия в приложении и события воронки
  • Запись для каждого выполненного уникального события конверсии. Поле event_name заполняется соответствующим образом. Если никаких событий не происходит, запись не производится.
  • События конверсии имеют min_event_counter = 0 и max_event_counter = 1. 
Взаимодействие с приложением  Чтобы определить, сколько раз пользователь выполнил то или иное событие в приложении, используйте формулу[округление (min_event_counter + max_event_counter) / 2]

Действует для постбэков iOS, полученных до 20 июля 2021 года:

Тип измерения Количество записей Описание
Прибыль 0-1 Если доход > 0, запись содержит поля skad_revenue и event_name.
Конверсии 

0-6

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

0-63

 Количество записей представляет собой количество раз, когда пользователь выполнял событие вовлечения. Если пользователь не вовлекался, записи отсутствуют.
Настройка 0-без ограничений В соответствии с вашей пользовательской схемой конверсии. 
Декодированное событие Параметры рекламы SRN
  • Отчет содержит события Meta Ads с детализацией до кампаний, групп объявлений и отдельных объявлений. Каждая строка отчета может быть как событием установки, так и событием в приложении.
  • Детализация на уровне групп объявлений и отдельных объявлений не включена в постбэки SKAN из Meta Ads. Эти данные уникальны для данного отчета и не отображаются на дэшборде SKAN, в API эффективности и других отчетах SKAN Data Locker.
  • Отчет без схемы. Параметры Data Locker по выбору полей не применяются.
  • Рекомендация: Не объединяйте и не сравнивайте данные из этого отчета с другими отчетами SKAN, поскольку между этим отчетом, который использует данные, декодированные SRN, и другими отчетами, которые используют данные, декодированные AppsFlyer, могут быть расхождения. Эти расхождения могут быть вызваны разницей в часовых поясах, разницей в схемах SRN или неправильным сопоставлением внутренних событий с CV в интеграции SRN.
  • Скачайте пример рекламных показателей SRN (CSV).

Название темы в Data Locker: skad_srn_advertising_dimensions

Типы форматов полей сырых данных

Форматы полей

Название формата Описание
Строка [n]

Максимальная длина строки. Обычно мы не применяем ограничения длины поля при получении данных, но превышающие данные могут быть обрезаны.
Строка времени

Строка, имеющая формат, гггг-мм-дд чч:мм:сс. Например, 2019-09-17 00:09:25 
Перечисление [n] Поля Enum (перечисление) могут содержать только определенные значения. Например, поле Валюта расходов содержит 3 символа и может содержать только определенные коды валют.
Временная отметка

10-значная метка времени Unix. Пример:

4 августа 2020, 07:25 UTC переведено в "timestamp": "1596525944"
Логическое значение

Значение поля может быть либо TRUE, либо FALSE.
Целое число

Целое число
Переменное число

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

Поля, доступные в отчетах по постбэкам и копиям постбэков

Имя поля Источник или начальная версия iOS SKAN Описание Формат Доступно в копии постбэков 

ad_network_campaign_id

 Рекламная сеть Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer Строка Нет

ad_network_campaign

_name

 Рекламная сеть

Название кампании, сообщенное рекламной сетью в AppsFlyer.

 

 Строка Нет

ad_network_timestamp

 Рекламная сеть

Время получения постбэка рекламной сетью.

В случае Google Рекламы это время определяется по времени последнего клика, которое сообщает Google.

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

app_id

 AppsFlyer Идентификатор приложения (приложение рекламодателя) с префиксом ID. Строка Да

city

 AppsFlyer С 30 августа 2021 года значение всегда null  Строка Нет

country_code

 Рекламная сеть   Строка Нет
dma   С 30 августа 2021 года значение всегда null  Строка Нет

postal_code

   С 30 августа 2021 года значение всегда null   Строка Нет

Регион

 AppsFlyer Согласно сообщаемому коду страны country_code Строка Нет

skad_ad_network_id

 1.0 

Некоторые SRN не сообщают свой идентификатор, и поле остается пустым. Например, Twitter. 

 Строка

Да 

skad_attribution_signature

 1.0   Строка Да
skad_campaign_id 1.0 Идентификатор кампании, используемый для публикации объявления. Диапазон: 0–100 Строка Да
skad_conversion_value 2.0 

Значение конверсии, сообщаемое iOS. Диапазон 0–63.

Если null, iOS не заполнила поле**. 

 Целое число Да
skad_redownload 2,0 Если true, приложение было загружено повторно

Логическое значение

Да
skad_source_app_id 2,0

ID сайта. Приложение, разместившее объявление. Это поле идентично source_app_id.

Заполнение полей зависит от пороговых значений конфиденциальности**

 Строка Да
skad_transaction_id 1.0   Строка Да
skad_version 2,0   Строка Да
timestamp Рекламная сеть

Время, когда AppsFlyer получил постбэк SKAN. 

 Строка времени Да
ad_network_name Рекламная сеть

Название рекламной сети, сообщаемое рекламной сетью в AppsFlyer. 

  • Если это поле пустое, значит, рекламная сеть не заполнила (не смогла заполнить) его.
  • Название рекламной сети можно определить с помощью skad_ad_network_id. Для этого используйте эту таблицу. 
 Строка Нет
ip  

IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк.

Это поле заполняется, если рекламная сеть предоставляет нам этот адрес.

Внимание! SDK не участвует в получении адреса.

 Строка Нет

skad_app_id

 1.0   Строка Нет

source_app_id

 AppsFlyer ID сайта. Приложение, разместившее объявление. Это поле идентично полю skad_source_app_id Строка Нет

ad_network_adset_id

 Рекламная сеть   Строка Нет

ad_network_adset_name

 Рекламная сеть   Строка Нет

ad_network_ad_name

 Рекламная сеть   Строка Нет

ad_network_ad_id

 Рекламная сеть   Строка Нет

did_win

 3.0 (iOS 14.6)

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

  • Если true, установка атрибутирована этой кампании.
  • Если false, то кампания считается ассистентом в установке, но она не включается ни в какие дэшборды или отчеты SKAN.
  • Если null, то iOS не заполнила поле из-за устаревшей версии iOS или SKAdNetwork.
 Логическое значение Да

fidelity_type

 2.2 (iOS 14.5)

Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом: 

  • Просмотры рекламы (0)
  • Реклама с рендерингом StoreKit (1)

Не учитывайте значение поля, если версия SKAN старше 2.2.

 Целое число Да

ad_network_source_app_id

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

ad_network_channel

 Рекламная сеть   Строка Нет

af_prt

 Рекламная сеть   Строка Нет

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • Значение представляет собой окно SKAN, либо0, либо1, либо2.
  • Для SKAN 3 значение равно0
 Целое число Да
skad_coarse_conversion_value

4.0 (iOS 16.2)

 
  • Значение может быть низкое, среднее или высокое.
  • Для SKAN 3 значение равно null.
 Строка Да
skad_source_identifier 4.0 (iOS 16.2)
  • Значение может иметь до 4 цифр.
  • Для SKAN 3 значение равно null. 
 Строка Да
skad_source_domain 4.0 (iOS 16.2)
  • Значение представляет собой источник атрибутируемой веб-рекламы.
  • Для SKAN 3 значение равно null.
 Строка Да
ad_network_creative Рекламная сеть
  • Значение основано на обогащении данных, полученных от рекламной сети.
  • Для SKAN 3 значение равно null
 Строка Нет

** Apple определяет, заполнено ли поле, используя механизм порога конфиденциальности 

 

Поля, доступные в декодированных отчетах о событиях

Имя поля Источник Описание Формат Включено в отчет о показателях рекламы SRN
ad_network_campaign_id Рекламная сеть Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer Строка Да
ad_network_campaign
_name		 Рекламная сеть Название кампании, сообщенное рекламной сетью в AppsFlyer Строка Да
ad_network_timestamp Рекламная сеть

Время получения постбэка рекламной сетью

В случае с Google Ads это поле не заполняется. 

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

(строка времени для отчета о показателях рекламы для SRN)

 Да
app_id iOS. ID приложения (приложение рекламодателя) Строка Да
city   С 30 августа 2021 года значение всегда null  Строка Нет
country_code Рекламная сеть   Строка Нет
dma   С 30 августа 2021 года значение всегда null  Строка Нет
event_name AppsFlyer

Имя события в приложении, настроенное в AppsFlyer.

Для отчета SRN это имя события в приложении, настроенное в Meta Ads.

 Строка Да
event_uuid AppsFlyer Уникальный случайный идентификатор, позволяющий партнерам идентифицировать дублирующиеся постбэки Строка Нет
install_date iOS. Оценивается AppsFlyer на основе времени прибытия постбэка. Строка времени Нет
install_type iOS. Новые установки Строка Нет
ip iOS.

IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк.

Это поле заполняется, если рекламная сеть предоставляет нам этот адрес.

Внимание! SDK не участвует в получении адреса. 

 Строка Нет
media_source iOS. Рекламная сеть, атрибутированная с помощью имен сетей в AppsFlyer Строка Да
postal_code   С 30 августа 2021 года значение всегда null  Строка Нет
Регион AppsFlyer Определяется в соответствии с кодом страны country_code Строка Нет
skad_ad_network_id iOS. Идентификатор рекламной сети, куда был отправлен постбэк Строка Нет
skad_ambiguous_event AppsFlyer Если true, то постбэк iOS был получен в течение первых 72 часов после того, как рекламодатель изменил настройки SKAN на дэшборде. Из-за различных таймеров, используемых SKAN, AppsFlyer не может точно сопоставить событие. Логическое значение Нет
skad_attribution_signature iOS.   Строка Нет
skad_campaign_id iOS. Идентификатор кампании, используемый для публикации объявления. Диапазон: 0–100 Целое число Нет
skad_conversion_value iOS.

Значение конверсии, сообщаемое iOS. Диапазон 0–63.

Если null, iOS не заполнила поле**

 Целое число Нет
skad_mode AppsFlyer

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

  • custom_decode
  • выручка
  • события
  • skan4
  • custom_encode
  • Вовлечение
 Строка Нет
skad_redownload iOS. Если true, приложение было загружено повторно Логическое значение Нет
skad_revenue iOS. Сумма выручки от события в USD. Переменное число Нет
skad_source_app_id iOS.

ID сайта — приложение, разместившее объявление.

Заполнение полей зависит от пороговых значений конфиденциальности**

 Строка Нет
skad_transaction_id iOS. - Строка Нет
skad_version iOS. - Строка Нет
timestamp iOS.

Время, когда AppsFlyer получил постбэк SKAN.

Для Google Рекламы и Meta Ads это время, когда AppsFlyer получает данные из API Google и Meta Ads соответственно.

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

(строка времени для отчета о показателях рекламы для SRN)

 Да
event_value S2S

Значение по умолчанию: null

Содержит строку, задаваемую приложениями, указывающую на пользовательское декодирование.

Рекламодатели употребляют это в своих системах. В AppsFlyer это не используется. 

 String (JSON) Нет

ad_network_adset_id

 Рекламная сеть   Строка Да

ad_network_adset_name

 Рекламная сеть   Строка Да

ad_network_ad_name

 Рекламная сеть   Строка Да

ad_network_ad_id

 Рекламная сеть

 

 Строка Да

skad_did_win (1)

 3.0 (iOS 14.6)

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

  • Если true, установка атрибутирована этой кампании.
  • Если false, то кампания считается ассистентом в установке, но она не включается ни в какие дэшборды или отчеты SKAN.
  • Если null, то iOS не заполнила поле из-за устаревшей версии iOS или SKAdNetwork.
 Логическое значение Нет

skad_fidelity_type (1)

 2.2 (iOS 14.5)

Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом: 

  • Просмотры рекламы (0)
  • Реклама с рендерингом StoreKit (1)

Не учитывайте значение поля, если версия SKAN старше 2.2.

 Целое число Да

ad_network_source_app_id (1)

 Рекламная сеть ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Основой для этих данных служит приложение издателя. Строка Нет

ad_network_channel (1)

 Рекламная сеть   Строка Нет

af_prt (1)

 Рекламная сеть   Строка Нет

min_revenue 

 AppsFlyer См. примечание (4) Вещественное число Нет

max_revenue 

 AppsFlyer См. примечание (4) Вещественное число Нет

event_revenue

 AppsFlyer

Формула: [сумма значений для конкретного события в USD] / [Количество событий, произошедших в конкретный день]

 Переменное число Да

min_event_counter

 AppsFlyer Используется для подсчета количества раз, когда пользователь выполняет то или иное событие. См. примечание (3) Целое число Нет

max_event_counter

 AppsFlyer См. примечание (3) Целое число Нет

min_time_post_install

 AppsFlyer См. примечание (5) Целое число Нет

max_time_post_install

 AppsFlyer См. примечание (5) Целое число Нет

af_attribution_flag

 AppsFlyer

Когда включен механизм единого источника истины (SSOT): Если true, установка была атрибутирована и AppsFlyer, и SKAN. Если false, установка не была атрибутирована AppsFlyer. Если значение skad_conversion_value равно null, флаг будет true или false (на основе моделирования).

 Логическое значение Нет

measurement_window

 AppsFlyer Продолжительность окна активности. По умолчанию 24 часа.  Целое число Нет

Интервал

 AppsFlyer Интервалы окна активности.  Целое число Нет

user_agent

 AppsFlyer Агент пользователя устройства Строка Нет

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • Значение представляет собой окно SKAN, либо0, либо1, либо2.
  • Для SKAN 3 значение равно0
 Целое число Да
skad_coarse_conversion_value

 

4.0 (iOS 16.2)
  • Значение может быть низкое, среднее или высокое.
  • Для SKAN 3 значение равно null.
 Строка Да
skad_source_identifier 4.0 (iOS 16.2)
  • Значение может иметь до 4 цифр.
  • Для SKAN 3 значение равно null. 
 Строка Да
skad_source_domain 4.0 (iOS 16.2)
  • Значение представляет собой источник атрибутируемой веб-рекламы.
  • Для SKAN 3 значение равно null.
 Строка Да
ad_network_creative Рекламная сеть
  • Значение основано на обогащении данных, полученных от рекламной сети.
  • Для SKAN 3 значение равно null
 Строка Нет

** Apple определяет, заполнено ли поле, используя механизм порога конфиденциальности

(1) Начиная со 2 июня 2021 года, поле добавляется в отчеты, но не обязательно заполняется.

(3) Чтобы определить, сколько раз пользователь выполнил то или иное событие в приложении, используйте формулу [округление (min_event_counter + max_event_counter) / 2]. Примечание!  Вы должны округлить до ближайшего целого числа.
Пример:
A. Если min = 0 и max = 1, среднее равно 0,5; округление дает результат 1.
B. Если min = 5 и max = 10, среднее равно 7,5; округление дает результат 8.

(4) Доход всегда указывается в поле skad_revenue. Если вы используете SKAN 4 или пользовательский режим Custom mode, то диапазон корзины, связанной с событием и используемой для расчета skad_revenue, описывается в полях min_revenue и max_revenue.

(5)

  • В пользовательской конверсии: 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, установленному вами в сопоставлении декодированных конверсий. 

 

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

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

Специфика Заметки 
Доступ рекламной сети Рекламным сетям отправляются постбэки
Доступ агентств Не доступно
Прозрачность агентства —
Time Zone (Часовой пояс) UTC
Валюта  USD
органические данные На основе данных о событиях SDK. Например, метрики органических установок рассчитываются следующим образом: все установки, данные по которым переданы SDK, минус неорганические установки, данные о которых переданы SKAN.
Неорганические данные На основе постбэков SKAN
Актуальность данных

Ежедневно. Время SKAN означает, что iOS сообщает об установке через 24-48 часов после закрытия окна.
Исторические данные

Ограничено окном доступности Data Locker. 
Доступ пользователей аккаунта Доступно. Согласно разрешениям аккаунта

 См. также