App Store 구독 추적

개발자 지원 필요

이 통합을 설정하려면 개발팀의 도움이 필요합니다. 이 가이드를 개발팀과 공유해주세요.

통합 개요

App Store 서버 알림은 구독 상태가 변경될 때마다 백엔드에 실시간 메시지를 보내는 Apple의 서버 간 서비스입니다.

App Store 서버 알림을 Pushwoosh에 연결하면 자체 백엔드 인프라를 구축하지 않고도 구독 취소에 대응할 수 있습니다. 사용자가 App Store 계정에서 구독의 자동 갱신을 끄면 Apple이 Pushwoosh에 알리고, Pushwoosh는 일치하는 사용자 프로필에서 PW_SubscriptionCancel 이벤트를 발생시킵니다.

참고

이 통합은 현재 iOS 구독(App Store 서버 알림 V2)을 지원합니다.

통합 유형

소스: App Store 서버 알림은 Apple에서 Pushwoosh로 전송됩니다.

동기화된 이벤트

이벤트 이름	설명	속성
PW_SubscriptionCancel	사용자가 App Store 구독의 자동 갱신을 비활성화할 때 발생합니다.	productID — 취소된 구독의 App Store 제품 식별자입니다.

작동 방식

1. 사용자가 App Store에서 구독의 자동 갱신을 비활성화합니다.
2. Apple이 Pushwoosh 알림 URL로 App Store 서버 알림(V2)을 보냅니다.
3. Pushwoosh가 서명된 페이로드를 디코딩하고 트랜잭션에서 appAccountToken을 읽습니다.
4. Pushwoosh는 HWID가 해당 토큰과 일치하는 기기를 조회하고, 해당 기기에 바인딩된 사용자를 찾아 해당 사용자에 대해 PW_SubscriptionCancel 이벤트를 게시합니다.

중요

App Store 트랜잭션과 Pushwoosh 사용자 간의 일치는 appAccountToken에 따라 달라집니다. 앱이 구매 시 이 토큰을 설정하지 않으면 Pushwoosh는 알림을 수신하지만 이벤트는 게시되지 않습니다. appAccountToken 설정 방법을 참조하세요.

사용 사례: 이탈 구독자 재확보

구독 취소는 즉시 이루어지지 않는 경우가 많습니다. 자동 갱신을 비활성화한 사용자는 유료 기간이 끝날 때까지 구독을 유지합니다. 이 기간이 고객을 다시 유치할 수 있는 가장 좋은 기회입니다.

PW_SubscriptionCancel 이벤트를 사용하면 자동 갱신이 비활성화되는 순간에 Customer Journey를 시작할 수 있습니다. 리텐션 제안이 포함된 푸시 알림을 보내고, 사용자가 잃게 될 기능을 강조하는 이메일로 후속 조치를 취하거나, 다음 갱신 시 할인이 포함된 인앱 메시지를 표시할 수 있습니다. 구독이 실제로 만료되기 전에 사용자에게 도달할 수 있습니다.

통합 설정하기

appAccountToken을 기기의 Pushwoosh HWID로 설정하기

Pushwoosh는 기기의 HWID로 올바른 사용자를 식별하므로, 앱은 StoreKit을 통해 구독을 구매할 때 기기의 Pushwoosh HWID를 appAccountToken으로 첨부해야 합니다.

기본적으로 Pushwoosh iOS SDK는 기기의 identifierForVendor(IDFV)를 HWID로 사용합니다. IDFV는 이미 UUID 형식이며, 이는 Apple이 appAccountToken에 요구하는 형식과 정확히 일치합니다. 그런 다음 Pushwoosh는 해당 기기에 현재 바인딩된 사용자를 자동으로 확인하므로, setUserId로 자체 User ID를 할당했는지 여부와 관계없이 이 방법이 작동합니다.

StoreKit 2

// 기기의 Pushwoosh HWID(기본 IDFV)를 appAccountToken으로 첨부합니다
var options: Set<Product.PurchaseOption> = []
if let hwid = UIDevice.current.identifierForVendor {
    options.insert(.appAccountToken(hwid))
}

let result = try await product.purchase(options: options)

StoreKit 1

// applicationUsername은 appAccountToken을 채우기 위해 UUID 문자열이어야 합니다
let payment = SKMutablePayment(product: product)
payment.applicationUsername = UIDevice.current.identifierForVendor?.uuidString
SKPaymentQueue.default().add(payment)

주의

앱이 Pushwoosh HWID를 재정의하는 경우(예: PushwooshKeychain 영구 HWID 모듈 또는 사용자 지정 값을 통해), appAccountToken을 동일한 HWID로 설정해야 합니다. 토큰은 Pushwoosh에 있는 기기의 HWID와 일치해야 하며, 그렇지 않으면 이벤트를 귀속시킬 수 없습니다.

Pushwoosh Application Code 찾기

Pushwoosh Control Panel에서 애플리케이션을 엽니다. Application Code(XXXXX-XXXXX 형식)는 사이드바의 프로젝트 이름 아래에 표시됩니다.

알림 URL을 빌드하려면 Application Code가 필요합니다.

App Store Connect에 알림 URL 추가하기

1. App Store Connect에서 앱 → 해당 앱 → 앱 정보(일반 아래)로 이동한 다음 App Store 서버 알림으로 스크롤합니다.
2. 버전 2 알림을 선택합니다.
3. 프로덕션 서버 URL과 샌드박스 서버 URL을 모두 다음과 같이 설정합니다:

https://appstore-notifications.pushwoosh.com/appstore/YOUR_APPLICATION_CODE/

4. YOUR_APPLICATION_CODE를 이전 단계의 Application Code로 바꾸세요. 마지막 슬래시(/)는 유지하세요.

참고

계정이 미국 데이터 센터에서 호스팅되는 경우, 대신 https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/를 사용하세요. 계정이 어떤 데이터 센터를 사용하는지 확실하지 않은 경우, 고객 성공 관리자 또는 Pushwoosh 지원팀에 문의하세요.

Pushwoosh에서 이벤트 확인하기

Pushwoosh가 첫 번째 App Store 알림을 처리하면, 문자열 속성 productID와 함께 PW_SubscriptionCancel을 프로젝트에 등록합니다. 샌드박스 테스트 후 Audience → Events를 열어 이벤트가 나타나는지 확인하세요. 그러면 세분화, 통계 및 Customer Journey에 사용할 준비가 된 것입니다.

고객 재확보 캠페인 구축하기

PW_SubscriptionCancel 이벤트에 대한 트리거 기반 진입으로 Customer Journey를 생성하고, 이탈하려는 사용자에게 보낼 메시지를 추가하세요.

테스트

App Store 서버 알림은 Apple의 샌드박스 환경에서 트리거할 수 있습니다. 통합을 확인하려면 다음을 수행하세요:

1. 위에서 설명한 대로 appAccountToken을 설정하여 샌드박스 구독 구매를 합니다.
2. 기기의 구독 관리 화면에서 자동 갱신을 비활성화합니다.
3. Pushwoosh Control Panel에서 사용자 프로필을 열고 이벤트 기록으로 이동합니다.
4. PW_SubscriptionCancel이 잠시 후 나타나는지 확인합니다.