Personalizar com cookies

Neste tutorial, você aprenderá a usar cookies no lado do servidor para personalização. Por exemplo, você pode mostrar conteúdo diferente, dependendo se o comprador é novo ou está retornando, como um banner de oferta de boas-vindas para novos compradores e um banner de oferta promocional para compradores que retornam.

Recomendamos testar as etapas em um ambiente que não seja de produção antes de implantar suas alterações na produção.

Antes de executar os comandos neste tutorial, substitua os espaços reservados por valores reais. Os espaços reservados são formatados da seguinte maneira: $PLACEHOLDER.

Para concluir este tutorial:

Use o PWA Kit versão 3.1.0 ou posterior.
Em sua máquina local, habilite os cookies no lado do servidor concluindo uma destas etapas:
- Defina a variável de ambiente MRT_ALLOW_COOKIES=true.
  
  ou
- Passe localAllowCookies para as opções de runtime.CreateHandler em ssr.js.
Para o ambiente escolhido, habilite os cookies do lado do servidor usando a Managed Runtime (MRT) API ou o Runtime Admin:
- MRT API: Chame o endpoint da projects_target_partial_update API e defina allow_cookies como true.
- Runtime Admin: Ative os cookies nas Configurações do ambiente.
Em app/pages/home/index.jsx, crie o conteúdo escolhido para compradores novos e recorrentes. Ou crie outro conteúdo que se aplique a diferentes categorias de compradores.

Adicione este código JavaScript ao arquivo da página inicial em seu projeto app/pages/home/index.jsx:

Implante seu pacote.

Teste completamente a funcionalidade de cookies em diferentes navegadores e dispositivos.
Sempre obtenha o consentimento do comprador antes de armazenar qualquer informação pessoal em cookies no lado do servidor.
Certifique-se de que sua abordagem de personalização esteja em conformidade com as regulamentações relevantes de privacidade de dados, como o Regulamento Geral de Proteção de Dados (GDPR) ou a Lei de Privacidade do Consumidor da Califórnia (CCPA).
Avalie cuidadosamente o impacto da personalização em diferentes segmentos de compradores para evitar consequências não intencionais.
Defina atributos de segurança apropriados para seu cookie, como o sinalizador HttpOnly para impedir o acesso JavaScript no lado do cliente e o sinalizador Seguro para conexões HTTPS.
Defina um tempo de expiração razoável para o cookie com base em suas necessidades. Para isNewShopper, um longo prazo de validade é adequado. Por exemplo, um ano.

Esta seção fornece soluções sugeridas para erros comuns que você pode encontrar ao usar cookies no lado do servidor.

Você não obteve o comportamento de site esperado depois de implantar o código que envolve cookies no lado do servidor.

Causa: Você não ativou os cookies no lado do servidor.

Solução sugerida: Habilite os cookies no lado do servidor, conforme descrito nos Pré-requisitos.

Há interrupções nas sessões ou preferências do usuário.

Causa: Os cookies expiraram ou foram excluídos prematuramente.

Solução sugerida:

Revise as configurações de expiração de seus cookies e ajuste-as conforme necessário para se alinhar com os requisitos de sessão ou persistência desejados.
Implemente mecanismos para detectar e lidar com cookies expirados ou excluídos normalmente, como autenticar novamente os compradores ou solicitar que eles restabeleçam suas preferências.
Monitore o feedback e o comportamento do comprador para identificar quaisquer padrões ou problemas relacionados à expiração ou exclusão de cookies e resolva-os de forma proativa.

Às vezes, os cookies se comportam de maneira diferente em diferentes páginas ou componentes do seu site, levando a inconsistências na experiência do comprador.

Causa: Lógica inconsistente ou descentralizada relacionada a cookies.

Solução sugerida:

Certifique-se de que a lógica relacionada a cookies, incluindo a configuração e leitura de cookies, seja aplicada de forma consistente em todas as páginas e componentes relevantes.
Analise o fluxo do seu aplicativo para identificar quaisquer discrepâncias ou inconsistências na forma como os cookies são tratados.
Considere centralizar a lógica relacionada a cookies ou usar uma biblioteca dedicada ou middleware para gerenciar cookies para garantir um comportamento uniforme.