Integração multidomínio
Saiba como integrar o SDK da Braze para web em vários domínios web.
Quando sua implementação abrange vários domínios, os limites de origem do navegador afetam a forma como o SDK da Braze para web armazena e lê o estado do usuário.
Escolha uma estratégia de app e chave de API
Você pode usar uma única chave de API do SDK para web em vários domínios, mas, na maioria dos casos, usar chaves de API separadas mapeadas para apps separados no mesmo espaço de trabalho oferece mais controle.
| Estratégia | Recomendada quando | Compensações |
|---|---|---|
| Apps separados (recomendado) | Você deseja direcionamento, relatórios e controle de Campaign independentes por domínio | Requer o gerenciamento de duas integrações de app |
| App único | Você trata ambos os domínios como uma única propriedade operacionalmente | Disparos de sessão e relatórios por domínio são mais difíceis de separar |
Com apps separados em um espaço de trabalho, você pode usar filtros de app para uma segmentação mais limpa e direcionamento de mensagens por domínio.
Configure notificações por push em um domínio
Para domínios raiz separados, o registro de web push é isolado por domínio.
- Escolha um domínio como seu domínio de notificações por push.
- Não registre push em ambos os domínios raiz para a mesma jornada de usuário, pois isso pode criar comportamentos conflitantes de solicitação e inscrição.
Identifique usuários de forma consistente entre domínios
Por padrão, cada domínio raiz armazena seu próprio estado do SDK. Para associar a atividade ao mesmo perfil de usuário da Braze entre domínios:
- Chame
changeUser()com o mesmoexternal_idem cada domínio após o login. - Mantenha ambos os apps no mesmo espaço de trabalho se estiver usando chaves de API separadas.
Para orientações gerais sobre IDs de usuário, consulte Definir IDs de usuário pelo SDK da Braze.
Planeje o comportamento de eventos e disparos por domínio
A forma como você modela eventos e disparos depende da sua estratégia de app:
- App único entre domínios: Registre eventos personalizados específicos do domínio para que você possa distinguir o comportamento por site na segmentação e nos disparos.
- Apps separados: Prefira filtros de app para direcionamento e análise de dados específicos por domínio.
Entenda o comportamento de sessão entre domínios
Por padrão, o tempo limite de sessão do SDK para web é de 30 minutos de inatividade. Para domínios raiz separados usando um único app/chave de API:
- Cada domínio inicia e encerra sessões de forma independente.
- Um usuário navegando entre ambos os domínios pode criar sessões sobrepostas.
- Disparos de início de sessão podem ser acionados em ambos os domínios.
Para detalhes sobre o ciclo de vida básico de sessões, consulte Rastrear sessões pelo SDK da Braze.