Usuários (IDs de Usuário)

O ID de Usuário é um identificador único atribuído a cada usuário para manter dados consistentes do usuário em todos os seus dispositivos. Isso permite que você forneça ao seu público uma experiência de usuário fluida em todos os seus dispositivos.

Como usuários e dispositivos estão relacionados?

A cada usuário é atribuído um identificador único chamado ID de Usuário. Os IDs de Usuário podem ser vinculados a múltiplos dispositivos, permitindo que as empresas permaneçam conectadas com os usuários mesmo quando eles trocam de dispositivo. Isso garante que as mensagens direcionadas cheguem ao usuário pretendido em qualquer dispositivo que ele esteja usando.

Um usuário (ID de Usuário) não é uma entidade autônoma; ele depende da presença de dispositivos associados. Se o último dispositivo associado for removido ou vinculado a outro usuário, o usuário será automaticamente excluído do sistema.

Um usuário (ID de Usuário) também funciona como uma entidade sob a qual vários dispositivos podem ser agrupados, cada um com seu próprio Hardware ID (HWID) único.

Nota

O Pushwoosh suporta a vinculação de múltiplos dispositivos a um único ID de Usuário sem qualquer configuração adicional. Simplesmente registre cada dispositivo com o mesmo ID de Usuário, e eles serão automaticamente agrupados sob um perfil de usuário.

Para instruções passo a passo sobre como fazer isso, veja Definir um ID de Usuário personalizado e vinculá-lo a múltiplos dispositivos.

Tipos de usuários

Existem dois tipos de usuários: usuários anônimos e conhecidos. Um usuário anônimo tem seu ID de Usuário igual ao HWID do dispositivo, que pode ser substituído pelo ID de Usuário real posteriormente.

Um usuário conhecido tem um ID de Usuário distinto. Você pode especificar um ID de Usuário ao registrar um novo dispositivo através da chamada de API /registerDevice.

Obtenção e gerenciamento de IDs de Usuário

O Pushwoosh oferece várias maneiras de acessar e gerenciar Usuários:

Criando usuários

Por padrão, quando um aplicativo com o SDK do Pushwoosh integrado é iniciado pela primeira vez, ele define o HWID de um dispositivo como um ID de Usuário. Você pode chamar o método setUserID do SDK do Pushwoosh no login para definir qualquer valor necessário para associar um dispositivo a um usuário específico. Quando um usuário faz logout, você pode redefinir este valor para um padrão com outra chamada setUserID, por exemplo, para um valor inicial de HWID.

Importando usuários

Você pode importar facilmente IDs de Usuário de um arquivo CSV para um segmento de usuário específico. Por favor, encontre nossas instruções detalhadas no guia de Segmentos.

Exportando usuários

Para exportar IDs de Usuário, você pode utilizar a requisição de API /exportSegment, que oferece a opção de exportar dados em formato CSV ou JSON.

Acessando IDs de Usuário a partir dos logs do dispositivo

Os IDs de Usuário também podem ser acessados diretamente dos logs do dispositivo. Para instruções passo a passo, por favor, consulte o artigo Como Obter Logs do Console e Tokens de Dispositivo.

Tags de usuário e dispositivo

Assim como os dispositivos, os usuários (IDs de Usuário) podem ter seus próprios conjuntos de tags que servirão como rótulos para categorizar e identificar usuários ou dispositivos com base em suas características.

Como criar tags específicas do usuário

Quando você define uma tag específica do usuário, ela se aplica automaticamente tanto aos usuários quanto a todos os seus dispositivos associados. Isso significa que a tag será vinculada ao perfil do usuário e será refletida em todos os seus dispositivos.

Para criar uma tag específica do usuário no Painel de Controle do Pushwoosh, marque a caixa de seleção Específico do usuário ao adicionar uma nova tag. Se você não marcar a tag como específica do usuário, ela será associada apenas ao dispositivo.

Gerenciando transições de usuários

Dentro do Pushwoosh, o gerenciamento de transições de usuários envolve dois cenários principais:

