Skip to main content
Os upsells de checkout podem deixar de ser exibidos por vários motivos diferentes. Siga as etapas abaixo em ordem para identificar a causa.
Os upsells de checkout estão disponíveis apenas para lojistas Shopify Plus, porque a API Checkout Extensibility da Shopify é exclusiva do Plus. Se você não está no Shopify Plus, os upsells de checkout não aparecerão, independentemente da sua configuração. Consulte Por que não consigo ver a aba de checkout?
Se um upsell não for exibido, a experiência de checkout do cliente não é afetada — nada quebra do lado do cliente.

​
Por onde começar

A maioria dos problemas de exibição se resume a uma de quatro coisas: o widget não está ativado, o bloco de app não foi adicionado/salvo na Shopify, o placement não corresponde ou as condições de gatilho não são atendidas. Confirme o básico primeiro:
  • Você está em um plano Shopify Plus
  • O widget está ativado no editor de Checkout da Aftersell (o botão Enable no canto superior direito das configurações do widget está ligado)
  • O bloco de app foi adicionado e salvo no Editor de Checkout da Shopify
  • O placement selecionado na Shopify corresponde ao placement definido na Aftersell
Se tudo isso estiver correto e o upsell ainda não aparecer, analise as causas detalhadas abaixo.

​
O widget não está ativado ou não foi adicionado ao checkout

Para que um upsell de checkout seja exibido, duas coisas devem ser verdadeiras ao mesmo tempo:
  1. O widget deve estar ativado no editor de Checkout da Aftersell
  2. O bloco de app deve estar adicionado e salvo no Editor de Checkout da Shopify
Se qualquer um deles estiver faltando, o widget não aparecerá. Para ativar o widget na Aftersell:
  1. Vá em Apps → Aftersell → Checkout
  2. Abra o widget de upsell que você deseja exibir
  3. Confirme que o widget está ligado — o cabeçalho mostra um botão de alternância ao lado de um selo Active / Inactive. (No editor de Checkout mais antigo, isso é um par de botões Enable / Disable no cabeçalho do cartão do widget.)
Para adicionar o bloco de app na Shopify:
  1. Vá em Settings → Checkout no seu admin da Shopify
  2. Clique em Customize ao lado do seu perfil de checkout
  3. Clique em Add app block e selecione o widget de upsell da Aftersell
  4. Posicione-o onde você quer que ele apareça
  5. Clique em Save — as alterações não são aplicadas até serem salvas

​
Divergência de placement entre a Aftersell e a Shopify

Uma divergência de placement é um dos motivos mais comuns para um upsell de checkout não ser exibido. A Aftersell suporta vários placements para que você possa executar mais de um widget do mesmo tipo na mesma página de checkout. Cada placement corresponde a um bloco de app separado no Editor de Checkout da Shopify, e o placement selecionado na Shopify deve corresponder ao configurado na Aftersell. O menu suspenso Placement do bloco de app Upsell Widget oferece oito valores: Default placement (Upsell Widget 1), Additional placement 1 (Upsell Widget 2), Additional placement 2 (Upsell Widget 3) e cinco espaços de widget de página de page-upsell-001 a page-upsell-005. Se os placements não corresponderem, o widget não aparecerá ou poderá ser exibido no local errado. Para corrigir uma divergência de placement:
  1. No editor de Checkout da Aftersell, abra o widget de upsell e anote qual placement está selecionado (por exemplo, Additional placement 1)
  2. No Editor de Checkout da Shopify, remova o bloco de app existente desse widget
  3. Clique em Add app block, selecione o widget de upsell da Aftersell e escolha o mesmo placement configurado na Aftersell
  4. Salve suas alterações
Saiba mais sobre a correspondência de placements →

​
As condições de gatilho não estão sendo atendidas

Se o seu widget de upsell tem gatilhos configurados, ele só será exibido quando essas condições forem atendidas pelo carrinho. Se o carrinho não satisfizer as condições de gatilho, o widget não aparecerá — esse é o comportamento esperado. Os tipos de gatilho disponíveis incluem:
  • Produtos / coleções específicos: um produto, variante ou coleção escolhida está (ou não está) no carrinho
  • Quantidade de um produto específico: por exemplo, 2 ou mais de um produto
  • Tag de produto / tipo de produto / nome da variante: qualquer item do carrinho corresponde a uma tag, tipo de produto ou título de variante da Shopify (sem diferenciar maiúsculas e minúsculas)
  • Metafield de produto / metafield de variante: um produto ou variante do carrinho tem um valor de metafield correspondente
  • Subtotal do carrinho: o subtotal atinge um limite (veja a nota abaixo sobre como o subtotal é calculado)
  • Quantidade do carrinho: número total de itens no carrinho
  • Assinatura no carrinho: se algum item do carrinho é uma assinatura
  • Atributo do carrinho: uma chave/valor de atributo no nível do carrinho corresponde (útil para dados definidos por outros apps)
  • Desconto aplicado / valor do desconto: um código de desconto específico está aplicado, ou o desconto total atinge um limite
  • País de entrega: o país de entrega do cliente (e opcionalmente a província) corresponde
  • Idioma do cliente: o idioma do checkout corresponde (por exemplo, exibir conteúdo em francês apenas para checkouts em francês)
  • Tags de cliente: o cliente conectado tem as tags necessárias
  • Tipo de dispositivo: o cliente está no dispositivo configurado (desktop ou mobile)
