Определения

• Окно измерения SKAN: актуально для SKAN 4+. Есть 3 временных периода (окна), в течение которых измеряется активность пользователя после установки:
  • Окно 1: 1-2 дня
  • Окно 2: 3-7 дней
  • Окно 3: 8-35 дней
  • Три окна измеряют три различных, не пересекающихся периода после установки. То есть, окно 2 измеряет дни 3-7 после установки, а не дни 0-7.
• Окно активности: актуально для SKAN 3 и ниже. Имеет заданную продолжительность, по умолчанию 24 часа, начиная с первого открытия приложения. Если вы используете SKAN 4+, но пользовательские устройства или рекламные сети еще не поддерживают SKAN 4, окно активности составляет 48 часов.
• Значение конверсии (CV): мера качества пользователя, о которой сообщается в постбэках, отправляемых iOS по завершении окон SKAN 4 или, для SKAN 3 и ниже, по завершении окна активности. CV автоматически определяются SDK AppsFlyer. Если вы хотите задать CV вручную, используйте Декодировать и загрузите свой файл сопоставления.
  • Для SKAN 4+ есть как точные, так и приблизительные значения конверсии.
    
• Биты в значении конверсии: количество CV, необходимых для сопоставления вашей настройки. Чем больше компонентов и элементов измерения вы выберете, тем больше требуется битов в значении конверсии. Каждый выбранный диапазон или элемент настройки расходует биты. (И каждая дополнительная единица настройки, включенная в один компонент, расходует биты по экспоненте!) Примеры максимального использования CV.
• Единый источник истины (SSOT): Механизм, чтобы сигнализировать, что пользователь был атрибутирован SKAN и другим методом сопоставления. Флаг используется, чтобы исключить дублирование данных об установке в сырых данных SKAN и рассчитать реальные показатели эффективности.
• Компоненты измерения:
  
  • Доход: измеряет полученный доход
  • Внутреннее событие приложения: измеряет конверсии (количество уникальных пользователей, выполнивших событие),
    интеракции (сколько раз событие было выполнено, т.е. частоту события) или и то, и другое.
  • Воронка: измеряет количество событий в приложении на основе списка последовательных событий в воронке. Если пользователь выполнил какое-либо событие воронки, считается, что он выполнил и все предшествовавшие ему события.
  • Приоритет: компонент, который содержит доход, внутреннее событие или оба эти параметра.
  • Predict: использует передовые алгоритмы машинного обучения для обеспечения точного прогнозирования успеха кампании на основе LTV. Прогнозируемые KPI на уровне пользователей (включая прогнозируемый доход и удержание) кодируются и передаются в SKAN как единое значение конверсии, которое SKAN затем сообщает в виде постбэка вместе с идентификатором кампании и источником атрибуции.  

Принципы

• Только админ: только администратор может сохранить настройки Conversion Studio. Пользователи аккаунта могут только просматривать настройки. 
• В каждый момент времени активен только один режим.
• Для заданного режима AppsFlyer сопоставляет комбинации, определенные вашими настройками, с CV. Вы можете просмотреть и скачать таблицу сопоставления.
• В приложении AppsFlyer устанавливает CV после каждого измеримого действия пользователя, используя режим измерения, активный при первом запуске приложения пользователем.
• iOS учитывает Apple Crowd Anonymity перед заполнением CV в постбэке.
• Действия пользователя, происходящие после окончания окна, не учитываются.
• Дэшборд и отчеты SKAN:

  • Представление и метрики на дэшборде SKAN зависят от режима и конфигурации.

  • Представление обновляется ежедневно и зависит от режима, активного в полночь по UTC. Обновленное представление будет доступно с 05:00 UTC. 

  • В SKAN 4, режимах Custom и Decode (Пользовательский и Декодирование) органические данные по событиям в приложении и общей выручке недоступны. 

Принципы S2S

Отчеты об измеряемых действиях можно получить с помощью межсерверного (S2S) API. Для каждого режима обратите внимание на следующее:

• SKAN 4 и режим Custom: S2S всегда включен.
• Decode: S2S не подходит для передачи данных и поэтому недоступен. В этом режиме AppsFlyer не задает CV.
• Режимы дохода, конверсии и интеракций: перед отправкой событий необходимо включить запись событий S2S.

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

Если вы переходите на SKAN 4 с предыдущего режима SKAN, ваше текущее сопоставление схемы переносится для точной конфигурации окна 1. AppsFlyer автоматически сопоставляет для вас приблизительные значения для окон 1-3.

