Notas de versão do Composable Storefront

Estas notas de versão incluem atualizações para Progressive Web App (PWA) Kit e Managed Runtime.

As notas de versão mais recentes do PWA Kit são publicadas na página de versões no GitHub antes de serem publicadas aqui. Para ficar por dentro das novas versões do PWA Kit, assine as notificações do GitHub para receber informações sobre as versões. Consulte Configuring Your Watch Settings (Configurar as definições de visualização).
  • As notas de versão podem ser publicadas antes de os pacotes do Github relevantes serem atualizados. As notas de versão identificam qualquer versão de pacote aplicável na qual um recurso está disponível.
  • Para obter as notas gerais da versão do B2C Commerce, consulte a a Ajuda da Salesforce.

PWA Kit vitrines agora podem enviar eventos de engajamento para Data Cloud, fornecendo visibilidade aprimorada dos dados unificados e em tempo real dos clientes. Consulte Integrar PWA Kit com Data Cloud.

O gerenciamento de redirecionamentos na interface do usuário do Runtime Admin é mais eficiente com um novo formato baseado em tabela paginada, permitindo que você veja mais informações de redirecionamento antecipadamente. Consulte Redirecionamentos.

As falhas de implantação em ambientes agora fornecem informações mais detalhadas, dando mais clareza sobre as ações corretivas a serem tomadas. Consulte Solucionar problemas de erros de push de pacote.

ap-south-2 região (Hyderabad) agora é suportada para ambientes. Consulte a lista de regiões suportadas.

Vários bugs do Runtime Admin também foram resolvidos:

  • A adição de várias variáveis de ambiente em uma linha por meio do Runtime Admin é corrigida
  • A exclusão de cabeçalhos de controle de acesso via Runtime Admin foi corrigida
  • A decodificação do Storefront Preview para Base64URLs foi corrigida

Com o B2C Commerce versão 25.3, a autenticação híbrida (auth) substitui a SLAS de plug-ins. A autenticação híbrida melhora o desempenho e a estabilidade de lojas (virtuais) híbridas movendo o recurso diretamente para a plataforma do B2C Commerce. Consulte Configurar um Storefront híbrido com autenticação híbrida.

Agora você pode implantar os projetos do PWA Kit com o Node 22! Para atualizar a versão do seu Node.js, siga as instruções em Fazer upgrade da versão do Node.

A cada ano, as versões do Node.js deixam de receber suporte formal. Para garantir uma postura de segurança robusta e uma experiência fluida para desenvolvedores, restringimos a versão do Node nos projetos implantados no Managed Runtime. O Node 18 tem uma data de fim de vida útil de 1º de setembro de 2025.

É altamente recomendável que você faça upgrade de seus projetos de produção bem antes da data de fim de vida útil. Dependendo da versão do seu PWA Kit, você pode atualizar para o Node 20 ou 22.

Este recurso está geralmente disponível a partir da versão 6.0 do Retail React App. Melhore a experiência do comprador com um tempo de implementação reduzido. Com o logon social, os compradores pode fazer logon rapidamente no seu site e criar perfis usando suas contas de rede social. Consulte Implementar logon social.

Este recurso está geralmente disponível a partir da versão 6.0 do Retail React App. Melhore a experiência do comprador com um tempo de implementação reduzido. Com a redefinição de senha, se os compradores esquecerem a senha, poderão usar um código de verificação ou um link em um e-mail ou texto para reaver o acesso à sua conta criando uma nova senha. Consulte Implementar redefinição de senha.

Este recurso está geralmente disponível a partir da versão 6.0 do Retail React App. Melhore a experiência do comprador com um tempo de implementação reduzido. Com o logon sem senha, os compradores podem fazer logon com segurança no seu site usando um código de verificação ou um link em um e-mail ou texto em vez de uma senha. Consulte Implementar logon sem senha.

