Personalizzazione con i cookie
In questo tutorial si apprenderà come utilizzare i cookie di lato server per la personalizzazione. Ad esempio, è possibile mostrare contenuti diversi a seconda che un acquirente sia nuovo o abituale, come un banner di offerta di benvenuto per i nuovi acquirenti e un banner di offerta promozionale per gli acquirenti abituali.
È consigliabile testare i passaggi in un ambiente non di produzione prima di distribuire le modifiche nell'ambiente Production.
Prima di eseguire i comandi di questo tutorial, sostituire tutti i segnaposto con valori effettivi. I segnaposto sono formattati nel seguente modo: $PLACEHOLDER
.
Per completare questo tutorial:
-
Utilizzare PWA Kit versione 3.1.0 o successiva.
-
Sul computer locale, abilitare i cookie di lato server completando uno dei seguenti passaggi:
-
Impostare la variabile di ambiente
MRT_ALLOW_COOKIES=true
.oppure
-
Far passare
localAllowCookies
alle opzioni diruntime.CreateHandler
inssr.js
.
-
-
Per l'ambiente scelto, abilitare i cookie di lato server utilizzando Managed Runtime (MRT) API o Runtime Admin:
- MRT API: Richiamare l'endpoint APIprojects_target_partial_update e impostare
allow_cookies
su true. - Runtime Admin: Abilitare i cookie in Environment Settings (Impostazioni ambiente).
- MRT API: Richiamare l'endpoint APIprojects_target_partial_update e impostare
-
In
app/pages/home/index.jsx
, creare i contenuti prescelti per gli acquirenti nuovi e abituali. In alternativa, è possibile creare altri contenuti che si applicano a diverse categorie di acquirenti.
- Aggiungere questo codice JavaScript al file della home page del proprio progetto
app/pages/home/index.jsx
:
- Testare a fondo la funzionalità dei cookie su diversi browser e dispositivi.
- Richiedere sempre il consenso dell'acquirente prima di memorizzare qualsiasi informazione personale nei cookie di lato server.
- Assicurarsi che l'approccio alla personalizzazione sia conforme alle normative sulla privacy dei dati pertinenti, come il GDPR (General Data Protection Regulation) o il CCPA (California Consumer Privacy Act).
- Valutare attentamente l'impatto della personalizzazione sui diversi segmenti di acquirenti per evitare conseguenze indesiderate.
- Impostare gli attributi di sicurezza appropriati per il cookie, ad esempio il flag HttpOnly per impedire l'accesso JavaScript di lato client e il flag Secure per le connessioni HTTPS.
- Impostare un tempo di scadenza ragionevole per il cookie in base alle proprie esigenze. Per
isNewShopper
è idoneo un tempo di scadenza lungo. Ad esempio, un anno.
In questa sezione vengono suggerite soluzioni per gli errori comuni che potrebbero verificarsi con l'utilizzo dei cookie di lato server.
Dopo la distribuzione del codice che coinvolge i cookie di lato server non si è verificato il comportamento del sito previsto.
Causa: I cookie di lato server non sono stati abilitati.
Soluzione suggerita: Abilitare i cookie lato server come descritto in Prerequisiti.
Si sono verificate interruzioni nelle sessioni o nelle preferenze dell'utente.
Causa: I cookie sono scaduti o sono stati eliminati prematuramente.
Soluzione suggerita:
- Esaminare le impostazioni di scadenza dei cookie e modificarle in base alle esigenze per allinearle ai requisiti di sessione o di persistenza desiderati.
- Implementare meccanismi per rilevare e gestire correttamente i cookie scaduti o eliminati, ad esempio riautenticando gli acquirenti o chiedendo loro di ristabilire le proprie preferenze.
- Monitorare il feedback e il comportamento degli acquirenti per identificare eventuali modelli o problemi relativi alla scadenza o all'eliminazione dei cookie e risolverli in modo proattivo.
A volte i cookie si comportano in modo diverso tra le diverse pagine o componenti del sito, causando incoerenze nell'esperienza dell'acquirente.
Causa: Logica incoerente o decentralizzata relativa ai cookie.
Soluzione suggerita:
- Assicurarsi che la logica relativa ai cookie, inclusa l'impostazione e la lettura dei cookie, sia applicata in modo coerente in tutte le pagine e i componenti pertinenti.
- Esaminare il flusso dell'applicazione per identificare eventuali discrepanze o incongruenze nella modalità di gestione dei cookie.
- Al fine di garantire un comportamento uniforme, è consigliabile centralizzare la logica relativa ai cookie o utilizzare una libreria o un middleware dedicato per la gestione dei cookie in questione.