> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Por que meu upsell de checkout não está sendo exibido?
> Uma análise completa de todos os motivos pelos quais seu upsell de checkout pode não estar aparecendo, incluindo problemas de configuração, posicionamento, gatilhos e produto/oferta.
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?](/pt/aftersell/why_cant_i_see_the_checkout_tab)
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](#widget-is-not-enabled-or-not-added-to-checkout)
* [Divergência de placement entre a Aftersell e a Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [As condições de gatilho não estão sendo atendidas](#trigger-conditions-are-not-being-met)
* [Há um problema com o produto ou com a oferta](#there-is-a-product-or-offer-issue)
* [Widgets do Shop Pay não aparecem](#shop-pay-widgets-not-showing)
* [Testando na pré-visualização da Shopify](#testing-in-the-shopify-preview)
* [Nada acima se aplica](#nothing-above-applies)
***
## 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 →](/pt/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)
***
## 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 →](/pt/aftersell/checkout_triggers)
***
## 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 →](/pt/aftersell/show_checkout_widgets_in_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](mailto:support@aftersell.app) incluindo uma descrição da configuração do seu widget e os detalhes do pedido de teste.