Comment intégrer StopChurn

Découvrez comment connecter StopChurn à B2CORE pour synchroniser les données et les événements clés des clients à des fins de fidélisation et de gestion de la relation client

Utilisez l’intégration avec StopChurn pour envoyer automatiquement les données et les événements clés des clients de B2CORE à StopChurn, une plateforme de fidélisation et de gestion de la relation client. StopChurn peut ensuite utiliser ces données pour segmenter les clients et mener des campagnes de fidélisation.

L’intégration permet uniquement le transfert de données de B2CORE vers StopChurn. B2CORE est la source unique de référence : StopChurn reçoit les données, mais aucune donnée n’est récupérée de StopChurn vers B2CORE.

Avant de continuer, assurez-vous d’avoir accès au Back Office de StopChurn et d’avoir reçu une clé API et un ID de marque de StopChurn. Si vous avez des questions, contactez l’équipe StopChurn.

Préparer StopChurn

Effectuez ces étapes dans StopChurn avant d’activer la connexion dans B2CORE.

Vérifier les champs de la table des contacts

Dans le Back Office de StopChurn, accédez à Base de données > Définitions des tables et ouvrez la table des utilisateurs (contacts). B2CORE renseigne les champs suivants pour chaque contact StopChurn :

Identité : ID, adresse e-mail, numéro de téléphone, prénom, nom, date de naissance
Localisation et profil : pays (nom), code pays, devise, juridiction, langue, type de client (particulier ou entreprise), date d’inscription, niveau de vérification
KYC : statut KYC, date de soumission du KYC, date d’approbation du KYC
Dépôts : date et montant du premier et du dernier dépôt, montant total des dépôts, dépôt net
Trading : date de la première et de la dernière transaction, nombre total de transactions, date d’ouverture du compte de trading
Attribution marketing : source UTM, support UTM, campagne UTM, ID d’affilié
Préférences marketing (e-mail et téléphone) : désactivées lorsque le client s’est désabonné des communications marketing ou n’a pas donné son consentement à leur réception
Préférences système (e-mail et téléphone) : toujours activées

Les dates sont envoyées sous forme d’horodatages. La devise du contact est toujours USD, et tous les montants des dépôts associés au contact sont en USD.

Créer les événements personnalisés

B2CORE envoie six événements personnalisés à StopChurn. Créez chacun d’eux dans Base de données > Définitions des tables en cliquant sur Nouvel événement personnalisé :

Nom — doit correspondre exactement à la valeur indiquée dans le tableau ci-dessous.
Libellé — le texte de votre choix.
Type de valeur — obligatoire ; doit correspondre à la valeur indiquée dans le tableau ci-dessous.

Événement	Nom	Type de valeur	Valeur
Inscription terminée	`REGISTRATION_COMPLETED`	`BOOLEAN`	Toujours `true`
Niveau de vérification modifié	`VERIFICATION_LEVEL_CHANGED`	`NUMBER`	Le nouveau niveau de vérification du client
KYC approuvé	`KYC_APPROVED`	`BOOLEAN`	Toujours `true`
KYC rejeté	`KYC_REJECTED`	`STRING`	Le motif du rejet (peut être vide)
Dépôt effectué	`DEPOSIT_COMPLETED`	`JSON`	Détails du dépôt (voir Champs des événements de dépôt)
Premier dépôt	`FIRST_DEPOSIT`	`JSON`	Détails du dépôt (voir Champs des événements de dépôt). Envoyé uniquement pour le premier dépôt réussi du client

Créez les six événements avant d’activer la connexion. Si un événement manque dans StopChurn ou que son type de valeur est incorrect, StopChurn le rejette et l’événement est perdu. Les événements rejetés ne sont pas renvoyés.

Champs des événements de dépôt

Les événements Dépôt effectué et Premier dépôt contiennent les champs suivants :

amount — le montant du dépôt dans la devise du dépôt.
currency — la devise du dépôt, par exemple EUR.
amountInUSD — le montant du dépôt converti en USD au taux de change en vigueur au moment où le dépôt a été effectué, arrondi à deux décimales. Ce champ est vide si B2CORE ne disposait pas d’un taux de change en USD pour la devise du dépôt à ce moment-là ; l’événement est tout de même envoyé.
paymentSystem — le nom de la méthode de dépôt utilisée par le client, tel qu’il figure dans le champ Nom de la méthode sous Système > Système de dépôt, par exemple b2binpay_enterprise.

Si vous utilisez l’événement de dépôt comme objectif de conversion dans StopChurn, définissez amountInUSD comme valeur de l’objectif afin que tous les dépôts soient mesurés dans une seule devise.

Donnez à vos méthodes de dépôt des noms clairs et stables. Si vous renommez une méthode de dépôt, StopChurn reçoit le nouveau nom pour tous les dépôts futurs effectués avec cette méthode. Les segments et les parcours StopChurn filtrés selon l’ancien nom ne correspondent alors plus à ces dépôts.

Configurer une connexion à StopChurn dans le Back Office de B2CORE

Pour configurer une connexion à StopChurn :

Accédez à Système > Connexions externes.

Cliquez sur +Créer dans l’angle supérieur droit de la page.

Sur la page Créer une connexion, remplissez les champs suivants :

Dans le champ Nom, saisissez un nom pour la connexion. Ce nom doit être unique.
Dans le champ Légende, saisissez une légende qui sera associée à la connexion dans le Back Office.
Dans la liste déroulante Fournisseur, sélectionnez StopChurn.

