Миграция с Adjust на AppsFlyer

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

О переходе на AppsFlyer

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

Сравните измерения между AppsFlyer и Adjust

При рассмотрении вопроса о миграции вам, возможно, захочется сравнить показатели атрибуции AppsFlyer и Adjust по одним и тем же медиа-источникам и кампаниям. Однако не все медиа-источники поддерживают измерение с помощью более, чем одного MMP. Те, которые это делают, могут иметь определенные ограничения и трудности в предотвращении расхождений в атрибуции. Больше информации об измерении атрибуции с помощью нескольких MMP можно найти здесь. 

Действия

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

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

  • Выполнить все задачи до релиза обновленного приложения с SDK AppsFlyer.  
  • Приостановить текущие маркетинговые кампании, прежде чем выполнять миграцию идентификаторов устройств.
Шаг Кто участвует Ожидаемое время выполнения Примечания
1. Создайте аккаунт AppsFlyer Маркетолог / пользователь дэшборда AppsFlyer 2 часа  
2. Добавьте приложение в AppsFlyer. Маркетолог / пользователь дэшборда AppsFlyer 2 часа  
3. Интегрируйте SDK (пакет средств разработки ПО) Разработчики приложений 1 день + 1 неделя тестирования и итерации
  • Рекомендация: Интегрируйте SDK AppsFlyer в версию приложения для тестирования.
  • Готовое приложение должно быть обновлено в магазинах приложений после выполнения всех остальных задач.
4. Произведите перенос устройств (необязательно) Инженер данных 1–2 недели
  • Перед миграцией рекомендуем приостановить текущие кампании и возобновить их после обновления версии приложения.    
  • Чтобы обеспечить полный охват, повторите перенос устройств в последний день миграции.  
5. Произведите миграцию рекламных кампаний Маркетолог / UA менеджер 1-3 дня для каждого медиа-источника
6. Настройте отчетность Инженер данных 3–6 недель  

Шаг 1: Создайте аккаунт AppsFlyer

Шаг 2: Добавьте свое приложение

Чтобы добавить ваше приложение в AppsFlyer:

  1. Добавьте ваше приложение в AppsFlyer.
  2. [Необязательно] Измените заданное по умолчанию окно реатрибуции в 90 дней в соответствии с вашим определением активных пользователей.
  3. При работе с мастером онбординга приложения в AppsFlyer подготовьте и отправьте электронное письмо разработчику с инструкциями и задачами по интеграции SDK и сопоставлению событий внутри приложения.

Шаг 3: Интегрируйте SDK (пакет средств разработки ПО)

SDK AppsFlyer, интегрированный в приложение, является связующим звеном между приложением и платформой AppsFlyer. Он сообщает об установках, открытиях и внутренних событиях приложения и т.д.

Чтобы интегрировать SDK AppsFlyer:

  1. Получите электронное письмо от маркетолога с инструкциями и действиями по интеграции SDK и сопоставлению событий в приложении.
  2. Следуйте инструкциям в электронном письме и используйте мастер интеграции SDK AppsFlyer, чтобы интегрировать SDK AppsFlyer в приложение.
    • Мастер проведет разработчика от установки до успешного тестирования интеграции. Он также помогает разработчику определять внутренние события приложения и успешно тестировать их передачу в AppsFlyer. Узнайте больше о мастере интеграции SDK
    • Ознакомьтесь с дополнительными руководствами для разработчиков по интеграции SDK Android и iOS.
    • Сопоставьте внутренние события приложения, которые вы хотите регистрировать, с помощью схем AppsFlyer.
      Это можно сделать через SDK или S2S.
  3. Удалите SDK Adjust.
    Это можно сделать сразу, перейдя исключительно на AppsFlyer, или одновременно использовать оба SDK в течение нескольких недель. Смотрите описание этих вариантов в таблице ниже.
    Вариант Что происходит после
    выпуска обновленной версии приложения
    Эффект
    Удалить SDK Adjust (рекомендуется) Новые установки и обновления регистрирует только AppsFlyer.
    Adjust по-прежнему отображает события, выполненные пользователями, пока пользователи не обновят свое приложение.
    • Быстрый переход.
    • Отсутствие двойной атрибуции.
    Сохраните SDK Adjust на переходный период AppsFlyer и Adjust атрибутируют новые установки и регистрируют события. Позднее удалите SDK Adjust.
    • Возможна проверка данных. Это означает, что вы можете сравнивать данные AppsFlyer и Adjust.
    • Двойная атрибуция может вызвать двойные расходы в рекламных сетях. См. приведенные ниже примеры.
    • Повышенная нагрузка.
  4. После завершения всех остальных задач, описанных в этой статье по миграции, выпустите версию приложения с SDK AppsFlyer на рынок. Новые пользователи будут атрибутироваться через AppsFlyer. 
    Примечание:
    • Обязательно обновите приложение для магазинов iOS, Google Play и всех независимых площадок для Android.
    • Ваше приложение для Android может быть выложено на неофициальных сайтах APK, даже если вы этого не знаете (чтобы это выяснить, введите в интернете название пакета вашего приложения).  Сайтам APK требуется некоторое время для обновления до последней версии, поэтому они могут привлекать органических пользователей, которые устанавливают старые версии без SDK AppsFlyer.
    • Обновление приложения в магазинах приложений может занять пару дней. Пользователи, устанавливающие приложение в этот период, могут получить предыдущую версию.

