Práticas recomendadas de coleta

Saber quando e como coletar dados de usuários conhecidos e desconhecidos pode ser um desafio quando se imagina o ciclo de vida do perfil do usuário de seus clientes. Este artigo ajuda a esclarecer diferentes métodos e práticas recomendadas para a coleta de dados de usuários novos e existentes, orientando você em um caso de uso.

O exemplo a seguir é um caso de uso de coleta de e-mail, mas a lógica se aplica a muitos cenários diferentes de coleta de dados. Neste exemplo, presumimos que você já tenha integrado um formulário de inscrição ou uma forma de coletar informações do usuário.

Depois que um usuário fornecer informações para registro, recomendamos que você verifique se os dados já existem no seu banco de dados e, quando necessário, crie um perfil de alias de usuário ou atualize o perfil de usuário existente.

Se um usuário desconhecido visualizar seu site e, posteriormente, criar uma conta ou se identificar por meio de inscrição por e-mail, a mesclagem de perfis deverá ser tratada com cuidado. Com base no método de mesclagem, as informações do usuário somente de alias ou os dados anônimos podem ser substituídos.

Capturando dados de usuários por meio de um formulário web

Etapa 1: Verifique se o usuário já existe

Quando um usuário insere conteúdo por meio de um formulário web, verifique se já existe um usuário com esse e-mail no seu banco de dados. Você pode fazer isso de uma das seguintes maneiras:

• Verificar banco de dados interno (recomendado): Se você tem um registro externo ou banco de dados contendo as informações do usuário fornecido que existe fora da Braze, consulte-o no momento do envio do e-mail ou da criação da conta para confirmar que as informações ainda não foram capturadas.
• Endpoint /users/track: Use email como identificador, e um novo perfil de usuário será criado se o endereço de e-mail ainda não existir.
• Endpoint /subscription/status/get: Se você coleta e-mails por meio de um formulário personalizado e depois define a participação no grupo de inscrições pela REST API, chame este endpoint primeiro. Se nenhum perfil correspondente existir, crie ou inscreva o usuário com o endpoint /subscription/status/set. Caso contrário, atualize o perfil existente em vez de criar uma duplicata.

Etapa 2: Registre ou atualize o usuário

• Se o usuário existir:
  • Não crie um novo perfil.
  • Registre um atributo personalizado (por exemplo, newsletter_subscribed: true) no perfil do usuário para indicar que ele enviou seu e-mail por meio de uma inscrição em newsletter. Se existirem múltiplos perfis de usuário na Braze com o mesmo endereço de e-mail, todos os perfis serão exportados.
    
    
• Se o usuário não existir:
  • Crie um perfil somente de alias por meio do endpoint /users/track. Esse endpoint aceitará um objeto user_alias e criará um perfil somente de alias quando update_existing_only estiver definido como false. Defina o e-mail do usuário como o alias do usuário para referenciá-lo futuramente (já que o usuário não terá um external_id).

Capturando e-mails de usuários por meio de um formulário de captura de e-mail

Use um formulário de captura de e-mail para solicitar que os usuários enviem seu endereço de e-mail, que será adicionado ao perfil de usuário. Para saber mais sobre como configurar esse formulário, confira Formulário de captura de e-mail.

Se você usar um formulário personalizado e definir a associação ao grupo de inscrições por meio da REST API, verifique se já existe um perfil antes de criar um usuário. Consulte a Etapa 1: Verifique se o usuário existe.

Identificando usuários somente por alias

Ao identificar usuários durante a criação de conta, os usuários somente por alias podem ser identificados e ter um ID externo atribuído por meio do endpoint /users/identify, mesclando o usuário somente por alias com o perfil conhecido.

Para verificar se um usuário é somente por alias, confira se o usuário existe no seu banco de dados.

• Se existir um registro externo, você pode chamar o endpoint /users/identify/.
• Se o endpoint /users/export/id retornar um external_id, você pode chamar o endpoint /users/identify/.
• Se o endpoint não retornar nada, a chamada ao /users/identify/ não deve ser feita.

Captura de dados de usuários quando já existem informações de usuários somente com alias

Quando um usuário cria uma conta ou se identifica por meio de inscrição por e-mail, você pode mesclar os perfis. Para uma lista de campos que podem ser mesclados, consulte Comportamento de atualização de mesclagem.

Mesclando perfis de usuário duplicados

À medida que seus dados de usuários crescem, você pode mesclar perfis de usuário duplicados diretamente pelo dashboard da Braze. Esses perfis duplicados devem ser encontrados usando a mesma consulta de busca. Para saber mais sobre como duplicar perfis de usuário, confira Mesclar usuários duplicados.

Você também pode usar o endpoint Mesclar usuários para mesclar um perfil de usuário em outro.

Nota

Após a mesclagem dos perfis de usuário, essa ação não pode ser desfeita.

Recursos adicionais

• Ciclo de vida do perfil de usuário
• Definição de IDs de usuárioInclui orientações sobre changeUser() para Android, iOS e web.