Passer au contenu principal

​
Qu’est-ce qu’un centre de préférences ?

Un centre de préférences est une page sur votre application ou site web qui permet à vos utilisateurs de contrôler comment et quel type de messages ils reçoivent de vous. Pour plus de détails et de raisons de créer un centre de préférences, consultez Un guide des centres de préférences utilisateur. Ce guide explique la configuration technique nécessaire pour inclure un centre de préférences utilisateur dans votre application ou site web en utilisant les API de OneSignal. Dans ce guide, nous discutons de comment :
  • assigner des sujets, catégories et contrôles de fréquence avec les balises de données
  • collecter de nouveaux canaux de communication (notifications push, email, SMS)
  • désactiver les canaux de communication si l’utilisateur souhaite se désabonner
  • gérer la conformité des données
  • supprimer les données utilisateur

​
Exigences

  • SDK mobiles OneSignal version 5+ et/ou SDK Web 16+
  • Définir l’ID externe ou alias
  • OneSignal ne fournit aucune API pour créer la mise en page du centre de préférences, uniquement les API pour GET, PATCH et DELETE les utilisateurs et abonnements
    • Si vous avez un site web et avez besoin d’un centre de préférences simple, essayez notre invite de catégorie

​
Lectures supplémentaires recommandées

​
Configuration

Lorsque l’utilisateur arrive sur votre centre de préférences, utilisez l’API Afficher l’utilisateur pour récupérer les données OneSignal de l’utilisateur en fonction soit de l’external_id soit d’un alias personnalisé que vous définissez. Cela vous fournira les properties et subscriptions de l’utilisateur. Les données utiles incluent mais ne se limitent pas à :
  • properties : les données utilisateur
    • tags - données personnalisées que vous envoyez à OneSignal
    • language - le code de langue pour l’utilisateur
  • subscriptions : les canaux de messagerie et le statut d’abonnement
    • id - l’ID d’abonnement
    • type - Email, SMS, *Push (AndroidPush, iOSPush, ChromePush, SafariPush, etc)
    • enabled - true signifie abonné, false signifie désabonné
    • token - le jeton push, l’adresse email ou le numéro de téléphone selon le type d’abonnement
{
  "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
    }
  ]
}
Utilisez les données fournies pour remplir le centre de préférences selon vos besoins.

​
Assigner des catégories et des contrôles de fréquence

Consultez Balises de données. Les balises sont des paires clé-valeur utilisées pour segmenter et personnaliser. Utilisez des entiers encodés en chaîne ou des horodatages pour activer le filtrage par plage. Les utilisateurs peuvent basculer des intérêts (par exemple, sports: 1) ou définir des balises de fréquence comme newsletter-frequency: weekly. Utilisez ces données dans les segments ou l’API Créer une notification avec des filtres. Pour mettre à jour une balise, appelez l’API Mettre à jour l’utilisateur.

​
Collecter de nouveaux canaux de communication

Vérifiez subscriptions pour le type et le statut activé. Affichez token uniquement pour email/SMS, pas pour push.
Si les informations de contact existent dans votre système mais pas encore dans OneSignal, utilisez votre propre base de données comme solution de secours pour les afficher.

​
Mises à jour Email & SMS

Utilisez les méthodes SDK addEmail, addSms ou les API Créer un abonnement et Mettre à jour l’abonnement. L’id d’abonnement est requis pour les mises à jour.

​
Mises à jour Push

Si le push n’est pas activé, invitez l’utilisateur.

​
Désactiver les canaux de communication

Utilisez Mettre à jour l’abonnement pour définir enabled sur false. Basculez sur true pour se réabonner.

​
Gérer la conformité des données

Empêchez l’initialisation du SDK par défaut et exigez le consentement de l’utilisateur pour initialiser. Consultez Gestion des données personnelles.

​
Supprimer les données utilisateur

Utilisez l’API Supprimer l’utilisateur pour supprimer complètement un utilisateur de OneSignal.