Melhores práticas de coleta

Saber quando e como coletar dados de usuários conhecidos e desconhecidos pode ser um desafio quando você pensa no ciclo de vida do perfil de usuário dos seus clientes. Este artigo ajuda a esclarecer diferentes métodos e melhores práticas para a coleta de dados de usuários novos e existentes, guiando você por 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 outros cenários de coleta de dados. Neste exemplo, presumimos que você já tenha integrado um formulário de inscrição ou outra forma de coletar informações do usuário.

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

Se um usuário desconhecido visitar seu site e, mais tarde, criar uma conta ou se identificar por meio de uma inscrição por e-mail, a mesclagem de perfis precisa ser feita com cuidado. Dependendo do método de mesclagem, as informações de usuários somente com 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 existe

Quando um usuário inserir conteúdo em 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 destas formas:

• Verificar o banco de dados interno (recomendado): Se você tiver um registro ou banco de dados externo à Braze com as informações fornecidas pelo usuário, consulte-o no momento do envio do e-mail ou da criação da conta. Assim, você confirma que essas informações ainda não foram capturadas.
• Endpoint /users/track: Use email como identificador. 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ê coletar e-mails por meio de um formulário personalizado e depois definir a associação ao grupo de inscrições pela REST API, chame esse endpoint primeiro. Se não houver um perfil correspondente, crie ou inscreva o usuário com o endpoint /subscription/status/set. Caso contrário, atualize o perfil existente em vez de criar um duplicado.

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 o e-mail por meio de uma inscrição na newsletter. Se houver vários perfis de usuário da 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 pelo endpoint /users/track. Esse endpoint aceita um objeto user_alias e cria um perfil somente de alias quando update_existing_only está definido como false. Defina o e-mail do usuário como alias para poder consultá-lo no futuro, já que ele não terá um external_id.

Capturar e-mails de usuários com um formulário de captura de e-mail

Use um formulário de captura de e-mail para pedir que os usuários enviem o endereço de e-mail deles, 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ê usa um formulário personalizado e define a associação ao grupo de inscrições pela REST API, verifique se já existe um perfil antes de criar um usuário. Consulte Etapa 1: Verificar se o usuário existe.

Identificação de usuários somente de alias

Ao identificar usuários no momento da criação da conta, você pode identificar usuários somente de alias e atribuir a eles um ID externo por meio do endpoint /users/identify, mesclando o usuário somente de alias com o perfil conhecido.

Para saber se um usuário é somente de alias, verifique 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, não faça uma chamada para /users/identify/.

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

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

Mesclagem de perfis de usuário duplicados

À medida que seus dados de usuários crescem, você pode mesclar perfis de usuário duplicados no dashboard da Braze. Esses perfis duplicados precisam ser encontrados com a mesma consulta de pesquisa. Para saber mais sobre como mesclar perfis de usuário duplicados, confira Mesclar usuários duplicados.

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

Nota

Depois que os perfis de usuário forem mesclados, essa ação não poderá ser desfeita.

Recursos adicionais

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