RevenueCat-Integration

Unterstützung durch Entwickler erforderlich

Sie benötigen die Unterstützung Ihres Entwicklungsteams, um die Integration einzurichten. Bitte teilen Sie diese Anleitung mit ihnen.

RevenueCat ist eine Plattform zur Abonnementverwaltung, die In-App-Käufe und Abonnements für Unternehmen auf iOS-, Android- und Web-Plattformen vereinfacht. Sie bietet umfassende Werkzeuge zum Erstellen, Analysieren und Verbessern von In-App-Abonnements.

Durch die Integration von Pushwoosh mit RevenueCat können Unternehmen gezielte Push-Benachrichtigungen, In-App-Aufforderungen und andere Nachrichten an Benutzer senden, basierend auf Abonnement-Events, die von RevenueCat an Pushwoosh gesendet werden. Dies kann Benutzer dazu ermutigen, Abonnements zu erneuern, auf höhere Stufen aufzurüsten oder Sonderangebote zu nutzen, was das Engagement erhöht, den Umsatz maximiert und die Abonnementverwaltung vereinfacht.

Anwendungsfälle

Personalisierte Kommunikation

Unternehmen können die Integration nutzen, um die Kommunikation mit Kunden zu personalisieren. Zum Beispiel kann eine E-Learning-Plattform das Benutzerengagement steigern, indem sie personalisierte Push-Benachrichtigungen sendet, wenn eine Änderung des Abonnementplans erkannt wird. Diese Benachrichtigungen bieten Anleitungen für den Übergang, empfehlen relevante Kurse basierend auf dem neuen Plan und bieten exklusive Vorteile, die auf das Update abgestimmt sind.

Benachrichtigungen bei Abrechnungsproblemen

Wenn bei dem Abonnement eines Benutzers ein Abrechnungsproblem auftritt, können Unternehmen die RevenueCat-Integration mit Pushwoosh nutzen, um umgehend gezielte Benachrichtigungen zu senden. Zum Beispiel kann ein Streaming-Dienst den Benutzer über das Abrechnungsproblem informieren und Anweisungen zur Lösung geben, wie z. B. die Aktualisierung der Zahlungsinformationen.

Benachrichtigungen bei nicht verlängerbaren Käufen

Unternehmen können die RevenueCat-Integration mit Pushwoosh nutzen, um einmalige Käufe in dauerhafte Kundenbeziehungen umzuwandeln. Zum Beispiel kann ein Essenslieferdienst eine Push-Benachrichtigung nach dem Kauf senden, um dem Kunden zu danken und relevante Produkte zu empfehlen oder einen Abonnementplan für fortgesetzten Komfort zu bewerben. Dies fördert die Kundenbindung, treibt Upsell-Möglichkeiten voran und kann potenziell einmalige Käufer in Abonnenten umwandeln.

Werbeaktionen für Tier-Upgrades

Apps mit mehreren Abonnementstufen können die Integration nutzen, um Benutzerabonnements zu überwachen und maßgeschneiderte Upgrade-Aufforderungen zu senden. Zum Beispiel könnte eine Gaming-App Push-Benachrichtigungen verwenden, um die Vorteile von Premium-Stufen wie exklusive Inhalte oder Rabatte hervorzuheben und Benutzer zu ermutigen, ihre Abonnements zu erhöhen.

Events

Jeder Webhook, den RevenueCat sendet, wird zu einem Pushwoosh-Event mit dem Namen RC_ plus dem RevenueCat-Event-Typ, zum Beispiel RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE oder RC_EXPIRATION. Pushwoosh erstellt das Event, wenn zum ersten Mal ein Webhook dieses Typs eintrifft, sodass neue RevenueCat-Event-Typen von selbst in Ihrer App erscheinen. Die vollständige Liste finden Sie unter Event-Typen in der RevenueCat-Dokumentation.

Jedes Event enthält die Felder des RevenueCat-Webhooks als Event-Attribute, zum Beispiel price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code und entitlement_ids:

• Felder, die eine Zeit in Millisekunden enthalten, werden zu Datumsangaben ohne das Suffix _ms, zum Beispiel purchased_at und expiration_at. Das Datum, an dem der Webhook gesendet wurde, ist das Attribut timestamp.
• Diese Datumsangaben sind in UTC und haben das Format YYYY-MM-DD, ohne Uhrzeit.
• Die Kundenattribute, die Sie in RevenueCat festlegen, werden ebenfalls zu Event-Attributen. Attribute, die eine Person oder ein Gerät identifizieren, wie E-Mail, Telefonnummer, Anzeigename, IP-Adresse, Werbe-IDs und Push-Tokens, werden nicht an Pushwoosh übergeben.
• Ein Event speichert bis zu 100 Attribute.

