> ## 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.

# Upsells no checkout

> Use uma Strategy para escolher dinamicamente o produto exibido em um widget de upsell do checkout na Shopify Plus.

<div id="overview">
  ## Visão geral
</div>

Ao configurar um widget de upsell do checkout, você pode preencher o slot de produto de algumas maneiras: escolher manualmente um produto específico, deixar a IA recomendar um ou anexar uma **Strategy**. Cada uma é uma ferramenta diferente para um trabalho diferente.

As Strategies servem para **merchandising dinâmico em tempo real** - combinar o acessório certo com um produto principal, sugerir um item complementar ou exibir um produto diferente dependendo do que já está no carrinho. Enquanto os **gatilhos** do checkout decidem *qual* widget aparece para um determinado comprador, uma Strategy decide *qual produto vai dentro dele*. Os gatilhos são a porta de entrada, as Strategies são o cérebro por trás da experiência.

***

<div id="attaching-a-strategy-to-a-checkout-widget">
  ## Anexando uma Strategy a um widget de checkout
</div>

As Strategies são anexadas **por widget**, não ao checkout como um todo. Você pode misturar widgets baseados em Strategy e widgets de produto estático no mesmo checkout.

1. Abra o widget de checkout que você quer editar.
2. No menu **Select product type**, escolha **Strategy**.
3. No seletor de Strategy, pesquise e selecione a Strategy que você quer usar.
4. Clique em **Confirm** e salve o widget.

Depois de anexada, o widget exibe o nome da Strategy no lugar de um produto específico. Cada vez que o checkout é carregado, a Strategy é avaliada e o produto retornado é renderizado no widget.

<Tip>
  Dê às suas Strategies nomes claros e descritivos. O nome da Strategy é o que aparece no editor de widget depois de anexada, e é a maneira mais fácil de saber, de relance, qual Strategy está controlando qual widget.
</Tip>

***

<div id="what-the-strategy-sees">
  ## O que a Strategy enxerga
</div>

O checkout tem um **contexto mais restrito** do que o pós-compra. A Strategy é avaliada quando a página de checkout é carregada, antes de o pedido ser feito - portanto, o histórico do cliente e a atribuição de sessão ainda não estão disponíveis. Veja abaixo o que é enviado automaticamente:

<div id="product-context">
  #### Contexto de produto
</div>

Os itens de linha atualmente no carrinho são enviados como produtos de entrada. Gatilhos como **tags de produto**, **coleções de produto**, **tipo de produto**, **fornecedor** e **metafields de produto** são todos avaliados com base nesses itens.

**O plano de venda não é avaliado aqui.** Os itens de linha do checkout não carregam um plano de venda nesse payload, então um gatilho de **Selling plan** nunca corresponde em widgets de checkout.

<div id="cart-context">
  #### Contexto do carrinho
</div>

* **Subtotal** - o subtotal do carrinho.
* **Contagem de itens** - quantidade total em todas as linhas.
* **Contagem de linhas** - número de itens de linha distintos.

<Warning>
  **Os gatilhos de cliente e sessão não corresponderão no checkout.** Tags de cliente, contagem de pedidos, país, localidade e parâmetros UTM não fazem parte do payload do checkout. Se uma Strategy usada em um widget de checkout depender desses gatilhos, essas regras nunca serão acionadas, e apenas regras com escopo de produto ou carrinho (ou o Catch all) poderão retornar um produto.
</Warning>

***

<div id="what-happens-when-the-strategy-returns">
  ## O que acontece quando a Strategy retorna
</div>

O(s) produto(s) retornado(s) pela Strategy **substituem** o placeholder no widget - eles não são adicionados a ele. O comprador vê o widget como se você tivesse escolhido aquele produto manualmente.

O widget preenche seus slots com os produtos retornados em ordem de prioridade, até o número de ofertas que o widget está configurado para exibir. Um widget de oferta única usa o primeiro produto retornado.

***

<div id="when-no-product-is-returned">
  ## Quando nenhum produto é retornado
</div>

Se nenhuma regra corresponder e a Strategy não retornar produtos, o widget **não é exibido** ao comprador - o slot desaparece completamente do checkout.

Para manter seu widget funcionando, configure um **Catch all** na Strategy para que sempre haja um produto de fallback para retornar. Consulte a página [Criando Strategies](/pt/aftersell/strategies_building_in_app) para saber como configurar um Catch all.

***

<div id="evaluation-timing">
  ## Momento da avaliação
</div>

Por padrão, uma Strategy em um widget de checkout é avaliada **uma vez, quando a página de checkout é carregada**. O produto escolhido no carregamento da página permanece sendo o produto exibido, mesmo que o comprador adicione ou remova itens durante o checkout.

Se o widget tiver a **reverificação flexível de gatilhos** ativada, a Strategy é reavaliada sempre que o carrinho muda durante o checkout, e o widget é atualizado para refletir o novo carrinho - semelhante ao comportamento da [integração com o Upcart](/pt/aftersell/implementing_strategies_upcart_upsells). Planeje suas regras de acordo com o modo que o widget usa: um snapshot fixo no carregamento do checkout ou uma reavaliação em tempo real a cada mudança no carrinho.

***

<div id="tips-for-checkout-strategies">
  ## Dicas para Strategies de checkout
</div>

* **Projete pensando apenas em produtos e carrinho.** Gatilhos com escopo de cliente e sessão nunca corresponderão no checkout, então crie Strategies com base em atributos de produto (tags, coleções, metafields) e no formato do carrinho (subtotal, contagem de itens, contagem de linhas).
* **Use o Catch all como rede de segurança.** Uma Strategy sem Catch all ocultará o widget se nada corresponder. Um Catch all simples mantém o slot exibindo *alguma coisa*.
* **Misture widgets dinâmicos e estáticos.** Nem todo widget precisa ser baseado em Strategy. Um padrão comum é uma Strategy no widget de upsell principal (mais personalizado) e um produto estático em um widget secundário (produto de vendas comprovadas).
