Modelar contas com várias assinaturas usando perfis no nível da assinatura
Dê a cada assinatura de uma conta de cliente compartilhada seu próprio perfil de usuário da Braze, vinculado por um atributo personalizado de ID de conta. Assim, você pode enviar mensagens e gerar relatórios no nível da assinatura e, ao mesmo tempo, agrupar os perfis que pertencem à mesma conta.
Sobre este exemplo
A StyleRyde é uma marca fictícia de transporte por aplicativo sob demanda em que uma conta de cliente pode ter várias assinaturas. Por exemplo, um plano familiar pode cobrir vários passageiros, cada um com um número de telefone exclusivo. Os consumidores fazem login uma vez no nível da conta e depois escolhem qual assinatura (linha telefônica) querem gerenciar.
A StyleRyde precisa:
- Enviar SMS de serviço para o número de telefone de uma assinatura específica.
- Enviar push de marketing e Content Cards para a sessão do dispositivo da assinatura ativa.
- Manter as preferências de marketing por push e SMS, o histórico de engajamento de push e SMS e os dados do Currents no nível de cada assinatura.
- Agrupar assinaturas relacionadas para relatórios e jornadas no nível da conta.
A Braze modela o engajamento em torno do perfil de usuário. E-mail, telefone, atributos de preferência e histórico de canais ficam nesse perfil. Em contas com várias assinaturas, trate cada assinatura como um perfil de usuário próprio e depois agrupe os perfis com um atributo personalizado account_id compartilhado. Pense em usuários agrupados por ID de conta, e não em um único objeto de conta que contém usuários.
Este exemplo aborda o padrão de perfis no nível da assinatura. Use esse padrão quando cada assinatura tiver (ou puder ter) um ID exclusivo e estável que seu app possa passar para changeUser().
Considerações
- ID de usuário ativo: Chame
changeUser()com o ID da assinatura quando um consumidor fizer login ou trocar de assinatura. O SDK associa um ID de usuário ativo por sessão. - IDs de conta compartilhados: Não chame
changeUser()com um ID de conta compartilhado para todas as assinaturas em um dispositivo. Isso mistura o engajamento de pessoas diferentes e prejudica o logout e o reengajamento. Consulte Como o changeUser() funciona. - Endereços de e-mail compartilhados: Vários perfis podem compartilhar um mesmo endereço. Antes de depender de caixas de entrada compartilhadas, consulte as perguntas frequentes sobre e-mail e o estado de inscrição de e-mail.
- Aceitação de e-mail: A aceitação acompanha o endereço. Uma alteração em um perfil é copiada para até 100 outros perfis com o mesmo endereço. As preferências de push e SMS ainda podem variar por assinatura quando os números de telefone são exclusivos.
- Desduplicação de e-mail: A Braze desduplica envios agendados baseados em segmentos para um endereço compartilhado. Envios para destinatários específicos e etapas posteriores do Canvas ainda podem enviar mais de uma vez para esse endereço.
- Engajamento de e-mail: Entregas, aberturas, cliques e relatórios de spam são registrados em cada perfil correspondente (até 100), e a Braze personaliza o envio para o único perfil que ela seleciona.