O subtotal do carrinho usado na avaliação dos gatilhos exclui quaisquer itens de linha já adicionados por upsells aceitos (aqueles marcados com o atributo de carrinho __as_offer_id). Portanto, aceitar um upsell não fará, por si só, o subtotal ultrapassar um limite que condiciona outro widget.
Combinando condições: quando um widget tem várias condições, elas são unidas com AND ou OR (à sua escolha), e as condições podem ser aninhadas em grupos para lógicas mais complexas. Com uma junção AND, todas as condições devem ser atendidas — uma única condição não correspondida bloqueia silenciosamente o widget. Com uma junção OR, basta uma correspondência. Revise cada condição individualmente em relação ao seu carrinho de teste. Para solucionar problemas de gatilhos:
  1. Abra o widget no editor de Checkout da Aftersell e revise suas condições de gatilho
  2. Defina temporariamente o gatilho como Show for all customers para confirmar que o widget em si está funcionando e, em seguida, reative seus gatilhos específicos
  3. Certifique-se de que pelo menos um widget usa um gatilho Show for all customers com a prioridade mais baixa, como um coringa, para que sempre haja alguma oferta exibida mesmo quando nenhum widget direcionado corresponder
Saiba mais sobre gatilhos de checkout →

​
Há um problema com o produto ou com a oferta

Mesmo quando o widget está ativado, corretamente posicionado e seus gatilhos correspondem, a própria oferta pode ser filtrada antes de ser exibida.
Se o estoque do produto é rastreado e nenhuma variante está disponível para venda, a oferta não será exibida. Garanta que pelo menos uma variante do produto de upsell tenha estoque disponível, ou use um produto que não rastreie estoque.
O produto de upsell deve ser um produto ativo e vendável. Produtos com status Draft ou Archived na Shopify são filtrados e não aparecerão como ofertas. Abra o produto no admin da Shopify e confirme que seu status é Active.
A configuração Hide offer if product already in cart oculta a oferta quando esse produto já está no carrinho do cliente. Ela vem ativada por padrão para ofertas de produto padrão. Se você quiser que o upsell apareça mesmo assim, desative essa configuração na configuração da oferta.
Se Subscription purchase option está definida como Subscription, mas o produto não tem planos de venda configurados na Shopify, a oferta é filtrada. Confirme que o produto tem pelo menos um plano de venda ativo, ou altere Subscription purchase option para One-time product (as outras opções são Subscription e Subscription and a one-time product).
Se a oferta está configurada como um upsell de substituição, ela só é exibida quando o produto que ela deve substituir está presente no carrinho. Confirme que o produto-alvo correto está selecionado na configuração do upsell de substituição.Uma oferta de substituição também é pulada quando a linha-alvo já tem um desconto aplicado — a menos que você marque Allow replacement if product has discount applied — ou quando a quantidade da linha-alvo é maior que um, a menos que você marque Allow replacement if product quantity greater than 1.
Se Max number of accepted offers está definido no widget, o upsell deixa de ser exibido quando o cliente aceita esse número de ofertas do widget no checkout atual. Isso é intencional — quando o limite é atingido, o widget se oculta. O campo se aplica apenas a upsells Single product e Multi product; upsells Checkmark não têm esse limite.
Para upsells single e multi-product, quando o cliente adiciona o produto da oferta ao carrinho, a oferta é ocultada (o produto já está no carrinho). Upsells Checkmark se comportam de forma diferente — eles permanecem visíveis com a caixa de seleção marcada depois de aceitos.

​
Widgets do Shop Pay não aparecem

Os widgets de checkout não são exibidos no Shop Pay por padrão. Para exibir seu upsell no Shop Pay, você precisa ativá-lo explicitamente:
  1. Abra o bloco de app de upsell da Aftersell no Editor de Checkout da Shopify
  2. Nas configurações do bloco, encontre a seção Checkout behaviour
  3. Marque a opção Include app block in Shop Pay
  4. Salve suas alterações
Saiba mais sobre widgets no Shop Pay →

​
Testando na pré-visualização da Shopify

A pré-visualização do Editor de Checkout da Shopify não renderiza widgets de forma confiável. Um widget pode estar configurado corretamente e mesmo assim não aparecer na pré-visualização do editor, porque a pré-visualização não consegue simular a marcação da página e as condições de gatilho. Não confie na pré-visualização do editor para confirmar se um widget está funcionando. Para testar seu upsell com precisão:
  1. Defina temporariamente o gatilho do widget como Show for all customers
  2. Faça um pedido de teste real usando o gateway de pagamento de teste da Shopify (ou um código de desconto que torne o pedido gratuito)
  3. Confirme que o widget aparece durante o fluxo real de checkout
  4. Restaure seus gatilhos após o teste

​
Nada acima se aplica

Se você já verificou tudo acima e o upsell ainda não está sendo exibido, confirme o seguinte:
  • O widget está ativado na Aftersell e o bloco de app está adicionado e salvo no Editor de Checkout da Shopify
  • O placement na Aftersell corresponde ao placement selecionado na Shopify
  • As condições de gatilho correspondem ao seu carrinho de teste — lembre-se de que, com uma junção AND, todas as condições devem ser atendidas
  • Existe pelo menos um widget com um gatilho Show for all customers na prioridade mais baixa, como um coringa
  • O produto de upsell está Active, em estoque e (para ofertas de assinatura) tem planos de venda ativos
  • Você está testando com um fluxo real de checkout, não com a pré-visualização do editor da Shopify
  • Tente limpar o cache do navegador ou testar em uma janela anônima — as alterações podem levar alguns minutos para propagar
Ainda não resolveu? Entre em contato pelo chat ou envie um e-mail para support@aftersell.app incluindo uma descrição da configuração do seu widget e os detalhes do pedido de teste.