Pular para o conteúdo

Defina um ID de usuário personalizado e vincule-o a vários dispositivos

Para permitir uma comunicação perfeita e personalizada em todas as plataformas e dispositivos, é essencial atribuir um ID de usuário personalizado a cada usuário.

O que é um User ID?

Anchor link to

O User ID é um identificador exclusivo atribuído a cada usuário para manter dados de 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 seus dispositivos.

Para uma explicação detalhada de como os User IDs funcionam e como eles se relacionam com os dispositivos, consulte este guia.

Por que você precisa definir um User ID personalizado

Anchor link to

Por padrão, quando seu aplicativo é iniciado pela primeira vez, o Pushwoosh cria um User ID igual ao Hardware ID (HWID) do dispositivo. Isso significa que cada dispositivo é tratado como um usuário separado. Portanto, se uma pessoa usa mais de um dispositivo, como um telefone e um tablet, o Pushwoosh os vê como dois usuários separados, e seus dados não serão conectados.

Se você deseja que o Pushwoosh reconheça vários dispositivos como pertencentes ao mesmo usuário, você precisa definir um User ID personalizado e atribuí-lo a todos os dispositivos desse usuário.

Fazer isso vincula todos os dispositivos e métodos de contato sob um único perfil de usuário, desbloqueando vários benefícios importantes:

Contagens de usuários precisas para faturamento

Anchor link to

O Pushwoosh cobra com base no número de usuários únicos em seu banco de dados.

Saiba mais sobre os preços do Pushwoosh

Se você não definir um User ID personalizado, cada dispositivo conta como um usuário separado, mesmo que pertençam à mesma pessoa. Por exemplo, se um usuário usa tanto um celular quanto um tablet, ele pode ser contado como dois usuários.

Mensagens consistentes em todos os canais

Anchor link to

Para uma experiência unificada em notificações push, e-mail, SMS, in-app, WhatsApp e outros canais, todos os dados do usuário devem estar vinculados sob um único User ID.

Ao definir um User ID personalizado, você garante que o Pushwoosh reconheça todos os métodos de contato (dispositivos, e-mails, números de telefone) como pertencentes ao mesmo usuário, o que é essencial para campanhas omnicanal consistentes e personalizadas.

Saiba mais sobre campanhas Omnichannel

Perfis de usuário persistentes

Anchor link to

Um User ID personalizado permite que o Pushwoosh mantenha um perfil completo e unificado para cada usuário. Este perfil inclui:

  • Todos os dispositivos e informações de contato vinculados ao mesmo usuário
  • Tags
  • Histórico de eventos e participação em campanhas
  • Mensagens enviadas e abertas

Você pode visualizar e gerenciar esses dados no Explorador de Usuários, ajudando a fornecer uma segmentação mais precisa e uma melhor personalização.

Como atribuir e gerenciar User IDs

Anchor link to

O Pushwoosh oferece vários métodos para atribuir e gerenciar User IDs:

Método setUserID do SDK

Anchor link to

Por padrão, quando um aplicativo com o SDK do Pushwoosh é iniciado pela primeira vez, ele define o HWID do dispositivo como um User ID. No entanto, você pode definir um ID de usuário personalizado em vários pontos, dependendo do design e do fluxo do usuário do aplicativo. Para isso, use o método setUserId fornecido pelo SDK do Pushwoosh.

Aqui estão alguns momentos-chave em que você pode definir ou atualizar um User ID personalizado:

  • Quando o usuário se registra no aplicativo
  • Quando o usuário faz login
  • Quando o usuário faz uma compra ou assinatura
  • Quando o usuário interage com recursos específicos, etc.

Exemplo para iOS

[[Pushwoosh sharedInstance] setUserId:@"userId"];

Exemplo para Android

Pushwoosh.getInstance().setUserId("testUser");

Exemplo para Web

api.registerUser('user123');

Gerenciando User IDs durante o login e logout

Anchor link to

Quando um usuário faz logout, é recomendável redefinir seu User ID para um valor padrão usando outra chamada setUserId. Quando o usuário fizer login novamente, atualize o User ID para o valor personalizado específico daquele usuário.

Se o User ID mudar (por exemplo, se um usuário fizer logout e outro usuário fizer login), chame setUserId para atualizar o User ID associado a esse dispositivo. Isso garante que o User ID correto esteja sempre vinculado ao dispositivo, permitindo que notificações personalizadas sejam enviadas ao usuário apropriado.

Método da API registerEmail ou registerEmailUser

Anchor link to

Use o método da API registerEmail ou registerEmailUser para associar um User ID externo a um endereço de e-mail especificado.

Observe que registerEmailUser não registra um endereço de e-mail em sua base de usuários; ele deve ser usado apenas para atribuir IDs de usuário a endereços de e-mail que já foram registrados por uma solicitação registerEmail.

Método da API registerDevice

Anchor link to

Embora usado principalmente para registrar um novo dispositivo no Pushwoosh, este método também pode definir um User ID no momento do registro do dispositivo.

Se você passar um User ID personalizado nesta chamada (por exemplo, “userId”: “Alex”), ele será associado ao dispositivo. Se nenhum User ID for fornecido, o dispositivo será associado a um User ID anônimo igual ao hardware ID (HWID).

Para associar números de telefone de clientes ao UserId usando o método /registerDevice, especifique o número de telefone no parâmetro “hwid”.

Método da API registerUser

Anchor link to

Este método da API permite que você associe um User ID externo a um dispositivo especificado ou transfira um dispositivo entre usuários, mantendo as tags do dispositivo, por exemplo, quando um usuário faz logout e um novo usuário faz login.

Este método pode ser usado antes que o dispositivo seja registrado ou antes de obter o token de push, por exemplo, quando você precisa pré-registrar um usuário no Pushwoosh. Saiba mais