RevenueCat 통합

RevenueCat은 iOS, Android 및 웹 플랫폼 전반에 걸쳐 비즈니스의 인앱 구매 및 구독을 단순화하는 구독 관리 플랫폼입니다. 인앱 구독을 구축, 분석 및 향상시키기 위한 포괄적인 도구를 제공합니다.

Pushwoosh를 RevenueCat과 통합함으로써, 기업은 RevenueCat에서 Pushwoosh로 전송된 구독 이벤트를 기반으로 사용자에게 타겟팅된 푸시 알림, 인앱 프롬프트 및 기타 메시지를 보낼 수 있습니다. 이를 통해 사용자가 구독을 갱신하거나, 더 높은 등급으로 업그레이드하거나, 특별 혜택을 이용하도록 유도하여 참여도를 높이고 수익을 극대화하며 구독 관리를 단순화할 수 있습니다.

사용 사례

개인화된 커뮤니케이션

기업은 이 통합을 사용하여 고객과의 커뮤니케이션을 개인화할 수 있습니다. 예를 들어, 이러닝 플랫폼은 구독 요금제 변경을 감지했을 때 개인화된 푸시 알림을 보내 사용자 참여를 높일 수 있습니다. 이러한 알림은 전환 안내를 제공하고, 새 요금제에 기반한 관련 강좌를 추천하며, 업데이트와 관련된 독점 혜택을 제공합니다.

결제 문제 알림

사용자의 구독에 결제 문제가 발생했을 때, 기업은 RevenueCat과 Pushwoosh 통합을 사용하여 신속하게 타겟 알림을 보낼 수 있습니다. 예를 들어, 스트리밍 서비스는 사용자에게 결제 문제를 알리고 결제 정보 업데이트와 같은 해결 방법을 안내할 수 있습니다.

비갱신 구매 알림

기업은 RevenueCat과 Pushwoosh 통합을 활용하여 일회성 구매를 지속적인 고객 관계로 전환할 수 있습니다. 예를 들어, 식사 배달 서비스는 구매 후 푸시 알림을 보내 고객에게 감사 인사를 전하고 관련 제품을 추천하거나 지속적인 편의를 위해 구독 요금제를 홍보할 수 있습니다. 이는 고객 충성도를 높이고, 상향 판매 기회를 창출하며, 일회성 구매자를 구독자로 전환할 수 있는 잠재력을 가집니다.

등급 업그레이드 프로모션

여러 구독 등급이 있는 앱은 이 통합을 사용하여 사용자 구독을 모니터링하고 맞춤형 업그레이드 프롬프트를 보낼 수 있습니다. 예를 들어, 게임 앱은 푸시 알림을 사용하여 독점 콘텐츠나 할인과 같은 프리미엄 레벨의 이점을 강조하여 사용자가 구독을 업그레이드하도록 유도할 수 있습니다.

이벤트

RevenueCat이 보내는 모든 웹훅은 RC_ 뒤에 RevenueCat 이벤트 유형이 붙은 이름의 Pushwoosh 이벤트가 됩니다(예: 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에서 설정한 고객 속성도 이벤트 속성이 됩니다. 이메일, 전화번호, 표시 이름, IP 주소, 광고 ID, 푸시 토큰처럼 사람이나 기기를 식별하는 속성은 Pushwoosh로 전달되지 않습니다.
하나의 이벤트에는 최대 100개의 속성이 저장됩니다.

App Store, Google Play, Mac App Store, Amazon에서의 구매는 iOS, Android, macOS, Amazon 플랫폼에 기록됩니다. Stripe, RevenueCat Billing, 프로모션 지급 등 다른 스토어에서의 구매는 플랫폼 없이 기록됩니다.

이 이벤트를 고객 여정(customer journeys)에서 사용할 수 있습니다. price 속성이 있는 이벤트는 RFM 세분화(RFM segmentation)와 함께 사용할 수 있습니다.

통합 설정하기

이 통합은 RevenueCat 웹훅을 통해 작동하며, 웹훅은 RevenueCat의 Pro 플랜에서 사용할 수 있습니다.

RevenueCat 고객을 Pushwoosh 사용자와 매칭

Pushwoosh는 웹훅이 지정한 Pushwoosh 사용자에 대해 웹훅을 기록하고, 사용자를 전혀 지정하지 않은 웹훅은 건너뜁니다. RevenueCat이 사용자를 지정하는 방법을 선택하세요:

앱이 자체 ID로 사용자를 식별하고 이를 App User ID로 RevenueCat에 전달하는 경우, App User ID를 Pushwoosh User ID로 사용하세요.
App User ID가 Pushwoosh User ID와 다른 경우(예: RevenueCat이 $RCAnonymousID:…와 같은 익명 ID를 사용하는 경우), Pushwoosh ID를 RevenueCat 속성으로 전송하세요. 이 속성이 없으면 이벤트는 Pushwoosh에 없는 User ID로 전달됩니다.

RevenueCat App User ID를 Pushwoosh User ID로 사용

RevenueCat에 전달하는 App User ID를 Pushwoosh User ID(setUserId)로 설정합니다.

Android

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Pushwoosh.configure.setUserId(appUserID)

Pushwoosh ID를 RevenueCat 속성으로 전송

RevenueCat에서 pushwooshUserId 및 pushwooshHwid 속성을 설정합니다. Pushwoosh는 App User ID 대신 이 속성을 사용합니다:

pushwooshUserId: 고객의 Pushwoosh User ID입니다.
pushwooshHwid: 고객 기기의 Pushwoosh 하드웨어 ID(HWID)입니다. 선택 사항입니다. 이 속성이 없으면 Pushwoosh는 User ID를 HWID로 사용합니다.

Android

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

iOS

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

RevenueCat 웹훅을 Pushwoosh로 전송

RevenueCat 대시보드에서:

프로젝트를 열고 왼쪽 메뉴에서 Integrations 카드를 찾은 다음 + New를 클릭합니다.

Webhooks를 선택합니다.

RevenueCat에 웹훅 목록이 표시되면 Add new configuration을 클릭합니다.
쉽게 식별할 수 있도록 통합에 _Pushwoosh_와 같이 간단한 이름을 지정합니다.
다음 URL을 웹훅 URL로 입력합니다:

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

URL에서 APP_CODE를 Pushwoosh 계정의 애플리케이션 이름 아래에 있는 기존 Pushwoosh 애플리케이션 코드로 교체합니다.

Authorization header value 필드에 Pushwoosh API 토큰을 삽입합니다. 이 토큰은 Pushwoosh의 Settings > API Access에서 찾을 수 있습니다.

프로덕션(실제) 구매, 샌드박스(테스트) 구매 또는 둘 다에 대한 이벤트를 전송할지 결정합니다.
App 드롭다운에서 웹훅 이벤트를 단일 앱 또는 프로젝트 내의 모든 앱에 대해 발송할지 지정합니다.
Event Type 드롭다운에서 모든 이벤트를 보낼지 또는 Pushwoosh로 보낼 이벤트를 지정할지 선택합니다.

모든 이벤트, 성공한 이벤트만 또는 실패한 이벤트만 표시하도록 선택합니다.

연결을 확인하려면 RevenueCat에서 테스트 웹훅을 보내세요. 전송에 성공하면 Pushwoosh가 URL과 API 토큰을 수락했다는 뜻입니다. 테스트 웹훅 자체는 이벤트로 기록되지 않습니다. 각 RC_ 이벤트는 해당 유형의 첫 번째 실제 웹훅이 도착하면 Pushwoosh 앱의 오디언스 → 이벤트에 나타납니다.