Кратко: Kahuna — интегрированный партнер AppsFlyer, который помогает компаниям расти и процветать в эпоху мобильных технологий. Мы обеспечиваем новый уровень подлинной вовлеченности между брендами и их клиентами, где бы они ни находились — в интернете, в электронной почте, на мобильных устройствах, в социальных каналах — благодаря персонализированной коммуникации в масштабе. Используя большие данные и машинное обучение, мы помогаем создавать превосходный опыт для каждого клиента благодаря идеальному сообщению, доставленному по нужному каналу в нужное время.
Важно!
Некоторые медиа-источники ограничивают передачу данных третьим лицам. Поэтому постбэки для ограниченных событий не будут отправляться этому партнёру, независимо от настроек отправки постбэков.
Чтобы настроить интеграцию с Kahuna, следуйте инструкциям ниже:
1. Минимальные требования — AppsFlyer SDK:
- Android – версия 2.3.1.18 и выше
- iOS – версия 3.3.3 и выше
2. Для интеграции с Kahuna необходимо, чтобы идентификатор устройства Kahuna (уникальный идентификатор пользователя Kahuna) был указан в SDK AppsFlyer. Этот параметр отправляется с каждым постбэком и позволяет идентифицировать каждого пользователя. Для этого необходимо вставить в код приложения следующие строки:
Важное замечание
Убедитесь, что строки кода вставлены в правильное место — после запуска SDK Kahuna и до вызова методов appsflyer.sendtracking (Android) / trackAppLaunch (iOS).
HashMap<String, Object> customData = new HashMap<String,Object>();
String deviceId = Kahuna.getInstance().getKahunaDeviceId();
customData .put("customData", deviceId);
AppsFlyerLib.setAdditionalData(customData);
NSString *kahunaDeviceID = [Kahuna getKahunaDeviceId];
[[AppsFlyerTracker sharedTracker] setAdditionalData:@{@"customData" : kahunaDeviceID}];
Настройка Kahuna
Необходимые условия. Перед настройкой интеграции необходимо связаться с партнером и открыть у него аккаунт.
Чтобы активировать интеграцию:
-
Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество > Маркетплейс партнеров.
Чтобы изменить: В боковом меню AppsFlyer выберите Сотрудничество > Активные интеграции. - Выберите соответствующее приложение.
- Нажмите Настроить интеграцию.
- При первом заходе сюда включите Активацию партнера, чтобы настройка параметров на вкладке интеграции стала возможной. Примечание. Подробнее об активации/деактивации партнеров.
- Завершите настройку, используя соответствующие вкладки, как описано в следующем разделе. Подробное описание заголовка окна настройки параметров партнера см. здесь.
В окне настройки Kahuna используется только вкладка Integration.
Вкладка «Интеграция»
Вкладка Integration («Интеграция») содержит несколько разделов, которые описаны ниже.
Активация партнера
При первом посещении нужно переключить переключатель ниже. При первом посещении вам нужно будет включить переключатель Активировать партнера, чтобы включить настройку параметров на вкладке интеграции. Кнопка ДОЛЖНА оставаться в положении «Включено», пока вы работаете с этим партнером.
Дополнительная информация по активации партнеров доступна здесь.
Общие настройки
Секретный ключ Kahuna, Staging и Production
Kahuna подключается к AppsFlyer с помощью уникального секретного ключа. Если у вас его ещё нет, для продолжения интеграции необходимо получить его у Kahuna или выполнить следующие шаги.
Получение секретного ключа Kahuna
1. Войдите в свою учетную запись Kahuna
2. Нажмите на значок пользователя и выберите Настройки в правом верхнем углу меню дэшборда
3. Скопируйте секретный ключ Kahuna:
4. Выберите APIs & Integrations — на этой странице вы найдете параметры:
- Вставьте Kahuna Master Key, полученный из консоли Kahuna (см. раздел 3)
- Если вы хотите отправлять события в среду Sandbox Kahuna, введите букву S в поле Staging (см. раздел «Тестирование с использованием Kahuna Sandbox»)
- Для рабочей среды введите букву P в поле Production
- Если ввести обе буквы, события будут отправляться в рабочую среду
- Нажмите Сохранить.
Постбэки по умолчанию
AppsFlyer может отправлять автоматические постбэки по установкам пользователей Kahuna. В этом разделе можно определить отправку этих постбэков.
Выберите События, атрибутированные любому партнеру или органические, чтобы отправлять постбэки в Kahuna для любого пользователя, который скачивает приложение.
Нажмите кнопку Сохранить.
После сохранения конфигурации AppsFlyer отправляет в Kahuna следующие данные для каждой органической и неорганической установки:
- Kahuna Dev_ID
- Источник медиа
- Доступно только в расширенных отчётах.
- Версия ОС
Вкладка «Ссылки атрибуции»
Ссылки атрибуции недоступны для Kahuna.
Вкладка «Стоимость»
Данные о расходах не поддерживаются при интеграции с этим партнёром.
Вкладка «Доходы от рекламы»
Доход от рекламы не поддерживается при интеграции с этим партнёром.
Вкладка Permissions (Разрешения)
Разрешения недоступны для Kahuna.
Просмотр данных атрибуции пользователей в Kahuna
События установки можно просматривать как Newbies на основном дэшборде Kahuna.
Вы можете найти конкретного пользователя или перейти в раздел «Top People» в меню слева.
При выборе одного из пользователей открывается Mini Profile, где в разделе Top Events можно увидеть событие установки «af_install»:
Тестирование через sandbox
Если вы еще не выпустили приложение в магазин приложений и хотите протестировать интеграцию из среды Sandbox Kahuna, выполните следующие действия:
1. Убедитесь, что при настройке Kahuna в AppsFlyer вы вводите «s» в поле Staging
2. Убедитесь, что вы добавили код в свое приложение для интеграции SDK AppsFlyer и Kahuna, как описано в разделах выше
3. Вам нужно получить Advertising ID с тестового устройства (его можно найти, установив приложение на устройство и просмотрев логи)
4. Попросите AppsFlyer добавить ваш Advertising ID в список разрешенных
5. Удалите приложение с устройства
6. Настройте этот URL-адрес, указав свои данные (имя пакета приложения, advertising ID и название кампании... не включайте скобки) - https://app.appsflyer.com/[APP PACKAGE NAME]?pid=[SOMETHING]&advertising_id=[DEVICE’S ADVERTISING ID]
7. Перейдите по этому URL-адресу, вы можете увидеть следующее:
8. Установите приложение на свое устройство
9. Перейдите в дэшборд Kahuna и найдите пользователя (можно включить отладку Kahuna и посмотреть логи, чтобы получить уникальный идентификатор устройства Kahuna для этого пользователя.. “dev_id”... или, если для вашего приложения требуется вход в систему и вы передаете учетные данные в Kahuna, можно также выполнить поиск по этим учетным данным). Когда вы найдете пользователя, вы должны увидеть событие “af_install” для этого пользователя.