Cliquez sur Enregistrer pour créer la connexion.

La connexion StopChurn apparaît dans la liste des connexions externes.

Cliquez sur Modifier pour saisir les détails de la connexion et renseignez les champs suivants :

Environnement — sélectionnez l’environnement StopChurn : Staging ou Production.
Clé API — saisissez la clé API fournie par StopChurn.
ID de marque — saisissez l’ID de la marque StopChurn qui reçoit les données.
Nom de la table des utilisateurs — facultatif. Laissez ce champ vide pour utiliser la table user par défaut de StopChurn.
Stratégie d’ID externe — sélectionnez la valeur que B2CORE utilise comme ID de contact dans StopChurn :
- ID client B2CORE (par défaut)
- Adresse e-mail du client B2CORE
- UUIDv7 aléatoire
Préfixe de l’ID externe — texte facultatif ajouté devant l’ID de contact. Caractères autorisés : lettres, chiffres et _ . : - ; 32 caractères au maximum. Utilisez un préfixe lorsque plusieurs marques ou instances B2CORE partagent un même compte StopChurn, afin que leurs ID de contact ne se chevauchent pas.

Cliquez sur Tester la connexion pour vérifier que StopChurn accepte la clé API. Le test ne crée ni ne modifie aucune donnée dans StopChurn.

Vérifiez le statut de la connexion.

Si la connexion est inactive (No s’affiche dans le champ Activé), activez-la en réglant la liste déroulante Activé sur Yes.

Cliquez sur Enregistrer pour appliquer les modifications.

L’ID de contact d’un client dans StopChurn est fixé lors du premier envoi de ce client. Si vous modifiez ensuite la Stratégie d’ID externe ou le Préfixe de l’ID externe, la modification ne s’applique qu’aux clients qui n’ont pas encore été envoyés. Les contacts existants conservent leurs ID, ce qui évite les doublons dans StopChurn.

Vous pouvez activer plusieurs connexions StopChurn simultanément, par exemple une par marque StopChurn. Chaque connexion activée reçoit l’ensemble des données et des événements des clients.

Pour envoyer vos clients existants à StopChurn après avoir activé et testé la connexion, demandez un chargement initial.

Données envoyées à StopChurn

B2CORE envoie automatiquement les données à StopChurn. Environ une minute après l’une des actions ci-dessous, B2CORE envoie la fiche de contact complète et à jour du client, ainsi que les événements associés :

Action dans B2CORE	Événements envoyés
Le client s’inscrit	Inscription terminée
L’adresse e-mail, le statut, le pays, le type de client, le niveau de vérification ou la juridiction du client change	—
Le prénom, le nom ou la date de naissance du client change	—
Le numéro de téléphone du client change	—
Le client soumet une demande de vérification	Niveau de vérification modifié
Une demande de vérification est approuvée	Niveau de vérification modifié, KYC approuvé
Une demande de vérification est rejetée	Niveau de vérification modifié, KYC rejeté (avec le motif)
Un dépôt est effectué avec succès	Dépôt effectué ; également Premier dépôt s’il s’agit du premier dépôt réussi du client
Le client se désabonne des communications marketing ou s’y réabonne	—

Chaque envoi met entièrement à jour le contact dans StopChurn. Il n’y a donc aucun risque à envoyer plusieurs fois le même client.

Chargement initial de tous les clients

Les envois automatiques ne concernent que les clients ayant une nouvelle activité. Un chargement initial est nécessaire pour envoyer tous vos clients existants à StopChurn. Si vous avez besoin d’un chargement initial, contactez l’équipe d’assistance B2BROKER après avoir créé et testé la connexion StopChurn.

Resynchroniser les contacts récemment mis à jour

Utilisez Resynchroniser les contacts pour envoyer à StopChurn tous les clients dont le profil a été mis à jour au cours du dernier mois. Lancez cette opération pour remettre StopChurn à jour après une courte interruption ou une erreur de configuration.

Resynchroniser les contacts ne remplace pas le chargement initial. Les clients dont le profil n’a pas été mis à jour au cours du dernier mois ne sont pas inclus.

Pour resynchroniser les contacts récemment mis à jour :

Accédez à Système > Connexions externes et ouvrez la connexion StopChurn.

Cliquez sur Actions > Resynchroniser les contacts.

Un message vert confirme que la resynchronisation a commencé. Elle s’exécute en arrière-plan.

Tenez compte des points suivants :

Resynchroniser les contacts n’est disponible que pour les connexions StopChurn activées et pour les utilisateurs du Back Office autorisés à mettre à jour les connexions externes.
Vous pouvez lancer une resynchronisation une fois par heure et par connexion. Si vous cliquez de nouveau sur le bouton avant la fin de cette heure, un message indique le nombre de minutes à attendre.
B2CORE ne lance pas automatiquement de resynchronisations complètes. Entre deux resynchronisations, les contacts restent à jour grâce aux envois automatiques.

Remarques et limites

La devise du contact est toujours USD, et tous les montants des dépôts associés au contact sont en USD. Les événements de dépôt comprennent le montant et la devise d’origine ainsi que le montant en USD (amountInUSD).
La documentation de StopChurn n’indique pas où consulter les événements reçus. Renseignez-vous auprès de l’équipe StopChurn.

Comment intégrer StopChurn

Sur cette page