Чтобы вручную установить SKAN 4, поэкспериментируйте с различными параметрами. Когда вы вносите изменения, биты в значении конверсии обновляются. Оптимизируйте настройки, чтобы собирать наиболее ценные для вас данные без превышения количества битов. См. раздел Расчет битов в значении конверсии.

Примечание. Если вы переходите на SKAN 4 с предыдущего режима SKAN, ваше текущее сопоставление схемы переносится для точной конфигурации и AppsFlyer автоматически сопоставляет для вас приблизительные значения. А если вы только начали использовать SKAN, AppsFlyer предоставляет начальное сопоставление по умолчанию.

Чтобы вручную установить значения конверсии в Conversion Studio, используя режим SKAN 4:

1. На дэшборде AppsFlyer перейдите в раздел Конфигурации > SKAN Conversion Studio.
2. Откройте дополнительные параметры (⋮) и убедитесь, что Измерение SKAN включено. Внимание! Если оно выключено, SDK не вызывает такие функции iOS SKAN, как registerAppForAdNetworkAttribution, updateConversionValue.
3. Выберите режим измерения SKAN 4.0.
4. Нажмите Продолжить.
   Откроются настройки для Окна 1 (1-2 дня) точного CV.
5. [Необязательно] Включите Единый источник истины (SSOT).
   Механизм SSOT сигнализирует об установках, об атрибуции которых сообщается более чем одним методом сопоставления, и дедуплицирует данные. Подробнее
   
6. Нажмите + Добавить измерение, чтобы добавить различные компоненты измерения.
   В следующих разделах подробно описаны параметры настройки и компоненты. Используйте их в качестве руководства, когда будете экспериментировать с различными настройками измерений SKAN:
   • Прибыль
   • Внутреннее событие приложения
   • Воронка
   • Приоритет
   • Predict
7. Нажмите Приблизительное и повторите Шаги 6-7, чтобы установить приблизительное CV для Окна 1 (1-2 дня).
   Примечание:
   • Доступны только компоненты измерения доходов и событий в приложении.
   • Низкое CV должно быть сессией пользователя, чтобы убедиться, что постбэк отправлен.
8. [Необязательно] Включите опцию Заблокировать окно и задайте условие (либо время, либо приблизительное значение конверсии) для блокировки окна SKAN раньше, чем по умолчанию. Узнать больше
9. Нажмите Окно 2 (3-7 дней) и повторите шаги 6-8 для установки CV для окна 2.
   Примечание:
   • Доступны только компоненты измерения доходов и событий в приложении.
   • [Рекомендуется] Низкое CV должно быть сессией пользователя.
10. Нажмите Окно 3 (8-35 дней) и повторите шаги 6-8 для установки CV для окна 3.
    Примечание:
    • Доступны только компоненты измерения доходов и событий в приложении.
    • [Рекомендуется] Низкое CV должно быть сессией пользователя.
11. Нажмите Сохранить.
    
12. Проверьте, что сопоставление постбэков о внутренних событиях от вашего партнера соответствует настроенным вами событиям.

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

Чтобы установить режим Custom, поэкспериментируйте с различными параметрами. Когда вы вносите изменения, биты в значении конверсии обновляются. Оптимизируйте настройки, чтобы собирать наиболее ценные для вас данные без превышения количества битов. См. раздел Расчет битов в значении конверсии.

Чтобы вручную установить значения конверсии в Conversion Studio, используя режим Custom:

1. На дэшборде AppsFlyer перейдите в раздел Конфигурации > SKAN Conversion Studio.
2. Откройте дополнительные параметры (⋮) и убедитесь, что Измерение SKAN включено. Внимание! Если оно выключено, SDK не вызывает такие функции iOS SKAN, как registerAppForAdNetworkAttribution, updateConversionValue.
3. Выберите режим измерения Custom.
4. Нажмите Продолжить.
   
5. [Необязательно] Включите Единый источник истины (SSOT).
   Механизм SSOT сигнализирует об установках, об атрибуции которых сообщается более чем одним методом сопоставления, и дедуплицирует данные. Подробнее
   
6. Нажмите + Добавить измерение, чтобы добавить различные компоненты измерения.
   В следующих разделах подробно описаны параметры настройки и компоненты. Используйте их в качестве руководства, когда будете экспериментировать с различными настройками измерений SKAN:
   • Прибыль
   • Внутреннее событие приложения
   • Воронка
   • Приоритет
   • Predict
