Pular para o conteúdo principal

​
O que é uma central de preferências?

Uma Central de Preferências é uma página em seu aplicativo ou site que permite aos usuários controlar como e que tipo de mensagens eles recebem de você. Para mais detalhes e razões para criar uma Central de Preferências, consulte Um Guia para Centrais de Preferências do Usuário. Este guia explica a configuração técnica necessária para incluir uma central de preferências de usuário em seu aplicativo ou site usando as APIs do OneSignal. Neste guia discutimos como:
  • atribuir tópicos, categorias e controles de frequência com Tags de Dados
  • coletar novos canais de comunicação (notificações push, email, SMS)
  • desabilitar canais de comunicação se o usuário quiser cancelar
  • lidar com conformidade de dados
  • excluir dados do usuário

​
Requisitos

  • SDKs Móveis do OneSignal versão 5+ e/ou Web SDK 16+
  • Configurar o External ID ou Alias
  • O OneSignal não fornece nenhuma API para criar o layout da Central de Preferências, apenas as APIs para GET, PATCH e DELETE de Usuários e Assinaturas
    • Se você tem um site e precisa de uma central de preferências simples, experimente nosso Prompt de Categoria

​
Leituras adicionais recomendadas

​
Configuração

Quando o usuário acessar sua central de preferências, use a API View user para obter os dados do OneSignal para o usuário com base no external_id ou em um alias personalizado que você definiu. Isso fornecerá as properties e subscriptions do usuário. Os dados úteis incluem, mas não se limitam a:
  • properties: os dados do usuário
    • tags - dados personalizados que você envia para o OneSignal
    • language - o código do idioma do usuário
  • subscriptions: os canais de mensagens e status de assinatura
    • id - o ID da Assinatura
    • type - Email, SMS, *Push (AndroidPush, iOSPush, ChromePush, SafariPush, etc)
    • enabled - true significa inscrito, false significa cancelado
    • token - o token push, endereço de email ou número de telefone dependendo do tipo de assinatura
{
  "properties": {
    "tags": {
      "finance": "1",
      "tech": "1",
      "sports": "1",
      "breaking-news": "0",
      "entertainment": "0",
      "deals": "0",
      "newsletter-frequency": "weekly",
      "customer_status": "Enterprise",
      "event": "1693411710",
      "first_name": "Jon",
      "last_name": "F"
    },
    "language": "en"
  },
  "subscriptions": [
    {
      "id": "sub_id_1",
      "type": "Email",
      "token": "email@example.com",
      "enabled": true
    },
    {
      "id": "sub_id_2",
      "type": "SMS",
      "token": "1234567890",
      "enabled": true
    },
    {
      "id": "sub_id_3",
      "type": "ChromePush",
      "token": "some_token_here",
      "enabled": true
    }
  ]
}
Use os dados fornecidos para preencher a central de preferências conforme necessário.

​
Atribuir categorias e controles de frequência

Consulte Tags de Dados. Tags são pares chave-valor usados para segmentar e personalizar. Use inteiros codificados como string ou timestamps para habilitar filtragem baseada em intervalo. Os usuários podem alternar interesses (por exemplo, sports: 1) ou definir tags de frequência como newsletter-frequency: weekly. Use esses dados em Segmentos ou na API Create notification com filtros. Para atualizar uma tag, chame a API Update user.

​
Coletar novos canais de comunicação

Verifique subscriptions para tipo e status habilitado. Mostre token apenas para email/SMS, não para push.
Se as informações de contato existirem no seu sistema mas ainda não no OneSignal, use seu próprio banco de dados como alternativa para exibi-las.

​
Atualizações de Email e SMS

Use os métodos SDK addEmail, addSms ou as APIs Create subscription e Update subscription. O id da assinatura é necessário para atualizações.

​
Atualizações de Push

Se push não estiver habilitado, solicite ao usuário.

​
Desabilitar canais de comunicação

Use Update subscription para definir enabled como false. Alterne para true para optar novamente.

​
Lidar com conformidade de dados

Evite a inicialização do SDK por padrão e exija consentimento do usuário para inicializar. Consulte Tratamento de Dados Pessoais.

​
Excluir dados do usuário

Use a API Delete user para remover completamente um usuário do OneSignal.