# RevenueCat-Integration

<Aside type="caution" icon="setting" title="Hilfe von Entwicklern benötigt">
 Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Bitte teilen Sie diese Anleitung mit ihnen.
</Aside>

[RevenueCat](https://www.revenuecat.com/) 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](https://www.revenuecat.com/) 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 über nicht verlängerbare Käufe

Unternehmen können die RevenueCat-Integration mit Pushwoosh nutzen, um einmalige Käufe in dauerhafte Kundenbeziehungen umzuwandeln. Zum Beispiel kann ein Essenslieferdienst nach dem Kauf eine Push-Benachrichtigung 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-Levels wie exklusive Inhalte oder Rabatte hervorzuheben und Benutzer zu ermutigen, ihre Abonnements zu erhöhen.

## Ereignisse

Die Integration ermöglicht die Verfolgung verschiedener Ereignisse, die automatisch in Pushwoosh erstellt werden, sobald das erste Ereignis von RevenueCat gesendet wird. Zu diesen Ereignissen gehören:

| Event                 | Event-Name      <div style="width:160px"></div>                   | Beschreibung                                                                                                                      | Attribute       <div style="width:200px"></div>                                                                                                   |
|---------------------- |--------------------------- |------------------------------------------------------------------------------------------------------------------------------ |--------------------------------------------------------------------------------------------------------------- |
| Erstkauf      | `RC_INITIAL_PURCHASE`      | Ein neues Abonnement wurde gekauft.                                                                                        | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul>                                   |
| Nicht verlängerbarer Kauf | `RC_NON_RENEWING_PURCHASE` | Ein Kunde hat einen Kauf getätigt, der sich nicht automatisch verlängert.                                                                      | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul>                                   |
| Verlängerung              | `RC_RENEWAL`               | Ein bestehendes Abonnement wurde verlängert oder ein abgelaufener Benutzer hat sich erneut angemeldet.                                                 | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li></ul>                                   |
| Produktwechsel       | `RC_PRODUCT_CHANGE`        | Ein Abonnent hat das Produkt seines Abonnements geändert.                                                                  |                                                                                                              |
| Stornierung         | `RC_CANCELLATION`          | Ein Abonnement oder ein nicht verlängerbarer Kauf wurde storniert.                                                                   |                                                                                                             |
| Abrechnungsprobleme       | `RC_BILLING_ISSUE`         | Beim Versuch, den Abonnenten zu belasten, ist ein Problem aufgetreten.                                                             |                                                                                                              |
| Abonnement-Alias   | `RC_SUBSCRIBER_ALIAS`      | Tritt auf, wenn eine neue `app_user_id` für einen bestehenden Abonnenten registriert wurde.                                         |                                                                                                             |
| Abonnement pausiert  | `RC_SUBSCRIPTION_PAUSED`   | Das Abonnement wurde so eingestellt, dass es am Ende des Zeitraums pausiert wird.                                                         |                                                                                                              |
| Stornierung rückgängig gemacht      | `RC_UNCANCELLATION`        | Ein nicht abgelaufenes, storniertes Abonnement wurde wieder aktiviert.                                                                    |                                                                                                             |
| Übertragung            | `RC_TRANSFER`              | Eine Übertragung von Transaktionen und Berechtigungen wurde von einer App-Benutzer-ID zu einer anderen initiiert.                            |                                                                                                             |
| Abonnement verlängert | `RC_SUBSCRIPTION_EXTENDED` | Ein bestehendes Abonnement wurde verlängert (das Ablaufdatum des aktuellen Abonnementzeitraums wurde nach vorne verschoben). |                                                                                                             |
| Ablauf          | `RC_EXPIRATION`            | Das Abonnement eines Kunden läuft ab.                                                                                      | <ul><li>price</li><li>price_in_purchased_currency</li><li>currency</li><li>expiration_at</li><li>purchased_at</li></ul> |

Sie können all diese Ereignisse in Ihren [Customer Journeys](/de/product/customer-journey/pushwoosh-journey-overview) verwenden. Ereignisse mit dem Attribut Preis können mit der [RFM-Segmentierung](/de/product/audience-data-and-segmentation/segmentation/rfm-segmentation) verwendet werden.

## Einrichten der Integration

### Synchronisieren von User-IDs und HWIDs zwischen Pushwoosh und RevenueCat

Um Ereignisse zwischen RevenueCat und Pushwoosh mit demselben Benutzer zu synchronisieren, müssen Sie die Pushwoosh UserID so einstellen, dass sie mit der RevenueCat App User ID übereinstimmt. Setzen Sie dazu die appUserID aus dem RevenueCat SDK im Pushwoosh SDK. [Erfahren Sie mehr über die RevenueCat appUserID](https://www.revenuecat.com/docs/customers/user-ids#provide-app-user-id-on-configuration)

#### Für Android

Setzen Sie die aus dem RevenueCat SDK erhaltene appUserID im Pushwoosh SDK mit der Methode `Pushwoosh.getInstance().setUserId(appUserIDFromRC);`.

#### Für iOS

Setzen Sie die aus dem RevenueCat SDK erhaltene appUserID im Pushwoosh SDK mit der Methode `[[Pushwoosh sharedInstance] setUserId: appUserIDFromRC];`.

### Senden von RevenueCat-Events an Pushwoosh

Nachdem Sie die User-IDs und HWIDs in Pushwoosh und RevenueCat synchronisiert haben, aktivieren Sie die Pushwoosh-Integration in Ihrem RevenueCat-Dashboard.

1. Navigieren Sie zu Ihrem Projekt im RevenueCat-Dashboard und finden Sie die Integrationskarte im linken Menü. Klicken Sie auf **+ Neu** oder **Integration hinzufügen**

<img src="/integrations-revenuecat-integration-1.webp" alt="Finden von Integrationen im RevenueCat-Dashboard"/>

2. Wählen Sie **Webhooks** aus dem Menü **Integrationen**

<img src="/integrations-revenuecat-integration-2.webp" alt="Auswählen von Webhooks aus dem Integrationsmenü"/>

3. Geben Sie der Integration einen einfachen Namen, wie z. B. _Pushwoosh_, zur leichten Identifizierung.
4. Geben Sie die folgende URL in das Feld **Webhook URL** ein:

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

<img src="/integrations-revenuecat-integration-3.webp" alt="Eingabe der Webhook-URL für die Pushwoosh-Integration"/>

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

<img src="/integrations-revenuecat-integration-4.webp" alt="Finden des Pushwoosh-Anwendungscodes"/>

5. Fügen Sie in das Feld **Authorization header value** Ihren **Pushwoosh API-Token** ein. Sie finden diesen Token unter **Einstellungen > API-Zugang** in Pushwoosh.

<img src="/integrations-revenuecat-integration-5.webp" alt="Eingabe des Pushwoosh API-Tokens im Autorisierungsheader"/>

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

<img src="/integrations-revenuecat-integration-6.webp" alt="Konfigurieren von Ereignistypen im RevenueCat-Webhook"/>

9. Wählen Sie, ob alle Ereignisse, nur erfolgreiche Ereignisse oder nur fehlgeschlagene Ereignisse angezeigt werden sollen.

<img src="/integrations-revenuecat-integration-7.webp" alt="Auswählen von Ereignisanzeigeoptionen im Webhook"/>

Zusätzlich haben Sie die Möglichkeit, einen Test-Webhook zu senden.