7. Установите продолжительность окна активности (12 часов – 63 дня), в течение которого вы хотите измерять активность пользователей.
   Таймер активности по умолчанию позволяет установить окно на 24-72 часа. А в настройках по умолчанию Интервал можно установить 12 или 24 часа. Используйте Настраиваемый период, чтобы расширить окно активности до 63 дней и установить более длительные интервалы.
8. Нажмите Сохранить.
   
9. Проверьте, что сопоставление постбэков о внутренних событиях от вашего партнера соответствует настроенным вами событиям.

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

• • Прибыль
  • Конверсия
  • Вовлечение

По мере того, как вы вносите изменения в настройки режима, обновляется показатель Биты в значении конверсии. Оптимизируйте настройки для сбора наиболее ценных для вас данных без превышения количества бит. См. Расчет бит в значении конверсии.

Внимание!

• Измерения в фиксированном режиме проводятся для 24-часового окна активности, начиная с первого открытия приложения. 
• Если вы хотите отправлять события с помощью S2S, вы должны явно включить SKAN S2S.

Чтобы вручную установить значения конверсии в Conversion Studio, используя фиксированный режим:

1. На дэшборде AppsFlyer перейдите в раздел Конфигурации > SKAN Conversion Studio.
2. Откройте дополнительные параметры (⋮) и:
   • Проверьте, что измерение SKAN включено. Внимание! Если оно выключено, SDK не вызывает такие функции iOS SKAN, как registerAppForAdNetworkAttribution, updateConversionValue.
   • [Необязательно] Включите отправку событий через S2S. Параметр доступен, если выбран режим доход, конверсия или интеракция.
3. Выберите фиксированный режим измерения.
4. Следуйте информации и инструкциям в следующей таблице для выбранного фиксированного режима измерений.
5. Нажмите Сохранить.
6. Проверьте, что сопоставление постбэков о внутренних событиях от вашего партнера соответствует настроенным вами событиям.

Измерение в фиксированном режиме

Создайте свое сопоставление CV с событиями и самостоятельно задайте CV в приложении. Используйте этот вариант, если не можете интегрировать SDK AppsFlyer в свое приложение.

Чтобы использовать декодирование:

1. На дэшборде AppsFlyer перейдите в раздел Конфигурации > SKAN Conversion Studio.
2. Откройте дополнительные параметры (⋮) и:
   • Проверьте, что измерение SKAN включено. Внимание! Если оно выключено, SDK не вызывает такие функции iOS SKAN, как registerAppForAdNetworkAttribution, updateConversionValue.
   • Загрузите свой файл сопоставления для режима Decode
3. Нажмите Сохранить.
4. Проверьте, что сопоставление постбэков о внутренних событиях от вашего партнера соответствует настроенным вами событиям.

С помощью компонента измерения приоритета, являющегося частью режима Custom, можно ранжировать действия на пути пользователя в приложении на основе вашей бизнес-логики, чтобы измерения с высоким приоритетом перевешивали измерения с низким приоритетом. Это позволяет вам выбирать, что измерять на каждом этапе воронки конверсии.

Каждый приоритет (максимум 63) может содержать доход, внутреннее событие или оба эти параметра. Когда пользователь выполняет события в приложении, AppsFlyer определяет, какой приоритет соответствует действиям пользователя, и соответствующим образом устанавливает CV.

Для простоты понимания давайте сравним использование режима Custom с компонентом приоритет и без него. Без приоритета AppsFlyer сопоставляет все возможные комбинации измерений с CV. Тогда как с приоритетом с CV сопоставляются только явно заданные вами комбинации измерений.

Приоритет подробно разбирается в этой статье.

Принципы приоритета

• Можно задать 1–63 приоритета. Доступное количество зависит от вашего окна активности и настроек единого источника правды.
• Приоритет 1 всегда имеет наивысший приоритет. Приоритет с наибольшим порядковым номером имеет самый низкий приоритет.
• Приоритет содержит доход, внутреннее событие или оба эти компонента. Каждый отдельный приоритет может содержать несколько внутренних событий и потоки дохода.
• Воронка недоступна в компоненте приоритета. Чтобы измерять конверсию пользователей в воронке, задайте в нем несколько внутренних событий приложения.
• Чтобы использовать компонент измерения приоритета, нельзя настраивать другие компоненты, такие как события в приложении или доход.

Чтобы установить измерение с использованием приоритета:

1. В AppsFlyer перейдите в SKAN Conversion Studio.
2. Выберите Custom (Настраиваемый), нажмите Continue (Далее). 
3. При необходимости нажмите Delete (Удалить), чтобы удалить текущие настройки.
4. Click + Add measurement (Добавить измерение).Выберите Priority (Приоритет).
   Отобразится приоритет 1.
   

   

