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.

Personalizar con cookies

En este tutorial, aprenderá a usar las cookies del lado del servidor para la personalización. Por ejemplo, puede mostrar contenido diferente en función de si un comprador es nuevo o regresa, como un banner de oferta de bienvenida para los nuevos compradores y un banner de oferta promocional para los compradores que regresan.

Se recomienda probar los pasos en un entorno que no sea de producción antes de implementar los cambios en producción.

Antes de ejecutar los comandos de este tutorial, reemplace los marcadores de posición por valores reales. Los marcadores de posición tienen el siguiente formato: $PLACEHOLDER.

Para completar este tutorial:

Utilice PWA Kit versión 3.1.0 o posterior.
En su máquina local, habilite las cookies del lado del servidor completando cualquiera de estos pasos:
- Establezca la variable de MRT_ALLOW_COOKIES=trueentorno .
  
  o
- Pase localAllowCookies a las opciones de runtime.CreateHandler en ssr.js.
Para el entorno elegido, habilite las cookies del lado del servidor mediante la API de Managed Runtime (MRT) o el administrador de tiempo de ejecución:
- API de MRT: Llame al punto de conexión de la projects_target_partial_update API y establézcalo allow_cookies en true.
- Admin Runtime: Habilite las cookies en la Configuración del entorno.
En app/pages/home/index.jsx, cree el contenido que elija para compradores nuevos y recurrentes. O crea otro contenido que se aplique a diferentes categorías de compradores.

Agregue este código JavaScript al archivo de la página de inicio en su proyecto app/pages/home/index.jsx:

Implemente su paquete.

Pruebe minuciosamente la funcionalidad de las cookies en diferentes navegadores y dispositivos.
Obtenga siempre el consentimiento del comprador antes de almacenar cualquier información personal en las cookies del lado del servidor.
Asegúrese de que su enfoque de personalización cumpla con las normativas de privacidad de datos relevantes, como el Reglamento General de Protección de Datos (RGPD) o la Ley de Privacidad del Consumidor de California (CCPA).
Evalúe cuidadosamente el impacto de la personalización en los diferentes segmentos de compradores para evitar consecuencias imprevistas.
Establezca los atributos de seguridad adecuados para su cookie, como el indicador HttpOnly para evitar el acceso a JavaScript del lado del cliente y el indicador Seguro para las conexiones HTTPS.
Establezca un tiempo de caducidad razonable para la cookie en función de sus necesidades. Para isNewShopper, un tiempo de caducidad largo es adecuado. Por ejemplo, un año.

Esta sección proporciona soluciones sugeridas para errores comunes que puede encontrar al usar cookies del lado del servidor.

No obtuvo el comportamiento esperado del sitio después de implementar código que involucra cookies del lado del servidor.

Causa: No habilitó las cookies del lado del servidor.

Solución sugerida: Habilite las cookies del lado del servidor como se describe en los requisitos previos.

Hay interrupciones en las sesiones o preferencias del usuario.

Causa: Las cookies han caducado o se han eliminado prematuramente.

Solución sugerida:

Revise la configuración de caducidad de sus cookies y ajústela según sea necesario para alinearla con los requisitos de sesión o persistencia deseados.
Implemente mecanismos para detectar y manejar las cookies caducadas o eliminadas de manera correcta, como volver a autenticar a los compradores o pedirles que restablezcan sus preferencias.
Supervise los comentarios y el comportamiento de los compradores para identificar patrones o problemas relacionados con la caducidad o eliminación de cookies y abordarlos de forma proactiva.

A veces, las cookies se comportan de manera diferente en diferentes páginas o componentes de su sitio, lo que genera inconsistencias en la experiencia del comprador.

Causa: Lógica incoherente o descentralizada relacionada con las cookies.

Solución sugerida:

Asegúrese de que la lógica relacionada con las cookies, incluida la configuración y lectura de cookies, se aplique de manera coherente en todas las páginas y componentes relevantes.
Revise el flujo de su aplicación para identificar discrepancias o inconsistencias en la forma en que se manejan las cookies.
Considere la posibilidad de centralizar la lógica relacionada con las cookies o utilizar una biblioteca dedicada o middleware para gestionar las cookies a fin de garantizar un comportamiento uniforme.