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

# Widget de Recomendação de Produtos

> Configure o widget de Recomendação de Produtos da página de agradecimento na Aftersell: escolha produtos, projete a oferta, aplique descontos e defina o tratamento do pedido.

O widget de Recomendação de Produtos exibe produtos de upsell na página de agradecimento após o checkout. Use-o para promover produtos específicos, gerar recomendações automáticas com base no conteúdo do carrinho ou destacar uma coleção. Esta página cobre todas as configurações do widget. Para a configuração completa do funil e as etapas no editor da Shopify, consulte [Como configurar widgets da página de agradecimento](/pt/aftersell/how_can_i_set_up_and_customize_thank_you_page_upsells_in_aftersell).

Adicione o widget na seção **Thank You Page** do seu funil clicando em **Add Widget** e selecionando **Product Recommendation**.

Diferentemente dos upsells pós-compra, as recomendações de produtos da página de agradecimento são compatíveis com **todos os gateways de pagamento** e **lojas multimoeda**. Os clientes reinserem seus dados de pagamento para concluir a compra do upsell, mas a Aftersell aplica automaticamente as informações de envio salvas para manter a experiência de checkout fluida.

<img src="https://mintcdn.com/aftersell/SnVX3h-PpMMxQMDU/images/aftersell/typ-extensions-editor-product-recommendation.gif?s=cd8c084de2e615bf735f29eb5c01374f" alt="Editor da página de agradecimento da Aftersell com o widget de Recomendação de Produtos ativo e um produto selecionado" width="2600" height="1080" data-path="images/aftersell/typ-extensions-editor-product-recommendation.gif" />

## Seleção de produtos

1. Escolha seu método de seleção de produtos:
   * **Specific Products** - Selecione manualmente os produtos a serem exibidos
   * **Automatic Upsells** - Deixe a Aftersell recomendar produtos com base no conteúdo do carrinho
   * **Collections** - Exiba produtos de uma coleção específica
   * **Strategy** - Preencha o widget a partir de um conjunto de regras de [Strategies](/pt/aftersell/strategies_overview) da Aftersell. Esta opção aparece apenas quando a segmentação por Strategies está ativa na sua loja e você ainda não escolheu produtos por outro método.
2. Defina o **número máximo de produtos** a serem exibidos. Não há um máximo fixo, mas manter a contagem focada (por exemplo, 4-10 produtos) mantém a oferta fácil de escanear.
3. Habilite **Hide product if purchased** para que os clientes não vejam um produto que já compraram no mesmo pedido.
4. Habilite **Hide out of stock variants** para filtrar variantes indisponíveis, de modo que os clientes vejam apenas itens que podem realmente comprar.

Ao navegar pela aba **Products** no seletor de produtos, você pode marcar **Active products only** para ocultar produtos em rascunho e arquivados. Este filtro está desligado por padrão e se aplica apenas à aba Products; as Coleções não são afetadas.

### Editando produtos específicos

Para escolher produtos específicos, clique em **Add upsell products** no editor do widget. Depois que você tem produtos selecionados, o rótulo do botão muda para **Edit upsell products**.

Abrir o seletor quando os produtos já estão selecionados mostra sua seleção atual pré-marcada. A partir daí, você pode:

* **Adicionar** novos produtos marcando-os.
* **Remover** produtos existentes desmarcando-os.
* **Limpar** a seleção inteira desmarcando todos os produtos.

Salvar o seletor concilia o widget com o que você deixar selecionado: produtos adicionados são incluídos, produtos desmarcados são removidos, e salvar novamente uma seleção inalterada não faz alterações. Linhas de upsell de Coleção, IA e Strategy não são afetadas quando você edita produtos específicos.

## Exibir em

A configuração **Display on** controla onde o widget aparece depois que um cliente conclui a compra:

* **On every impression** - Mostra o widget tanto na página de agradecimento quanto na página de status do pedido.
* **Only on thank you page** - Mostra o widget apenas na página de agradecimento.
* **Only on order status page** - Mostra o widget apenas na página de status do pedido.
* **Only once on order status page** - Mostra o widget na página de status do pedido uma única vez, em vez de a cada visita.

<img src="https://mintcdn.com/aftersell/SnVX3h-PpMMxQMDU/images/aftersell/typ-extensions-recommendation-display-settings.gif?s=a7c3c5c98669d63e59100c05f33dd9f9" alt="Menu suspenso Display on da recomendação de produtos, campo Max products e alternadores de ocultar produto" width="1192" height="1080" data-path="images/aftersell/typ-extensions-recommendation-display-settings.gif" />

## Design da oferta

As configurações de **Offer design** controlam como as recomendações de produtos são apresentadas aos clientes.

