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

Требуется помощь разработчика

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

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

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

После настройки интеграции AppsFlyer будет отправлять в Pushwoosh следующую информацию:

• Поведение пользователей в приложении в виде событий (Events) и их атрибутов;
• Источники привлечения пользователей в виде значений тега Acquisition Source.

Примеры использования

Используя эти данные, вы можете создавать сегменты пользователей и проводить точно таргетированные и персонализированные кампании в Pushwoosh. Ниже приведены два примера использования данных AppsFlyer для создания эффективных Customer Journeys в Pushwoosh.

1. Создавайте высокотаргетированные кампании в Pushwoosh, используя события, отслеживаемые AppsFlyer.

Допустим, у вас есть новостное приложение. Вы настроили AppsFlyer для отслеживания события SubscribedToNews, которое срабатывает каждый раз, когда пользователь подписывается на новостной канал. У этого события есть атрибут категории, указывающий на тип новостей, на которые подписывается пользователь: politics, business или sports.

Pushwoosh получает информацию об этом событии со значениями его атрибутов. Вы можете создать три сегмента пользователей на основе трех возможных значений:

Теперь вы можете создавать кампании, нацеленные на пользователей, которые интересуются определенным типом новостей:

2. Персонализируйте сообщения на основе данных о поведении пользователей из AppsFlyer.

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

AppsFlyer отправляет данные о событии AddToWishlist в Pushwoosh, где вы можете персонализировать сообщения в зависимости от выбора пользователей. Например, вы можете создать пресет пуш-уведомления, предлагающий скидку на товар, который пользователь добавил в свой список желаний. Вместо названия товара добавьте плейсхолдер динамического контента с атрибутом item:

Если пользователь добавит товар в свой список желаний, он получит пуш-уведомление с информацией о нем. Например, те, кто выберет iPhone 14 Pro Max, увидят такое сообщение:

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

Примечание

Процесс интеграции одинаков для платформ Android и iOS.

1. Интегрируйте Pushwoosh SDK в ваше приложение, если вы еще этого не сделали. Для получения более подробных инструкций прочтите руководство.

Осторожно

Для корректной работы требуется Pushwoosh iOS SDK версии 6.5.7 или выше и Pushwoosh Android SDK версии 6.6.16 или выше.

2. Чтобы убедиться, что в AppsFlyer отправляются правильные данные, интегрируйте этот фрагмент кода в ваш код. Убедитесь, что он выполняется после инициализации как Pushwoosh SDK, так и AppsFlyer SDK.

Java

String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);

Objective-C

NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];

Опасно

При использовании кастомных значений Pushwoosh UserID для идентификации и таргетинга пользователей, убедитесь, что код выполняется после вызова метода setUserId() в Pushwoosh SDK с кастомным значением.

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

3. Настройте интеграцию с Pushwoosh в AppsFlyer. Для этого в вашем аккаунте AppsFlyer перейдите в Collaborate > Partner Marketplace. В списке партнеров найдите и выберите Pushwoosh.

4. Нажмите Set up integration. Затем вы будете перенаправлены на страницу настройки интеграции. Там включите переключатель Activate partner.

Примечание

Для iOS-приложений по умолчанию включен Advanced Privacy Mode, который позволяет контролировать доступность данных атрибуции на уровне пользователя через платформу AppsFlyer. Хотя AppsFlyer не отправляет этот тип данных в Pushwoosh, включенный переключатель Advanced Privacy может мешать передаче данных.

Чтобы убедиться, что Pushwoosh получает все данные, мы рекомендуем отключить Advanced Privacy Mode в App Settings. Это не нарушит конфиденциальность пользовательских данных. Pushwoosh стремится к безопасному и ответственному управлению данными, используя стандартные отраслевые протоколы безопасности для защиты конфиденциальности.

5. В разделе General settings введите ваши учетные данные Pushwoosh:

• API Access Token. Чтобы получить токен, в вашем аккаунте Pushwoosh перейдите в Settings > API Access и скопируйте код. Вы можете узнать больше о токене доступа к API в этом руководстве.
• Application Code (XXXXX-XXXXX), который вы можете найти под названием вашего приложения в вашем аккаунте Pushwoosh.

6. В разделе Default postback выберите All media sources, including organic.

7. В разделе In-app event settings введите ваш Application Code и API Access Token от Pushwoosh.

8. Включите переключатель In-app event postback и настройте события и данные, которые будут включены в постбэки, отправляемые в Pushwoosh.

Выберите одно или несколько событий AppsFlyer для отправки в Pushwoosh из выпадающего меню и заполните необходимые параметры.

Параметр	Описание
the mapped to partner event	Хотя это поле является обязательным, не беспокойтесь о том, что вы вводите, так как это не изменит названия событий. Pushwoosh все равно будет получать события с теми же именами, что и в AppsFlyer.
for users from	В этом поле выберите, будут ли постбэки отправляться исключительно для пользователей, атрибутированных этому партнеру, или для всех источников медиа, включая органические.
including	Выберите, как данные о событиях будут передаваться в Pushwoosh: No values & no revenue: Отправлять только само событие без каких-либо параметров (значений или дохода). Values & no revenue: Отправлять все параметры, кроме значения дохода. Values & revenue: Отправлять все параметры события, включая значение дохода (если оно есть в событии). Чтобы получать события с дополнительными атрибутами, отправляемыми в Pushwoosh, выберите Values and Revenue.

9. После завершения настройки интеграции нажмите Save.

Примечание

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