Transição de usuário Anônimo para Conhecido

Quando um usuário anônimo se torna um usuário conhecido, o dispositivo que ele está usando passa a ser associado ao seu novo perfil de usuário. Durante essa transição, todos os atributos do dispositivo permanecem intactos. No entanto, é importante notar que todos os atributos específicos do usuário são redefinidos para os valores do usuário conhecido ou para o padrão, se não existirem.

Por exemplo, vamos considerar um cenário em que um usuário convidado tem usado um aplicativo de rastreamento de fitness com configurações padrão. Quando ele cria uma conta, os dados do seu dispositivo permanecem inalterados. No entanto, quaisquer detalhes específicos do usuário, como nome, e-mail e metas personalizadas, serão redefinidos para os valores do usuário conhecido.

Transição de um usuário Conhecido para outro

Se o Usuário associado a um dispositivo for alterado usando setUserID do SDK do Pushwoosh, o dispositivo é associado ao novo perfil de usuário.

Saiba mais sobre como definir IDs de Usuário para Android e iOS.

Você também pode usar a chamada de API /registerUser.

Assim como no cenário anterior, os atributos do dispositivo permanecem os mesmos, garantindo uma transição suave. No entanto, as tags específicas do usuário agora serão atribuídas aos valores do novo usuário. Isso garante que as tags do usuário reflitam o perfil do novo usuário com precisão.

Como exemplo, considere um cenário em um serviço de streaming de vídeo. Se um usuário registrado fizer logout e um usuário registrado diferente fizer login no mesmo dispositivo, as configurações do dispositivo, como idioma preferido e configurações de qualidade de vídeo, são mantidas. No entanto, qualquer informação específica do usuário, como histórico de visualização e recomendações, será alterada para o novo usuário.

Métodos de API para gerenciar usuários

O Pushwoosh fornece vários métodos de API para gerenciar usuários dentro de sua aplicação. Você precisará da ajuda de sua equipe de desenvolvimento para trabalhar com esses métodos. Para mais detalhes, compartilhe este link com sua equipe de desenvolvimento.

Se um usuário estiver associado a múltiplos dispositivos, qual deles receberá a mensagem durante uma Jornada do Cliente?

Cuidado

Por padrão, um usuário não pode estar na mesma jornada duas vezes ao mesmo tempo. Se um usuário acionar as condições de entrada enquanto já estiver participando, ele não será reinserido até que complete ou saia da jornada atual.

As Jornadas do Cliente operam com base nos IDs de Usuário. Se um ID de Usuário estiver vinculado a múltiplos dispositivos ou contatos, nenhum deles poderá reentrar na jornada enquanto o usuário já estiver nela.

Se você deseja que os usuários entrem na mesma jornada várias vezes, por exemplo, para compras ou reservas repetidas, ative a configuração de múltiplas sessões e defina um identificador de sessão (como order_id ou appointment_id).

Quando um usuário tem múltiplos dispositivos associados à sua conta, a forma como as mensagens são entregues entre eles depende do tipo de jornada:

Jornadas de entrada baseada em público e entrada baseada em Webhook

Por padrão, nessas jornadas, as mensagens são enviadas para o dispositivo ativo mais recentemente associado ao usuário. Isso garante que a mensagem chegue ao usuário com maior probabilidade de interagir com ela.

Jornadas de entrada baseada em gatilho

Por padrão, a mensagem é enviada para o dispositivo onde a ação de gatilho foi disparada pela última vez. Isso mantém o contexto e a relevância, entregando a mensagem no dispositivo onde a atividade relevante do usuário ocorreu.

Entrega em todos os dispositivos

No entanto, você pode optar por substituir essas configurações padrão e enviar a mensagem para todos os dispositivos associados ao ID de Usuário simultaneamente. Para isso, nas configurações da mensagem, role para baixo até Opções e ative a opção Enviar para todos os dispositivos do usuário.

Esta opção pode ser útil para transmissões ou notificações urgentes que precisam chegar ao usuário, independentemente do dispositivo que ele esteja usando no momento.