> ## 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 na página de agradecimento

> Use uma Strategy para escolher dinamicamente os produtos exibidos em um widget de recomendação de produtos da Thank You Page.

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

Ao configurar um widget de **recomendação de produtos** da Thank You Page, você pode preenchê-lo de algumas maneiras: escolher manualmente produtos específicos, retornar uma coleção, deixar a IA recomendar produtos 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 complemento certo com o que o comprador acabou de comprar, exibir um item complementar ou recomendar o próximo passo de uma rotina. Enquanto o widget da Thank You Page decide *onde* as recomendações aparecem, uma Strategy decide *quais produtos vão dentro dele* - avaliada do zero para cada pedido.

Uma Strategy na Thank You Page também pode substituir o texto de cada card e aplicar um desconto por produto, de modo que produtos diferentes podem ter mensagens e preços diferentes. Veja [Texto da regra e descontos por produto](#rule-copy-and-per-product-discounts).

***

<div id="attaching-a-strategy-to-a-thank-you-page-widget">
  ## Anexando uma Strategy a um widget da Thank You Page
</div>

Uma Strategy é a origem de produtos de um único widget de recomendação de produtos. Ela é **exclusiva** - um widget alimentado por uma Strategy não pode também usar produtos específicos, uma coleção ou recomendações de IA.

1. Abra o funil da Thank You Page e edite o widget de **recomendação de produtos** que você quer configurar.
2. No menu **Add upsell products**, escolha **Strategy**.
3. No seletor de Strategy, pesquise e selecione a Strategy que você quer usar.
4. Confirme e salve o widget.

Depois de anexada, o widget mostra o nome da Strategy no lugar de produtos específicos. Cada vez que a Thank You Page é carregada, a Strategy é avaliada e os produtos retornados são renderizados 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>

Quando um widget da Thank You Page avalia uma Strategy, o contexto a seguir é enviado automaticamente. Você não precisa configurar nada - ele é extraído do pedido concluído e da sessão enquanto a página é carregada.

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

Os itens de linha do **pedido recém-concluído** são enviados como produtos de entrada. Os gatilhos de produto - **tags de produto**, **coleções de produto**, **tipo de produto**, **fornecedor**, **título**, **handle** e **metafields de produto** - são todos avaliados com base nesses itens. Seus atributos são resolvidos automaticamente, então você só precisa das regras; não é necessário fornecer os dados dos produtos por conta própria.

<Note>
  Os produtos que o comprador acabou de comprar são automaticamente **excluídos** dos resultados, então uma Strategy nunca recomenda novamente um item que já está no pedido.
</Note>

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

* **Subtotal** - o subtotal do pedido (nas unidades principais da moeda da loja, por exemplo, dólares).
* **Contagem de itens** - quantidade total em todas as linhas.
* **Contagem de linhas** - número de itens de linha distintos.

<div id="customer-context">
  #### Contexto do cliente
</div>

* **Tags de cliente**
* **Contagem de pedidos** (pedidos ao longo da vida do cliente)
* **País / estado** (o destino do pedido)
* **Localidade**

<div id="session-context">
  #### Contexto de sessão
</div>

Parâmetros UTM capturados quando o comprador chegou à loja:

* **UTM source**
* **UTM medium**
* **UTM campaign**
* **UTM content**
* **UTM term**

<Warning>
  **Alguns gatilhos não corresponderão na Thank You Page.** Notas e atributos do carrinho, total gasto pelo cliente e aceita-marketing, o gatilho de plano de venda e os gatilhos de frete/moeda da loja não fazem parte do payload da Thank You Page. Regras que dependem desses gatilhos nunca serão acionadas aqui - crie Strategies da Thank You Page com base em atributos de produto, formato do carrinho, tags de cliente / contagem de pedidos / localização e parâmetros UTM.
</Warning>

***

<div id="rule-copy-and-per-product-discounts">
  ## Texto da regra e descontos por produto
</div>

Uma Strategy dá a você controle por produto tanto sobre o **texto** quanto sobre o **desconto** exibidos em cada card da Thank You Page.

* **Texto da regra** - uma regra correspondente pode definir um **título**, um **subtítulo** e um **rótulo de botão (CTA)** para os produtos que ela retorna. Quando presente, o título da regra aparece acima do título do produto (não o substitui), o subtítulo é exibido como uma linha secundária e o CTA substitui o texto do botão do widget. Cards cujos produtos não vieram de uma regra com texto são renderizados sem alterações.
* **Desconto por produto** - uma regra correspondente pode definir um desconto (uma porcentagem ou um valor fixo) que se aplica aos produtos que ela retorna. Isso **substitui** o desconto configurado no widget, por produto - portanto, regras diferentes podem exibir descontos diferentes em cards diferentes. O desconto exibido no card é o desconto realmente cobrado quando o comprador aceita.

A configuração de desconto do próprio widget se torna o **padrão**: ela se aplica a qualquer produto retornado para o qual a Strategy não defina um desconto.

<Warning>
  Um desconto de **valor fixo** em uma moeda diferente da moeda do pedido não pode ser aplicado, então o card recorre ao desconto configurado no widget. Descontos em **porcentagem** sempre se aplicam, independentemente da moeda.
</Warning>

***

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

O widget renderiza os produtos que a Strategy retorna, em ordem de prioridade, até o **número máximo de produtos a exibir** do widget. Apenas produtos disponíveis para compra são exibidos.

Os produtos da Strategy **substituem** o placeholder do widget - o comprador vê o widget como se você tivesse escolhido aqueles produtos manualmente.

***

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

Se a Strategy não retornar produtos, o widget não renderiza **nada** - ele fica oculto na Thank You Page. A página nunca quebra: se uma Strategy não puder ser avaliada por qualquer motivo, o widget simplesmente não é exibido.

Para manter o 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. (Produtos de fallback do Catch all são exibidos sem texto de regra nem desconto por produto.)

***

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

Uma Strategy em um widget da Thank You Page é avaliada **uma vez, quando a Thank You Page é carregada**. O pedido já foi feito, então não há nada contra o que reavaliar - os produtos escolhidos no carregamento são os produtos exibidos.

***

<div id="how-shoppers-accept">
  ## Como os compradores aceitam
</div>

Como um upsell aceito é processado depende da configuração de tratamento de pedidos do funil:

* **Novo pedido** - o comprador conclui um checkout separado e com desconto para o produto do upsell.
* **Modificar pedido original** - o upsell é mesclado ao pedido que o comprador acabou de fazer.

Em ambos os casos, o produto, a variante e o desconto são revalidados em relação ao que a Strategy retornou antes de o pedido ser criado ou editado - assim, o preço cobrado sempre corresponde ao preço exibido.

***

<div id="tips-for-thank-you-page-strategies">
  ## Dicas para Strategies da Thank You Page
</div>

* **Projete com base no pedido.** Atributos de produto (tags, coleções, tipo, fornecedor, metafields), formato do carrinho (subtotal, contagem de itens/linhas), tags de cliente / contagem de pedidos / localização e parâmetros UTM são os sinais disponíveis aqui.
* **Aproveite o texto e os descontos por produto.** Use o texto da regra para adaptar a mensagem por produto e os descontos por produto para variar o preço por regra - com o desconto do widget como um padrão seguro.
* **Use o Catch all como rede de segurança.** Sem ele, o widget não exibe nada quando nenhuma regra corresponde.
