Декодирование CV в SKAN (сопоставление значения конверсии с событиями)

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

SKAdNetwork_-_Custom__1_.png

Декодирование значения конверсии SKAN

Рекламодатели используют декодирование значения конверсии в качестве альтернативы опциям, доступным в Conversion Studio. Если вы используете декодирование, это означает, что вы несете ответственность за настройку updatePostbackConversionValue в соответствии с логикой вашего приложения. 

За исключением настройки значения конверсии (CV) в приложении, остальная часть процесса, функции и параметры отчетности такие же, как описаны в руководстве по решению SKAN. Это означает, что по истечении окна активности (установленного вами) iOS отправляет постбэк в рекламную сеть, которая пересылает его в AppsFlyer. AppsFlyer декодирует CV в соответствии с вашим сопоставлением в события, обрабатываемые так же, как декодированные CV, установленные SDK.

Настраиваемое значение конверсии — декодирование

Для реализации настраиваемого декодирования CV необходимо загрузить CSV-файл, содержащий сопоставление вашего CV, на платформу AppsFlyer. 

Принципы сопоставления для декодирования

  • Предоставьте сопоставление декодирования для точных значений конверсии (1–63) и приблизительных (низкое, среднее и высокое) для окон 1–3. Не обязательно сопоставлять весь диапазон значений. Например, вы можете сопоставить значения 1, 2, 10 и 43.
  • Значение 0 всегда сопоставлено с установкой. Вы не можете это изменить. 
  • Таблица сопоставления загружается в AppsFlyer в виде CSV-файла. При необходимости вы можете загрузить обновленную таблицу сопоставления. 
  • После получения постбэка от iOS CV декодируется в события, как показано в примерах. 
  • Дата установки определяется по времени прибытия постбэка. 
  • События имеют то же время, что и время установки.
  • Чтобы лучше понять, как подготовить схему, ознакомьтесь со сценариями сопоставления, приведенными ниже. 
  • Разрешены пользовательские названия событий в приложении.
    • Это означает, что вы отправляете новые имена событий, даже если они никогда не отправлялись из SDK.
    • Вы можете сопоставить внутренние события приложения с внутренними событиями рекламной сети.
    • Это также справедливо для интеграции Meta ads, при условии соблюдения специфических для Meta правил, подробно описанных в следующем разделе. 

Правила сопоставления для декодирования

Обратите внимание:

  • Диапазон точных значений конверсии: 1-63
  • Диапазон приблизительных значений конверсии: Низкий, средний и высокий
  • Определенное значение конверсии сопоставляется с одним или несколькими указанными вами событиями в приложении. События в приложении имеют необязательные параметры.
  • Для примеров: Предположим, что дата установки — 1 февраля, 08:00.
  • Следующая таблица представляет собой пример таблицы сопоставления декодирования. Ее структура аналогична структуре требуемого CSV-файла. После таблицы приведены события, полученные в результате процесса декодирования.
  • Событие установки генерируется всегда, независимо от вашего сопоставления.
  • Измерение дохода:
    • Доход указан в долларах США.
    • Указанное значение конверсии имеет диапазон доходов, ограниченный min_revenue и max_revenue. 
    • В агрегированных отчетах и на дэшбордах доход рассчитывается как среднее значение диапазона. Пример: min_revenue=4 и max_revenue=10. Расчетный доход составляет 7.
    • Отчеты по сырым данным включают расчетный доход (skad_revenue), min_revenue и max_revenue.

Правила, специфичные для Meta

При интеграции с Meta ads придерживайтесь следующих правил:

  • Минимальные и максимальные значения дохода для заданного значения конверсии должны быть разными. Они не могут быть равны. 
  • Значения не должны перекрываться и должны располагаться в последовательном порядке, как показано для conversion_value 1-2 и 62 в следующей таблице. 
  • Счетчик событий event_counter: Meta ads не учитывают это значение. [Рекомендация] Заполните его значением 1. 

Пример: Сопоставление для декодирования

conversion_
value
event_
name
event_
value

min_revenue

(не включая)

max_revenue (включая) event_
counter
hours_from_
install
1 af_purchase {abc} 0 3 1 24
2 af_purchase {def} 3 10 3 36
21 event_a       1 24
21 event_b       3 24
21 event_c {xyz}     2 24
21 event_d       1 24
21 event_e       1 24
21 event_f       1 24
21 event_g       1 24
62 af_purchase {fgh) 10 17 2 72
62 event_a {klm}     3 72

Пример A: Точное значение конверсии 1

event_name skad_revenue

min_revenue 

max_revenue

event_value
install        
af_purchase 1,5 0 3 {abc}

Пример B: Точное значение конверсии 2

