Passer au contenu principal

​
Vue d’ensemble

OneSignal fournit une expérience de désabonnement email conforme par défaut qui insère un lien dans vos modèles d’email permettant aux utilisateurs de se désabonner facilement et leurs statuts d’abonnement sont mis à jour en temps réel. Si vous souhaitez un contrôle total sur l’identité visuelle, le contenu et les champs (comme la désinscription par catégorie), vous pouvez remplacer le lien par défaut par votre propre page personnalisée et utiliser l’API OneSignal pour désabonner ou mettre à jour les préférences utilisateur. Ce guide explique comment ajouter votre propre page de désabonnement personnalisée aux emails (en supprimant le lien OneSignal par défaut) et quelles API utiliser pour désabonner l’abonnement email de l’utilisateur. Si vous souhaitez ajouter plus de fonctionnalités à votre page de désabonnement personnalisée (comme se désabonner de catégories d’emails spécifiques plutôt que de tous), ceci est détaillé dans notre tutoriel Centre de préférences.

​
Supprimer le lien de désabonnement par défaut de OneSignal

OneSignal insère automatiquement un lien spécial au format [unsubscribe_url] dans vos modèles d’email. Cette URL désabonne l’utilisateur de tous les emails dans OneSignal. Consultez Liens de désabonnement email pour plus de détails. Pour utiliser votre propre page, localisez et supprimez le lien par défaut dans votre modèle.
  • Éditeur Glisser-Déposer
  • Éditeur HTML
Dans l’éditeur glisser-déposer, le lien par défaut peut apparaître imbriqué comme ceci :
Lien de désabonnement dans l'éditeur Glisser-Déposer

Lien de désabonnement dans l'éditeur Glisser-Déposer

​
Ajouter votre lien de désabonnement personnalisé

Maintenant que vous avez supprimé notre lien spécial, vous pouvez le remplacer par votre propre URL. Souvent, ces liens nécessitent que des données supplémentaires soient transmises à votre page. Utilisez les variables Liquid pour transmettre les données OneSignal à votre page. Paramètres courants :
ParamètreDescription
subscription.emailAdresse email de l’abonné
subscription.external_idID externe de l’utilisateur
app.idID d’application OneSignal
message.idID de la notification email
subscription.languageLangue préférée (pour la localisation)
subscription.unsubscribe_tokenJeton de sécurité pour la vérification de l’API
Exemple d’URL : 
https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}
HTML
  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      Unsubscribe
    </a>
    <p style="display: inline;"> from our emails</p>
  </div>
Ajouter un lien de désabonnement personnalisé

Ajouter un lien de désabonnement personnalisé

​
Désactiver le suivi des clics

Les clics de désabonnement ne sont généralement pas utilisés pour les métriques d’engagement. Si vous souhaitez désactiver le suivi des liens, vous pouvez ajouter l’attribut data-disable-tracking="true" à votre lien comme ceci :
HTML
  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    Unsubscribe
  </a>
Attributs spécifiques aux fournisseurs :
FournisseurAttribut
OneSignaldata-disable-tracking="true"
Mailgundisable-tracking=true
SendGridclicktracking=off
Mandrillmc:disable-tracking

​
Héberger votre page de désabonnement personnalisée

Déployez une page web qui :
  • Lit les paramètres de requête du lien de désabonnement.
  • Affiche des options de désinscription ou de préférences conviviales.
  • Envoie la demande de désabonnement ou de mise à jour à OneSignal via l’API.
Nous fournissons un projet exemple GitHub fonctionnel que vous pouvez dupliquer et déployer.
Page de désabonnement exemple

Interface de page de désabonnement exemple

​
Appeler l’API OneSignal

Selon votre cas d’utilisation, vous pouvez utiliser les API suivantes pour désabonner ou mettre à jour les préférences utilisateur :
  • Mettre à jour l'abonnement par jeton
  • Désabonner l'email avec jeton
  • Mettre à jour l'utilisateur
Cette API est le plus souvent utilisée lorsque vous avez l’adresse email de l’utilisateur et souhaitez simplement l’abonner ou le désabonner de tous les emails.Paramètres de requête requis :
  • app_id
  • token
Authentification requise
  • Appelez cette API depuis votre serveur.
Vous devriez maintenant avoir toutes les informations nécessaires pour créer une page de désabonnement personnalisée.