Intégration multi-domaine
Découvrez comment intégrer le SDK Web de Braze sur plusieurs domaines web.
Lorsque votre déploiement s’étend sur plusieurs domaines, les limites d’origine du navigateur affectent la manière dont le SDK Web de Braze stocke et lit l’état utilisateur.
Choisir une stratégie d’application et de clé API
Vous pouvez utiliser une seule clé API du SDK Web sur plusieurs domaines, mais dans la plupart des cas, l’utilisation de clés API distinctes associées à des applications séparées dans le même workspace vous offre un meilleur contrôle.
| Stratégie | Recommandée quand | Compromis |
|---|---|---|
| Applications séparées (recommandé) | Vous souhaitez un ciblage, un reporting et un contrôle de Campaign indépendants par domaine | Nécessite la gestion de deux intégrations d’applications |
| Application unique | Vous traitez les deux domaines comme une seule propriété sur le plan opérationnel | Les déclencheurs de session et le reporting par domaine sont plus difficiles à séparer |
Avec des applications séparées dans un même workspace, vous pouvez utiliser des filtres d’application pour une segmentation et un ciblage de messages plus précis par domaine.
Configurer les notifications push sur un seul domaine
Pour des domaines racine distincts, l’enregistrement des notifications push Web est isolé par domaine.
- Choisissez un domaine comme domaine de notification push.
- N’enregistrez pas les notifications push sur les deux domaines racine pour le même parcours utilisateur, car cela peut créer des comportements conflictuels d’invite et d’abonnement.
Identifier les utilisateurs de manière cohérente entre les domaines
Par défaut, chaque domaine racine stocke son propre état SDK. Pour associer l’activité au même profil utilisateur Braze entre les domaines :
- Appelez
changeUser()avec le mêmeexternal_idsur chaque domaine après la connexion. - Conservez les deux applications dans le même workspace si vous utilisez des clés API séparées.
Pour des conseils généraux sur les ID utilisateur, consultez Définir les ID utilisateur via le SDK de Braze.
Planifier le comportement des événements et des déclencheurs par domaine
La manière dont vous modélisez les événements et les déclencheurs dépend de votre stratégie d’application :
- Application unique sur plusieurs domaines : Enregistrez des événements personnalisés spécifiques au domaine afin de pouvoir distinguer le comportement par site dans la segmentation et le déclenchement.
- Applications séparées : Privilégiez les filtres d’application pour le ciblage et l’analyse spécifiques au domaine.
Comprendre le comportement des sessions entre les domaines
Par défaut, le délai d’expiration de session du SDK Web est de 30 minutes d’inactivité. Pour des domaines racine distincts utilisant une seule application/clé API :
- Chaque domaine démarre et termine les sessions de manière indépendante.
- Un utilisateur naviguant entre les deux domaines peut créer des sessions qui se chevauchent.
- Les déclencheurs de début de session peuvent se déclencher sur les deux domaines.
Pour plus de détails sur le cycle de vie des sessions, consultez Suivre les sessions via le SDK de Braze.