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

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

1. Интегрируйте SDK AppsFlyer в приложение.
   См. руководства по интеграции SDK для Android и iOS.
2. Сопоставьте внутренние события приложения, которые вы хотите регистрировать, с помощью схем AppsFlyer.
   Это можно сделать через SDK или S2S.

3. Удалите SDK конкурирующего поставщика атрибуции.
   Это можно сделать сразу, перейдя исключительно на AppsFlyer, или одновременно использовать оба SDK в течение нескольких недель. Смотрите описание этих вариантов в таблице ниже.
    

   Вариант	Что происходит после выпуска обновленной версии приложения	Эффект
   Удалить SDK конкурента (рекомендуется)	Новые установки и обновления регистрирует только AppsFlyer. Конкурент по-прежнему отображает события, выполненные пользователями, пока пользователи не обновят свое приложение.	Быстрый переход. Отсутствие двойной атрибуции.
   Оставить SDK конкурента на период миграции	Атрибутируют новые установки и регистрируют события и AppsFlyer, и конкурент. На следующем этапе следует удалить SDK конкурента.	Возможна проверка данных. Это означает, что вы можете сравнивать данные AppsFlyer и системы другого поставщика. Двойная атрибуция может вызвать двойные расходы в рекламных сетях. См. приведенные ниже примеры. Повышенная нагрузка.

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

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

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

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

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

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

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

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

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

Правила для 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	Идентификатор приложения + IDFA/GAID	Если у всех ваших пользователей Android есть идентификаторы GAID. Только пользователи iOS
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 получит лучший идентификатор, может быть зарегистрирована новая атрибуция. android_id и imei по умолчанию не собираются SDK AppsFlyer. Если вы используете любой из этих идентификаторов, обязательно собирайте их при интеграции SDK.

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

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

См. образец CSV

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

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

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

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

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

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

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

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

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

Чтобы изменить текущие ссылки собственных медиа на ссылки AppsFlyer OneLink:

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

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

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

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

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

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

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

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

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