So integrieren Sie StopChurn

Erfahren Sie, wie Sie StopChurn mit B2CORE verbinden, um Kundendaten und wichtige Kundenereignisse für Kundenbindungs- und CRM-Prozesse zu synchronisieren

Nutzen Sie die Integration mit StopChurn, um Kundendaten und wichtige Kundenereignisse automatisch von B2CORE an StopChurn zu senden. StopChurn ist eine Plattform für Kundenbindung und CRM und kann diese Daten verwenden, um Kunden zu segmentieren und Kundenbindungskampagnen durchzuführen.

Die Integration unterstützt eine einseitige Datenübertragung von B2CORE an StopChurn. B2CORE ist die einzige maßgebliche Datenquelle: StopChurn empfängt lediglich Daten. Es werden keine Daten von StopChurn zurück nach B2CORE übertragen.

Bevor Sie fortfahren, stellen Sie sicher, dass Sie Zugriff auf das StopChurn Back Office haben und von StopChurn einen API-Schlüssel und eine Brand ID erhalten haben. Wenden Sie sich bei Fragen an das StopChurn-Team.

StopChurn vorbereiten

Führen Sie diese Schritte in StopChurn aus, bevor Sie die Verbindung in B2CORE aktivieren.

Felder der Kontakttabelle prüfen

Öffnen Sie im StopChurn Back Office unter Datenbank > Tabellendefinitionen die Benutzer- bzw. Kontakttabelle. B2CORE befüllt für jeden StopChurn-Kontakt die folgenden Felder:

Identität: ID, E-Mail-Adresse, Telefonnummer, Vorname, Nachname, Geburtsdatum
Standort und Profil: Land (Name), Ländercode, Währung, Jurisdiktion, Sprache, Kundentyp (Privatperson oder Unternehmen), Registrierungsdatum, Verifizierungsstufe
KYC: KYC-Status, Einreichungsdatum für KYC, Genehmigungsdatum für KYC
Einzahlungen: Datum und Betrag der ersten und letzten Einzahlung, Gesamteinzahlungsbetrag, Nettoeinzahlung
Handel: Datum des ersten und letzten Handelsgeschäfts, Gesamtzahl der Handelsgeschäfte, Eröffnungsdatum des Handelskontos
Marketing-Attribution: UTM-Quelle, UTM-Medium, UTM-Kampagne, Affiliate-ID
Marketing-Einstellungen (E-Mail und Telefon): deaktiviert, wenn der Kunde Marketingmitteilungen abbestellt oder keine Einwilligung zum Erhalt von Marketingmitteilungen gegeben hat
Systemeinstellungen (E-Mail und Telefon): immer aktiviert

Datumsangaben werden als Zeitstempel gesendet. Die Kontaktwährung ist immer USD, und alle Einzahlungsbeträge im Kontaktdatensatz sind in USD angegeben.

Benutzerdefinierte Ereignisse erstellen

B2CORE sendet sechs benutzerdefinierte Ereignisse an StopChurn. Erstellen Sie jedes davon unter Datenbank > Tabellendefinitionen, indem Sie auf Neues benutzerdefiniertes Ereignis klicken:

Name — muss exakt mit dem Wert in der folgenden Tabelle übereinstimmen.
Bezeichnung — beliebiger Text.
Werttyp — erforderlich; muss mit dem Wert in der folgenden Tabelle übereinstimmen.

Ereignis	Name	Werttyp	Wert
Registrierung abgeschlossen	`REGISTRATION_COMPLETED`	`BOOLEAN`	Immer `true`
Verifizierungsstufe geändert	`VERIFICATION_LEVEL_CHANGED`	`NUMBER`	Die neue Verifizierungsstufe des Kunden
KYC genehmigt	`KYC_APPROVED`	`BOOLEAN`	Immer `true`
KYC abgelehnt	`KYC_REJECTED`	`STRING`	Der Ablehnungsgrund (kann leer sein)
Einzahlung abgeschlossen	`DEPOSIT_COMPLETED`	`JSON`	Einzahlungsdetails (siehe Felder der Einzahlungsereignisse)
Erste Einzahlung	`FIRST_DEPOSIT`	`JSON`	Einzahlungsdetails (siehe Felder der Einzahlungsereignisse). Wird nur bei der ersten erfolgreichen Einzahlung des Kunden gesendet

Erstellen Sie alle sechs Ereignisse, bevor Sie die Verbindung aktivieren. Wenn ein Ereignis in StopChurn fehlt oder den falschen Werttyp hat, lehnt StopChurn es ab und das Ereignis geht verloren. Abgelehnte Ereignisse werden nicht erneut gesendet.