Não coloque conteúdo específico de uma assinatura (como uma linha telefônica ou detalhes do plano) em um e-mail para um endereço compartilhado. A Braze personaliza esse e-mail para o único perfil que ela seleciona. Envie esse conteúdo por push, SMS ou Content Cards, ou dê a cada assinatura seu próprio endereço de e-mail.
- Números de telefone para SMS: Use um número de telefone exclusivo em cada perfil de assinatura quando o SMS for seu canal de serviço. O telefone fica armazenado no perfil que você direciona para o SMS.
- Tokens por push: Os tokens por push pertencem a um perfil por dispositivo. Consulte a Etapa 3 para saber o que acontece quando um consumidor troca de assinatura.
- Consolidações por conta: Consolidações no nível da conta (por exemplo, “alguma assinatura desta conta comprou um passe mensal”) exigem uma junção no data warehouse ou no Currents por
account_id. Um filtro de segmento poraccount_idretorna cada perfil com esse valor. - Faturamento: Cada perfil de assinatura conta como um perfil separado para seus usuários ativos mensais (MAU) e para o uso de pontos de dados, conforme descrito em Faturamento e Pontos de dados (legado).
Configuração
Etapa 1: Definir identificadores
Mapeie os identificadores do seu CRM para a Braze da seguinte forma.
| Conceito | Exemplo da StyleRyde | Campo da Braze |
|---|---|---|
| Conta (login e faturamento) | Conta familiar acct_12345 |
Atributo personalizado account_id (string) em todos os perfis relacionados |
| Assinatura (linha individual) | Assinatura do passageiro sub_12345_1 |
external_id do perfil |
| E-mail de contato | E-mail familiar compartilhado | email do perfil (pode se repetir entre perfis) |
| Telefone de contato | Exclusivo por assinatura | phone do perfil |
Use um ID de assinatura estável e exclusivo como external_id. Mantenha o ID da conta como um atributo personalizado para poder segmentar e juntar perfis relacionados sem fundi-los em um único usuário da Braze.
Etapa 2: Criar um perfil por assinatura
Crie ou atualize cada assinatura pelo SDK ou pelo endpoint /users/track. Inclua pelo menos o seguinte:
| Campo | O que armazenar |
|---|---|
external_id |
ID da assinatura |
email e phone |
Campos de contato, quando coletados |
account_id |
Identificador de conta compartilhado |
| Atributos de função ou titularidade | Por exemplo, is_account_owner |
| Atributos de preferência de marketing por push e SMS | Valores necessários para a segmentação. A aceitação de e-mail é gerenciada com estados e grupos de inscrição de e-mail, que se aplicam por endereço. |
Exemplo de estrutura de perfis para duas contas da StyleRyde:
| Atributo | Perfil A | Perfil B | Perfil C | Perfil D |
|---|---|---|---|---|
external_id (assinatura) |
sub_12345_1 |
sub_12345_2 |
sub_12345_3 |
sub_789_1 |
account_id |
acct_12345 |
acct_12345 |
acct_12345 |
acct_789 |
email |
[email protected] |
[email protected] |
[email protected] |
[email protected] |
phone |
+15555550101 |
+15555550102 |
+15555550103 |
+15555550901 |
is_account_owner |
false |
true |
false |
true |
marketing_sms_opt_in |
true |
true |
false |
false |
Cada coluna é um usuário separado da Braze. Os perfis A a C compartilham o account_id acct_12345, mas mantêm telefones, preferências de SMS e históricos de engajamento de SMS e push distintos. Como compartilham [email protected], eles também compartilham um único estado de inscrição de e-mail e o engajamento de e-mail.
Exemplo de carga útil de atributos do /users/track para uma assinatura:
{
"attributes": [
{
"external_id": "sub_12345_2",
"email": "[email protected]",
"phone": "+15555550102",
"account_id": "acct_12345",
"is_account_owner": true,
"marketing_sms_opt_in": true
}
]
}
Etapa 3: Identificar a assinatura ativa no SDK
Quando o consumidor fizer login ou trocar a assinatura que está gerenciando, chame changeUser() com o external_id dessa assinatura.
// After the consumer selects subscription sub_12345_2 in the StyleRyde app
braze.changeUser("sub_12345_2");
A partir daí, os tokens por push, os Content Cards e as mensagens no app acompanham o perfil da assinatura ativa naquela sessão. Se o consumidor trocar para outra assinatura no app, chame changeUser() novamente com o novo ID de assinatura.
Quando um perfil registra o token por push de um dispositivo, a Braze remove esse token de todos os outros perfis no mesmo dispositivo. Na prática, um titular de conta que alterna entre assinaturas em um mesmo celular recebe push apenas da última assinatura selecionada. As mensagens push destinadas às outras assinaturas não chegam a esse celular.
Etapa 4: Alinhar os canais com os campos do perfil
| Canal | Direcionar usando |
|---|---|
| SMS (serviço) | phone no perfil da assinatura que você quer alcançar |
Use email no perfil. Perfis que compartilham um endereço também compartilham o estado de inscrição de e-mail, e alguns envios são desduplicados, conforme descrito em Considerações. |
|
| Push e Content Cards | O perfil definido no momento com changeUser() no dispositivo. O token por push do dispositivo pertence apenas ao último perfil que o registrou. |
Para jornadas exclusivas do titular da conta (por exemplo, lembretes de cobrança), filtre por is_account_owner igual a true e pelo account_id ou pelos atributos de assinatura relevantes.
Etapa 5: Segmentar e gerar relatórios com atributos de conta e de assinatura
- Crie segmentos no nível da assinatura com telefone, preferências de marketing por push e SMS e atributos personalizados específicos da assinatura.
- Crie públicos no escopo da conta com o filtro
account_id(por exemplo, todas as assinaturas em queaccount_idé igual aacct_12345). Esse filtro seleciona cada perfil com esse valor. - Use o Currents e a análise de dados no nível do usuário em cada perfil de assinatura para relatórios de engajamento. Faça a junção por
account_idno seu data warehouse quando precisar de consolidações por família, como “a conta X tem um perfil que comprou um passe mensal”. - Entregas, aberturas, cliques e relatórios de spam de e-mail podem ficar armazenados em mais de um perfil que compartilha um endereço. Leve isso em conta ao fazer a junção por
account_id, conforme descrito em Considerações.