Краткий обзор. AppsFlyer декодирует и преобразует заданное вами значение конверсии в события. События используются для заполнения дэшборда SKAN, сырых данных и постбэков партнерам.
Декодирование значения конверсии 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 |
Да, для:
|
Целое число 1–63 |
Одно и то же точное значение конверсии может быть указано несколько раз. Для дальнейшего объяснения смотрите примеры. |
Приблизительное значение конверсии |
Актуально только для SKAN 4 |
Строка:
|
Одно и то же приблизительное значение конверсии может быть указано несколько раз. |
event_name | Да | Строка |
Внутреннее событие приложения: Это не обязательно должно быть событие, которое уже существует в AppsFlyer. Внимание! Названия событий в приложении чувствительны к регистру. Практические рекомендации: Название события для дохода af_skad_revenue. |
event_value | Нет | Строка | Строка, заданная разработчиком, содержащая данные, которые рекламодатель должен декодировать в своих системах. Обычно это формат JSON. |
min_revenue |
Нет
|
Целое или плавающее |
Используйте min_revenue и max_revenue, чтобы задать диапазон дохода в долларах США.
Внимание! Если вы создаете файл с помощью Excel, перед сохранением измените формат столбца на запятую, а не на денежную единицу, чтобы Excel не внедрял символ $ в CSV-файл. |
max_revenue | Нет |
Если вы заполняете min_revenue: max_revenue должен иметь значение больше 0. Объяснение см. в min_revenue. |
|
Нет |
Устарело с 7 июля 2021 г. Используйте min_revenue и max_revenue
|
||
event_counter | Да |
Целое число
|
Пример: Если пользователь выполнил заданное событие 5 раз, то генерируется 5 событий. Факторы, которые необходимо учитывать: Если вы отправляете доход, общая сумма в долларах США умножается на значение в event_counter. Это означает, что если min_revenue = 0, max_revenue = 3 и event_counter = 4, то общий доход составит 1,5 X 4 = 6. Смотрите примеры. |
hours_from_install | Да | Целое число |
AppsFlyer использует это для определения даты установки следующим образом:
|
postback_sequence_index |
Да, но актуально только для SKAN 4 |
Целое число:
|
Для точного значения может быть получено только значение 0. |
Загрузить файл со схемой значений конверсии
Прежде чем начать:
- Подготовьте CSV-файл со схемой значений конверсии.
- Если вы интегрируетесь с Meta ads и измеряете доход, убедитесь, что ваша схема соответствует правилам для Meta. Если этого не сделать, Meta ads не сможет интерпретировать схему.
Чтобы включить измерение SKAN с помощью декодирования:
- В AppsFlyer перейдите в раздел Настройки > SKAN Conversion Studio.
- Нажмите значок других действий (⋮), выберите Загрузить файл сопоставления декодирования.
- Если вы еще не перешли на SKAN 4, выберите загрузку файла для SKAN 4 или предыдущей версии SKAN. После обновления до SKAN 4 выбор других версий будет недоступен.
- Выполните одно из следующих действий:
- Нажмите Перетащить файл.
- Загрузите обновленный файл сопоставления.
- Следуйте инструкциям в пользовательском интерфейсе, чтобы загрузить файл.
- Включите Измерение SKAN.
- Нажмите Сохранить изменения.
Примечание. В течение следующих 48–72 часов данные на дэшборде будут неоднозначными. Это означает, что из-за проблем с таймером iOS мы не можем быть уверены, соответствует ли сопоставление декодирования сопоставлению кодирования, которое вы используете. - Убедитесь, что вы сопоставили события в приложении с событиями партнеров, чтобы они могли правильно использовать постбэки.
Устранение неполадок при загрузке CSV-файла
Сообщения об ошибках загрузки
Одно или несколько значений в файле не соответствуют требуемому формату: Формат файла был изменен с 7 июня 2021 года. Убедитесь, что формат вашего файла соответствует примеру в этой статье.
Использование Excel для форматирования столбца event_revenue_usd
При использовании таблиц Excel/Google для создания CSV-файла столбец event_revenue_usd должен быть правильно отформатирован перед сохранением файла в формате CSV.
После сохранения CSV-файла проверьте правильность форматирования его содержимого. Примечание: Не используйте Excel для проверки, лучше воспользуйтесь редактором.
Форматирование ячеек event_revenue_usd в Excel
Обычно Excel форматирует ячейки со значениями с помощью запятой для отделения тысяч, как показано на рисунке. Этот формат не подходит для загрузки CSV-файлов. Вам также необходимо удалить символ $.
Это можно исправить, отформатировав ячейки в Excel.
Для форматирования сумм затрат без отделителя тысяч и знака $:
- Выберите ячейки, которые необходимо отформатировать.
- Щелкните правой кнопкой мыши и выберите Форматировать ячейки.
Откроется окно форматирования ячеек. - Выберите Number (Число).
- Очистите поле Использовать 1000-й сепаратор (,) .
- (Необязательно) Установите количество знаков после десятичного разделителя. По умолчанию установлено значение 2. Максимально допустимое значение — 5.
- Нажмите кнопку OK.
Ячейки отформатированы правильно.
Визуальный контроль CSV-файла без использования Excel
Чтобы просмотреть содержимое CSV-файла, воспользуйтесь редактором.
- Windows: Блокнот, Notepad++
- macOS: TextEdit
Ниже приведен скриншот с примером CSV-файла, отображаемого в редакторе.
Вид в редакторе
Используя редактор, просмотрите CSV-файл. Обратите особое внимание на следующее:
- Пробелы: Убедитесь, что до и после запятых, разделяющих поля, нет пробелов. В Excel для удаления пробелов используйте команду @trim.
-
event_revenue_usd: Убедитесь, что в столбце event_revenue_usd нет ни запятой, ни символа $.
CSV-файлы, создаваемые Excel, не имеют запятых в качестве разделителей
Если Excel создает CSV-файл, в котором в качестве разделителя используется точка с запятой «;» или другой символ, но не запятая:
- Это происходит, когда в региональных настройках компьютера установлен язык/регион, отличный от английского.
- Особенно часто эта проблема возникает, когда в региональных настройках выбран немецкий язык.
- Решение зависит от операционной системы компьютера (macOS или Windows).
- Чтобы решить эту проблему, найдите последнее руководство от Microsoft или пообщайтесь на других форумах. Используйте следующие поисковые запросы: Операционная система (macOS или Windows) Excel меняет разделитель для файлов CSV.