Интеграция Amplitude с AppsFlyer

Краткий обзор: Интегрируйте AppsFlyer с Amplitude, чтобы делиться данными атрибуции пользователей и аналитикой по событиям для лучшего понимания вовлечённости пользователей, удержания и дохода. Выберите одну из двух версий интеграции: V1 или V2 в зависимости от ваших целей и потребностей в аналитике.

Об интеграции

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

Существует две версии интеграции Amplitude:

  • Amplitude V1:
    Эта версия использует API атрибуции Amplitude. AppsFlyer отправляет данные об установках, собранные после завершения интеграции. Amplitude использует идентификатор рекламы в качестве идентификатора и удаляет данные, если в течение 72 часов не зарегистрировано соответствующее событие пользователя. Подробнее
  • Amplitude V2:
    Эта версия использует HTTP V2 API Amplitude. AppsFlyer отправляет как данные об установках, так и данные о событиях в приложении после завершения интеграции. Приоритет отдаётся идентификаторам (user_id и device_id) и, если сопоставление не удаётся, регистрируется новый пользователь. Подробнее

 

Версии интеграции:

Версия Используемый API Используемые идентификаторы Охват событий
V1 API атрибуции Рекламный идентификатор (AdID) Только установки
V2 HTTP V2 API user_id, device_id (логика резервного варианта) Установки и внутренние события приложения

Важно!

  • Выберите интеграцию Amplitude V1 или V2. Не используйте обе версии одновременно. Использование обеих версий одновременно может привести к отправке дублирующихся событий в Amplitude.
  • Некоторые медиа-источники ограничивают передачу данных третьим лицам. Постбэки для ограниченных событий не будут отправляться этому партнёру, даже если они настроены.

Необходимые условия

Прежде чем начать:

  • Свяжитесь с Amplitude, чтобы создать учётную запись, если у вас её ещё нет.
  • Выберите версию интеграции Amplitude: V1 или V2.
  • Проверьте, чтобы у вас не отправлялись одни и те же события как из SDK Amplitude, так и из AppsFlyer, чтобы предотвратить дублирование.
  • См. дополнительные необходимые условия для интеграции Amplitude V2.

Дополнительные необходимые условия для интеграции Amplitude V2.

Для интеграции V2 необходимо настроить:

Идентификатор устройства Amplitude

Чтобы включить атрибуцию на уровне пользователя, вы должны передать идентификатор устройства Amplitude в SDK AppsFlyer. Это значение отправляется с каждым постбэком.

Android iOS (Objective-C) iOS (Swift) Unity React Native Cordova Flutter
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())

Язык: Java/Kotlin

Документация:  Справка по Android SDK, Amplitude

Идентификатор пользователя клиента

Настройка идентификатора пользователя (CUID).  Это уникальный идентификатор, который обычно генерируется и устанавливаемый владельцем приложения во время регистрации пользователя.
Подробнее

Идентификатор сессии Amplitude

Настройте идентификатор сессии Amplitude и передайте его в AppsFlyer (необязательно). Подробнее

Android iOS (Objective-C) iOS (Swift) Unity React Native Cordova Flutter
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())

Язык: Java/Kotlin

Документация: Справочник по SDK Android

Настройка интеграции

Для настройки интеграции:

  1. В AppsFlyer перейдите в Сотрудничество > Маркетплейс партнёров.
  2. Чтобы настроить интеграцию Amplitude V1, выберите Amplitude V1 (Tech partner).

    Select Amplitude V1 doctored.png


    Чтобы настроить интеграцию Amplitude V2, выберите Amplitude V2 (Tech partner). 

    Select Amplitude V2.png

     
  3. После выбора версии Amplitude нажмите Настроить интеграцию.

    Click set up integration.png
     
  4. На вкладке Интеграция:
    • Выберите своё приложение.
    • Включите переключатель Активировать партнёра.

      Activate partner blurred.png

       
  5. Завершите настройку на оставшихся вкладках:

