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

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

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

RevenueCat — это платформа для управления подписками, которая упрощает покупки и подписки в приложениях для бизнеса на платформах iOS, Android и в вебе. Она предоставляет комплексные инструменты для создания, анализа и улучшения подписок в приложениях.

Интегрируя Pushwoosh с RevenueCat, компании могут отправлять таргетированные push-уведомления, in-app сообщения и другие уведомления пользователям на основе событий подписки, отправляемых из RevenueCat в Pushwoosh. Это может побудить пользователей продлевать подписки, переходить на более высокие уровни или пользоваться специальными предложениями, повышая вовлеченность, максимизируя доход и упрощая управление подписками.

Варианты использования

Персонализированная коммуникация

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

Уведомления о проблемах с оплатой

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

Уведомления о невозобновляемых покупках

Компании могут использовать интеграцию RevenueCat с Pushwoosh, чтобы превратить разовые покупки в долгосрочные отношения с клиентами. Например, сервис доставки еды может отправить push-уведомление после покупки, поблагодарив клиента и порекомендовав релевантные товары или предложив план подписки для постоянного удобства. Это будет способствовать лояльности клиентов, создавать возможности для дополнительных продаж и потенциально превращать разовых покупателей в подписчиков.

Продвижение перехода на более высокий уровень

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

События

Каждый вебхук, который отправляет RevenueCat, становится событием Pushwoosh с именем RC_ плюс тип события RevenueCat, например RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE или RC_EXPIRATION. Pushwoosh создает событие, когда приходит первый вебхук этого типа, поэтому новые типы событий RevenueCat появляются в вашем приложении сами. Полный список см. в разделе Типы событий документации RevenueCat.

Каждое событие передает поля вебхука RevenueCat как атрибуты события, например price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code и entitlement_ids:

• Поля, которые хранят время в миллисекундах, становятся датами без суффикса _ms, например purchased_at и expiration_at. Дата отправки вебхука — это атрибут timestamp.
• Эти даты указаны в UTC в формате YYYY-MM-DD, без времени суток.
• Атрибуты клиента, которые вы задаете в RevenueCat, тоже становятся атрибутами события. Атрибуты, которые идентифицируют человека или устройство, например email, номер телефона, отображаемое имя, IP-адрес, рекламные идентификаторы и push-токены, в Pushwoosh не передаются.
• Событие хранит до 100 атрибутов.

Покупки из App Store, Google Play, Mac App Store и Amazon записываются на платформы iOS, Android, macOS и Amazon. Покупки из других магазинов, например Stripe, RevenueCat Billing или промо-начисления, записываются без платформы.

Вы можете использовать эти события в своих сценариях Customer Journey. События с атрибутом price можно использовать с RFM-сегментацией.

Совет

Вы также можете отслеживать доход по событиям, таким как RC_INITIAL_PURCHASE, RC_RENEWAL или RC_NON_RENEWING_PURCHASE (используя их атрибуты price и currency), как события-конверсии. Не отслеживайте доход по RC_CANCELLATION или RC_EXPIRATION. События-конверсии не поддерживают возвраты или отмены, поэтому они будут по-прежнему учитываться как доход.

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

Интеграция работает через вебхуки RevenueCat, которые доступны на тарифе Pro в RevenueCat.

Сопоставление клиентов RevenueCat с пользователями Pushwoosh

Pushwoosh записывает вебхук на того пользователя Pushwoosh, которого он указывает, и пропускает вебхук, в котором пользователь не указан вовсе. Выберите, как RevenueCat будет указывать пользователя:

• Если ваше приложение идентифицирует пользователей собственным ID и передает его в RevenueCat как App User ID, используйте App User ID как User ID в Pushwoosh.
• Если App User ID отличается от User ID в Pushwoosh, например когда RevenueCat использует анонимные идентификаторы вида $RCAnonymousID:…, отправляйте идентификаторы Pushwoosh как атрибуты RevenueCat. Без них события попадают на User ID, которого в Pushwoosh нет.

Использование App User ID из RevenueCat как User ID в Pushwoosh

Установите App User ID, который вы передаете в RevenueCat, как User ID в Pushwoosh (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Отправка идентификаторов Pushwoosh как атрибутов RevenueCat

Задайте в RevenueCat атрибуты pushwooshUserId и pushwooshHwid. Pushwoosh использует их вместо App User ID:

• pushwooshUserId: User ID клиента в Pushwoosh.
• pushwooshHwid: аппаратный идентификатор (HWID) устройства клиента в Pushwoosh. Атрибут необязательный. Без него Pushwoosh использует User ID в качестве HWID.

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

Отправка вебхуков RevenueCat в Pushwoosh

В панели управления RevenueCat:

1. Откройте свой проект, найдите карточку Integrations в меню слева и нажмите + New.

2. Выберите Webhooks.

3. Если RevenueCat показывает список ваших вебхуков, нажмите Add new configuration.
4. Дайте интеграции простое имя, например Pushwoosh, для легкой идентификации.
5. Введите следующий URL как URL вебхука:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

В URL замените APP_CODE на код вашего приложения Pushwoosh, который находится под названием вашего приложения в аккаунте Pushwoosh.

6. В поле Authorization header value вставьте ваш API-токен Pushwoosh. Вы можете найти этот токен в разделе Settings > API Access в Pushwoosh.

7. Решите, хотите ли вы передавать события для производственных (реальных) покупок, покупок в песочнице (тестовых) или для обоих.
8. В выпадающем списке App укажите, должны ли события вебхука отправляться для одного приложения или для всех приложений в проекте.
9. В выпадающем списке Event Type выберите, отправлять ли все события или указать, какие именно события отправлять в Pushwoosh.

10. Выберите, показывать ли все события, только успешные или только неудачные.

Чтобы проверить подключение, отправьте тестовый вебхук из RevenueCat. Успешная доставка означает, что Pushwoosh принял URL и API-токен. Сам тестовый вебхук не записывается как событие: каждое событие RC_ появляется в разделе Аудитория → События вашего приложения Pushwoosh, когда приходит первый реальный вебхук этого типа.