* Escolha se os produtos são exibidos em um layout **horizontal** ou **vertical** e ajuste elementos visuais como bordas, estilos de botão e espaçamento para corresponder ao seu checkout.
* Adicione **texto de banner** acima da oferta para introduzir a recomendação, destacar um incentivo ou fornecer contexto para os produtos exibidos.
* Configure a exibição do **preço comparativo** e a cor usada para os preços promocionais.
* Habilite um **seletor de quantidade**, personalize o rótulo de quantidade e defina **limites mínimos ou máximos de quantidade**.

Os preços Compare, Discount e Sale oferecem duas famílias de cores:

* **Checkout branding colors** - Accent, Decorative, Info, Subdued
* **Preset colors** - Success (verde), Warning (amarelo), Critical (vermelho)

<Frame>
  <img src="https://mintcdn.com/aftersell/SnVX3h-PpMMxQMDU/images/aftersell/typ-extensions-compare-price-color-options.png?fit=max&auto=format&n=SnVX3h-PpMMxQMDU&q=85&s=555ec0085917bccf174d689e0a9c725c" alt="As opções de cor do preço comparativo tanto do tema quanto dos nossos presets." width="282" height="284" data-path="images/aftersell/typ-extensions-compare-price-color-options.png" />
</Frame>

Algumas dessas configurações também podem ser modificadas por meio do editor de checkout da Shopify ou por outros apps que oferecem essa funcionalidade.

Dois alternadores complementam o recurso Automatic Discount:

* **Show compare at price** - Exibir o preço "Compare at" com um traço.
* **Show discount** - Exibir o desconto no upsell.

## Descontos e tratamento do pedido

### Descontos

Aplique um desconto diretamente ao upsell definindo uma **porcentagem** ou um **valor fixo**. O desconto é aplicado automaticamente quando o cliente aceita a oferta.

Personalize como o desconto aparece com o **texto do desconto** e a **cor do preço com desconto**. As cores de desconto podem usar as cores de branding do seu checkout (Accent, Decorative, Info, Subdued) ou um preset (Success, Warning, Critical). Se habilitado, a exibição do desconto pode incluir o **preço comparativo**, mostrado com um traço para destacar a economia.

<img src="https://mintcdn.com/aftersell/SnVX3h-PpMMxQMDU/images/aftersell/typ-extensions-thank-you-upsell-offer.gif?s=41788af72c0b25ff35871242596c5f79" alt="Oferta de upsell da página de agradecimento para um chapéu mostrando 43 por cento de desconto com um preço comparativo tachado" width="2000" height="1080" data-path="images/aftersell/typ-extensions-thank-you-upsell-offer.gif" />

Os descontos seguem as regras padrão de desconto de checkout da Shopify. Apenas um desconto por linha de item pode ser aplicado a um produto de cada vez, e os descontos só combinam se marcados como **combinable** no Shopify Admin. Em alguns casos, os descontos podem não ser aplicados se outro app modificar o checkout. Recomendamos testar seu checkout após habilitar os descontos.

### Tratamento do pedido

<a id="order-handling" />

O tratamento do pedido controla como um upsell aceito é adicionado ao pedido do cliente. Há duas opções, cada uma com diferentes vantagens e desvantagens.

* **Modify original order** - Adiciona o upsell diretamente ao pedido existente. Frete grátis é aplicado automaticamente. Você pode opcionalmente enviar um e-mail ao cliente quando o pedido dele é modificado.
* **Create new draft order** - Mantém o pedido original intocado e cria um pedido separado para o upsell.

<Frame>
  <img src="https://mintcdn.com/aftersell/SnVX3h-PpMMxQMDU/images/aftersell/typ-extensions-order-handling-options.png?fit=max&auto=format&n=SnVX3h-PpMMxQMDU&q=85&s=de2249c801aef599ce76686b46f91dec" alt="Opções de tratamento do pedido para modificar o pedido original ou criar um novo pedido rascunho" width="828" height="722" data-path="images/aftersell/typ-extensions-order-handling-options.png" />
</Frame>

#### Quando escolher cada opção

| Use **Modify original order** quando...                          | Use **Create new draft order** quando...                                                                            |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Você quer um único fulfillment para tudo o que o cliente comprou | Você quer reoferecer um produto que o cliente acabou de comprar (por exemplo, o mesmo item com desconto pós-compra) |
| Seu catálogo de upsell é distinto dos seus best-sellers          | Seus best-sellers também são seus principais candidatos a upsell                                                    |
| Frete grátis no upsell é a prioridade                            | Você precisa de um pedido separado por motivos de fulfillment ou relatório                                          |
| Seus produtos de upsell não são produtos bundle                  | Seus produtos de upsell incluem produtos bundle                                                                     |