O banner de consentimento de rastreamento geralmente está disponível com a versão 6.0 ou posterior do Retail React App. Preserve a confiança dos compradores e reduza os custos de implementação. Com o banner de consentimento de rastreamento, seus compradores podem aceitar ou recusar o rastreio de atividades no seu site. Consulte a Política de Privacidade com um Banner de consentimento de rastreamento.

Aumente a estabilidade e o desempenho de lojas (virtuais) híbridas e garanta uma ótima experiência do comprador. Consulte Upgrade de estabilidade híbrida para a versão 3.8.0 do PWA Kit ou Upgrade de estabilidade híbrida para a versão 2.x do PWA Kit.

A personalização com contexto do comprador agora é pré-integrada à versão 5.0.0 ou posterior do Retal React App. Apoia as experiências de compra personalizadas e reduz os custos de implementação. Com o contexto do comprador, você pode usar recursos como promoções, precificação e recomendações de produtos personalizadas para aumentar a conversão e a fidelidade do comprador. Consulte Personalizar com contexto do comprador.

Tornando-se ainda mais global! Para otimizar o desempenho por meio da co-localização de instâncias de back-end em regiões do Hyperforce, agora você pode implantar seus ambientes Managed Runtime nestas regiões:

  • sa-east-1 - América do Sul (São Paulo)
  • eu-central-2 - UE (Zurique)
  • eu-south-1 - UE (Milão)
  • ap-southeast-3 - Ásia-Pacífico (Jacarta)
  • me-central-1 - Oriente Médio (Emirados Árabes Unidos)
  • il-central-1 - Israel (Tel Aviv)

Anteriormente, você podia ver logs no Log Center somente de ambientes de Production associados a instâncias do Primary Instance Group (PIG). Agora você pode ver logs do Secondary Instance Group (SIG) e instâncias de On-demand Sandbox (ODS). Esses novos logs contam para os limites de volume de log.

Esse recurso está geralmente disponível a partir da versão 3.7 do PWA Kit. Com o parâmetro de consulta __server_timing, você pode monitorar o desempenho do site do PWA Kit para apoiar seus esforços de otimização. O parâmetro fornece acesso ao cabeçalho HTTP Server-Timing e aos logs, que oferecem métricas sobre partes do processo de renderização no lado do servidor, como correspondência de rotas, carregamento de componentes e estratégias de busca. Os logs de métricas de desempenho também estão disponíveis no Log Center. Consulte _._server_timing

A versão 4.0 do Retail React App usa as novas versões do Commerce SDK React e do Commerce SDK Isomorphic. Esses SDKs agora atendem às orientações do Shopper Login and API Access (SLAS) para usar channel_id como um argumento na recuperação de tokens de acesso de visitante. Consulte Tokens de visitante.

O localizador de lojas geralmente está disponível com o Retail React App versão 4.0 ou posterior e com o Commerce SDK React versão 2.0.1 ou posterior. Com nosso localizador de lojas, seus compradores podem encontrar lojas (virtuais) próximas com base em seus códigos postais, cidades e outros. Insira facilmente mais informações sobre a sua loja no Business Manager para personalizar os metadados de localização exibidos no seu site. Consulte Boost In-Store Sales with Store Locator (Aumentar as vendas na loja com o localizador de lojas).

Os pacotes de produtos geralmente estão disponíveis com o Retail React App versão 4.0 ou posteriores e com o Commerce SDK React versão 2.0.1 ou posteriores. Use os pacotes de produtos para agrupar vários produtos relacionados em um único produto que pode ser pedido para conveniência e personalização do cliente. Os compradores podem atualizar as variações e quantidades do pacote diretamente em seus carrinhos. Por exemplo, uma loja online de artigos esportivos pode oferecer um ”Pacote do Corredor”, permitindo que os compradores selecionem o tamanho do calçado, o tamanho das roupas e o modelo de dispositivo fitness diretamente em seu carrinho. Pacotes de produtos podem ajudar você a reduzir o abandono do carrinho e a melhorar o gerenciamento do inventário. Consulte Pacotes de produtos.