Felder der Einzahlungsereignisse

Die Ereignisse Einzahlung abgeschlossen und Erste Einzahlung enthalten die folgenden Felder:

amount — der Einzahlungsbetrag in der Einzahlungswährung.
currency — die Einzahlungswährung, zum Beispiel EUR.
amountInUSD — der Einzahlungsbetrag, umgerechnet in USD zum Wechselkurs zum Zeitpunkt des Abschlusses der Einzahlung und auf zwei Dezimalstellen gerundet. Leer, wenn B2CORE zu diesem Zeitpunkt keinen USD-Wechselkurs für die Einzahlungswährung hatte; das Ereignis wird trotzdem gesendet.
paymentSystem — der Name der vom Kunden verwendeten Einzahlungsmethode, genau wie im Feld Name der Methode unter System > Einzahlungssystem angegeben, zum Beispiel b2binpay_enterprise.

Wenn Sie das Einzahlungsereignis in StopChurn als Conversion-Ziel verwenden, legen Sie amountInUSD als Zielwert fest, damit alle Einzahlungen in einer einzigen Währung gemessen werden.

Geben Sie Ihren Einzahlungsmethoden eindeutige, beständige Namen. Wenn Sie eine Einzahlungsmethode umbenennen, erhält StopChurn für alle künftigen Einzahlungen mit dieser Methode den neuen Namen. StopChurn-Segmente und -Abläufe, die nach dem alten Namen filtern, erfassen diese Einzahlungen dann nicht mehr.

Verbindung zu StopChurn im B2CORE Back Office konfigurieren

So konfigurieren Sie eine Verbindung zu StopChurn:

Navigieren Sie zu System > Externe Verbindungen.

Klicken Sie oben rechts auf der Seite auf +Erstellen.

Füllen Sie auf der Seite Verbindung erstellen die folgenden Felder aus:

Geben Sie im Feld Name einen Namen für die Verbindung ein. Der Name muss eindeutig sein.
Geben Sie im Feld Beschriftung eine Beschriftung ein, die für die Verbindung im Back Office verwendet wird.
Wählen Sie im Dropdown-Menü Anbieter die Option StopChurn aus.

Klicken Sie auf Speichern, um die Verbindung zu erstellen.

Die Verbindung StopChurn erscheint in der Liste der externen Verbindungen.

Klicken Sie auf Bearbeiten, um die Verbindungsdetails einzugeben, und füllen Sie die folgenden Felder aus:

Umgebung — wählen Sie die StopChurn-Umgebung aus: Staging oder Production.
API-Schlüssel — geben Sie den von StopChurn bereitgestellten API-Schlüssel ein.
Brand ID — geben Sie die ID der StopChurn-Marke ein, die die Daten empfängt.
Name der Benutzertabelle — optional. Lassen Sie das Feld leer, um die standardmäßige StopChurn-Tabelle user zu verwenden.
Strategie für externe IDs — wählen Sie den Wert aus, den B2CORE als Kontakt-ID in StopChurn verwendet:
- B2CORE-Kunden-ID (Standard)
- B2CORE-Kunden-E-Mail-Adresse
- Zufällige UUIDv7
Präfix für externe IDs — optionaler Text, der der Kontakt-ID vorangestellt wird. Zulässige Zeichen: Buchstaben, Ziffern sowie _ . : -; maximal 32 Zeichen. Verwenden Sie ein Präfix, wenn mehrere Marken oder B2CORE-Instanzen ein StopChurn-Konto gemeinsam nutzen, damit sich ihre Kontakt-IDs nicht überschneiden.

Klicken Sie auf Verbindung testen, um zu prüfen, ob StopChurn den API-Schlüssel akzeptiert. Beim Test werden in StopChurn keine Daten erstellt oder geändert.

Prüfen Sie den Verbindungsstatus.

Wenn die Verbindung inaktiv ist (im Feld Aktiviert wird No angezeigt), aktivieren Sie sie, indem Sie im Dropdown-Menü Aktiviert die Option Yes auswählen.

Klicken Sie auf Speichern, um die Änderungen zu übernehmen.

Die Kontakt-ID eines Kunden in StopChurn wird bei der ersten Übertragung des Kunden festgelegt. Wenn Sie die Strategie für externe IDs oder das Präfix für externe IDs später ändern, gilt die Änderung nur für Kunden, die noch nicht übertragen wurden. Bestehende Kontakte behalten ihre IDs, sodass StopChurn keine Duplikate erhält.