Käufe aus dem App Store, Google Play, dem Mac App Store und Amazon werden auf den Plattformen iOS, Android, macOS und Amazon erfasst. Käufe aus anderen Stores, wie Stripe, RevenueCat Billing oder Werbe-Gutschriften (Promotional Grants), werden ohne Plattform erfasst.

Sie können diese Events in Ihren Customer Journeys verwenden. Events mit dem Attribut price können mit der RFM-Segmentierung verwendet werden.

Tipp

Sie können den Umsatz für Events wie RC_INITIAL_PURCHASE, RC_RENEWAL oder RC_NON_RENEWING_PURCHASE (unter Verwendung ihrer Attribute price und currency) auch als Conversion-Events erfassen. Erfassen Sie keinen Umsatz für RC_CANCELLATION oder RC_EXPIRATION. Conversion-Events unterstützen keine Rückerstattungen oder Stornierungen, sodass sie weiterhin als Umsatz gezählt würden.

Einrichten der Integration

Die Integration funktioniert über RevenueCat-Webhooks, die im Pro-Tarif von RevenueCat verfügbar sind.

RevenueCat-Kunden Pushwoosh-Nutzern zuordnen

Pushwoosh erfasst einen Webhook für den Pushwoosh-Nutzer, den er angibt, und überspringt einen Webhook, der gar keinen Nutzer angibt. Wählen Sie, wie RevenueCat den Nutzer angibt:

• Wenn Ihre App Nutzer mit einer eigenen ID identifiziert und diese als App User ID an RevenueCat übergibt, verwenden Sie die App User ID als Pushwoosh-User-ID.
• Wenn sich die App User ID von der Pushwoosh-User-ID unterscheidet, zum Beispiel wenn RevenueCat anonyme IDs wie $RCAnonymousID:… verwendet, senden Sie die Pushwoosh-IDs als RevenueCat-Attribute. Ohne sie landen Events bei einer User-ID, die Pushwoosh nicht kennt.

Die RevenueCat App User ID als Pushwoosh-User-ID verwenden

Legen Sie die App User ID, die Sie an RevenueCat übergeben, als Pushwoosh-User-ID fest (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Pushwoosh-IDs als RevenueCat-Attribute senden

Legen Sie in RevenueCat die Attribute pushwooshUserId und pushwooshHwid fest. Pushwoosh verwendet sie anstelle der App User ID:

• pushwooshUserId: die Pushwoosh-User-ID des Kunden.
• pushwooshHwid: die Pushwoosh-Hardware-ID (HWID) des Geräts des Kunden. Sie ist optional. Ohne sie verwendet Pushwoosh die User-ID als 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-Webhooks an Pushwoosh senden

In Ihrem RevenueCat-Dashboard:

1. Öffnen Sie Ihr Projekt, suchen Sie die Karte Integrationen im linken Menü und klicken Sie auf + Neu.

2. Wählen Sie Webhooks.

3. Wenn RevenueCat die Liste Ihrer Webhooks anzeigt, klicken Sie auf Neue Konfiguration hinzufügen.
4. Geben Sie der Integration einen einfachen Namen, wie z. B. Pushwoosh, zur leichten Identifizierung.
5. Geben Sie die folgende URL als Webhook-URL ein:

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

Ersetzen Sie in der URL APP_CODE durch Ihren bestehenden Pushwoosh-Anwendungscode, den Sie unter dem Namen Ihrer Anwendung in Ihrem Pushwoosh-Konto finden.

6. Fügen Sie in das Feld Authorization header value Ihr Pushwoosh API-Token ein. Sie finden dieses Token unter Einstellungen > API-Zugang in Pushwoosh.

7. Entscheiden Sie, ob Sie Events für Produktions- (Live-)Käufe, Sandbox- (Test-)Käufe oder beides übertragen möchten.
8. Geben Sie im Dropdown-Menü App an, ob Webhook-Events für eine einzelne App oder alle Apps innerhalb des Projekts gesendet werden sollen.
9. Wählen Sie im Dropdown-Menü Event-Typ aus, ob alle Events gesendet werden sollen oder geben Sie an, welche Events an Pushwoosh gesendet werden sollen.

10. Wählen Sie, ob alle Events, nur erfolgreiche Events oder nur fehlgeschlagene Events angezeigt werden sollen.

Um die Verbindung zu prüfen, senden Sie einen Test-Webhook aus RevenueCat. Eine erfolgreiche Zustellung bedeutet, dass Pushwoosh die URL und das API-Token akzeptiert hat. Der Test-Webhook selbst wird nicht als Event erfasst: Jedes RC_-Event erscheint unter Zielgruppe → Events in Ihrer Pushwoosh-App, sobald der erste echte Webhook dieses Typs eintrifft.