# DataFirefly Venda cruzada no carrinho: sugestões de produtos no carrinho PrestaShop
> Apresentação O DataFirefly Venda cruzada no carrinho apresenta sugestões de produtos na página do carrinho, na janela de adição ao carrinho e no carrinho vazio. O cliente adiciona uma sugestão…
- Página:
- Idioma: pt
- Atualizado em: 2026-11-02
- Outros idiomas: [en](https://www.datafirefly.com/en/documentation/dfcartcrosssell/index.md), [fr](https://www.datafirefly.com/documentation/dfcartcrosssell/index.md), [es](https://www.datafirefly.com/es/documentation/dfcartcrosssell/index.md), [de](https://www.datafirefly.com/de/documentation/dfcartcrosssell/index.md), [it](https://www.datafirefly.com/it/documentation/dfcartcrosssell/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcartcrosssell/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcartcrosssell/index.md)
- Índice:
## Apresentação
O DataFirefly Venda cruzada no carrinho apresenta sugestões de produtos na **página do carrinho**, na **janela de adição ao carrinho** e no **carrinho vazio**. O cliente adiciona uma sugestão num clique, escolhe a combinação no próprio cartão e o carrinho é atualizado sem recarregar a página.
As sugestões vêm primeiro das suas **regras** e depois das **fontes automáticas**: produtos relacionados, frequentemente comprados juntos, mesma categoria, mesma marca, mesmas características, mais vendidos, novos produtos e preço semelhante. Uma regra pode baixar o preço dos seus produtos enquanto o carrinho contiver um produto que a ative.
O módulo funciona do PrestaShop 1.7.8 ao 9.x com PHP 7.1 a 8.5, com os temas Classic e Hummingbird. Está traduzido em inglês, francês, espanhol, alemão, italiano, polaco, neerlandês e português.
## Instalação e atualização
1. Em **Módulos > Gestor de Módulos**, clique em **Carregar um módulo** e arraste o ficheiro `dfcartcrosssell-2.0.0.zip`.
2. Clique em **Configurar** para abrir a página do módulo com os seus quatro separadores: Painel, Regras, Definições e Ferramentas.
A instalação constrói o índice «frequentemente comprados juntos» a partir das suas encomendas existentes, pelo que esta fonte funciona desde a primeira visita.
Atualização a partir da versão 1.0: carregue o zip 2.0.0 por cima do módulo antigo. As suas definições e estatísticas são mantidas, os pacotes da 1.0 passam a ser regras e a cache dos ficheiros JS/CSS combinados é esvaziada. O desconto de pacote da 1.0 nunca era aplicado aos carrinhos: os descontos passam agora pelas ofertas das regras.
## Onde aparecem as sugestões
### Página do carrinho
Por predefinição, o bloco aparece por baixo dos produtos do carrinho, em carrossel, grelha ou lista compacta. Por cima, o bloco **frequentemente comprados juntos** lista os produtos muitas vezes encomendados com os do carrinho, com caixas de seleção, a escolha da combinação, o total real dos produtos selecionados e um botão para os adicionar todos.
Página do carrinho com o bloco comprados juntos e o carrossel de sugestões com preços de oferta
Também pode colocar o bloco na coluna do resumo da encomenda: passa então a ser uma lista compacta com 4 produtos no máximo.
### Janela de adição ao carrinho
Quando um cliente adiciona um produto a partir de qualquer página, a janela de confirmação apresenta sugestões para esse produto. Ao adicionar uma, a janela mantém-se aberta, o contador do carrinho é atualizado e o novo total do carrinho é anunciado aos leitores de ecrã.
Janela de confirmação de adição ao carrinho com sugestões para o produto adicionado
### Carrinho vazio
Um carrinho vazio apresenta os seus mais vendidos, para que a página nunca seja um beco sem saída.
Página do carrinho vazio com os mais vendidos da loja
### Telemóvel
No telemóvel, o carrossel desliza com o dedo e o cartão seguinte espreita na margem para convidar a deslizar. As setas, a navegação por teclado e a deslocação automática opcional estão disponíveis no computador; a deslocação automática para ao passar o rato, ao focar e quando o visitante prefere movimento reduzido.
Carrossel de sugestões no telemóvel
## Adição ao carrinho num clique
Cada cartão mostra o preço, o preço normal quando há redução, a etiqueta de desconto ou de oferta, a marca e, se o módulo Comentários de produtos estiver ativo, a avaliação média real das avaliações validadas. Os produtos com combinações têm uma lista pendente no cartão: o preço acompanha a combinação escolhida e as combinações indisponíveis aparecem a cinzento.
O botão de adição envia um pedido verificado pelo servidor: o produto tem de estar ativo, visível, disponível para encomenda, em stock (salvo se forem permitidas encomendas sem stock), sem personalização obrigatória e acessível ao grupo do cliente. Em seguida, o módulo desencadeia a atualização do carrinho do tema: os totais, a pré-visualização do carrinho e o próprio bloco são atualizados sem recarregar a página, com um esqueleto de carregamento enquanto as sugestões são recalculadas.
Adicionar ao carrinho num clique com escolha da combinação
## Regras
As regras escolhem os produtos a sugerir para determinados carrinhos. Aparecem antes das sugestões automáticas, da prioridade mais alta para a mais baixa. A lista mostra os acionadores, os produtos sugeridos, a oferta, a prioridade, o estado (ativa, inativa, agendada, expirada) e as adições e a receita dos últimos 30 dias.
Lista de regras de venda cruzada com gatilhos, produtos sugeridos, ofertas, prioridade e estado
### Criar uma regra
1. **Quando o carrinho contém**: produtos, categorias (incluindo as subcategorias) ou valores de característica. Deixe tudo vazio para aplicar a regra a qualquer carrinho. Pode acrescentar um valor mínimo do carrinho.
2. **Sugerir**: produtos pela ordem escolhida, categorias ou valores de característica (são usados os produtos mais vendidos).
3. **Oferta** (opcional): uma percentagem ou um valor com IVA sobre os produtos sugeridos indicados na regra.
4. **Opções**: prioridade de 0 a 100, mostrar apenas os produtos desta regra, datas de início e de fim, grupos de clientes e um título do bloco próprio em cada idioma.
A pré-visualização à direita mostra os cartões exatamente como os clientes os verão, com os preços de oferta.
Editor de regras
### Regras baseadas em características de produto
Uma regra pode ser ativada por valores de característica (por exemplo _Coleção: Citações inspiradoras_) e sugerir produtos com outros valores (por exemplo _Composição: Cerâmica_). Pesquise um valor com _Característica: valor_; é indicado o número de produtos de cada valor.
Regra de venda cruzada por características
### Ofertas
Uma oferta baixa o preço de um produto sugerido enquanto o carrinho contiver também **outro** produto que ative a regra. É calculada pelo servidor e aplicada através de um preço específico limitado a esse carrinho: nada do que o navegador envia a pode alterar. É novamente verificada a cada alteração do carrinho e retirada assim que o carrinho deixa de cumprir a condição. As promoções do catálogo existentes são mantidas: a oferta aplica-se ao preço já reduzido.
Sugestões de uma regra com título próprio e uma oferta em valor para um carrinho com chá
Uma oferta aplica-se a todas as unidades do produto no carrinho. Desative **Ofertas das regras** nas definições para parar todas as ofertas de uma vez.
## Sugestões automáticas e características de produto
Cada fonte automática tem um peso de 0 (desativada) a 10. Os produtos encontrados por várias fontes têm uma pontuação mais alta. A fonte **Mesmas características** sugere os produtos que partilham mais valores de característica com o carrinho; pode limitá-la a determinadas características.
Peso das fontes automáticas
O DataFirefly Tags em características transforma as etiquetas dos produtos em características nativas. A venda cruzada lê estas características em tempo real, sem qualquer configuração: assim que as etiquetas são convertidas, a fonte «mesmas características» e as regras por características passam a usá-las.
Produtos inativos, invisíveis e indisponíveis, produtos com personalização obrigatória e produtos de categorias ocultas para o grupo do cliente nunca são sugeridos. Em **Filtros e exclusões** pode também ocultar os produtos esgotados, os que já estão no carrinho e determinados produtos ou categorias.
## Apresentação e aspeto
O separador Definições reúne a posição no carrinho, a disposição, o número de produtos, os títulos em cada idioma, a janela de adição ao carrinho, o carrinho vazio, o bloco comprados juntos, o conteúdo dos cartões, quatro estilos de cartão, a cor de destaque (ou as cores do seu tema), o arredondamento dos cantos e a sombra. Em multiloja, as definições são guardadas por loja.
Definições de apresentação
## Painel
O painel mostra apenas dados registados pelo módulo na sua loja: visualizações do bloco, cliques em produtos, adições ao carrinho, taxa de adição, encomendas com um produto sugerido e a **receita adicional**, ou seja, o total sem IVA das linhas de encomenda dos produtos adicionados a partir do bloco, em encomendas válidas. Compara também a encomenda média com e sem produto sugerido, e cada valor com o período anterior.
Painel de venda cruzada
As tabelas detalham visualizações, adições, taxa e receita por fonte e por localização (página do carrinho, janela, carrinho vazio, bloco comprados juntos) e listam os produtos com melhor desempenho.
Desempenho das sugestões por fonte e localização
## Ferramentas
O **simulador de carrinho** mostra as sugestões para qualquer lista de produtos, com a fonte, a regra e a pontuação de cada uma: a forma mais rápida de verificar uma regra ou os pesos.
Simulador de carrinho
- **Índice «comprados juntos»**: atualizado a cada encomenda; reconstrua-o após importar encomendas ou alterar a duração do histórico.
- **Tarefa agendada** (opcional): chame o URL uma vez por dia para reconstruir o índice e limpar dados antigos. Sem ela, a limpeza é executada automaticamente no máximo uma vez por dia.
- **Manutenção**: número de carrinhos com uma oferta ativa e eliminação das estatísticas.
## Segurança e privacidade
- Adicionar ao carrinho exige um pedido POST com o token da loja; os preços e quantidades enviados pelo navegador são ignorados.
- As visualizações e os cliques são assinados pelo servidor, pelo que as estatísticas forjadas são recusadas.
- As estatísticas não contêm dados pessoais: contadores diários por produto e o id do carrinho apenas para associar uma adição à respetiva encomenda.
- A desinstalação elimina as tabelas, as definições e as ofertas de carrinho do módulo.
## Resolução de problemas
### O bloco não aparece
Verifique se **Mostrar sugestões** está ativado, se a posição no carrinho não está definida como _Não na página do carrinho_ e se há produtos que possam ser sugeridos: o simulador de carrinho indica porque é que uma lista está vazia.
### O script antigo continua a ser carregado após a atualização
A atualização esvazia a cache dos ficheiros combinados. Se uma cache do servidor ou uma CDN mantiver uma cópia antiga, esvazie-a também.
### Uma oferta não é aplicada
O carrinho tem de conter outro produto que ative a regra, a regra tem de estar ativa e dentro das suas datas, e a oferta tem de dar um preço inferior ao atual.