Шаг 4: Осуществите миграцию устройствнеобязательно

Миграция устройств — это процесс загрузки в AppsFlyer списка идентификаторов устройств ваших имеющихся пользователей (IDFA, IDFV, GAID). (Если у вас нет всех необходимых идентификаторов устройств, вы можете обратиться к своему CSM, который поможет вам пройти процесс миграции с использованием CUID.) Этот процесс нужно выполнить до выпуска новой версии приложения, в которой есть SDK AppsFlyer. Есть два варианта миграции устройств — с атрибуцией и без атрибуции.

Миграция устройств решает проблемы с данными по имеющимся пользователям, которые загрузили приложение и были атрибутированы Adjust. Например, в случае двойной оплаты в SRN, которая возникает, когда пользователи, изначально атрибутированные SRN-сети системой Adjust и все еще находящиеся в ее окне атрибуции, повторно атрибутируются этой SRN уже системой AppsFlyer.

Пример

  • Новый пользователь кликает по рекламному объявлению в приложении Facebook и устанавливает ваше приложение 15 июня.
  • 24 июня этот пользователь обновляет приложение до версии с SDK AppsFlyer и запускает его. Для AppsFlyer это новый пользователь, которого нужно атрибутировать в реальном времени.
  • AppsFlyer запрашивает у Meta Ads идентификатор устройства пользователя. Поскольку пользователь все еще находится в рамках 28-дневного окна атрибуции Meta Ads, то Meta Ads атрибутирует пользователя себе. Из-за этого владелец приложения несет двойные расходы за этого пользователя.

После миграции устройств данные отражаются в AppsFlyer следующим образом:

  • Данные об установках: Как и в случае с повторными установками, по перенесенным устройствам нет данных об установках. Установки по перенесенным устройствам не отображаются в AppsFlyer.
  • Данные о внутренних событиях и сессиях: Регистрируются и отображаются как органические при использовании метода миграции устройств без атрибуции, или атрибутируются медиа-источнику и кампании при использовании метода атрибуции.  
  • Ретаргетинг: Реатрибуции и повторные вовлечения отображаются в обычном режиме.
  • Данные об активности: Отображаются в обычном режиме.
  • Отчеты об удержании пользователей и когортные отчеты Перенесенные устройства не имеют записи об установке. Поэтому они не связаны с какой-либо когортой и не могут отображаться в отчетах по удержанию пользователей и когортных отчетах.  

Примечание

Если приложение не будет открыто в течение 180 дней с даты миграции, все перенесенные данные устройства будут удалены. Следовательно, если приложение будет открыто по истечении 180 дней, будет зафиксирована новая установка.

Чтобы осуществить миграцию устройств: 

  1. Решите, какую группу пользователей следует перенести. Вы можете перенести всех существующих пользователей (что может помешать вам получить точные данные повторной атрибуции от AppsFlyer) или пользователей, которые только недавно установили ваше приложение (что может привести к двойной оплате за пользователей, установивших его ранее).
    Мы рекомендуем производить перенос пользователей, активных в рамках текущего окна реатрибуции. Например, окно реатрибуции вашего приложения составляет 90 дней, осуществляйте перенос тех пользователей, у которых за предыдущие 90 дней была хотя бы одна сессия.
  2. [Необязательно] Попросите маркетолога / менеджера по привлечению пользователей приостановить текущие маркетинговые кампании (в рекламных сетях SRN, рекламных сетях, не относящихся к SRN, в собственных каналах и др.), пока не завершится миграция устройств.
    Если вы решите не приостанавливать кампании, перенесите все оставшиеся идентификаторы устройств из системы другого поставщика, как только обновленная версия приложения с SDK AppsFlyer будет выпущена в магазинах приложений.  
  3. Подготовьте CSV-файл на основе выбранной группы пользователей, используя структуру миграции с атрибуцией или без атрибуции. См. образец CSV
  4. Отправьте CSV-файл своему CSM менеджеру AppsFlyer.
    Ваш CSM менеджер проведет миграцию идентификаторов устройств в AppsFlyer.  

Шаг 5: Произведите миграцию рекламных кампаний

Переключите текущие маркетинговые кампании на AppsFlyer, чтобы активировать атрибуцию AppsFlyer и избежать двойной оплаты и потери данных атрибуции.

Примечание: Не обязательно переносить все маркетинговые кампании сразу. Чтобы осуществить перенос нескольких кампаний, выделите их в сегмент по медиа-источнику (такому как рекламная сеть или агентство), гео или кампании. 

В следующих разделах объясняется, что необходимо для включения измерения AppsFlyer для различных типов медиа-источников: SRN, рекламные сети, не относящиеся к SRN, собственные медиа и SKAN. 

SRN:

SRN отвечают партнерам по измерению эффективности мобильной рекламы (MMP) на запросы об интеракциях конкретных устройств. Если AppsFlyer и Adjust запрашивают один и тот же SRN об одной и той же установке устройства, с вас может взиматься двойная плата. 

Чтобы мигрировать кампании в SRN:

  • Активируйте и настройте в AppsFlyer соответствующие SRN.

Примечание

  • В SRN (кроме Meta Ads и Twitter) может быть запущено несколько MMP.
  • Meta Ads не может выполнять дедупликацию внутренних событий приложения.

Рекламные сети без собственной атрибуции (не относящиеся к SRN)

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

Чтобы мигрировать кампании рекламных сетей без самостоятельной атрибуции (не относящиеся к SRN):

  1. Активируйте соответствующие рекламные сети в AppsFlyer.
  2. Сформируйте ссылки атрибуции AppsFlyer для каждой рекламной сети.
  3. Замените имеющиеся ссылки в каждой вашей кампании на ссылки атрибуции AppsFlyer.  

Собственные каналы взаимодействия

К собственным медиа относятся ссылки атрибуции, используемые в следующих каналах:

  • Использование функции "поделиться контентом"
  • Web-to-app
  • Электронная почта
  • СМС
  • Посты в социальных сетях
  • Блоги
  • Интернет-сообщества (например, Quora)
  • и др.

Для таких кампаний AppsFlyer использует настраиваемые ссылки OneLink. Настраиваемые ссылки OneLink перенаправляют пользователей с учетом их устройств в нужный магазин приложений, непосредственно в приложение или на веб-страницу/лэндинг.

Чтобы изменить ссылки Adjust на ссылки AppsFlyer OneLink:

  • Обратитесь к своему CSM, который поможет вам преобразовать ваши собственные медиассылки в ссылки OneLink в соответствии с используемыми вами в данный момент каналами и инструментами.

SKAN

Для атрибуции SKAdNetwork (SKAN) обновлять значение конверсии может только один SDK. В противном случае данные SKAN станут бессмысленными. Поэтому убедитесь, что после миграции только SDK AppsFlyer обновляет значение конверсии SKAN.

Как настроить значение конверсии SKAN в AppsFlyer.

Шаг 6: Настройте отчетность

AppsFlyer позволяет получать отчеты по сырым и агрегированным данным с использованием различных методов. Ознакомьтесь с доступными методами и настройте те, которые вам подходят.

Методы создания отчетов:

  • Панели управления
  • Экспорт отчетов
  • Push API
  • Pull API
  • Data Locker

До миграции ваши системы сохраняют данные атрибуции, предоставляемые Adjust в соответствии с настроенными для него структурами, полями и параметрами отчетов. Чтобы данные правильно отображались в AppsFlyer, необходимо адаптировать и сопоставить имеющиеся структуры отчетов со структурой, полями и параметрами отчета AppsFlyer.

Чтобы адаптировать и сопоставить структуры отчетов:

  • Свяжитесь со своим CSM менеджером AppsFlyer, чтобы быстро адаптировать и перенести структуры данных ваших отчетов от Adjust с используемыми AppsFlyer.

Дополнительная информация

Атрибутируемая миграция

Для устройств, перенесенных в AppsFlyer с помощью этого метода, внутренние события и сессии регистрируются и отображаются в соответствии с медиа-источником, указанным предыдущим поставщиком атрибуции, и в соответствии с политиками хранения данных рекламных сетей.

Структура CSV-файла для миграции устройств с атрибуцией

Столбец
Описание Обязательно Примеры
app_id
 
Идентификатор приложения (App ID) в том виде, в каком он отображается на дэшборде AppsFlyer Да
  • Android: com.great.app1  
  • iOS: id123456789
платформа
 
Платформа устройства: ios или android Да
  • iOS
  • Android
device_id
 
  • Android: gaid или android_id
  • iOS: IDFV (рекомендуется, если доступен) или IDFA
  • Не используйте одну и ту же комбинацию идентификатора устройства и идентификатора приложения в нескольких строках. Если происходит дублирование, используется последнее вхождение в файле.
Да
  • gaid (строчными буквами): 9c9a82fb-d5de-4cd1-90c3-527441c11828
  • android_id (строчными буквами): f35aea8908254891
  • IDFV(заглавными буквами): A7328D98-A973-402A-8B87-D22A8611F2AF
  • IDFA (заглавными буквами): 9876F1SS-2983-3855-27RR-2R626772VFNB
id_type
 
  • Android: advertiserId (также поддерживается amazon_aid), android_id 
  • iOS:idfa или idfv
  • В настоящее время другие идентификаторы (OAID, IMEI) не поддерживаются.  
    Используйте метод миграции без атрибуции для пользователей Android, которые загрузили приложение не из магазина Google Play.
Да
  • advertiserId
  • android_id
  • IDFA
  • IDFV
install_time
 
Время установки исходного приложения в формате ISO 8601 UTC:
гггг-мм-ддTЧЧ:ММ:СС.МСС
Нет 2018-01-22T08:45:33.412
медиа-источник
 
  • Либо:
    • Идентификатор партнера AppsFlyer
    • Настраиваемый медиа-источник (не может быть идентификатором партнера).
  • Чтобы получить список идентификаторов партнеров в соответствии с требованиями AppsFlyer:
  • Формат: Значения чувствительны к регистру.
Да


Неорганические: facebook_int, googleadwords_int

Органические: organic

integrated_partner
 
  • Указывает, является ли медиа-источник интегрированным партнером. Имеется в виду органический или индивидуально настраиваемый медиа-источник.
     
  • Формат: Значения чувствительны к регистру
Да
  • Да
  • Нет (если media_source имеет значение custom)
кампания
 

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

Формат: Строка

Нет  
campaign_id
 

 Для более детальной атрибуции укажите исходный идентификатор кампании.

Формат: Строка без пробелов

Нет  

Правила для CSV-файла:

  • CSV-файл может содержать сведения об устройствах пользователей по нескольким приложениям.
  • Не используйте одну и ту же комбинацию идентификатора устройства и идентификатора приложения в нескольких строках. Если происходит дублирование, используется последнее вхождение в файле.
  • Должны быть включены все заголовки столбцов: app_id, platform, device_id, id_type, install_time, media_source, integrated_partner, campaign, campaign_id. Примечание: Порядок столбцов важен, и его необходимо соблюдать.
  • По одному и тому же устройству можно добавить и IDFV, и IDFA, но они должны находиться в разных строках. В этих строках все поля, кроме device_id, будут одинаковыми.
  • Каждая строка должна содержать ровно 9 полей, разделенных запятыми.
  • Оставьте необязательные поля пустыми.
  • Файлы могут содержать до 5 млн строк.
  • Если у вас несколько файлов, дайте каждому файлу уникальное имя.
  • В качестве кодировки используйте UTF-8.
  • [Необязательно] Сжимайте файлы с помощью ZIP или GZIP. 

См. образец CSV

Неатрибутируемая миграция

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

Структура CSV-файла для миграции устройств без атрибуции

Вариант Столбцы Когда использовать Пример
1 App ID + IDFA/GAID/IDFV
  • Если у всех ваших пользователей Android есть идентификаторы GAID.
  • Только пользователи iOS  
device_migration_file_option_1.png
2 App ID + Device ID + Device ID type
  • Если у некоторых из ваших пользователей Android есть только IMEI или Android ID, но нет GAID (независимые площадки, версии Android ниже 4.4.2).
  • Android ID должен иметь шестнадцатеричный формат.
Примечание:
  • Используйте точно эти строки для столбца ID type: advertiserId (также поддерживается amazon_aid), idfa, idfv, android_id, imei.
  • Если вы используете android_id или imei, и позднее AppsFlyer получит лучший идентификатор, может быть зарегистрирована новая атрибуция.
device_migration_file_option_2.png

Правила для CSV-файла:

  • CSV-файл может содержать сведения об устройствах пользователей по нескольким приложениям.
  • Каждая строка содержит один идентификатор устройства для одного приложения. 
  • В зависимости от выбранного варианта структуры файла столбцы файла должны быть следующими (и в указанном порядке):
    • Вариант 1: app_id,device_id 
    • Вариант 2: app_id,device_id,id_type  
  • App ID строчными буквами
  • Идентификаторы Android строчными буквами
  • IDFA/IDFV заглавными буквами
  • Допускается до 25 млн. строк

См. образец CSV