Вкладка «Интеграция»

На вкладке «Интеграция» есть несколько разделов, которые описаны ниже.

Активация партнёра

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

Общие настройки

Расширенный обмен данными

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

Свойство Amplitude Точка данных AppsFlyer
sub_publisher af_siteid
network_name pid
adgroup_name af_adset
creative_name af_ad_id
installed_at install_timestamp
search_term af_keywords
channel af_channel
user_id af_customer_user_id
af_sub1 af_sub1
af_sub2 af_sub2
af_sub3 af_sub3
af_sub4 af_sub4
af_sub5 af_sub5
app_version app_version

Центр обработки данных Amplitude в ЕС

Когда Центр обработки данных Amplitude в ЕС выключен, постбэки об установках отправляются в центр обработки данных в США.
Для отправки постбэков об установках в центр обработки данных в ЕС включите Центр обработки данных Amplitude в ЕС.

Ключ API

Amplitude подключается с AppsFlyer через уникальный ключ API. Если у вас ещё нет ключа, для продолжения интеграции вы должны получить его от Amplitude или выполнить следующие шаги.

Получение ключа API от Amplitude

Примечание: доступ к ключу API могут получить только пользователи, у которых есть роль администратора или менеджера.

  1. Войдите в свой аккаунт Amplitude.
  2. В правом верхнем углу страницы нажмите на значок настройки > Organization Settings (Настройки организации).
    Amplitude
  3. Нажмите Projects (Проект) и выберите проект, из которого нужно отправлять данные в AppsFlyer. 
    amplitude
  4. На вкладке Project (Проект) скопируйте свой ключ API.
    Amplitude
  5. Перейдите к настройке Amplitude на дэшборде AppsFlyer.

Постбэки по умолчанию

AppsFlyer может отправлять автоматические постбэки в Amplitude после установки пользователя. В этом разделе можно определить источник пользователей, которому нужно отправлять постбэки. Узнайте больше о постбэках по умолчанию.

Настройки внутренних событий приложения

  • Введите ключ API.
  • Когда Центр обработки данных Amplitude выключен, постбэки о внутренних событиях отправляются в центр обработки данных в США.
    Для отправки постбэков о внутренних событиях в центр обработки данных в ЕС включите Центр обработки данных Amplitude.

После сохранения конфигурации AppsFlyer отправляет в Amplitude следующие данные:

  • Идентификатор устройства (IDFV / Google Advertising ID)
  • Медиа-источник
  • Название кампании

Отправка IDFA для устройств iOS осуществляется с согласия пользователя на ATT и с учётом настроек повышенной конфиденциальности.

Постбэки по внутренним событиям приложения

Настройка передачи постбэков по внутренним событиям приложения в Amplitude.

Вкладка «Ссылки атрибуции»

Ссылки атрибуции недоступны для Amplitude.

Вкладка «Затраты»

Данные о расходах не поддерживаются при интеграции с этим партнёром.

Вкладка «Доходы от рекламы»

Доход от рекламы не поддерживается при интеграции с этим партнёром.

Вкладка «Разрешения»

Разрешения недоступны для Amplitude.

Просмотр данных атрибуции в консоли Amplitude

Данные атрибуции, отправленные из AppsFlyer в Amplitude, отображаются на ваших дэшбордах в виде событий и свойств с префиксом [AppsFlyer]:

amplitude-properties.png

 Важно!

В некоторых случаях Amplitude показывает данные, полученные от AppsFlyer, как «Заблокировано». Если вы не видите данные AppsFlyer в Amplitude, проверьте, не определено ли это событие как заблокированное.amplitude-blocked-data.png

Отправка событий Amplitude в AppsFlyer

Эта интеграция также позволяет отправлять ваши события Amplitude в AppsFlyer через API сервер-сервер. См. документацию Amplitude, чтобы узнать, как это сделать.