Restrinja o acesso ao ambiente do Managed Runtime pelo tráfego proveniente da eCDN. Defina um cabeçalho de controle de acesso compartilhado na eCDN e no ambiente para garantir que compradores, bots e rastreadores não acessem seu ambiente diretamente.

Consulte Lançar seu Storefront/Loja (virtual) atualizada e a nova upsertOriginHeaderModification API para obter informações detalhadas sobre como configurar o Managed Runtime e a eCDN para bloquear seu ambiente.

Encontre rapidamente logs gerados pelo seu site do PWA Kit pesquisando namespaces adicionados como prefixos a logs no Log Center. O namespace indica a parte específica da base de códigos na qual o erro ocorreu, ajudando você a focar os esforços na solução de problemas. Consulte Depurar usando o Log Center.

Restrinja o acesso ao ambiente do Managed Runtime pelo tráfego proveniente da rede de distribuição de conteúdo (CDN) de terceiros. Defina um cabeçalho de controle de acesso compartilhado em sua CDN e ambiente para garantir que compradores, bots e rastreadores não acessem seu ambiente diretamente.

Consulte Cabeçalhos de controle de acesso e a projects_target_access_control_header_create API para saber como você pode bloquear seu ambiente.

Impulsione a conversão e o engajamento do comprador e reduza os custos de implementação com nossos mosaicos de produtos bastante aprimorados que estão disponíveis no PWA Kit Retail React App. Os mosaicos de produtos agora apresentam:

  • Textos explicativos promocionais
  • Precificação riscada
  • Amostras de mosaico de produto para seleção de variantes
  • Selos de produtos
  • Uso da productSearch API com expansões, que oferece melhor desempenho em relação à combinação da productSearch API e da getProduct(s) API.

Crie facilmente um mapa do site no Business Manager (BM) para sua loja (virtual) headless ou PWA Kit construída no B2C Commerce. Mapas do site fornecem aos rastreadores de pesquisa instruções sobre as páginas a serem indexadas e a hierarquia do site, e ainda ajudam a melhorar a classificação de SEO. Consulte Melhorar o SEO com um mapa do site.

PWA Kit agora oferece suporte à coleta de métricas de pedidos do Active Data. Use essa coleta para entender o comportamento do cliente e otimizar sua estratégia de segmentação e merchandising. Consulte Active Data.

Use o Runtime Admin para gerenciar variáveis de ambiente. Esse recurso está disponível como uma alternativa ao gerenciamento de variáveis de ambiente usando a Managed Runtime API. As variáveis de ambiente permitem a você adicionar variáveis no processo do aplicativo executado em um ambiente sem precisar fazer mudanças no código. Consulte Variáveis de ambiente.

Esse recurso agora está disponível para todos.

Solucione problemas de erros em seu site criado com o PWA Kit usando o Log Center:

  • Pesquise e filtre vários logs. Verifique os logs históricos.
  • Acesse uma única interface de usuário para visualizar os logs do Managed Runtime (MRT) e da sua instância do B2C Commerce. Conecte o que está acontecendo em seu ambiente MRT com o que está acontecendo em sua instância do B2C Commerce.
  • Veja facilmente os logs MRT sem usar uma CLI.

Consulte Depurar usando o Log Center.

Esse recurso está geralmente disponível a partir da versão 3.5 do PWA Kit. Verifique a página de lançamentos no GitHub para obter a versão mais recente disponível do PWA Kit.

Habilite um cliente privado Shopper Login and API Access Service (SLAS) em seu site do Kit PWA para que você possa oferecer suporte a esses recursos com tempo de implementação reduzido:

  • Logon sem senha
  • Redefinição de senha
  • Tempos de carregamento de página mais rápidos

