Краткий обзор. 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.
Пример: Сопоставление для декодирования
| значение конверсии |
название события |
значение события |
min_revenue (не включая) |
max_revenue (включая) | счетчик событий |
часы с момента установки |
|---|---|---|---|---|---|---|
| 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
| имя_события | Строка (JSON) |
min_revenue |
макс_выручка |
event_value |
|---|---|---|---|---|
| Установить | ||||
| af_purchase | 1.5 | 0 | 3 | {abc} |
Пример B: Точное значение конверсии 2
| имя_события | Строка (JSON) | min_revenue | макс_выручка | event_value |
|---|---|---|---|---|
| Установить | ||||
| af_purchase | 6.5 | 3 | 10 | {def} |
| af_purchase | 6.5 | 3 | 10 | {def} |
| af_purchase | 6.5 | 3 | 10 | {def} |
Пример C: Точное значение конверсии 21
| имя_события | Строка (JSON) | min_revenue | макс_выручка | event_value |
|---|---|---|---|---|
| Установить | ||||
| event_a | ||||
| event_b | ||||
| event_b | ||||
| event_b | ||||
| event_c | {xyz} | |||
| event_c | {xyz} | |||
| event_d | ||||
| event_e | ||||
| event_f | ||||
| event_g |
Пример D: Точное значение конверсии 62
| имя_события | Строка (JSON) | min_revenue | макс_выручка | event_value |
|---|---|---|---|---|
| Установить | ||||
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| event_a | {klm} | |||
| event_a | {klm} | |||
| event_a | {klm} |
Поддержка Единого источника истины SSOT для режима Decode
Информация о компании
Клиенты, использующие режим Decode, теперь могут получить доступ к атрибуции по модели Единого источника истины (SSOT), что дает преимущества дедупликации, ранее доступные только пользователям режима Encode. Это повышает точность измерения неорганической эффективности без необходимости внедрять режим Encode.
Ключевые преимущества
- Получайте через API индикатор в реальном времени о том, атрибутирована ли установка (неорганическая) или нет (органическая) в AppsFlyer.
- Учитывайте сигнал атрибуции Единого источника истины SSOT при обновлении значений конверсии.
- Используйте совместимые с SSOT схемы Decode, загружая обновленные файлы схемы со специальным флагом SSOT.
- Получите доступ к дэшбордам Единого источника истины SSOT и отчетам DataLocker.
- Выполняйте дедупликацию неорганических установок во всех сетях.
- Обеспечьте более точную атрибуцию и отчетность.
- Сократите сложность разработки и контроля качества.
Как включить SSOT для режима декодирования
- Извлеките идентификатор AppsFlyer — получите идентификатор AppsFlyer из SDK во время установки.
-
Вызовите SSOT API - используйте идентификатор AppsFlyer и идентификатор приложения, чтобы проверить, была ли установка атрибутирована AppsFlyer.
-
API возвращает:
"is-non-organic-install": true/false
-
-
Примените сигнал атрибуции — используйте этот сигнал, чтобы скорректировать логику CV. Например, отразите атрибуцию, добавив событие
af_attribution_flagв соответствующие записи CV. -
Загрузите обновленный файл схемы — используйте существующую схему декодирования. Для CV, затронутых атрибуцией SSOT, добавьте событие
af_attribution_flag, чтобы указать дедупликацию. -
Доступ к отчетам
Дэшборды SSOT и файлы DataLocker теперь включают данные режима декодирования.
Часто задаваемые вопросы
В: Когда следует вызывать API, чтобы получить флаг атрибуции SSOT?
О:
-
Вызывайте API сразу после установки.
-
Повторяйте запрос каждые 10 секунд (до 5 раз), чтобы учесть задержку атрибуции.
-
Либо выполните запрос один раз не менее чем через 25 секунд после установки, чтобы обеспечить точность.
Спецификация CSV-файла декодирования
Значения конверсии сопоставляются с одним или несколькими событиями в приложении.
Правила файла
- Формат: Файл CSV
- Максимальное количество строк: 640 + строка заголовка; всего 641.
- В строку заголовка необходимо включить все названия столбцов именно так, как они отображаются здесь. Практические рекомендации: Используйте прикрепленный файл-пример в качестве шаблона. См. примеры декодирования CSV-файлов для SKAN 3 и SKAN 4.
- Не используйте следующие символы в качестве первого символа в столбце:
=,+,-и
Спецификация CSV-файла декодирования
| Столбчатая | Обязательное значение | Контент | Подробности |
|---|---|---|---|
| значение конверсии |
Да, для:
|
Целое число 1–63 |
Одно и то же точное значение конверсии может быть указано несколько раз. Для дальнейшего объяснения смотрите примеры. |
| Приблизительное значение конверсии |
Актуально только для SKAN 4 |
String:
|
Одно и то же приблизительное значение конверсии может быть указано несколько раз. |
| имя_события | Да | строка |
Внутреннее событие приложения: Внутреннее событие приложения: Внутреннее событие приложения: Это не обязательно должно быть событие, которое уже существует в AppsFlyer. Внимание! Названия событий в приложении чувствительны к регистру. Практические рекомендации: Название события для дохода af_skad_revenue. |
| event_value | Нет | строка | Строка, заданная разработчиком, содержащая данные, которые рекламодатель должен декодировать в своих системах. Обычно это формат JSON. |
| min_revenue |
Нет
|
Целое или плавающее |
Используйте min_revenue и max_revenue, чтобы задать диапазон дохода в долларах США.
Внимание! Если вы создаете файл с помощью Excel, перед сохранением измените формат столбца на запятую, а не на денежную единицу, чтобы Excel не внедрял символ $ в CSV-файл. |
| макс_выручка | Нет |
Если вы заполняете min_revenue: max_revenue должен иметь значение больше 0. Объяснение см. в min_revenue. |
|
| Нет |
Устарело с 7 июля 2021 г. Устарело с 7 июля 2021 г. Устарело с 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 выбор других версий будет недоступен.
- Выполните одно из следующих действий:
- Кликните Drag & drop file.
- Загрузите обновленный файл сопоставления.
- Следуйте инструкциям в пользовательском интерфейсе, чтобы загрузить файл.
- Включите Измерение 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.
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.