<Warning>
  **O "Modify original order" tem limitações.** Quando este modo é selecionado, um banner de **Limitations** aparece no editor do widget listando o seguinte:

  * **Upsells da mesma variante são ocultados.** A API de edição de pedidos da Shopify não permite variantes duplicadas em um pedido. Se o cliente já tem a variante do upsell no pedido original, o upsell é ocultado da página de agradecimento. Se um upsell for ocultado por este motivo, o Order Browser sinaliza o pedido afetado com um banner "Upsell hidden due to order merging".
  * **Produtos bundle não podem ser adicionados a um pedido existente.** A API de edição de pedidos da Shopify rejeita produtos bundle. Quando uma variante de upsell selecionada é um bundle, o resultado segue sua configuração **When the order can't be modified**:
    * Com **Hide the offer and block late acceptances**: o upsell bundle é ocultado e os clientes não podem comprá-lo por meio desta oferta.
    * Com **Hide the offer, but allow late acceptances as a new order** ou **Keep showing the offer and sell it as a new order**: o upsell bundle é atendido como um pedido rascunho separado em vez de ser mesclado ao pedido original.

  Mude para **Create new draft order** se quiser que produtos bundle ou upsells de mesma variante estejam sempre disponíveis para os clientes.
</Warning>

#### Quando o pedido não pode ser modificado

Quando **Modify original order** está selecionado, alguns pedidos não podem ser editados no momento em que um cliente aceita o upsell. Há exatamente três casos: o pedido foi **arquivado**, está **parcialmente pago** ou é mais antigo que a **janela de expiração** que você define abaixo. A configuração **When the order can't be modified** controla o que acontece nesses casos.

Um pedido **fulfilled** não é um deles; ele ainda pode ser editado, mas apenas produtos de upsell que não exigem envio podem ser mesclados a ele (veja a nota mais abaixo).

| Opção                                                         | O que faz                                                                                                                                                                                                                                              |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Hide the offer and block late acceptances**                 | A oferta é ocultada assim que o pedido não pode mais ser editado. Qualquer aceitação que chegue depois que o pedido se torna inelegível é bloqueada.                                                                                                   |
| **Hide the offer, but allow late acceptances as a new order** | A oferta é ocultada assim que o pedido não pode mais ser editado. Se um cliente aceitar logo antes de a oferta ocultar (uma aceitação de janela de corrida), o upsell é atendido como um pedido rascunho separado. Este é o padrão para novos widgets. |
| **Keep showing the offer and sell it as a new order**         | A oferta permanece visível independentemente de o pedido poder ser editado. Se o pedido não puder ser modificado, o upsell aceito é atendido como um pedido rascunho separado.                                                                         |

As duas opções alternativas criam um pedido rascunho separado para o upsell quando o pedido original não pode ser modificado. O cliente recebe um link de pagamento para concluir a compra como um novo pedido.

#### Definindo uma janela de expiração

Você pode definir um limite de tempo para quanto tempo um pedido permanece elegível para mesclagem. Use o campo **Consider the order uneditable after** (localizado abaixo do seletor de comportamento em **Order handling**) para inserir um número de minutos. Uma vez que esse número de minutos tenha passado desde que o pedido foi feito, o pedido é tratado como inelegível e o comportamento **When the order can't be modified** se aplica.

Deixe o campo em branco ou defina-o como **0** para nunca expirar; a oferta permanece elegível pelo tempo que o próprio pedido for editável.

Isso é útil quando seu fluxo de fulfillment processa pedidos rapidamente e você quer evitar tentar mesclar em um pedido que provavelmente já está em andamento.

#### Outras coisas a saber sobre "Modify original order"

* Frete grátis é aplicado automaticamente e não pode ser desativado.
* O pedido original é marcado como **partially paid** até que o cliente conclua o pagamento do upsell adicionado. Depois que o pagamento é capturado, a Shopify atualiza o pedido automaticamente.
* Se o pedido já estiver fulfilled, não tiver linha de envio ou contiver apenas itens que não exigem envio, apenas produtos de upsell que **não exigem envio** podem ser mesclados a ele. Produtos que exigem envio são descartados da oferta nesses pedidos.

### Frete grátis

Você pode oferecer **frete grátis** em produtos de upsell aceitos para ajudar a aumentar a conversão. Quando habilitado, os clientes não são cobrados pelo frete do upsell, enquanto suas configurações de envio existentes da Shopify continuam a se aplicar ao pedido original.

Como o alternador Free shipping se comporta depende da sua configuração **Order handling**:

* **Modify original order** - Frete grátis é aplicado automaticamente ao upsell aceito e o alternador não pode ser desativado.
* **Create new draft order** - O alternador Free shipping se aplica ao pedido rascunho separado criado para o upsell. Quando habilitado, o pedido rascunho é criado sem cobranças de envio na linha do item do upsell. Deixe o alternador desligado se quiser que as tarifas de envio normais da Shopify se apliquem a esse novo pedido.

O mesmo comportamento se aplica quando uma alternativa cria um pedido rascunho separado sob **Modify original order** (por exemplo, um upsell de mesma variante ou bundle, ou uma aceitação após o pedido se tornar não editável): o alternador Free shipping controla se o pedido rascunho é criado sem cobranças de envio no upsell.

Você também pode exibir um **selo "Free Shipping"** na oferta e personalizar o texto do selo para destacar o benefício.