Consulte Usar um um cliente privado SLAS.

Reduza o tempo de carregamento da página após reimplantar seus pacotes. Esses aprimoramentos da rede de distribuição de conteúdo (CDN) melhoram o desempenho do aplicativo:

  • HTTP/3 — Usamos automaticamente o protocolo HTTP/3 para todos os navegadores e clientes compatíveis. O HTTP/3 melhora o desempenho, especialmente para os compradores que usam dispositivos com restrições de rede, como os móveis.
  • Cache da CDN entre regiões — Usamos automaticamente respostas em cache entre regiões para melhorar a taxa de acerto do cache e o desempenho de sites com um público global.
  • Mais regiões de CDN — Adicionamos mais regiões à CDN, resultando em tempos de resposta mais rápidos e saltos de rede mais curtos se for usada uma configuração de CDN empilhada.

Use o Runtime Admin para habilitar os cookies do lado do servidor. Esse recurso está disponível como uma alternativa à habilitação de cookies do lado do servidor usando a opção Managed Runtime API. O uso de cookies do lado do servidor ajuda a aumentar a privacidade e a segurança e oferece suporte à personalização e ao marketing mais adaptado. Consulte Personalizar com cookies.

Use o Runtime Admin para ativar os mapas de origem. Esse recurso está disponível como uma alternativa à habilitação de mapas de origem usando a Managed Runtime API. Os mapas de origem são projetados para melhorar muito a experiência de desenvolvimento e depuração, enquanto aprimora a legibilidade da pilha de erros. Consulte Depurar usando mapas de origem.

Use um sistema de gerenciamento de conteúdo (CMS) de terceiros com o Storefront Preview. Por exemplo, se você tiver um banner de promoção de feriado gerenciado pelo seu CMS, use a Visualização do Storefront para ver como o banner aparecerá no site durante o período especificado. Consulte Visualização do Storefront.

Visualize a aparência do seu site do Progressive Web App (PWA) Kit com base em um ou mais IDs de grupos de clientes. Por exemplo, visualize seu site como ele apareceria para os compradores que recebem um desconto de funcionário. Consulte Visualização de seu Storefront

Os projetos agora podem ser implementados com o Nó 20! Os projetos do PWA Kit precisarão atualizar para a versão 3.4.x mais recente e seguir as instruções em Atualizar a versão do nó.

Os clientes no Japão agora podem executar seu ambiente na região de Osaka, além da região de Tóquio já existente. Sua região pode ser alterada nas Configurações de ambiente.

Os mapas de origem agora estão disponíveis no Managed Runtime. Este recurso foi projetado para melhorar muito a experiência de desenvolvimento e depuração, enquanto aprimora a legibilidade da pilha de erros. Os mapas de origem podem ser gerados no PWA Kit 3.4.x e podem ser habilitados alternando a configuração de ambiente enable_source_maps. Consulte Depurar usando mapas de origem.

Use o Active Data em seu site do PWA Kit para observar as métricas de desempenho do produto e definir regras automatizadas de comercialização. Consulte Active Data.

Use o recurso Storefront Preview para ver como o site do PWA Kit ficará em diferentes contextos, como código-fonte especificado, grupos de clientes ou uma data ou hora específica. Por exemplo, visualize as alterações do seu site em um ambiente de preparação (staging) antes de implementá-las na produção. Consulte Visualização do Storefront.

Ao criar um ambiente no Runtime Admin, agora você pode selecionar uma instância do Commerce Cloud e sites para se conectar ao ambiente. Isso permite uma integração mais profunda entre seus ambientes Managed Runtime e a plataforma Commerce Cloud. Você também pode usar os novos endpoints da Managed Runtime API para gerenciar e rastrear as conexões de seus ambientes com as instâncias do Commerce Cloud. Para obter mais informações, consulte esta documentação:

Para notas de versão publicadas antes de outubro de 2023, consulte: