> ## 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.
# Módulo de recompensas por níveis - configurações gerais
> Configurando as opções de design e funcionamento do Módulo de Recompensas
O Módulo de Recompensas é um recurso essencial do Upcart que exibe uma barra de progresso visual no cart drawer, incentivando os clientes a gastar mais ao acompanhar seu progresso rumo a recompensas como frete grátis, descontos ou brindes.
Este é o primeiro de três guias sobre as configurações de Recompensas:
* **Configurações gerais** (este documento)
* **[Configurações de recompensas](/pt/upcart/tiered_rewards_module_rewards_settings)**
* **[Configurações avançadas](/pt/upcart/tiered_rewards_module_advanced_settings)**
⚠️ *Este módulo é puramente visual e não aplica descontos nem lógica de frete. Para tornar as recompensas funcionais, consulte o documento [Configurações de recompensas](/pt/upcart/tiered_rewards_module_rewards_settings).*
# Configurações gerais
## Mostrar recompensas no carrinho vazio
Ative esta opção para exibir a barra de recompensas mesmo quando o carrinho estiver vazio.
## Cores
Personalize a aparência visual da barra:
* **Cor de fundo da barra**: Representa o que ainda falta conquistar
* **Cor de primeiro plano da barra**: Indica o progresso rumo a uma recompensa
* **Cor do ícone de nível de recompensa completo**: Os ícones dos níveis que o cliente já desbloqueou. **Somente na Versão 2.**
* **Cor do ícone de nível de recompensa incompleto**: Os ícones dos níveis ainda a desbloquear. **Somente na Versão 2.**
## Texto após completar toda a barra de recompensas
Adicione uma mensagem personalizada que aparece quando todos os níveis de recompensa forem atingidos. Use as ferramentas de formatação (negrito, itálico, sublinhado, cor) para estilizar a mensagem como quiser.
***
## Cálculo das recompensas
Este é um cartão próprio, abaixo de **Configurações gerais**. Escolha como o progresso é calculado:
* **Total do carrinho (\$)**\
Acompanha com base no valor total do carrinho (por exemplo, recompensa em \$100).
* **Quantidade do carrinho (#)**\
Acompanha com base no número de itens (por exemplo, recompensa com 5 itens).
* A base selecionada se aplica a toda a barra de recompensas e não pode variar por nível.
## Usar preços antes de descontos para o total do carrinho
No mesmo cartão **Cálculo das recompensas**, e exibido apenas quando a base é **Total do carrinho (\$)**. Quando ativado, as recompensas são calculadas usando o total do carrinho antes de qualquer desconto. Isso evita que os clientes sejam desqualificados de uma recompensa pelo próprio cupom. Consulte [Como excluir descontos da meta de recompensa](/pt/upcart/how_to_exclude_discounts_in_reward_goal).
***
## Filtrar quais produtos contam para as recompensas
Com os **Filtros de produtos**, você pode controlar quais itens do carrinho são elegíveis para contribuir com o progresso das recompensas. Isso permite maior precisão e flexibilidade de uso, como excluir cartões-presente ou considerar apenas grupos específicos de produtos.
Esses filtros exigem o módulo de Recompensas **Versão 2**. Na Versão 1, a seção de filtros nem aparece.
Você pode aplicar filtros por **produto**, **coleção**, **propriedade do item** ou **status de assinatura**. Cada filtro pode ser definido como **incluir** (apenas os itens selecionados contribuem) ou **excluir** (tudo contribui, exceto os itens selecionados). Vários filtros podem ser combinados para criar uma lógica em camadas.
## **Filtro de produto**
Este filtro permite incluir ou excluir produtos individuais da barra de recompensas.
* **Incluir**: Apenas os produtos selecionados contarão para a recompensa.
* **Excluir**: Todos os produtos contam, exceto os que você excluiu.
Use-o para isolar SKUs de alta margem, excluir itens promocionais ou remover produtos de baixo valor, como cartões-presente, do cálculo das recompensas.
## **Filtro de coleção**
Este filtro aplica a mesma lógica do filtro de produto, mas no **nível de coleção**.
* Você pode incluir uma coleção inteira da Shopify (por exemplo, "Coleção de Festas") para contar nas recompensas.
* Ou excluir uma coleção como "Itens em promoção" se não quiser que produtos com desconto contribuam.
Ótimo para controle em lote sem precisar selecionar produtos individualmente.
## **Filtro de propriedade do item**
Use este filtro para incluir ou excluir itens com base em **propriedades de item de linha** — metadados frequentemente adicionados por outros apps, opções de produto personalizadas ou marcações internas.
* Adicione filtros usando **pares chave-valor** (por exemplo, `upsell: true`, `__upcartRecommendation: [ID]`)
* Você pode deixar o campo de valor em branco para filtrar apenas pela chave (por exemplo, excluir todos os itens com a chave `upsell`, independentemente do valor)
Isso é ideal para excluir itens de upsell, assinaturas, pedidos personalizados ou qualquer coisa marcada dinamicamente pela sua loja ou automação.
## **Filtro de status de assinatura**
Este filtro permite incluir ou excluir itens conforme sejam itens de assinatura ou compras avulsas.
* **Itens de assinatura**: Apenas itens com um plano de assinatura ativo contarão para a recompensa
* **Itens avulsos**: Apenas itens comprados de forma avulsa (sem assinatura) contarão para a recompensa
Use isso para criar recompensas específicas para compras por assinatura (por exemplo, "Adicione 3 itens de assinatura e ganhe frete grátis") ou para excluir assinaturas de certos níveis de recompensa.
***
## Configurações avançadas
Abre o menu de Configurações avançadas de recompensas. Para recursos como recompensas por moeda e condições avançadas, consulte o guia **[Configurações avançadas](/pt/upcart/tiered_rewards_module_advanced_settings)**.