Bonnes pratiques de collecte

Lorsque vous réfléchissez au cycle de vie du profil utilisateur de vos clients, il n’est pas toujours simple de savoir quand et comment collecter les données des utilisateurs connus et inconnus. À travers un cas d’usage, cet article présente les différentes méthodes et bonnes pratiques pour collecter les données des utilisateurs nouveaux et existants.

L’exemple suivant porte sur la collecte d’adresses e-mail, mais la même logique s’applique à de nombreux autres scénarios de collecte de données. Dans cet exemple, nous partons du principe que vous avez déjà intégré un formulaire d’inscription ou un autre moyen de recueillir des informations sur l’utilisateur.

Lorsqu’un utilisateur vous fournit des informations à enregistrer, nous vous recommandons de vérifier si ces données existent déjà dans votre base de données et, si nécessaire, de créer un profil d’alias d’utilisateur ou de mettre à jour le profil utilisateur existant.

Si un utilisateur inconnu consulte votre site, puis crée un compte ou s’identifie plus tard en s’inscrivant par e-mail, la fusion des profils doit être gérée avec précaution. Selon la méthode de fusion utilisée, les informations des utilisateurs disposant uniquement d’un alias ou les données anonymes peuvent être écrasées.

Capturer des données utilisateur via un formulaire web

Étape 1 : Vérifier si l’utilisateur existe

Lorsqu’un utilisateur saisit du contenu dans un formulaire web, vérifiez si un utilisateur avec cette adresse e-mail existe déjà dans votre base de données. Pour cela, plusieurs options s’offrent à vous :

• Vérifier la base de données interne (recommandé) : Si vous disposez d’un enregistrement ou d’une base de données externe à Braze contenant les informations fournies par l’utilisateur, consultez-la au moment de la soumission de l’e-mail ou de la création du compte afin de confirmer que ces informations n’ont pas déjà été collectées.
• Endpoint /users/track : Utilisez email comme identifiant. Un nouveau profil utilisateur sera créé si l’adresse e-mail n’existe pas encore.
• Endpoint /subscription/status/get : Si vous collectez des e-mails via un formulaire personnalisé, puis définissez l’appartenance au groupe d’abonnement via la REST API, appelez d’abord cet endpoint. Si aucun profil correspondant n’existe, créez ou abonnez l’utilisateur avec l’endpoint /subscription/status/set. Sinon, mettez à jour le profil existant au lieu de créer un doublon.

Étape 2 : Enregistrer ou mettre à jour l’utilisateur

• Si l’utilisateur existe :
  • Ne créez pas de nouveau profil.
  • Enregistrez un attribut personnalisé (par exemple, newsletter_subscribed: true) dans le profil de l’utilisateur pour indiquer qu’il a soumis son e-mail en s’abonnant à une newsletter. Si plusieurs profils utilisateur Braze partagent la même adresse e-mail, tous les profils seront exportés.
    
    
• Si l’utilisateur n’existe pas :
  • Créez un profil alias uniquement via l’endpoint /users/track. Cet endpoint accepte un objet user_alias et crée un profil alias uniquement lorsque update_existing_only est défini sur false. Définissez l’e-mail de l’utilisateur comme alias d’utilisateur afin de pouvoir y faire référence ultérieurement (puisque l’utilisateur n’aura pas d’external_id).

Capturer les e-mails des utilisateurs à l’aide d’un formulaire de capture d’e-mail

Utilisez un formulaire de capture d’e-mail pour inviter les utilisateurs à saisir leur adresse e-mail, qui sera ensuite ajoutée à leur profil utilisateur. Pour savoir comment configurer ce formulaire, consultez Formulaire de capture d’e-mail.

Si vous utilisez un formulaire personnalisé et définissez l’appartenance aux groupes d’abonnement via la REST API, vérifiez si un profil existe déjà avant de créer un utilisateur. Consultez Étape 1 : Vérifier si l’utilisateur existe.

Identifier les utilisateurs alias uniquement

Lorsque vous identifiez des utilisateurs au moment de la création de leur compte, vous pouvez identifier les utilisateurs alias uniquement et leur attribuer un ID externe à l’aide de l’endpoint /users/identify, qui fusionne l’utilisateur alias uniquement avec le profil connu.

Pour savoir si un utilisateur est alias uniquement, vérifiez si l’utilisateur existe dans votre base de données.

• Si un enregistrement externe existe, vous pouvez appeler l’endpoint /users/identify/.
• Si l’endpoint /users/export/id renvoie un external_id, vous pouvez appeler l’endpoint /users/identify/.
• Si l’endpoint ne renvoie rien, n’effectuez pas d’appel à /users/identify/.

Capture des données utilisateur lorsque des informations utilisateur avec alias uniquement existent déjà

Lorsqu’un utilisateur crée un compte ou s’identifie lors d’une inscription par e-mail, vous pouvez fusionner les profils. Pour consulter la liste des champs pouvant être fusionnés, reportez-vous à la section Comportement des mises à jour lors de la fusion.

Fusion des profils utilisateurs en double

À mesure que vos données utilisateur augmentent, vous pouvez fusionner les profils utilisateurs en double depuis le tableau de bord de Braze. Ces profils en double doivent être trouvés à l’aide de la même requête de recherche. Pour en savoir plus sur la fusion des profils utilisateurs en double, consultez Fusionner les utilisateurs en double.

Vous pouvez également utiliser l’endpoint Fusionner les utilisateurs pour fusionner un profil utilisateur dans un autre.

Remarque

Une fois les profils utilisateurs fusionnés, cette action est irréversible.

Ressources supplémentaires

• Cycle de vie du profil utilisateur
• Définir les ID utilisateurInclut des conseils sur changeUser() pour Android, iOS et Web.