Bonnes pratiques de collecte
Savoir quand et comment collecter les données des utilisateurs connus et inconnus peut s’avérer difficile lorsque vous envisagez le cycle de vie du profil utilisateur de vos clients. Cet article aide à clarifier les différentes méthodes et bonnes pratiques pour la collecte de données d’utilisateurs nouveaux et existants en vous guidant à travers un cas d’usage.
L’exemple suivant est un cas d’usage de collecte d’e-mails, mais la logique s’applique à de nombreux scénarios de collecte de données différents. Dans cet exemple, nous supposons que vous avez déjà intégré un formulaire d’inscription ou une autre façon de recueillir des informations sur l’utilisateur.
Lorsqu’un utilisateur vous fournit des informations à enregistrer, nous vous recommandons de vérifier si les données existent déjà dans votre base de données et, le cas échéant, de créer un profil d’alias utilisateur ou de mettre à jour le profil utilisateur existant.
Si un utilisateur inconnu consulte votre site puis, à une date ultérieure, crée un compte ou s’identifie par le biais d’une inscription par e-mail, la fusion des profils doit être gérée avec précaution. En fonction de la méthode utilisée pour la fusion, les informations relatives aux utilisateurs avec alias uniquement ou les données anonymes peuvent être écrasées.
Collecte de données utilisateur via un formulaire web
Étape 1 : Vérifier si l’utilisateur existe
Lorsqu’un utilisateur saisit du contenu via un formulaire web, vérifiez si un utilisateur avec cet e-mail existe déjà dans votre base de données. Vous pouvez le faire de l’une des manières suivantes :
- Vérifier la base de données interne (recommandé) : Si vous disposez d’un enregistrement externe ou d’une base de données contenant les informations utilisateur fournies, qui existe en dehors de Braze, consultez-la au moment de la soumission de l’e-mail ou de la création du compte pour confirmer que les informations n’ont pas déjà été capturées.
- Endpoint
/users/track: Utilisezemailcomme identifiant, et 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 à un 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 un utilisateur existe :
- Ne créez pas de nouveau profil.
- Enregistrez un attribut personnalisé (par exemple,
newsletter_subscribed: true) sur le profil de l’utilisateur pour indiquer qu’il a soumis son e-mail via un abonnement à une newsletter. Si plusieurs profils utilisateur Braze existent avec la même adresse e-mail, tous les profils seront exportés.
- Si un utilisateur n’existe pas :
- Créez un profil alias uniquement via l’endpoint
/users/track. Cet endpoint accepte un objetuser_aliaset crée un profil alias uniquement lorsqueupdate_existing_onlyest défini surfalse. Définissez l’e-mail de l’utilisateur comme alias d’utilisateur pour référencer cet utilisateur à l’avenir (puisque l’utilisateur n’aura pas d’external_id).
- Créez un profil alias uniquement via l’endpoint

Capture des adresses e-mail via un formulaire de capture d’e-mail
Utilisez un formulaire de capture d’e-mail pour inviter les utilisateurs à soumettre leur adresse e-mail, qui sera ajoutée à leur profil utilisateur. Pour en savoir plus sur la configuration de ce formulaire, consultez la section Formulaire de capture d’e-mail.
Si vous utilisez un formulaire personnalisé et définissez l’appartenance au groupe d’abonnement via la REST API, vérifiez si un profil existe déjà avant de créer un utilisateur. Consultez l’Étape 1 : Vérifier si l’utilisateur existe.
Identification des utilisateurs uniquement identifiés par alias
Lors de l’identification des utilisateurs à la création d’un compte, les utilisateurs uniquement identifiés par alias peuvent être identifiés et se voir attribuer un ID externe via l’endpoint /users/identify en fusionnant l’utilisateur uniquement identifié par alias avec le profil connu.
Pour vérifier si un utilisateur est uniquement identifié par alias, 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/idrenvoie unexternal_id, vous pouvez appeler l’endpoint/users/identify/. - Si l’endpoint ne renvoie rien, l’appel à
/users/identify/ne doit pas être effectué.
Capture des données utilisateur lorsque des informations d’utilisateur alias uniquement sont déjà présentes
Lorsqu’un utilisateur crée un compte ou s’identifie via une inscription par e-mail, vous pouvez fusionner les profils. Pour consulter la liste des champs pouvant être fusionnés, reportez-vous à Comportement de la mise à jour par fusion.
Fusion des profils utilisateur en double
Au fur et à mesure que vos données utilisateur augmentent, vous pouvez fusionner les profils utilisateur 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 duplication de profils utilisateur, consultez Fusionner les utilisateurs en double.
Vous pouvez également utiliser l’endpoint Fusionner les utilisateurs pour fusionner un profil utilisateur avec un autre.

Une fois les profils utilisateur fusionnés, cette action ne peut pas être annulée.