Skip to main content

​
Visão geral

Este guia ajuda você a solucionar situações em que o Upcart não abre ou os clientes são redirecionados para a página do carrinho em vez de ver o drawer do Upcart. A maioria desses problemas é causada pelas configurações de tipo de carrinho do tema, pela configuração de Enhanced AJAX API Compatibility, por redirecionamentos de apps de terceiros ou pelo roteamento do botão de checkout.
Se o Upcart não estiver abrindo de jeito nenhum ou estiver redirecionando para a página do carrinho, veja Solução de problemas: Upcart não abre ou redireciona para a página do carrinho para um guia de solução de problemas mais completo.

​
Qual tipo de carrinho escolher

Antes de mergulhar na solução de problemas, verifique primeiro a configuração de tipo de carrinho do seu tema, pois essa é a causa mais comum.
  • Page - Geralmente é a melhor opção, já que o Upcart intercepta as requisições para a página /cart.
  • Drawer - Selecione esta opção se o Upcart não abrir e a página /cart estiver sendo acionada no lugar.
  • Confirmation Popup - Use esta opção se o seu tema a suportar e as demais opções não resolverem o problema.
Testar as duas opções leva apenas alguns minutos, mas Page costuma ser a escolha mais eficaz.

​
Como alterar o tipo de carrinho no seu tema

  1. Vá em Online Store > Themes > Customize no seu admin da Shopify.
  2. Abra Theme Settings > Cart > Cart Type.
  3. Escolha Page ou Drawer com base no comportamento que você está investigando.
  4. Salve as alterações e teste o carrinho na sua vitrine.
Configurações de carrinho do editor de tema da Shopify mostrando a opção de tipo de carrinho
Se você não conseguir localizar essa configuração, entre em contato com o desenvolvedor do seu tema. Essa configuração é controlada pelo seu tema e o Upcart não pode modificá-la diretamente.

​
Etapas de solução de problemas

Se alterar o tipo de carrinho não resolver o problema, siga as etapas abaixo em ordem.

​
1. Verifique a Enhanced AJAX API Compatibility

Essa configuração controla como o Upcart lida com os eventos de Add to Cart e é uma das causas mais comuns de problemas de redirecionamento.
  1. Vá em Upcart > Cart Editor > Settings > Cart settings e expanda Advanced Settings.
  2. Localize Enhanced Ajax API compatibility.
  3. Essa configuração vem desativada por padrão para a maioria das lojas. Quando desativada, o Upcart intercepta as chamadas de Add to Cart e impede redirecionamentos.
  4. Se ela estiver ativada, outros apps podem assumir o controle do comportamento do carrinho e redirecionar os clientes para a página do carrinho. Tente desativá-la e teste.
  5. Se desativá-la causar outros problemas, reative-a e use a API manual do Upcart (upcartRegisterAddToCart) no lugar.
Para orientações completas sobre essa configuração, veja Enhanced AJAX API Compatibility.

​
2. Verifique redirecionamentos de apps de terceiros

Muitos apps de terceiros sobrescrevem o comportamento do carrinho e podem redirecionar os clientes para fora do drawer do Upcart. Se o seu botão de Add to Cart está especificamente enviando os clientes para a página do carrinho, veja Por que o ‘Add to Cart’ vai para a página do carrinho em vez do Upcart? para mais detalhes. Abra as configurações de todos os apps relacionados ao carrinho e procure opções como:
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
Altere-as para Stay on page ou Do nothing. Correções comuns específicas por app:
  • PageFly - Desative as regras de redirecionamento nas configurações do app PageFly.
  • Globo Product Options - Desative o redirecionamento automático para o carrinho da Shopify.
  • Replo - Ajuste as configurações de “go to page” para ativar o cart drawer.
  • Zepto Product Personalizer - Vá em Zepto > Settings > Add to Cart Settings e altere “Action after a product is added to the cart” para “Stay on the product page and show a success message.”
Se você não tem certeza de qual app está causando o conflito, desative os apps relacionados ao carrinho um de cada vez e teste após cada um até o Upcart começar a funcionar corretamente.

​
3. Verifique o roteamento do botão de checkout

Se os clientes clicam no botão de checkout dentro do Upcart e são redirecionados para a página do carrinho em vez do checkout:
  1. Vá em Upcart > Cart Editor > Settings > Cart settings.
  2. Localize “Go to cart page when pressing checkout button”.
  3. Desative essa opção.
  4. Salve e teste.
O redirecionamento para uma página de checkout personalizada requer programação avançada e não é diretamente suportado pelo Upcart. Se você precisa direcionar os clientes para uma página de checkout personalizada, será necessário trabalhar com um desenvolvedor.

​
4. Verifique as configurações de redirecionamento de carrinho do tema

Alguns temas redirecionam os clientes automaticamente após adicionar um produto, ignorando o Upcart por completo.
  1. Vá em Online Store > Themes > Customize.
  2. Abra Theme Settings > Products (ou Cart).
  3. Procure configurações como:
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. Desative essas opções.
  5. Salve e teste.

​
5. Limpe o cache do navegador

Scripts antigos em cache podem manter o comportamento anterior do carrinho e impedir que o Upcart carregue corretamente.
  1. Abra as configurações do seu navegador.
  2. Vá em Privacidade e segurança.
  3. Selecione Limpar dados de navegação.
  4. Limpe imagens e arquivos em cache e cookies.
  5. Recarregue sua loja e teste.

​
6. Teste com um tema padrão da Shopify

Se o problema persistir, mude temporariamente para um tema padrão da Shopify, como o Dawn, para descartar um conflito específico do tema.
  1. Vá em Shopify Admin > Online Store > Themes.
  2. Adicione e ative um tema gratuito como o Dawn.
  3. Teste o Upcart no tema padrão.
Se o Upcart funcionar corretamente no Dawn, o problema está no seu tema personalizado. Entre em contato com o desenvolvedor do seu tema para obter ajuda.

​
Medidas preventivas

  • Revise as configurações após atualizações - Atualizações de temas e apps podem redefinir ou sobrescrever as configurações do carrinho. Verifique o tipo de carrinho e as configurações dos apps após qualquer atualização importante.
  • Teste a compatibilidade dos apps antes de instalar - Antes de adicionar novos apps de terceiros, confirme que eles são compatíveis com o Upcart.
  • Use um tema em rascunho para testar - Teste as alterações em um tema em rascunho antes de publicar, para evitar interromper sua loja ativa. Veja Ativando o Upcart apenas em um tema em rascunho para instruções.

​
Perguntas frequentes

Não, o redirecionamento para uma página de checkout personalizada requer programação avançada e não é diretamente suportado pelo Upcart. Se você precisar disso, terá que trabalhar com um desenvolvedor.
Certifique-se de que o Upcart está ativo e publicado no Cart Editor. Limpe também o cache do seu navegador para garantir que o comportamento atualizado entre em vigor. Se o problema persistir, verifique conflitos com apps de terceiros usando as etapas acima.
Abra as configurações do app de complemento e procure configurações de redirecionamento automático ou de “go to cart”. Desative-as se elas conflitarem com o Upcart. Veja a Etapa 2 acima para exemplos específicos por app.
Precisa de ajuda? Se você seguiu todas as etapas acima e o problema persistir, entre em contato com nossa equipe de suporte pelo chat no app ou enviando um e-mail para support@upcart.app.