event_name skad_revenue min_revenue max_revenue event_value
install        
af_purchase 6,5 3 10 {def}
af_purchase 6,5 3 10 {def}
af_purchase 6,5 3 10 {def}

Пример C: Точное значение конверсии 21

event_name skad_revenue min_revenue max_revenue event_value
install        
event_a        
event_b        
event_b        
event_b        
event_c       {xyz}
event_c       {xyz}
event_d        
event_e        
event_f        
event_g        

Пример D: Точное значение конверсии 62

event_name skad_revenue min_revenue max_revenue event_value
install        
af_purchase 13.5 10 17 {fgh}
af_purchase 13.5 10 17 {fgh}
event_a       {klm}
event_a       {klm}
event_a       {klm}

Спецификация CSV-файла декодирования

Значения конверсии сопоставляются с одним или несколькими событиями в приложении.

Правила файла

  • Формат: Файл CSV
  • Максимальное количество строк: 640 + строка заголовка; всего 641.
  • В строку заголовка необходимо включить все названия столбцов именно так, как они отображаются здесь. Практические рекомендации: Используйте прикрепленный файл-пример в качестве шаблона. См. примеры декодирования CSV-файлов для SKAN 3 и SKAN 4.
  • Не используйте следующие символы в качестве первого символа в столбце: =, +, - и @

Спецификация CSV-файла декодирования

Столбец  Обязательное значение  Контент Подробности
conversion_value

Да, для:

  • SKAN 3 и ниже
  • SKAN 4, где postback_sequence_index равно 0
Целое число 1–63

Одно и то же точное значение конверсии может быть указано несколько раз. Для дальнейшего объяснения смотрите примеры. 

Приблизительное значение конверсии

Актуально только для SKAN 4

Строка:

  • Низкое
  • Среднее
  • Высокое

Одно и то же приблизительное значение конверсии может быть указано несколько раз.

event_name Да Строка

Внутреннее событие приложения: Это не обязательно должно быть событие, которое уже существует в AppsFlyer.

Внимание! Названия событий в приложении чувствительны к регистру.

Практические рекомендации: Название события для дохода af_skad_revenue. 

event_value Нет Строка Строка, заданная разработчиком, содержащая данные, которые рекламодатель должен декодировать в своих системах. Обычно это формат JSON. 
min_revenue

Нет

 

Целое или плавающее

Используйте min_revenue и max_revenue, чтобы задать диапазон дохода в долларах США.

  • Если вы не хотите связывать доход со значением конверсии, оставьте поля min_revenue и max_revenue пустыми.
  • Значение, установленное в параметре min_revenue, не включительно. То есть оно будет больше 0, напр. 0,0001
  • Значение, установленное в max_value, включительно.
  • Пример: Если min_revenue равен 0, а max_revenue равен 4, это означает, что диапазон составляет 0,0001-4.
  • max_revenue должен быть больше min_revenue

Внимание! Если вы создаете файл с помощью Excel, перед сохранением измените формат столбца на запятую, а не на денежную единицу, чтобы Excel не внедрял символ $ в CSV-файл.

max_revenue Нет  

Если вы заполняете min_revenue: max_revenue должен иметь значение больше 0. 

Объяснение см. в min_revenue. 

event_revenue_usd Нет  

 

Устарело с 7 июля 2021 г. Используйте min_revenue и max_revenue

 

event_counter Да

Целое число 

 

  • Сколько раз событие дублируется при декодировании. Обычно отображает количество раз, когда пользователь выполнил определенное действие.
  • Минимальное значение 1.

Пример: Если пользователь выполнил заданное событие 5 раз, то генерируется 5 событий.

Факторы, которые необходимо учитывать: Если вы отправляете доход, общая сумма в долларах США умножается на значение в event_counter. Это означает, что если min_revenue = 0, max_revenue = 3 и event_counter = 4, то общий доход составит 1,5 X 4 = 6.

Смотрите примеры.

hours_from_install Да Целое число
  • Сколько прошло часов с момента установки
  • Минимальное значение: 1
  • Максимальное значение: 1512 (63 дня)
  • Значение для всех строк данного значения конверсии должно быть одинаковым. Это означает, что допускаются разные значения для разных значений конверсии. 

AppsFlyer использует это для определения даты установки следующим образом:

  • Если постбэки — SKAN V4, формула даты установки следующая: Дата установки = время прибытия постбэка - [суммированная длина окна] - [средняя задержка постбэка].
    • Постбэк 1: дата установки = время прибытия постбэка - 48ч. - 36ч.
  • Если постбэки — SKAN V3, формула даты установки следующая: Дата установки = время прибытия постбэка - 36 часов - [средний диапазон последней активности]. 
    • По умолчанию [средний диапазон последней активности] составляет 12 часов.
    • Если значение конверсии равно 0, средний диапазон последней активности устанавливается равным 0.