5. Выберите компонент измерения из:
   • Прибыль
   • Внутреннее событие приложения
6. Заполните поля, следуя инструкциям на экране.
   • Обратите внимание, что приоритет может содержать доход, внутреннее событие или оба эти параметра.
   • Значения диапазонов частоты событий и дохода должны быть возрастающими (увеличиваться) и непрерывными. Например, следующие диапазоны увеличиваются и являются непрерывными: 1-5, 5-8, 8-10 и так далее. Данный диапазон может быть использован более одного раза (повторно), если во второй раз он используется как часть уникальной комбинации и является тем же диапазоном, что и последний приоритет с диапазоном. Например, 1-5, 1-5 + добавить в корзину.
7. Click Validate (Подтвердить).
   Появится сообщение Priority is valid (Приоритет действителен). В противном случае скорректируйте приоритет, прежде чем продолжить.
8. Произведите одно из следующих действий:
   • Чтобы добавить приоритет, нажмите + Add priority. Текущий приоритет 1 смещается вниз и становится приоритетом 2. Выполните настройку приоритета, как описано выше.
   • Чтобы удалить приоритет, нажмите … > Delete.
   • Чтобы изменить уровень приоритета, нажмите Опции (⋮) и выберите Change order (Изменить порядок) или Make lowest priority (Установить самый низкий приоритет).
   • Чтобы продублировать приоритет, нажмите Опции (⋮) и выберите Duplicate (Дублировать).
   • Нажмите Save (Сохранить) для завершения настройки.

Примечание. Функция блокировки окна актуальна только для SKAN 4 и выше.

Внимание:

• Окно активности актуально только для SKAN 3 и ниже (имеются в виду режим Custom и фиксированный режим).
• Если вы используете SKAN 4+, но пользовательские устройства или рекламные сети еще не поддерживают SKAN 4, окно активности составляет 48 часов.

• Просмотрите события, сопоставленные с CV, выбрав CV. Сопоставленные события отображаются под таблицей.
• Скачайте таблицу сопоставления CV в формате CSV. Нажмите Скачать файл сопоставления.
• Получите сопоставление CV, используя API SKAN для схемы CV для рекламодателей. 

Столбцы в CSV-файле сопоставления

Как объяснялось ранее, максимальное количество доступных значений конверсии — 64. По следующей формуле можно вычислить, сколько доступных значений конверсии использует режим.

(activity time duration in hours / interval size in hours) * 
(number of revenue ranges + 1 ) * 
(number of in-app event ranges + 1 ) * 
(number of steps in a funnel + 1)

Настройте формулу, чтобы включить все компоненты измерения.

Пример 1

Пример 2

Пример 3

Пример 4

В приложении для шопинга рекламодатель хочет сосредоточиться на измерении:

• Действий неплатящих пользователей
• Дохода от платящих пользователей

При этом рекламодатель использует CV для более точной регистрации дохода. Эти требования к измерениям преобразуются в набор приоритетов для измерений, как указано в следующей таблице.

Рассмотрим:

• Самый высокий приоритет всегда под номером 1. Примечание! Номера приоритетов не сопоставляются напрямую с CV. Сопоставление CV отображается в пользовательском интерфейсе.
• Максимальное количество приоритетов — 63. Фактическое количество зависит от окна активности и от того, включен ли единый источник истины.
• Каждый приоритет содержит либо диапазон дохода, либо диапазон частоты внутренних событий, либо и то и другое.
• Значения диапазона: нижнее значение границы не включается в диапазон, но верхнее значение включается. Например, диапазон $5-$10 не включает значение 5, но включает 10.

Пример настройки приоритетов измерения

В таблице ниже представлены сценарии пути пользователя. Каждый сценарий содержит список действий, выполненных пользователем на пути, и приоритет, определенный AppsFlyer.

В таблице:

• Несколько действий разделяются с помощью символа >
• Значение в скобках () является приоритетом, определяемым AppsFlyer после завершения действия пользователя. На основе приоритета AppsFlyer обновляет CV в приложении.

Сценарии пути пользователя

Пример A: измерение дохода

Пример B: измерение конверсии

Пример C: измерение интеракций

Если у вас много приложений, для которых нужны одинаковые конфигурации значений конверсии SKAN, разработка схемы для каждого приложения отдельно в пользовательском интерфейсе Conversion Studio может занять много времени и быть сложной. Чтобы сэкономить время и усилия, вы можете один раз настроить схему SKAN в пользовательском интерфейсе, а затем использовать API для SKAN Conversion Studio для использования этой же схемы в нескольких приложениях. Примечание. API поддерживает только схемы, настроенные в пользовательском интерфейсе с использованием SKAN 4 или пользовательских режимов измерения (и в этих режимах компонент измерения Predict не поддерживается).

Чтобы использовать API для SKAN Conversion Studio:

1. Получите токен API. Получить токен должен админ.
2. Дайте разработчику токен API, который будет использоваться в заголовке аутентификации.
3. Предоставьте разработчикам идентификаторы приложений:
   • Приложение, для которого в пользовательском интерфейсе настроена схема SKAN (имеется в виду приложение, из которого вы хотите скопировать схему SKAN).
   • Все приложения, которые должны иметь эту же схему.
4. Скажите своему разработчику, чтобы он следовал инструкциям по API для SKAN Conversion Studio в хабе разработчиков.

Внимание:

• API можно использовать для копирования схемы в одно приложение за один вызов API. Однако ваш разработчик может создать сценарий для копирования требуемой схемы в несколько приложений.
• API для SKAN Conversion Studio недоступен для агентств.

Рассмотрим:

• Начав использовать режим измерения SKAN 4, вы не сможете вернуться к более раннему режиму.
• Когда вы вносите изменения в настройки, они начинают действовать с 00:00 утра по UTC, и начинается переходный период. В течение этого периода мы декодируем значение конверсии, используя самые последние настройки. Однако поступивший постбэк теперь связан с установкой, которая произошла ранее.
• Сообщаемое количество установок не связано с изменением настроек и является точным.

Чтобы отключить измерение SKAdNetwork:

1. В AppsFlyer перейдите в раздел Configuration (Настройки) > SKAN Conversion Studio.
2. Нажмите ⋮ .
3. Отключите измерение SKAdNetwork. 
   Помимо прочего, SDK прекратит вызывать такие функции SKAN, как registerAppForAdNetworkAttribution, updateConversionValue.
4. Нажмите Save changes (Сохранить изменения).

Как SDK, так и межсерверный API (S2S) могут отправлять данные о внутренних событиях приложения на серверы AppsFlyer. 

Схема для S2S:

• Событие, связанное с пользователем, происходит на серверах рекламодателя. Приложение в этот момент может быть открыто или закрыто. 
• Серверы рекламодателя передают данные об этом событии в AppsFlyer через S2S.
• AppsFlyer рассчитывает обновленное значение конверсии и затем: 
  • Если приложение открыто на устройстве пользователя: SDK получает уведомление об обновленном значении. SDK обновляет значение конверсии в iOS на устройстве.
  • Если приложение не открыто на устройстве пользователя: сервер ждет его открытия, чтобы уведомить SDK о значении конверсии. Это должно произойти до окончания окна активности. Если отправить уведомление не удается, событие не учитывается.

Необходимая версия SDK

• Установите в приложение SDK последней версии. Внимание! От разработчика не требуется дополнительных действий. 

Чтобы реализовать отправку данных о внутренних событиях приложения с помощью межсерверного API:

1. Произведите одно из следующих действий:
   • Если выбран режим SKAN 4 или Custom:
     • Изменение настроек не требуется.
   • Если выбран режим доход, конверсии или интеракции:
     1. В AppsFlyer перейдите в раздел Configuration (Настройки) > SKAN Conversion Studio.
     2. Откройте дополнительные параметры (⋮).
     3. Включите Record in-app events sent by server-to-server API (Регистрация внутренних событий межсерверным API).
2. Отправляйте события через S2S. 

Ограничения

• Если вы реализуете анонимизацию для данного пользователя, вы не сможете отправлять события через S2S по этму пользователю. 

Если у вас настроен режим измерения выручки или интеракций, функция Единый источник истины (SSOT, которая дедуплицирует и точно сообщает данные iOS) не поддерживается. Подробнее о SSOT

Чтобы включить SSOT, если у вас настроен режим измерения выручки или интеракций:

1. В AppsFlyer перейдите в раздел Configuration (Настройки) > SKAN Conversion Studio.
2. Прокрутите вниз до активного режима измерения. 
3. Нажмите + Add Single Source of Truth (Добавить Единый источник истины).
   • Переключатель Single Source of Truth (Единый источник истины) включен автоматически.
   • Диапазоны измерений в фиксированном режиме изменяются минимально, чтобы предоставить SSOT некоторое пространство для значений конверсии.
4. Нажмите Сохранить.