Add the #DF24 Developer Keynote to your agenda. Join us in-person on 9/18 at 2:30 p.m. PT or on Salesforce+ at 5 p.m. PT for the must-see session built just for developers.

Personnaliser avec des cookies

Dans ce tutoriel, vous allez apprendre à utiliser les cookies côté serveur pour la personnalisation. Par exemple, vous pouvez afficher différents contenus selon qu’il s’agit d’un nouvel acheteur ou d’un acheteur régulier, comme une bannière d’offre de bienvenue pour les nouveaux acheteurs et une bannière d’offre promotionnelle pour les acheteurs réguliers.

Nous vous recommandons de tester les étapes dans un environnement hors production avant de déployer vos modifications en production.

Avant d’exécuter les commandes de ce tutoriel, remplacez les espaces réservés par des valeurs réelles. Les espaces réservés sont formatés ainsi : $PLACEHOLDER.

Pour suivre ce tutoriel, procédez comme suit :

Utilisez PWA Kit version 3.1.0 ou ultérieure.
Sur votre ordinateur local, activez les cookies côté serveur en effectuant l’une des actions suivantes :
- Définir la variable d’environnement MRT_ALLOW_COOKIES=true.
  
  ou
- Passer localAllowCookies aux options de runtime.CreateHandler dans ssr.js.
Pour l’environnement que vous avez choisi, activez les cookies côté serveur à l’aide de l’API Managed Runtime (MRT) ou de Runtime Admin :
- API MRT : appelez le point de terminaison d’API projects_target_partial_update et définissez allow_cookies sur true.
- Runtime Admin : activez les cookies dans les paramètres d’environnement.
Dans app/pages/home/index.jsx, créez le contenu de votre choix pour les nouveaux acheteurs et les acheteurs réguliers. Vous pouvez également créer d’autres contenus qui s’appliquent à différentes catégories d’acheteurs.

Ajoutez ce code JavaScript au fichier de la page d’accueil de votre projet app/pages/home/index.jsx :

Déployez votre paquet.

Testez soigneusement la fonctionnalité des cookies sur différents navigateurs et appareils.
Obtenez toujours le consentement de l’acheteur avant de stocker des informations personnelles dans des cookies côté serveur.
Assurez-vous que votre approche de la personnalisation est conforme aux réglementations pertinentes en matière de confidentialité des données, telles que le Règlement général sur la protection des données (RGPD) ou le California Consumer Privacy Act (CCPA).
Évaluez soigneusement l’impact de la personnalisation sur les différents segments d’acheteurs pour éviter des conséquences inattendues.
Configurez des attributs de sécurité appropriés pour votre cookie, tels que l’indicateur HttpOnly pour empêcher l’accès JavaScript côté client et l’indicateur Secure pour les connexions HTTPS.
Définissez un délai d’expiration raisonnable pour le cookie en fonction de vos besoins. Pour isNewShopper, un long délai d’expiration convient, par exemple un an.

Cette section suggère des solutions pour les erreurs courantes que vous pouvez rencontrer lors de l’utilisation de cookies côté serveur.

Vous n’avez pas obtenu le comportement de site attendu après avoir déployé du code impliquant des cookies côté serveur.

Cause : vous n’avez pas activé les cookies côté serveur.

Solution suggérée : activez les cookies côté serveur comme décrit dans les Prérequis.

Il y a des perturbations dans les sessions ou les préférences des utilisateurs.

Cause : les cookies ont expiré ou ont été supprimés prématurément.

Solution suggérée :

Passez en revue les paramètres d’expiration de vos cookies et ajustez-les si nécessaire pour les aligner sur les exigences de session ou de persistance souhaitées.
Implémentez des mécanismes pour détecter et gérer correctement les cookies expirés ou supprimés, par exemple en authentifiant à nouveau les acheteurs ou en les invitant à rétablir leurs préférences.
Surveillez les commentaires et le comportement des acheteurs pour identifier les tendances ou les problèmes liés à l’expiration ou à la suppression des cookies et y remédier de manière proactive.

Parfois, les cookies se comportent différemment d’une page ou d’un composant à l’autre de votre site, ce qui entraîne des incohérences dans l’expérience d’achat.

Cause : logique incohérente ou décentralisée liée aux cookies.

Solution suggérée :

Assurez-vous que la logique liée aux cookies, y compris la configuration et la lecture des cookies, est appliquée de manière cohérente sur toutes les pages et tous les composants pertinents.
Examinez le flux de votre application pour identifier les divergences ou les incohérences dans la façon dont les cookies sont gérés.
Envisagez de centraliser la logique liée aux cookies ou d’utiliser une bibliothèque ou un middleware dédié pour gérer les cookies afin de garantir un comportement uniforme.