Краткий обзор: Интегрируйте 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
Идентификатор устройства Amplitude
Чтобы включить атрибуцию на уровне пользователя, вы должны передать идентификатор устройства Amplitude в SDK AppsFlyer. Это значение отправляется с каждым постбэком.
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())
Язык: Java/Kotlin
Документация: Справка по Android SDK, Amplitude
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];
Язык: Objective-C
Документация: Справочник по iOS SDK, Amplitude
AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]
Язык: Swift
Документация: Справочник по iOS SDK, Amplitude
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId());
AppsFlyer.setAdditionalData(customData);
Язык: C#
Документация: Справочник по Unity SDK
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);
Язык: JavaScript
Документация: Справочник по React Native SDK
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});
Язык: JavaScript
Документация: Не применимо
var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);
Язык: Dart
Документация: Справочник по SDK Flutter
Идентификатор пользователя клиента
Настройка идентификатора пользователя (CUID). Это уникальный идентификатор, который обычно генерируется и устанавливаемый владельцем приложения во время регистрации пользователя.
Подробнее
Идентификатор сессии Amplitude
Настройте идентификатор сессии Amplitude и передайте его в AppsFlyer (необязательно). Подробнее
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())
Язык: Java/Kotlin
Документация: Справочник по SDK Android
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];
Язык: Objective-C
Документация: Справочник по SDK iOS
AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]
Язык: Swift
Документация: Справочник по SDK iOS
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId());
AppsFlyer.setAdditionalData(customData);
Язык: C#
Документация: Справочник по Unity SDK
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);
Язык: JavaScript
Документация: Справочник по React Native SDK
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});
Язык: JavaScript
Документация: Не применимо
var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);
Язык: Dart
Документация: Справочник по SDK Flutter
Настройка интеграции
Для настройки интеграции:
- В AppsFlyer перейдите в Сотрудничество > Маркетплейс партнёров.
- Чтобы настроить интеграцию Amplitude V1, выберите Amplitude V1 (Tech partner).
Чтобы настроить интеграцию Amplitude V2, выберите Amplitude V2 (Tech partner).
- После выбора версии Amplitude нажмите Настроить интеграцию.
- На вкладке Интеграция:
- Выберите своё приложение.
- Включите переключатель Активировать партнёра.
- Завершите настройку на оставшихся вкладках:
Вкладка «Интеграция»
На вкладке «Интеграция» есть несколько разделов, которые описаны ниже.
Активация партнёра
При первом заходе сюда включите Активацию партнёра, чтобы настройка параметров на вкладке интеграции стала возможной. Этот переключатель должен быть активирован все время, пока вы работаете с этим партнёром.
Подробнее об активации партнёров.
Общие настройки
Расширенный обмен данными
Чтобы обмениваться с 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 могут получить только пользователи, у которых есть роль администратора или менеджера.
- Войдите в свой аккаунт Amplitude.
- В правом верхнем углу страницы нажмите на значок настройки > Organization Settings (Настройки организации).
- Нажмите Projects (Проект) и выберите проект, из которого нужно отправлять данные в AppsFlyer.
- На вкладке Project (Проект) скопируйте свой ключ API.
- Перейдите к настройке Amplitude на дэшборде AppsFlyer.
Постбэки по умолчанию
AppsFlyer может отправлять автоматические постбэки в Amplitude после установки пользователя. В этом разделе можно определить источник пользователей, которому нужно отправлять постбэки. Узнайте больше о постбэках по умолчанию.
Настройки внутренних событий приложения
- Введите ключ API.
- Когда Центр обработки данных Amplitude выключен, постбэки о внутренних событиях отправляются в центр обработки данных в США.
Для отправки постбэков о внутренних событиях в центр обработки данных в ЕС включите Центр обработки данных Amplitude.
После сохранения конфигурации AppsFlyer отправляет в Amplitude следующие данные:
- Идентификатор устройства (IDFV / Google Advertising ID)
- Медиа-источник
- Название кампании
Отправка IDFA для устройств iOS осуществляется с согласия пользователя на ATT и с учётом настроек повышенной конфиденциальности.
Постбэки по внутренним событиям приложения
Настройка передачи постбэков по внутренним событиям приложения в Amplitude.
Вкладка «Ссылки атрибуции»
Вкладка «Затраты»
Данные о расходах не поддерживаются при интеграции с этим партнёром.
Вкладка «Доходы от рекламы»
Доход от рекламы не поддерживается при интеграции с этим партнёром.
Вкладка «Разрешения»
Разрешения недоступны для Amplitude.
Просмотр данных атрибуции в консоли Amplitude
Данные атрибуции, отправленные из AppsFlyer в Amplitude, отображаются на ваших дэшбордах в виде событий и свойств с префиксом [AppsFlyer]:
Важно!
В некоторых случаях Amplitude показывает данные, полученные от AppsFlyer, как «Заблокировано». Если вы не видите данные AppsFlyer в Amplitude, проверьте, не определено ли это событие как заблокированное.
Отправка событий Amplitude в AppsFlyer
Эта интеграция также позволяет отправлять ваши события Amplitude в AppsFlyer через API сервер-сервер. См. документацию Amplitude, чтобы узнать, как это сделать.