Usuários (IDs de Usuário)

Um ID de Usuário é um identificador único que é atribuído a cada usuário para manter os dados do usuário consistentes em todos os seus dispositivos. Isso permite que você forneça ao seu público uma experiência de usuário contínua 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 ID de Hardware (HWID) único.

Tipos de usuários

Existem dois tipos de usuários: usuários anônimos e usuários 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.

Obtendo e gerenciando 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 um HWID do 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 esse valor para um padrão com outra chamada de setUserID, por exemplo, para um valor HWID inicial.

Importando usuários

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

Exportando usuários

Para exportar IDs de Usuário, você pode utilizar a solicitaçã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 a partir dos logs do dispositivo. Para instruções passo a passo, consulte o artigo How to Obtain Console Logs and Device Tokens.

Tags de usuário e de 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ífica 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ário

Dentro do Pushwoosh, o gerenciamento de transições de usuário 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 fica 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 monitoramento de atividades físicas 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 será 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 em seu aplicativo. Entender esses métodos é crucial para o gerenciamento e direcionamento eficazes dos dados do usuário. Aqui estão os quatro métodos principais que alteram o status ou os atributos do usuário:

1. /applicationOpen

• Cria um dispositivo sem um token de push e um usuário anônimo, se eles não existirem.
• Define tags específicas do dispositivo no dispositivo.
• Não lida com alterações relacionadas ao usuário.

2. /registerDevice

• Cria um dispositivo com um token de push e um usuário, se eles não existirem.
• Associa um dispositivo ao usuário da solicitação de API (caso contrário, um usuário anônimo)
• Atribui todas as tags especificadas tanto ao dispositivo quanto ao seu usuário associado.

Cuidado

Para se proteger contra possíveis condições de corrida (onde múltiplas operações tentam modificar dados compartilhados simultaneamente), evite usar /registerDevice simultaneamente com /registerUser.

3. /registerUser

• Cria um dispositivo sem um token de push e um usuário, se ele não existir.
• Transfere um dispositivo entre usuários, mantendo as tags do dispositivo.

4. /setTags

• Cria um dispositivo sem um token de push e um usuário anônimo, se ele não existir.
• Atribui tags de dispositivo ao dispositivo.
• Atribui tags de usuário ao usuário fornecido na solicitação (se tal usuário existir).
• Este método não transfere o dispositivo e, como resultado, não pode criar um novo usuário conhecido (você pode usar o método /registerUser para criar um novo usuário conhecido).

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

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 baseadas em Audiência e 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 baseadas 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.