Centre de préférences pour les e-mails de l’API

En gérant les paramètres d’un centre de préférences, vous offrez à vos utilisateurs un guichet unique où ils peuvent modifier et gérer leurs préférences en matière d’envoi de messages e-mail. Cet article comprend des étapes pour créer un centre de préférences généré par l’API, mais vous pouvez également créer un centre de préférences à l’aide de l’éditeur par glisser-déposer.

Dans le tableau de bord de Braze, allez dans Audience > Centres de préférences e-mail.

C’est ici que vous pouvez gérer et visualiser chaque groupe d’abonnements. Chaque groupe d’abonnement que vous créez est ajouté à cette liste de centres de préférences. Vous pouvez créer plusieurs centres de préférences.

Créer un centre de préférences avec l’API

En utilisant les endpoints Preference Center Braze, vous pouvez créer un centre de préférences, un site web hébergé par Braze, qui peut afficher l’état de l’abonnement de votre utilisateur et les statuts du groupe d’abonnement. Votre équipe de développeurs peut créer le centre de préférences à l’aide de HTML et de CSS afin que le style de la page corresponde aux lignes directrices de votre marque.

L’utilisation de Liquid vous permet de retrouver les noms de vos groupes d’abonnement et le statut de chaque utilisateur. De cette manière, Braze stocke et récupère ces données lors du chargement de la page.

Conditions préalables

Étape 1 : Utilisez l’endpoint Créer un centre de préférences

Commençons par créer un centre de préférences à l’aide de l’ endpoint Créer un centre de préférences. Pour personnaliser votre centre de préférences, vous pouvez inclure du code HTML correspondant à votre image de marque dans les champs preference_center_page_html et confirmation_page_html.

L’endpoint Générer l’URL du centre de préférences vous permet d’obtenir l’URL du centre de préférences pour un utilisateur spécifique en dehors d’un e-mail envoyé par Braze.

Étape 2 : Inclure dans votre campagne d’e-mailing

Pour placer un lien vers le centre de préférences dans vos e-mails, utilisez l’étiquette Liquid suivante à l’endroit souhaité dans votre e-mail, de la même manière que vous inséreriez des URL de désabonnement.

1
{{preference_center.${kitchenerie_preference_center_example}}}

Vous pouvez également utiliser une combinaison de HTML qui inclut Liquid. Par exemple, vous pouvez coller l’URL suivante dans l’éditeur HTML ou l’éditeur par glisser-déposer. Vous verrez alors apparaître la présentation de base du centre de préférences, qui répertorie automatiquement tous les groupes d’abonnement e-mail.

1
<a href="{{preference_center.${kitchenerie_preference_center_example}}}">Edit your preferences</a>

Le centre de préférences comporte une case à cocher qui permettra à vos utilisateurs de se désabonner de tous les e-mails. Notez que vous ne pourrez pas enregistrer ces préférences si elles sont envoyées en tant que message test.

Modifier un centre de préférences

Vous pouvez modifier et mettre à jour votre centre de préférences en utilisant l’endpoint Mettre à jour le centre de préférences.

Identifier les centres de préférence et les détails

Pour identifier vos centres de préférences, utilisez le point de terminaison Afficher les détails du centre de préférences pour renvoyer des informations connexes telles que l’horodatage de la dernière mise à jour, l’ID du centre de préférences, etc.

Personnalisation

Braze gère les mises à jour de l’état des abonnements à partir du centre de préférences, ce qui permet à ce dernier de rester synchronisé. Cependant, vous pouvez également créer et héberger votre propre centre de préférences en utilisant les API des groupes d’abonnement avec les options suivantes.

Option 1 : Lien avec des paramètres de requête sous forme de chaîne de caractères

Utilisez les paires champ-valeur de la chaîne de caractères dans le corps de l’URL pour transmettre l’ID de l’utilisateur et la catégorie d’e-mail à la page afin que les utilisateurs n’aient qu’à confirmer leur choix de se désinscrire. Cette option est intéressante pour ceux qui stockent un identifiant d’utilisateur dans un format haché et qui ne disposent pas encore d’un centre d’abonnement.

Pour cette option, chaque catégorie d’e-mail nécessitera un lien de désabonnement spécifique :
http://mycompany.com/query-string-form-fill?field_id=John&field_category=offers

1
2
{% assign my_string = {{${user_id}}} | md5 %}
My encoded string is: {{my_string}}

Option 2 : S’authentifier avec un jeton web JSON

Utilisez un jeton web JSON pour authentifier les utilisateurs auprès d’une partie de votre serveur web (par exemple, les préférences de compte) qui se trouve normalement derrière une couche d’authentification telle que l’identification par nom d’utilisateur et mot de passe.

Cette approche ne nécessite pas de paires de chaînes de caractères intégrées dans l’URL, car celles-ci peuvent être transmises dans la charge utile du jeton web JSON, par exemple :

1
2
3
4
5
{
    "user_id": "1234567890",
    "name": "John Doe",
    "category": offers
}

Questions fréquemment posées

Je n’ai pas créé de centre de préférences. Pourquoi mon tableau de bord affiche-t-il “PreferenceCenterBrazeDefault” ?

Il est utilisé pour afficher le centre de préférences lorsque l’ancien Liquid ${preference_center_url} est utilisé, ce qui signifie que les étapes du canvas ou les modèles qui font référence à ${preference_center_url} ou preference_center.${PreferenceCenterBrazeDefault} ne fonctionneront pas. Ceci s’applique également aux messages envoyés précédemment qui comprenaient l’ancien Liquid ou “PreferenceCenterBrazeDefault” dans le message.

Si vous faites à nouveau référence à ${preference_center_url} dans un nouveau message, un centre de préférences nommé “PreferenceCenterBrazeDefault” sera à nouveau créé.

Les centres de préférences prennent-ils en charge plusieurs langues ?

Non. Cependant, vous pouvez utiliser Liquid lorsque vous écrivez le code HTML pour les pages personnalisées d’abonnement et de désabonnement. Si vous utilisez des liens dynamiques pour gérer les désabonnements, il s’agit d’un lien unique.

Par exemple, si vous suivez le taux de désabonnement des utilisateurs hispanophones, vous devrez soit utiliser des campagnes distinctes, soit exploiter l’analyse/analytique autour de Currents (par exemple en regardant quand un utilisateur se désabonne et en vérifiant la langue préférée de cet utilisateur).

Autre exemple, pour suivre les taux de désabonnement des utilisateurs hispanophones, vous pourriez ajouter une chaîne de caractères de paramètre de requête telle que ?Spanish=true à l’URL de désabonnement si la langue des utilisateurs est l’allemand et utiliser un lien de désabonnement ordinaire dans le cas contraire :

1
2
3
4
{% if ${language} == 'spanish' %} "${unsubscribe_url}?spanish=true"
{% else %}
${unsubscribe_url}
{% endif %}

Ensuite, grâce à Currents, vous pourriez identifier les utilisateurs qui parlent espagnol et le nombre d’événements de clics pour ce lien de désinscription.

L’envoi de liens de désinscription et de centres de préférences pour les e-mails est-il obligatoire ?

Non. Si le message “Le corps de votre e-mail ne contient pas de lien de désabonnement” s’affiche lors de la composition d’une campagne e-mail, cet avertissement est attendu si votre lien de désabonnement se trouve dans un bloc de contenu.