Краткий обзор. Отчеты 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.
-
push
- Обновление данных: См. Push API для данных SKAN.
-
Отчет Data Locker
-
Дата установки: Вычисляется по времени прибытия постбэка в AppsFlyer следующим образом:
-
Если для постбэков используется SKAN V4, формула даты установки такая: Дата установки = время прибытия постбэка - [аккумулированная длина окна] - [средняя задержка постбэка].
- Постбэк 1: дата установки = время прибытия постбэка - 48ч. - 36ч.
- Постбэк 2: дата установки = время прибытия постбэка - 168ч. - 84ч.
- Постбэк 3: дата установки = время прибытия постбэка - 840ч. - 84ч.
-
Если для постбэков используется SKAN V3, формула даты установки такая: Дата установки = время прибытия постбэка - 36ч. - [средний диапазон последней активности].
- По умолчанию [средний диапазон последней активности] составляет 12 часов.
- Если значение конверсии равно 0, средний диапазон последней активности устанавливается равным 0.
- Google самостоятельно оценивает время установки, а AppsFlyer использует это время. Примечание. Сообщение Google об установках может занять до 13 дней. Узнать больше
-
Если для постбэков используется SKAN V4, формула даты установки такая: Дата установки = время прибытия постбэка - [аккумулированная длина окна] - [средняя задержка постбэка].
Доступные типы отчетов:
- Постбэк устройства: 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, загрузил приложение впервые. Название темы в Data Locker: skad_installs |
|||||||||||||||||||||||
| Декодированное событие | повторные загрузки |
Установки приложений, которые не являются первыми установками SKAN сообщает redownload=true. Это означает, что пользователь, представленный через Apple ID, загрузил приложение не первый раз. Название темы в Data Locker: skad_redownloads |
|||||||||||||||||||||||
| Декодированное событие | Внутренние события приложений |
Внутренние события приложений Начиная с 21 июля 2021 года вносятся изменения в порядок предоставления сырых данных о событиях в приложении, как указано в таблицах. Количество записей о событиях в приложении зависит от настроек измерения. Скачать пример событий в приложении (CSV). Название темы в Data Locker: skad_inapps Действует для постбэков iOS, полученных начиная с 21 июля 2021 года:
Действует для постбэков iOS, полученных до 20 июля 2021 года:
|
|||||||||||||||||||||||
| Декодированное событие | Параметры рекламы SRN |
|
Типы форматов полей сырых данных
Форматы полей
| Название формата | Описание |
|---|---|
| Строка [n] | Максимальная длина строки. Обычно мы не применяем ограничения длины поля при получении данных, но превышающие данные могут быть обрезаны. |
| Строка времени |
Строка, имеющая формат, гггг-мм-дд чч:мм:сс. Например, 2019-09-17 00:09:25 |
| Перечисление [n] | Поля Enum (перечисление) могут содержать только определенные значения. Например, поле Валюта расходов содержит 3 символа и может содержать только определенные коды валют. |
| Временная отметка |
10-значная метка времени Unix. Пример: 4 августа 2020, 07:25 UTC переведено в |
| Логическое значение |
Значение поля может быть либо TRUE, либо FALSE.
|
| Целое число | Целое число |
| Число с плавающей запятой | Вещественное число с плавающей точкой, которое может иметь десятичную точку и значения после десятичной точки. |
Поля, доступные в отчетах по постбэкам и копиям постбэков
| Имя поля | Источник или начальная версия iOS SKAN | Описание | Формат | Доступно в копии постбэков |
|---|---|---|---|---|
| идентификатор_кампании_рекламной_сети | Рекламная сеть | Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer | строка | Нет |
|
ad_network_campaign _name |
Рекламная сеть |
Название кампании, сообщенное рекламной сетью в AppsFlyer.
|
строка | Нет |
| ad_network_timestamp | Рекламная сеть |
Время получения постбэка рекламной сетью. В случае Google Рекламы это время определяется по времени последнего клика, которое сообщает Google. |
Временная отметка | Нет |
| app_id (идентификатор приложения) | AppsFlyer: | Идентификатор приложения (приложение рекламодателя) с префиксом ID. | строка | Да |
| город | AppsFlyer: | С 30 августа 2021 года значение всегда null | строка | Нет |
| код_страны | Рекламная сеть | строка | Нет | |
| дма | С 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_версия | 2.0 | строка | Да | |
| временная метка | Рекламная сеть | Время, когда AppsFlyer получил постбэк SKAN. | Строка времени | Да |
| имя_рекламной_сети | Рекламная сеть | Название рекламной сети, сообщаемое рекламной сетью в AppsFlyer.
|
строка | Нет |
| ip |
IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк. Это поле заполняется, если рекламная сеть предоставляет нам этот адрес. Внимание! SDK не участвует в получении адреса. |
строка | Нет | |
| skad_app_id | 1.0 | строка | Нет | |
| идентификатор_приложения_источника | AppsFlyer: | ID сайта. Приложение, разместившее объявление. Это поле идентично полю skad_source_app_id | строка | Нет |
| идентификатор_набора_объявлений_рекламной_сети | Рекламная сеть | строка | Нет | |
| название_набора_объявлений_рекламной_сети | Рекламная сеть | строка | Нет | |
| название_рекламной_сети_рекламы | Рекламная сеть | строка | Нет | |
| идентификатор_рекламы_рекламной_сети | Рекламная сеть | строка | Нет | |
| выиграл_ли | 3.0 (iOS 14.6) | Используется для различения кампаний, которые способствовали установке или которым атрибутирована установка:
|
Логическое значение | Да |
| fidelity_type | 2.2 (iOS 14.5) |
Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом:
Не учитывайте значение поля, если версия SKAN старше 2.2. |
Целое число | Да |
| ad_network_source_app_id | Рекламная сеть | ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Приложение издателя дает основу для этих данных. | строка | Нет |
| канал_рекламной_сети | Рекламная сеть | строка | Нет | |
| af_prt | Рекламная сеть | строка | Нет | |
| skad_postback_sequence_index | 4.0 (iOS 16.2) |
|
Целое число | Да |
| skad_coarse_conversion_value |
4.0 (iOS 16.2)
|
|
строка | Да |
| skad_source_identifier | 4.0 (iOS 16.2) |
|
строка | Да |
| skad_source_domain | 4.0 (iOS 16.2) |
|
строка | Да |
| креатив_рекламной_сети | Рекламная сеть |
|
строка | Нет |
| ** Apple определяет, заполнено ли поле, используя механизм порога конфиденциальности | ||||
Поля, доступные в декодированных отчетах о событиях
| Имя поля | Источник | Описание | Формат | Включено в отчет о показателях рекламы SRN |
|---|---|---|---|---|
| идентификатор_кампании_рекламной_сети | Рекламная сеть | Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer | строка | Да |
| ad_network_campaign _name |
Рекламная сеть | Название кампании, сообщенное рекламной сетью в AppsFlyer | строка | Да |
| ad_network_timestamp | Рекламная сеть |
Время получения постбэка рекламной сетью В случае с Google Ads это поле не заполняется. |
Временная отметка (строка времени для отчета о показателях рекламы для SRN) |
Да |
| app_id (идентификатор приложения) | iOS. | ID приложения (приложение рекламодателя) | строка | Да |
| город | С 30 августа 2021 года значение всегда null | строка | Нет | |
| код_страны | Рекламная сеть | строка | Нет | |
| дма | С 30 августа 2021 года значение всегда null | строка | Нет | |
| имя_события | AppsFlyer: |
Имя события в приложении, настроенное в AppsFlyer. Для отчета SRN это имя события в приложении, настроенное в Meta Ads. |
строка | Да |
| event_uuid | AppsFlyer: | Уникальный случайный идентификатор, позволяющий партнерам идентифицировать дублирующиеся постбэки | строка | Нет |
| дата_установки | iOS. | Оценивается AppsFlyer на основе времени прибытия постбэка. | Строка времени | Нет |
| install_type | iOS. | Новые установки | строка | Нет |
| ip | iOS. |
IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк. Это поле заполняется, если рекламная сеть предоставляет нам этот адрес. Внимание! SDK не участвует в получении адреса. |
строка | Нет |
| медиа-источник | 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. Варианты:
|
строка | Нет |
| skad_redownload | iOS. | Если true, приложение было загружено повторно | Логическое значение | Нет |
| Строка (JSON) | iOS. | Сумма выручки от события в USD. | Число с плавающей запятой | Нет |
| skad_source_app_id | iOS. |
ID сайта — приложение, разместившее объявление. Заполнение полей зависит от пороговых значений конфиденциальности** |
строка | Нет |
| skad_transaction_id | iOS. | - | строка | Нет |
| skad_версия | iOS. | - | строка | Нет |
| временная метка | iOS. |
Время, когда AppsFlyer получил постбэк SKAN. Для Google Рекламы и Meta Ads это время, когда AppsFlyer получает данные из API Google и Meta Ads соответственно. |
Временная отметка (строка времени для отчета о показателях рекламы для SRN) |
Да |
| event_value | S2S |
Значение по умолчанию: null Содержит строку, задаваемую приложениями, указывающую на пользовательское декодирование. Рекламодатели употребляют это в своих системах. В AppsFlyer это не используется. |
Строка (JSON) | Нет |
| идентификатор_набора_объявлений_рекламной_сети | Рекламная сеть | строка | Да | |
| название_набора_объявлений_рекламной_сети | Рекламная сеть | строка | Да | |
| название_рекламной_сети_рекламы | Рекламная сеть | строка | Да | |
| идентификатор_рекламы_рекламной_сети | Рекламная сеть | строка | Да | |
| skad_did_win (1) | 3.0 (iOS 14.6) | Используется для различения кампаний, которые способствовали установке или которым атрибутирована установка:
|
Логическое значение | Нет |
| skad_fidelity_type (1) | 2.2 (iOS 14.5) |
Различает варианты представления объявлений, влияющие на атрибуцию. Указывается с помощью значений 0 и 1 следующим образом:
Не учитывайте значение поля, если версия SKAN старше 2.2. |
Целое число | Да |
| ad_network_source_app_id (1) | Рекламная сеть | ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Основой для этих данных служит приложение издателя. | строка | Нет |
| ad_network_channel (1) | Рекламная сеть | строка | Нет | |
| af_prt (1) | Рекламная сеть | строка | Нет | |
| min_revenue | AppsFlyer: | См. примечание (4) | Вещественное число | Нет |
| макс_выручка | 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) |
|
Целое число | Да |
| skad_coarse_conversion_value |
4.0 (iOS 16.2) |
|
строка | Да |
| skad_source_identifier | 4.0 (iOS 16.2) |
|
строка | Да |
| skad_source_domain | 4.0 (iOS 16.2) |
|
строка | Да |
| креатив_рекламной_сети | Рекламная сеть |
|
строка | Нет |
|
** Apple определяет, заполнено ли поле, используя механизм порога конфиденциальности (1) Начиная со 2 июня 2021 года, поле добавляется в отчеты, но не обязательно заполняется. (3) Чтобы определить, сколько раз пользователь выполнил то или иное событие в приложении, используйте формулу (4) Доход всегда указывается в поле (5)
|
||||
Дополнительные сведения
Ограничения и особенности
| Специфика | Показы |
|---|---|
| Доступ рекламной сети | Рекламным сетям отправляются постбэки |
| Доступ агентств | Не доступно |
| Прозрачность агентства | Переменное число |
| Time Zone (Часовой пояс) | UTC |
| Валюта | USD (доллар США) |
| органические данные | На основе данных о событиях SDK. Например, метрики органических установок рассчитываются следующим образом: все установки, данные по которым переданы SDK, минус неорганические установки, данные о которых переданы SKAN. |
| Неорганические данные | На основе постбэков SKAN |
| Актуальность данных | Ежедневно. Время SKAN означает, что iOS сообщает об установке через 24-48 часов после закрытия окна. |
| Исторические данные | Ограничено окном доступности Data Locker. |
| Доступ пользователей аккаунта | Доступно. Согласно разрешениям аккаунта |
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.