App Store subscription tracking

Developer assistance needed

You’ll need help from your development team to set up this integration. Please share this guide with them.

Integration overview

App Store Server Notifications is Apple’s server-to-server service that sends your backend a real-time message whenever a subscription’s status changes.

By connecting App Store Server Notifications to Pushwoosh, you can react to cancellations without building your own backend infrastructure. When a user turns off auto-renewal for a subscription in their App Store account, Apple notifies Pushwoosh, and Pushwoosh fires a PW_SubscriptionCancel event on the matching user profile.

ملاحظة

This integration currently supports iOS subscriptions (App Store Server Notifications V2).

Integration type

Source: App Store Server Notifications are sent from Apple to Pushwoosh.

Synchronized event

Event name	Description	Attributes
PW_SubscriptionCancel	Fired when a user turns off auto-renewal for an App Store subscription.	productID — the App Store product identifier of the canceled subscription.

How it works

1. A user disables auto-renewal for their subscription in the App Store.
2. Apple sends an App Store Server Notification (V2) to your Pushwoosh notification URL.
3. Pushwoosh decodes the signed payload and reads the appAccountToken from the transaction.
4. Pushwoosh looks up the device whose HWID matches that token, finds the user bound to it, and posts the PW_SubscriptionCancel event for that user.

Important

The match between an App Store transaction and a Pushwoosh user relies on the appAccountToken. If your app doesn’t set this token at purchase time, Pushwoosh receives the notification but no event is posted. See how to set appAccountToken.

Use case: Win back churning subscribers

A cancellation is rarely instant. A user who disables auto-renewal keeps their subscription until the end of the paid period. That window is your best chance to win them back.

With the PW_SubscriptionCancel event, you can launch a Customer Journey the moment auto-renewal is turned off. Send a push notification with a retention offer, follow up with an email highlighting features the user would lose, or show an in-app message with a discount on their next renewal. You can reach users before the subscription actually lapses.

Setting up the integration

Set appAccountToken to the device’s Pushwoosh HWID

Pushwoosh identifies the right user from the device’s HWID, so your app must attach the device’s Pushwoosh HWID as the appAccountToken when the subscription is purchased through StoreKit.

By default, the Pushwoosh iOS SDK uses the device’s identifierForVendor (IDFV) as the HWID. IDFV is already a UUID, exactly the format Apple requires for appAccountToken. Pushwoosh then resolves the user currently bound to that device automatically, so this works whether or not you assign your own User IDs with setUserId.

StoreKit 2

// Attach the device's Pushwoosh HWID (the default IDFV) as the 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 must be a UUID string to populate appAccountToken
let payment = SKMutablePayment(product: product)
payment.applicationUsername = UIDevice.current.identifierForVendor?.uuidString
SKPaymentQueue.default().add(payment)

تنبيه

If your app overrides the Pushwoosh HWID (for example, via the PushwooshKeychain persistent HWID module or a custom value), set appAccountToken to that same HWID. The token must match the device’s HWID in Pushwoosh, or the event cannot be attributed.

Find your Pushwoosh Application Code

Open your application in the Pushwoosh Control Panel. Your Application Code (format XXXXX-XXXXX) is shown below the project name in the sidebar.

You’ll need the Application Code to build the notification URL.

Add the notification URL in App Store Connect

1. In App Store Connect, go to Apps → your app → App Information (under General), and scroll to App Store Server Notifications.
2. Select Version 2 notifications.
3. Set both the Production Server URL and the Sandbox Server URL to:

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

4. Replace YOUR_APPLICATION_CODE with the Application Code from the previous step. Keep the trailing slash.

ملاحظة

If your account is hosted in the US data center, use https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/ instead. If you’re unsure which data center your account uses, contact your Customer Success Manager or Pushwoosh Support.

Confirm the event in Pushwoosh

When Pushwoosh processes the first App Store notification, it registers PW_SubscriptionCancel in your project with a string attribute productID. After a sandbox test, open Audience → Events to verify the event appears. It is then ready for segmentation, statistics, and Customer Journeys.

Build your win-back campaign

Create a Customer Journey with a trigger-based entry on the PW_SubscriptionCancel event, and add the messages you want to send to users who are about to churn.

Testing

App Store Server Notifications can be triggered in Apple’s Sandbox environment. To verify the integration:

1. Make a sandbox subscription purchase with appAccountToken set as described above.
2. Disable auto-renewal from the device’s subscription management screen.
3. In Pushwoosh Control Panel, open the user profile and go to Events history.
4. Confirm that PW_SubscriptionCancel appears within a few moments.