App Store-Abonnement-Tracking

Hilfe vom Entwicklungsteam erforderlich

Sie benötigen Hilfe von Ihrem Entwicklungsteam, um diese Integration einzurichten. Bitte teilen Sie diese Anleitung mit ihnen.

Integrationsübersicht

App Store Server Notifications ist Apples Server-zu-Server-Dienst, der Ihrem Backend eine Echtzeitnachricht sendet, wann immer sich der Status eines Abonnements ändert.

Durch die Verbindung von App Store Server Notifications mit Pushwoosh können Sie auf Kündigungen reagieren, ohne eine eigene Backend-Infrastruktur aufbauen zu müssen. Wenn ein Benutzer die automatische Verlängerung für ein Abonnement in seinem App Store-Konto deaktiviert, benachrichtigt Apple Pushwoosh, und Pushwoosh löst ein PW_SubscriptionCancel-Ereignis im passenden Benutzerprofil aus.

Hinweis

Diese Integration unterstützt derzeit iOS-Abonnements (App Store Server Notifications V2).

Integrationstyp

Quelle: App Store Server Notifications werden von Apple an Pushwoosh gesendet.

Synchronisiertes Ereignis

Ereignisname	Beschreibung	Attribute
PW_SubscriptionCancel	Wird ausgelöst, wenn ein Benutzer die automatische Verlängerung für ein App Store-Abonnement deaktiviert.	productID — der App Store-Produktidentifikator des gekündigten Abonnements.

Funktionsweise

1. Ein Benutzer deaktiviert die automatische Verlängerung für sein Abonnement im App Store.
2. Apple sendet eine App Store Server Notification (V2) an Ihre Pushwoosh-Benachrichtigungs-URL.
3. Pushwoosh dekodiert die signierte Nutzlast und liest den appAccountToken aus der Transaktion.
4. Pushwoosh sucht das Gerät, dessen HWID mit diesem Token übereinstimmt, findet den damit verbundenen Benutzer und postet das PW_SubscriptionCancel-Ereignis für diesen Benutzer.

Wichtig

Die Zuordnung zwischen einer App Store-Transaktion und einem Pushwoosh-Benutzer basiert auf dem appAccountToken. Wenn Ihre App diesen Token zum Zeitpunkt des Kaufs nicht setzt, empfängt Pushwoosh zwar die Benachrichtigung, aber es wird kein Ereignis gepostet. Siehe So setzen Sie den appAccountToken.

Anwendungsfall: Abwandernde Abonnenten zurückgewinnen

Eine Kündigung erfolgt selten sofort. Ein Benutzer, der die automatische Verlängerung deaktiviert, behält sein Abonnement bis zum Ende des bezahlten Zeitraums. Dieses Zeitfenster ist Ihre beste Chance, ihn zurückzugewinnen.

Mit dem PW_SubscriptionCancel-Ereignis können Sie eine Customer Journey starten, sobald die automatische Verlängerung deaktiviert wird. Senden Sie eine Push-Benachrichtigung mit einem Rückgewinnungsangebot, gefolgt von einer E-Mail, die Funktionen hervorhebt, die der Benutzer verlieren würde, oder zeigen Sie eine In-App-Nachricht mit einem Rabatt auf die nächste Verlängerung an. Sie können Benutzer erreichen, bevor das Abonnement tatsächlich ausläuft.

Einrichtung der Integration

Setzen Sie den appAccountToken auf die Pushwoosh-HWID des Geräts

Pushwoosh identifiziert den richtigen Benutzer anhand der HWID des Geräts. Daher muss Ihre App die Pushwoosh-HWID des Geräts als appAccountToken anhängen, wenn das Abonnement über StoreKit gekauft wird.

Standardmäßig verwendet das Pushwoosh iOS SDK den identifierForVendor (IDFV) des Geräts als HWID. IDFV ist bereits eine UUID, genau das Format, das Apple für den appAccountToken verlangt. Pushwoosh löst dann automatisch den Benutzer auf, der aktuell an dieses Gerät gebunden ist, sodass dies funktioniert, unabhängig davon, ob Sie Ihre eigenen Benutzer-IDs mit setUserId zuweisen oder nicht.

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)

Vorsicht

Wenn Ihre App die Pushwoosh-HWID überschreibt (z. B. über das persistente HWID-Modul PushwooshKeychain oder einen benutzerdefinierten Wert), setzen Sie den appAccountToken auf dieselbe HWID. Der Token muss mit der HWID des Geräts in Pushwoosh übereinstimmen, sonst kann das Ereignis nicht zugeordnet werden.

Finden Sie Ihren Pushwoosh-Anwendungscode

Öffnen Sie Ihre Anwendung im Pushwoosh Control Panel. Ihr Anwendungscode (Format XXXXX-XXXXX) wird unter dem Projektnamen in der Seitenleiste angezeigt.

Sie benötigen den Anwendungscode, um die Benachrichtigungs-URL zu erstellen.

Fügen Sie die Benachrichtigungs-URL in App Store Connect hinzu

1. Gehen Sie in App Store Connect zu Apps → Ihre App → App-Informationen (unter Allgemein) und scrollen Sie zu App Store Server Notifications.
2. Wählen Sie Benachrichtigungen der Version 2 aus.
3. Setzen Sie sowohl die Produktionsserver-URL als auch die Sandbox-Server-URL auf:

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

4. Ersetzen Sie YOUR_APPLICATION_CODE durch den Anwendungscode aus dem vorherigen Schritt. Behalten Sie den abschließenden Schrägstrich bei.

Hinweis

Wenn Ihr Konto im US-Rechenzentrum gehostet wird, verwenden Sie stattdessen https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/. Wenn Sie sich nicht sicher sind, welches Rechenzentrum Ihr Konto verwendet, wenden Sie sich an Ihren Customer Success Manager oder den Pushwoosh Support.

Bestätigen Sie das Ereignis in Pushwoosh

Wenn Pushwoosh die erste App Store-Benachrichtigung verarbeitet, registriert es PW_SubscriptionCancel in Ihrem Projekt mit dem String-Attribut productID. Öffnen Sie nach einem Sandbox-Test Audience → Events, um zu überprüfen, ob das Ereignis angezeigt wird. Es ist dann bereit für Segmentierung, Statistiken und Customer Journeys.

Erstellen Sie Ihre Rückgewinnungskampagne

Erstellen Sie eine Customer Journey mit einem auslöserbasierten Eintritt für das PW_SubscriptionCancel-Ereignis und fügen Sie die Nachrichten hinzu, die Sie an Benutzer senden möchten, die kurz vor der Abwanderung stehen.

Testen

App Store Server Notifications können in der Sandbox-Umgebung von Apple ausgelöst werden. Um die Integration zu überprüfen:

1. Tätigen Sie einen Sandbox-Abonnementkauf, bei dem der appAccountToken wie oben beschrieben gesetzt ist.
2. Deaktivieren Sie die automatische Verlängerung auf dem Abonnementverwaltungsbildschirm des Geräts.
3. Öffnen Sie im Pushwoosh Control Panel das Benutzerprofil und gehen Sie zum Ereignisverlauf.
4. Bestätigen Sie, dass PW_SubscriptionCancel innerhalb weniger Augenblicke erscheint.