Sie können mehrere StopChurn-Verbindungen gleichzeitig aktivieren, beispielsweise eine pro StopChurn-Marke. Jede aktivierte Verbindung empfängt alle Kundendaten und Ereignisse.

Um Ihre bestehenden Kunden nach dem Aktivieren und Testen der Verbindung an StopChurn zu senden, fordern Sie einen Initialimport an.

An StopChurn gesendete Daten

B2CORE sendet Daten automatisch an StopChurn. Etwa eine Minute nach einer der folgenden Aktionen sendet B2CORE den vollständigen, aktuellen Kontaktdatensatz des Kunden zusammen mit den zugehörigen Ereignissen:

Aktion in B2CORE	Gesendete Ereignisse
Der Kunde registriert sich	Registrierung abgeschlossen
E-Mail-Adresse, Status, Land, Kundentyp, Verifizierungsstufe oder Jurisdiktion des Kunden ändert sich	—
Vorname, Nachname oder Geburtsdatum des Kunden ändert sich	—
Die Telefonnummer des Kunden ändert sich	—
Der Kunde reicht einen Verifizierungsantrag ein	Verifizierungsstufe geändert
Ein Verifizierungsantrag wird genehmigt	Verifizierungsstufe geändert, KYC genehmigt
Ein Verifizierungsantrag wird abgelehnt	Verifizierungsstufe geändert, KYC abgelehnt (mit Angabe des Grundes)
Eine Einzahlung wird erfolgreich abgeschlossen	Einzahlung abgeschlossen; zusätzlich Erste Einzahlung, wenn es die erste erfolgreiche Einzahlung des Kunden ist
Der Kunde bestellt Marketingmitteilungen ab oder meldet sich erneut dafür an	—

Bei jeder Übertragung wird der Kontakt in StopChurn vollständig aktualisiert. Daher ist es unbedenklich, denselben Kunden mehrfach zu senden.

Initialimport aller Kunden

Automatische Übertragungen erfassen nur Kunden mit neuen Aktivitäten. Um alle Ihre bestehenden Kunden an StopChurn zu senden, ist ein Initialimport erforderlich. Wenn Sie einen Initialimport benötigen, wenden Sie sich an das B2BROKER-Supportteam, nachdem Sie die StopChurn-Verbindung erstellt und getestet haben.

Kürzlich aktualisierte Kontakte erneut synchronisieren

Verwenden Sie Kontakte erneut synchronisieren, um alle Kunden, deren Profile im letzten Monat aktualisiert wurden, an StopChurn zu senden. Führen Sie die erneute Synchronisierung durch, um StopChurn nach einem kurzen Ausfall oder einer fehlerhaften Konfiguration auf den neuesten Stand zu bringen.

Kontakte erneut synchronisieren ersetzt nicht den Initialimport. Kunden, die im letzten Monat nicht aktualisiert wurden, sind nicht enthalten.

So synchronisieren Sie kürzlich aktualisierte Kontakte erneut:

Navigieren Sie zu System > Externe Verbindungen und öffnen Sie die StopChurn-Verbindung.

Klicken Sie auf Aktionen > Kontakte erneut synchronisieren.

Eine grüne Meldung bestätigt, dass die erneute Synchronisierung gestartet wurde. Sie läuft im Hintergrund.

Beachten Sie Folgendes:

Kontakte erneut synchronisieren ist nur für aktivierte StopChurn-Verbindungen und nur für Back-Office-Benutzer mit der Berechtigung zum Aktualisieren externer Verbindungen verfügbar.
Sie können pro Verbindung einmal pro Stunde eine erneute Synchronisierung durchführen. Wenn Sie innerhalb dieser Stunde erneut auf die Schaltfläche klicken, zeigt eine Meldung an, wie viele Minuten Sie warten müssen.
B2CORE führt keine vollständigen erneuten Synchronisierungen automatisch durch. Zwischen den erneuten Synchronisierungen bleiben die Kontakte durch die automatischen Übertragungen auf dem neuesten Stand.

Hinweise und Einschränkungen

Die Kontaktwährung ist immer USD, und alle Einzahlungsbeträge im Kontaktdatensatz sind in USD angegeben. Einzahlungsereignisse enthalten sowohl den ursprünglichen Betrag und die ursprüngliche Währung als auch den Betrag in USD (amountInUSD).
In der Dokumentation von StopChurn ist nicht beschrieben, wo empfangene Ereignisse eingesehen werden können. Fragen Sie beim StopChurn-Team nach.

So integrieren Sie StopChurn

Auf dieser Seite