Solução de problemas do conteúdo do Checkout Blocks
O conteúdo do Checkout Blocks pode não ser exibido como esperado por vários motivos, resultando no desaparecimento ou no mau funcionamento de elementos. Os problemas comuns incluem o não cumprimento das regras de exibição, configurações incorretas de permissão ou discrepâncias entre as configurações no próprio bloco e a forma como o bloco foi adicionado ao editor de checkout e contas.
Este guia ajuda a solucionar e resolver problemas comuns do Checkout Blocks por conta própria. Se os problemas persistirem após a análise dos passos deste guia, entre em contato com o Atendimento ao cliente da Shopify para receber ajuda.
Nesta página
- Solução de problemas de blocos
- Solução de problemas de erros ao criar ou salvar blocos
- Solução de problemas de descontos personalizados
- Solução de problemas de personalizações de entrega e de formas de pagamento
- Validação de alterações com um checkout de teste
- Perguntas frequentes
- Antes de entrar em contato com o Atendimento ao cliente da Shopify sobre o Checkout Blocks
Solução de problemas de blocos
Os blocos são os elementos de personalização que exibem conteúdo no checkout, como campos personalizados, conteúdo dinâmico e banners. Se um bloco não estiver funcionando como esperado, use as seções a seguir para identificar e resolver o problema.
O bloco não está sendo exibido no checkout
Solução de problemas: bloco não adicionado ao editor
Criar um bloco no app Checkout Blocks não o adiciona automaticamente ao checkout. É preciso adicionar o bloco à configuração de checkout usando o editor de checkout e de contas.
Etapas:
- No admin da Shopify, acesse Configurações > Checkout.
Solução de problemas: o status do bloco não está definido como Ativo
Um bloco precisa ter o status Ativo para ser exibido no checkout. Blocos no estado de rascunho não são exibidos para os clientes.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas: bloco não publicado no mercado ou na página
Se o bloco estiver configurado com configurações de publicação específicas do mercado, ele será exibido apenas nos mercados selecionados. Se o bloco for publicado apenas em páginas de checkout específicas, ele não será exibido em outras páginas.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas: regras de exibição não estão sendo cumpridas
As Regras de exibição definem as condições que precisam ser atendidas para que um bloco seja exibido no checkout. Se essas condições não forem atendidas durante a sessão de checkout de um cliente, o bloco não será exibido.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas: incompatibilidade de ID do bloco
Cada tipo de bloco no editor de checkout e contas tem uma configuração de ID do bloco. O ID do bloco no editor deve corresponder ao ID do bloco criado no app Checkout Blocks. Se os IDs não corresponderem, o bloco não será exibido.
Por exemplo, se o bloco tiver um ID de bloco 4 no app Checkout Blocks, o bloco no editor de checkout e contas também precisará ter o ID do bloco definido como 4.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas: o campo de ID do bloco de pré-visualização contém um valor
O campo ID do bloco de pré-visualização (para fins de teste) no editor de checkout e contas destina-se apenas a testes. Se esse campo contiver um valor depois de salvar o checkout, ele poderá substituir as regras de exibição do bloco e causar um comportamento inesperado.
Etapas:
- No admin da Shopify, acesse Configurações > Checkout.
Solução de problemas: bloco de maior prioridade sendo exibido
Se houver vários blocos do mesmo tipo com regras de exibição sobrepostas, apenas o bloco de maior prioridade será exibido. Saiba mais sobre a prioridade de blocos.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas de limite de blocos ativos atingido
O Checkout Blocks é compatível com até 30 blocos ativos por tipo de bloco. Se você tiver mais de 30 blocos ativos de um único tipo, como 35 blocos de campo personalizado ativos, apenas os 30 primeiros blocos poderão ser exibidos no checkout.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
O bloco é exibido várias vezes no checkout
Solução de problemas de bloco adicionado à seção compartilhada
Dependendo de onde você adiciona um bloco no editor de checkout e de contas, ele pode ser exibido em todas as etapas do checkout. A seção Resumo do pedido e a área anexada ao botão Continuar ou voltar são consistentes em todas as páginas do checkout.
Para exibir um bloco apenas em uma etapa específica, adicione-o à área de conteúdo principal dessa etapa.
Etapas:
- No admin da Shopify, acesse Configurações > Checkout.
Solução de problemas de várias instâncias de bloco adicionadas
Alguns tipos de bloco, como os blocos Line item edit, normalmente só precisam ser adicionados ao checkout uma vez. O bloco depende de regras de exibição para mostrar conteúdo diferente em cenários distintos. Se o conteúdo do bloco estiver duplicado, talvez você o tenha adicionado acidentalmente mais vezes do que o necessário.
Etapas:
- No admin da Shopify, acesse Configurações > Checkout.
Solução de problemas de erros ao criar ou salvar blocos
Se você receber um erro ao tentar criar ou salvar um bloco, consulte as seções a seguir.
Solução de problemas do erro "Houve alguns problemas com o envio do formulário"
Normalmente, esse erro indica que a conta de membro da equipe não tem as permissões necessárias para criar blocos no Checkout Blocks.
Permissões necessárias:
- Permissões da loja > Conteúdo: os membros da equipe precisam ter permissão para Visualizar e Criar e editar definições de metaobjeto, bem como para Visualizar e Criar e editar entradas.
- Permissões da loja > Configurações da loja: os membros da equipe precisam ter a permissão Gerenciar configurações.
- Permissões de app: os membros da equipe precisam ter pelo menos permissões para o Checkout Blocks.
Etapas:
- No admin da Shopify, acesse Configurações > Usuários e permissões.
- Clique na conta de membro da equipe que está apresentando o erro.
- Em Permissões da loja, expanda a seção Conteúdo.
- Confirme se as permissões Visualizar e Criar e editar estão selecionadas para Definições de metaobjeto.
- Confirme se as permissões Visualizar e Criar e editar estão selecionadas para Entradas.
- Em Configurações da loja, confirme se a permissão Gerenciar configurações está selecionada.
- Em Permissões de app, confirme se Checkout Blocks está selecionado.
- Clique em Salvar.
Se você não tiver permissão para modificar as permissões de membros da equipe, entre em contato com o titular da loja ou com um membro da equipe com permissões de gerenciamento de usuários.
Solução de problemas de descontos personalizados
Os descontos personalizados criados no Checkout Blocks podem não ser aplicados como esperado por vários motivos.
Solução de problemas de limite de descontos automáticos ativos atingido
A Shopify permite no máximo 25 descontos automáticos ativos por vez, incluindo os descontos de apps instalados. Esse limite se aplica a toda a loja, e não apenas ao Checkout Blocks.
Se você tentar ativar o 26º desconto automático, ele não será aplicado no checkout.
Etapas:
- No admin da Shopify, acesse Descontos.
- Filtre para exibir apenas os descontos automáticos.
- Conte quantos descontos automáticos estão ativos no momento.
- Se houver 25 ou mais descontos automáticos ativos, desative ou exclua os descontos que não são mais necessários antes de ativar novos.
Saiba mais sobre as limitações ao combinar descontos.
Solução de problemas de desconto inativo
Para que um desconto personalizado seja aplicado no checkout, ele precisa estar definido como Ativo. Além disso, o desconto não pode ter expirado com base nas datas de início e término configuradas.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas de regras de desconto não cumpridas
Os descontos personalizados no Checkout Blocks podem ter regras condicionais detalhadas que determinam quando o desconto é aplicado. Se essas condições não forem cumpridas durante a sessão de checkout de um cliente, o desconto não será aplicado.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas de personalizações de forma de entrega e de pagamento
Se as formas de entrega ou de pagamento não forem ocultadas, renomeadas ou reordenadas como esperado, confira as seções a seguir.
Solução de problemas de personalização inativa
Uma personalização de forma de entrega ou de pagamento precisa estar definida como Ativa para ser aplicada no checkout.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas de limite de functions ativas atingido
O Shopify Functions tem limites para o número de funções ativas que você pode ter por tipo. É possível ativar no máximo 25 funções de personalização de pagamento em cada loja. Se esse limite for ultrapassado, talvez você receba o seguinte erro: Failed to enable customization. Please try again or contact support.
Esses limites ajudam a garantir que o checkout mantenha um alto desempenho. É preciso mesclar ou remover personalizações para não ultrapassar o limite.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Solução de problemas de regras de personalização não atendidas
As personalizações de forma de entrega e de pagamento dependem de regras que determinam quando a personalização é aplicada. Se essas condições não forem atendidas durante a sessão de checkout de um cliente, a personalização não terá efeito.
Etapas:
- No admin da Shopify, acesse Apps > Checkout Blocks.
Validação das alterações com um checkout de teste
Antes de usar as personalizações do Checkout Blocks em um ambiente ativo, valide se elas funcionam como esperado usando um checkout de teste.
Etapas:
- Na loja virtual, adicione produtos ao carrinho que correspondam às condições dos blocos, descontos ou personalizações que você quer testar.
- Vá para o checkout, mas não conclua a compra.
- Analise cada etapa do checkout e verifique o seguinte:
- Os blocos são exibidos nos locais corretos com o conteúdo correto.
- Os descontos personalizados são aplicados quando os requisitos de qualificação são atendidos.
- As personalizações de forma de entrega e de pagamento funcionam como esperado.
- Se estiver testando regras de exibição com base no total do carrinho, tente usar valores diferentes no carrinho para confirmar se os blocos aparecem e desaparecem nos limites corretos.
- Se estiver testando regras de exibição baseadas no cliente, teste os cenários de checkout com login e como convidado.
Perguntas frequentes
Quantos blocos posso ter ativos ao mesmo tempo?
Você pode ter até 30 blocos ativos por tipo de bloco. Por exemplo, pode ter 30 campos personalizados ativos, 30 blocos de conteúdo dinâmico ativos e 30 blocos de edição de item de linha ativos simultaneamente. É possível criar mais de 30 blocos de um tipo, mas apenas os primeiros 30 blocos ativos podem ser exibidos no checkout.
Por que preciso ter permissões de membro da equipe específicas para usar o Checkout Blocks?
O Checkout Blocks cria definições de metaobjeto para armazenar as configurações do bloco. Os membros da equipe precisam de permissões para criar e editar definições e entradas de metaobjeto para salvar blocos no app. Além disso, os membros da equipe precisam das permissões Gerenciar configurações em Configurações da loja e de Permissões do app explícitas para o Checkout Blocks.
Posso usar o Checkout Blocks se eu não tiver o plano Shopify Plus?
Os lojistas do plano Basic ou superior podem usar os blocos de conteúdo dinâmico e conteúdo estático apenas nas páginas de agradecimento e de status do pedido. Todos os outros recursos do Checkout Blocks, incluindo campos personalizados, descontos personalizados e personalizações de entrega/forma de pagamento, exigem o plano Shopify Plus.
Como sei qual ID de bloco usar?
Ao criar um bloco no app Checkout Blocks, ele recebe um ID de bloco (o padrão é 0). Ao adicionar esse tipo de bloco ao checkout no editor, é preciso definir o mesmo ID de bloco para que o editor saiba qual bloco específico exibir. Se quiser exibir blocos diferentes do mesmo tipo em locais diferentes, atribua a cada bloco um ID exclusivo e combine esses IDs no editor. Saiba mais sobre os IDs de bloco.
Posso combinar descontos do Checkout Blocks com outros descontos?
Os descontos personalizados criados no Checkout Blocks são descontos automáticos viabilizados pelo Shopify Functions. Eles seguem as mesmas regras de combinação de descontos de outros descontos automáticos. É possível ter no máximo 25 descontos automáticos ativos na loja, incluindo os criados no Checkout Blocks e em outros apps.
Antes de entrar em contato com o Atendimento ao cliente da Shopify sobre o Checkout Blocks
Se você tentou seguir as etapas de solução de problemas acima e o problema com o Checkout Blocks persiste, entre em contato com o Atendimento ao cliente da Shopify para receber ajuda. Antes de entrar em contato com o Atendimento ao cliente da Shopify, reúna as seguintes informações específicas do Checkout Blocks para agilizar a resolução do problema:
- Detalhes do bloco: o nome, o tipo (como campo personalizado, conteúdo dinâmico ou edição de item de linha) e o ID do bloco que não está funcionando
- Capturas de tela da configuração: capturas de tela das configurações do bloco no app Checkout Blocks, incluindo regras de exibição, configurações de publicação e status
- Capturas de tela do editor: capturas de tela de como o bloco está configurado no editor do checkout e de contas, incluindo os campos de ID do bloco e de ID de pré-visualização do bloco
- Mensagens de erro: capturas de tela ou o texto exato de quaisquer mensagens de erro recebidas ao criar, salvar ou pré-visualizar blocos
- URL do checkout de teste: um link para um checkout de teste ou um checkout abandonado em que o problema possa ser reproduzido, juntamente com o conteúdo do carrinho usado para acionar as regras de exibição
- Comportamento esperado versus comportamento real: uma descrição clara do que você esperava que acontecesse em comparação com o que está realmente acontecendo no checkout
- Etapas de solução de problemas concluídas: quais seções deste guia você já analisou e o que tentou fazer
- Permissões da equipe: confirmação de que a conta tem as permissões necessárias para Conteúdo (definições e entradas de metaobjeto), configurações da loja (Gerenciar configurações) e permissões de apps (Checkout Blocks)
Ter essas informações específicas do Checkout Blocks em mãos ajuda o Atendimento ao cliente da Shopify a diagnosticar e resolver o problema com mais eficiência.