Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Руководство Adjust по миграции данных

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

Инфографика, на которой демонстрируются этапы переноса данных в Adjust с другого MMP.

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

Примечание:
Если ваш тарифный план включает выделенную поддержку, вам будет предоставлен доступ к семинарам по интеграции SDK, привлечению пользователей, экспорту данных/бизнес-аналитике, работе с Datascape и анализу данных, а также по настройке кампаний для iOS.
Как работает импорт устройств?

Adjust SDK обрабатывает пользователей, которые были у вас до внедрения Adjust SDK, как новых пользователей. Это происходит при первом же открытии приложения. Таким образом, существующие пользователи учитываются как новые установки. Поэтому при использовании других инструментов аналитики или отчетности, а также при сравнении показателей App Store и Google Play, вы увидите несоответствие между общим количеством установок в отчетах.

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

1. Настройте приложение в Adjust

Прежде чем импортировать архивные данные, необходимо настроить ваше приложение в AppView. Все архивные данные импортируются по токену приложения Adjust .

  1. Следуйте инструкциям в руководстве по настройке приложения.
  2. После завершения настройки приложения скопируйте токен приложения .

2. Интегрируйте и протестируйте Adjust SDK

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

Документация SDK доступна в разделе Разработчик справочного центра. Пока вы настраиваете свое приложение для работы с Adjust SDK, обязательно переведите SDK в тестовый режим и включите запись логов в режиме подробных логов, чтобы получить как можно больше информации. По вопросам интеграции SDK обращайтесь к представителям Adjust или по адресу support@adjust.com.

Для упрощения тестирования Adjust предлагает консоль тестирования и API устройств. Используйте эти инструменты для анализа данных, которые SDK отправляет на серверы Adjust.

3. Экспорт архивных данных

После настройки приложения в AppView можно создать файл для импорта, содержащий архивные данные. Экспортируйте данные от предыдущего партнера по мобильным измерениям или из системы бизнес-аналитики и отформатируйте файл описанным здесь образом.

Формат файла

Файл должен быть представлен в формате CSV (разделенные запятыми значения), который:

  • использует кодировку UTF-8;
  • содержит данные, разделенные запятыми;
  • заключен в двойные кавычки (").

Название файла

Имя файла CSV должно содержать следующую информацию в нижнем регистре :

  1. токен приложения, сохраненный в шаге 1;
  2. Hазвание целевой операционной системы (например, ios или android);
  3. тип идентификатора устройства, который содержится в файле.

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

<app_token>_<os_name>_<device_id_type>.csv

Типы идентификаторов устройств

Доступны следующие типы идентификаторов устройств:

Для iOS :

  • idfa
  • idfv

Для устройств Android с таргетингом на Google Play Store :

  • gps_adid
  • android_id

Для устройств Android с таргетингом на магазин приложений Amazon :

  • fire_adid
  • android_id

Пример

В этом примере показано имя файла, которое следует использовать для данных со следующими свойствами.

  1. Относится к приложению с токеном приложения Adjust abc123.
  2. Для устройств под управлением Android .
  3. Идентифицируется по типу идентификатора устройства gps_adid.
abc123_android_gps_adid.csv

Поля

Важно:
В файле CSV необходимо экранировать любые двойные кавычки ( "). Для этого заключите процитированные поля в другие двойные кавычки, как показано ниже: ""High spenders"".

CSV файл должен содержать следующие поля в этом порядке.

ПолеОбязательно или опциональноПример значенияПримечания
device_idОбязательныйB1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8Тире необязательно. Поддерживаемые типы device_id:
  • android_id (case-insensitive)
  • external_device_id (case-sensitive)
  • gps_adid (рекламный идентификатор Google, без учета регистра)
  • fire_adid (case-insensitive)
  • idfa (case-insensitive)
  • idfv (case-insensitive)
created_atОпционально1586391845Метка времени установки Unix — это целое число, указывается в секундах. Если это поле не заполнено в файле для импорта, значение автоматически заполняется временной меткой импорта.
networkОбязательныйИмпортированные устройстваИмпортированные данные следует поместить в отдельную сеть, чтобы избежать путаницы с актуальными наборами данных Adjust. Дополнительные сведения о том, как структурировать эту информацию, см. в таблице сопоставления сетей .
campaignОпциональноironSource
рекламная группаОпциональноironsource_ios_us
креативОпциональноAd Group 1

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

Сопоставление сетей

Важно, чтобы архивные данные были импортированы в плейсхолдер network под названием «Импортированные устройства», как показано в таблице ниже. Все возвращающиеся пользователи попадают под этот плейсхолдер, и ваши данные остаются чистыми. Этот статически закодированный плейсхолдер означает, что Adjust может различать трафик, поступающий от существующих пользователей, то есть пользователей, которые были до внедрения Adjust SDK, и новых пользователей, которые должны быть атрибутированы активной кампании.

При импорте пользователей от одного и того же сетевого партнера по умолчанию могут возникнуть проблемы при анализе определенных KPI, что может ввести в заблуждение при анализе кампаний и эффективности приложений.

Используйте приведенную ниже полную структуру для подробного изучения существующих данных о кампаниях до трех подуровней:

Предыдущее значение системыЗначение импорта CSV AdjustПримечания
networkУстановите для этого параметра неизменяемое значение Imported Devices.
Название сетиcampaign
Название кампаниирекламная группа
Название группы объявленийкреатив

Детализация (сеть, кампания, группа объявлений) импортированных устройств не является обязательной и указывается на случай, если вы хотите сохранить эти данные.

Пример

Вот образец со строкой заголовка и значениями:

device_id,created_at,network,campaign,adgroup,creative
<device_id>,<created_at>,Imported Devices,<network>,<campaign>,<adgroup>

Заполните <device_id>, <created_at>, <network>, <campaign> и <adgroup> значениями из предыдущей системы. Например:

device_id,created_at,network,campaign,adgroup,creative
B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8,1586391845,Imported Devices,ironsource,ironsource_ios_us,Ad Group 1

4. Импорт данных в Adjust

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

Примечание:
Импортированные пользователи автоматически не попадают в отчетность Datascape. Они отображаются при запуске сеанса в вашем приложении после выпуска обновления, содержащего Adjust SDK.

5. Выпуск приложения

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

6. Настройте свои кампании

Следуйте руководствам по настройке кампании для настройки кампаний с сетевыми партнерами и сетями с самоатрибуцией. Если вам нужна помощь в настройке кампании, предоставьте список партнеров своим представителям Adjust.

Если ваш тарифный план включает в себя выделенную поддержку, представитель Adjust пригласит вас на семинар для обсуждения следующих тем:

  • типы кампаний, которые вы можете записывать;
  • уровни информации, которые вы можете получать;
  • как создать ссылку на кампанию;
  • методика атрибуции Adjust.
  • Hастройка кампаний для устройств iOS версии 14 и выше.

После этого вы сможете обратиться к сетям, с которыми вы работаете, для настройки кампаний.

7. Обновление ссылок на кампании

Примечание:
Сети не должны начинать тестирование, пока версия вашего приложения с интегрированным Adjust SDK не будет опубликована в магазине приложений.

После настройки кампаний отправьте ссылки на кампании Adjust сетевым партнерам, чтобы они могли проверить их работоспособность и обновить свои настройки.

8. Знакомство с новой панелью управления Adjust

Вот и все! Теперь вам доступна новая панель управления Adjust. Посетите справочный центр, чтобы ознакомиться с руководствами по следующим темам:

Если вам нужна дополнительная консультация или разъяснения, обратитесь к своему менеджеру по работе с клиентами или напишите на support@adjust.com.