RevenueCat

RevenueCat ist die einzige Quelle der Wahrheit für Ihren Abo-Status auf iOS, Android und im Internet. Ganz gleich, ob Sie eine neue App entwickeln oder bereits Millionen von Abonnent:innen haben, mit RevenueCat können Sie plattformübergreifende In-App-Käufe erstellen, Ihre Produkte und Abonnent:innen verwalten und Ihre Daten analysieren – ganz ohne Server-Code.

Diese Integration wird von RevenueCat gepflegt.

Über die Integration

Die Integration von RevenueCat und Braze ermöglicht es Ihnen, die Kauf-Events und Abo-Lebenszyklen Ihrer Kund:innen automatisch plattformübergreifend zu synchronisieren. So können Sie Campaigns erstellen, die auf die Phase des Abo-Lebenszyklus Ihrer Kund:innen reagieren, z. B. die Ansprache von Kund:innen, die sich während der kostenlosen Testphase abgemeldet haben, oder das Versenden von Erinnerungen an Kund:innen mit Rechnungsproblemen.

Voraussetzungen

Zumindest müssen Sie die Integration über das RevenueCat-Dashboard aktivieren, um RevenueCat mit Braze zu verbinden. Wenn Sie das Braze SDK verwenden, können Sie die SDKs von RevenueCat und Braze zusammen verwenden, um die Integration zu verbessern, indem Sie sicherstellen, dass in beiden Systemen derselbe Bezeichner für die Kund:innen verwendet wird.

Anwendungsfälle

• Triggern Sie eine Onboarding-Campaign, die Ihre Premium-Features hervorhebt, wenn Kund:innen eine kostenlose Testversion starten.
• Senden Sie eine Erinnerung zur Aktualisierung der Abrechnungsinformationen, wenn ein Ereignis „Abrechnungsproblem“ empfangen wird.
• Senden Sie eine Umfrage, nachdem Kund:innen eine kostenlose Testversion gekündigt haben.

Integration

1. Schritt: Braze-Nutzer:innen-Identität festlegen

Im Braze SDK können Sie die Braze-Nutzer-ID so einstellen, dass sie mit der RevenueCat-App-Nutzer-ID übereinstimmt. So wird sichergestellt, dass die von Braze und RevenueCat gesendeten Ereignisse mit denselben Nutzer:innen synchronisiert werden können.

Konfigurieren Sie das Braze SDK mit derselben App-Nutzer-ID wie RevenueCat oder verwenden Sie die Braze-SDK-Methode .changeUser().

• swift
• objective-c
• java

1
2
3
4
5
6
7
8
9
// Configure Purchases SDK
Purchases.configure(withAPIKey: "public_sdk_key", appUserID: "my_app_user_id")

// Change user in Braze SDK
Appboy.sharedInstance()?.changeUser("my_app_user_id")

// Optional User Alias Object attributes
Purchases.shared.setAttributes(["$brazeAliasName" : "name",
                             "$brazeAliasLabel" : "label"])

1
2
3
4
5
6
7
8
9
10
11
// Configure Purchases SDK
[RCPurchases configureWithAPIKey:@"public_sdk_key" appUserID:@"my_app_user_id"];

// Change user in Braze SDK
[[Appboy sharedInstance] changeUser:@"my_app_user_id"];

// Optional User Alias Object attributes
[[RCPurchases sharedPurchases] setAttributes:@{
    @"$brazeAliasName": @"name",
    @"$brazeAliasLabel": @"label"
}];

1
2
3
4
5
6
7
8
9
10
11
12
// Configure Purchases SDK
Purchases.configure(this, "public_sdk_key", "my_app_user_id");

// Change user in Braze SDK
Braze.getInstance(context).changeUser(my_app_user_id);

// Optional User Alias Object attributes
Map<String, String> attributes = new HashMap<String, String>();
attributes.put("$brazeAliasName", "name");
attributes.put("$brazeAliasLabel", "label");

Purchases.getSharedInstance().setAttributes(attributes);

Nutzer-Alias-Objekt an Braze senden (optional)

Wenn Sie einen alternativen eindeutigen Bezeichner senden möchten, der sich von der RevenueCat-App-Nutzer-ID unterscheidet, aktualisieren Sie die Nutzer:innen mit den folgenden Daten als RevenueCat-Abonnent:innen-Attribute.

Beide Attribute sind erforderlich, damit das Nutzer-Alias-Objekt zusammen mit Ihren Ereignisdaten gesendet werden kann. Diese Eigenschaften können manuell eingestellt werden, wie jedes andere RevenueCat-Abonnent:innen-Attribut. Beispiele für Code-Snippets finden Sie in Schritt 1.

2. Schritt: RevenueCat-Ereignisse an Braze senden

Nachdem Sie das RevenueCat-Purchases-SDK und das Braze SDK so eingerichtet haben, dass sie dieselbe Nutzer:innen-Identität verwenden, können Sie die Integration einschalten und die Ereignisnamen über das RevenueCat-Dashboard konfigurieren.

1. Navigieren Sie zu Ihrem Projekt im RevenueCat-Dashboard und suchen Sie im linken Menü die Karte Integrations. Wählen Sie + New.
2. Wählen Sie als Nächstes Braze aus den verfügbaren Integrationen aus und fügen Sie Ihre Braze-Instanz und Ihren Braze-REST-API-Schlüssel hinzu.
3. Geben Sie die Ereignisnamen ein, die RevenueCat senden soll, oder wählen Sie die Standard-Ereignisnamen. Weitere Einzelheiten zu den verfügbaren Ereignissen finden Sie in Schritt 3.
4. Wählen Sie aus, ob RevenueCat den Erlös (nach dem App-Shop-Anteil) oder den Umsatz (Bruttoumsatz) melden soll.

3. Schritt: Ereignisnamen konfigurieren

Geben Sie die Ereignisnamen ein, die RevenueCat senden soll, oder wählen Sie aus den Standard-Ereignisnamen, indem Sie Use Default Event Names auswählen. Die Ereignisse, deren Versand RevenueCat unterstützt, werden in der folgenden Tabelle beschrieben.

Bei Ereignissen, die Einnahmen beinhalten, zeichnet RevenueCat diesen Betrag automatisch zusammen mit dem Ereignis in Braze auf, z. B. bei Conversions von Testversionen und Verlängerungen.

Verwendung dieser Integration

Nachdem Sie die Braze-Einstellungen in RevenueCat konfiguriert haben, fließen die Ereignisse automatisch von RevenueCat zu Braze, ohne dass Sie weitere Maßnahmen ergreifen müssen.

Anpassung

Sandbox-API-Schlüssel zum Testen hinzufügen

Wenn Sie RevenueCat nur einen Braze-REST-API-Schlüssel zur Verfügung stellen, werden nur Produktionsereignisse gesendet. Wenn Sie auch Sandbox-Testereignisse senden möchten, erstellen Sie einen weiteren Braze-REST-API-Schlüssel und fügen Sie ihn zu Ihren Braze-Einstellungen in RevenueCat hinzu.