postback_sequence_index 

Да, но актуально только для SKAN 4

Целое число:

  • 0
  • 1
  • 2

Для точного значения может быть получено только значение 0.

Загрузить файл со схемой значений конверсии

Прежде чем начать:

  • Подготовьте CSV-файл со схемой значений конверсии.
  • Если вы интегрируетесь с Meta ads и измеряете доход, убедитесь, что ваша схема соответствует правилам для Meta. Если этого не сделать, Meta ads не сможет интерпретировать схему. 

Чтобы включить измерение SKAN с помощью декодирования:

  1. В AppsFlyer перейдите в раздел Настройки  > SKAN Conversion Studio
  2. Нажмите значок других действий (⋮), выберите Загрузить файл сопоставления декодирования.
  3. Если вы еще не перешли на SKAN 4, выберите загрузку файла для SKAN 4 или предыдущей версии SKAN. После обновления до SKAN 4 выбор других версий будет недоступен.
  4. Выполните одно из следующих действий:
    • Нажмите Перетащить файл.
    • Загрузите обновленный файл сопоставления.
  5. Следуйте инструкциям в пользовательском интерфейсе, чтобы загрузить файл. 
  6. Включите Измерение SKAN.
  7. Нажмите Сохранить изменения
    Примечание. В течение следующих 48–72 часов данные на дэшборде будут неоднозначными. Это означает, что из-за проблем с таймером iOS мы не можем быть уверены, соответствует ли сопоставление декодирования сопоставлению кодирования, которое вы используете. 
  8. Убедитесь, что вы сопоставили события в приложении с событиями партнеров, чтобы они могли правильно использовать постбэки. 

Устранение неполадок при загрузке CSV-файла

Сообщения об ошибках загрузки

Одно или несколько значений в файле не соответствуют требуемому формату: Формат файла был изменен с 7 июня 2021 года. Убедитесь, что формат вашего файла соответствует примеру в этой статье. 

Использование Excel для форматирования столбца event_revenue_usd

При использовании таблиц Excel/Google для создания CSV-файла столбец event_revenue_usd должен быть правильно отформатирован перед сохранением файла в формате CSV. 

После сохранения CSV-файла проверьте правильность форматирования его содержимого. Примечание: Не используйте Excel для проверки, лучше воспользуйтесь редактором

Форматирование ячеек event_revenue_usd в Excel

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

mceclip0.png

Это можно исправить, отформатировав ячейки в Excel.  

Для форматирования сумм затрат без отделителя тысяч и знака $

  1. Выберите ячейки, которые необходимо отформатировать.
  2. Щелкните правой кнопкой мыши и выберите Форматировать ячейки.
    Откроется окно форматирования ячеек.
  3. Выберите Number (Число).

    Formatnumbers.png

  1. Очистите поле Использовать 1000-й сепаратор (,) .
  2. (Необязательно) Установите количество знаков после десятичного разделителя. По умолчанию установлено значение 2. Максимально допустимое значение — 5. 
  3. Нажмите кнопку OK.
    Ячейки отформатированы правильно.

Визуальный контроль CSV-файла без использования Excel

Чтобы просмотреть содержимое CSV-файла, воспользуйтесь редактором. 

  • Windows: Блокнот, Notepad++
  • macOS: TextEdit

Ниже приведен скриншот с примером CSV-файла, отображаемого в редакторе. 

Вид в редакторе

SKCustomeEditor.png

Используя редактор, просмотрите CSV-файл. Обратите особое внимание на следующее:

  • Пробелы: Убедитесь, что до и после запятых, разделяющих поля, нет пробелов. В Excel для удаления пробелов используйте команду @trim. 
  • event_revenue_usd: Убедитесь, что в столбце event_revenue_usd нет ни запятой, ни символа $.

    mceclip1.png

CSV-файлы, создаваемые Excel, не имеют запятых в качестве разделителей

Если Excel создает CSV-файл, в котором в качестве разделителя используется точка с запятой «;» или другой символ, но не запятая:

  • Это происходит, когда в региональных настройках компьютера установлен язык/регион, отличный от английского.
  • Особенно часто эта проблема возникает, когда в региональных настройках выбран немецкий язык.
  • Решение зависит от операционной системы компьютера (macOS или Windows).
  • Чтобы решить эту проблему, найдите последнее руководство от Microsoft или пообщайтесь на других форумах. Используйте следующие поисковые запросы: Операционная система (macOS или Windows) Excel меняет разделитель для файлов CSV.