> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Upsell & Cross Sell não aparece na minha loja > ℹ️ **Note:** Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte. A Upsell & Cross Sell widget geralmente começa a aparecer logo após você publicar seu primeiro upsell — mas às vezes uma pequena configuração, regra de visibilidade ou configuração relacionada ao tema pode impedir que ele apareça na frente do store. A boa notícia é que estas questões são geralmente muito rápidas para corrigir 🚀 Este guia caminha através das razões mais comuns por que o seu Upsell & Cross Sell bloco pode não aparecer e como resolver cada passo a passo. Na maioria dos casos, a questão está relacionada a um dos seguintes: * A App Inbed está desabilitada * A configuração não foi salva * A configuração não foi publicada * Tipo de colocação errado para a página que você está testando * Bloco de posição personalizado não adicionado ao tema * Condições de exibição (história da ordem, valor do carrinho, clientes pela primeira vez) * Configurações de segmentação do cliente * Restrições de orientação geográfica * Upsell produtos não estão disponíveis ou fora de estoque * Conflitos de temas * Navegador ou cache de armazenamento Vamos passar por eles um por um. 👇 --- # **✅ Passo 1: Verifique se a incorporação da aplicação está habilitada** Pela Upsell & Cross Sell widget para aparecer em seu storefront, o aplicativo embed deve ser ativado dentro de seu Shopify tema. Sem ele, o script widget nunca carrega em sua loja — mesmo que tudo o mais esteja configurado perfeitamente. Ir para: **Shopify Admin → Canais de Vendas → Loja online → Temas → Editar tema → App Incorpora** Depois: * Procurar **"Upsell Cross-Sell Slider"** * Activar * Clique **Gravar** 💡 Dica: Se já estiver habilitado, tente fechar o Editor de Temas e reabri-lo, e então deslige a aplicação Incorporar e ligar novamente, e clique em **Gravar** Mais uma vez. ℹ️ O aplicativo também verifica isso para você. No painel de aplicação, o **Guia de Configuração** mostra uma _"Ativar incorporação de aplicativos"_ passo — fica verde uma vez que a incorporação é detectada como ativa em seu tema ao vivo. --- # **✅ Passo 2: Salvar a Configuração** Ao criar um novo upsell, sua configuração não é armazenada até você clicar **Gravar** na barra de gravação no topo da página de configuração. Se você fechou a aba sem salvar, o upsell nunca foi criado — então não há nada para o storefront exibir. Abra sua configuração Upsell → faça suas alterações → Clique **Gravar** --- # **✅ Passo 3: Publicar a Configuração** Mesmo que seu Upsell esteja totalmente configurado e salvo, os clientes não o verão até que a configuração tenha sido **publicado**. Abra sua configuração Upsell → Clique **Publicar** no topo da página. Você pode confirmar o status do crachá ao lado do nome da configuração: * **Publicado** → viver em sua loja ✅ * **Não publicado** → escondido dos clientes Você também pode publicar ou criar configurações diretamente da tabela do painel usando as ações em massa. ⚠️ Salvar sozinho não faz o Upsell viver. Ambas as acções são necessárias — **Gravar** Primeiro, então... **Publicar**. --- # **✅ Passo 4: Certifique-se de que você está testando a página certa** Cada configuração upsell está ligada a um tipo de colocação específico, e o widget só aparece na página correspondente: * **Página do produto** → mostra abaixo o botão Adicionar ao Carrinho nas páginas do produto * **Página do Carrinho** → mostra no `/cart` página * **Gaveta de Carrinhos** → mostra dentro da gaveta do carrinho * **Posição Personalizada** → mostra onde quer que você coloque o bloco do aplicativo em seu tema Exemplo: Se você criou um **Página do Carrinho** upsell, ele nunca aparecerá em uma página de produto — não importa quantas vezes você refresque. Abra a página do carrinho da sua loja e verifique lá. 💡 Para o Cart Gawer upsells, o widget é injetado quando a gaveta abre. Adicione um produto ao carrinho e abra a gaveta para testá-lo. --- # **✅ Passo 5: Usando a posição personalizada? Verificar o Bloco da Aplicação** Se a sua configuração usar o **Posição personalizada** colocação, o widget não aparece automaticamente — ele renderiza apenas onde você colocou o bloco Upsell em seu tema. Abra sua configuração Upsell → **Colocação** tab → **Mostrar Ligado (Incluir)** → certifique-se **Posição personalizada** é selecionado, então: 1. Copiar a **Upsell ID** mostrado dentro da configuração (ou da legenda da página no topo) 2. Ir para **Shopify Editor de Temas → Adicionar Secção / Adicionar Bloco → Guia Apps → Upsell Cross-Vell Block** 3. Colar o **Upsell ID** nas configurações do bloco 4. Clique **Gravar** Alternativamente, você pode colocar o trecho de código fornecido em um **Liquido Personalizado** seção ou diretamente em seu código de tema. ⚠️ Posição personalizada em que funciona actualmente **páginas de produto e páginas de carrinho** Apenas. O bloco ficará vazio em outras páginas, e também ficará vazio se o Upsell ID colado no bloco não corresponder exatamente à configuração. 📖 Precisa de ajuda para localizar a identificação? Ver: 🔎 Como encontrar Upsell ID? --- # **✅ Passo 6: Verificar as Regras de Exibição (Incluir) e Excluir** Dentro da **Colocação** tab, o **Mostrar Ligado (Incluir)** definindo controles em que produtos o widget aparece. Abra sua configuração Upsell → **Colocação** tab → **Mostrar Ligado (Incluir)** Em seguida, verifique: * Se **Produtos específicos** é selecionado → o widget só mostra nessas páginas exatas do produto * Se **Todos os produtos em coleções específicas** é selecionado → o produto que você está vendo deve pertencer a uma das coleções selecionadas * Se **Todos os produtos com etiquetas específicas** é selecionado → o produto deve carregar uma das etiquetas inseridas Mesmo abaixo dele, verifique o **Não exibir Ligado (Excluir)** seção também — você pode ter excluído o produto exato ou coleção que você está testando. Exemplo: Se o widget aparecer em algumas páginas de produto, mas não em outras, as páginas que faltam são quase sempre capturadas por uma regra de inclusão ou exclusão aqui. --- # **✅ Passo 7: Verifique as Condições de "Exibir somente quando"** A **Mostrar apenas quando** a seção adiciona condições que devem ser verdadeiras antes do widget aparecer. Abra sua configuração Upsell → **Colocação** tab → **Mostrar apenas quando** Verificar se algum destes está habilitado: * **Número mínimo de pedidos** → escondido até que o cliente tenha colocado que muitos pedidos * **Mostrar uma vez por cliente** → escondido de qualquer um que já tenha pedido * **O valor do carrinho está abaixo (valor máximo do carrinho)** → escondido uma vez que o total do carrinho vai acima da quantidade que você definir * **A última encomenda foi há mais de X dias** → mostrado apenas a clientes cuja última encomenda é mais antiga do que o período definido * **A última ordem foi nos últimos X dias** → mostrado apenas aos clientes que encomendaram recentemente Exemplo: Se **O valor do carrinho está abaixo de $50** está habilitado e seu carrinho de teste já contém $80 de produtos, o widget permanece escondido por design. 💡 Para efeitos de ensaio, seleccionar **Mostrar Sempre** — isto substitui todas as outras condições e ajuda a confirmar se estas definições estão a causar o problema de visibilidade. 📖 Para uma análise completa de cada condição de alvo, ver: 🎯 Opções de Alvo Avançadas para Upsell & Cross Sell --- # **👥 Passo 8: Verifique as configurações de destino do cliente** Se **Segmentação do cliente** está configurado, o widget pode permanecer oculto para certos visitantes ou grupos de clientes. Abra sua configuração Upsell → **Colocação** tab → **Segmentação do cliente** Verifique o seguinte: * **Visibilidade (Status de login do cliente)** → se definido para _Apenas os clientes logados_, visitantes que não estão logados não verão o widget (e vice-versa para _Apenas clientes de saída_) * **Visualização do Cliente** → se definido para _Clientes com etiqueta específica_ ou _Clientes com montante específico gasto_, apenas clientes correspondentes irão vê-lo * **Ocultar cliente** → os clientes com a etiqueta selecionada ou o valor de despesa são explicitamente excluídos ⚠️ Exemplo: Se o widget estiver configurado para mostrar apenas para clientes marcados como `VIP`, em seguida, clientes regulares sem `VIP` Tag não vai vê-lo. Tags de clientes e histórico de pedidos também só funcionam para **Clientes registados** — os visitantes logados são tratados como sem etiquetas e sem encomendas. 💡 Para efeitos de ensaio, recomenda-se que: → **Visibilidade → Todos os visitantes** → **Display do cliente → Todos os clientes** → **Ocultar cliente → Nenhum** Isso ajuda a confirmar se o alvo do cliente está causando o problema de visibilidade. --- # **✅ Etapa 9: Verificar a Meta de Geolocalização** Se a Meta de Geolocalização estiver habilitada, o widget só poderá aparecer em países ou regiões selecionados. Abra sua configuração Upsell → **Colocação** tab → **Objectivo da geolocalização** Se **Países específicos** é selecionado, verifique se seu país está incluído na lista permitida. Exemplo: Se apenas _Estados Unidos_ está selecionado e você está navegando da Índia, o widget não será visível para você a menos que você use uma VPN. 💡 Dica: O país detectado é lembrado durante a sua sessão de navegação. Se você mudou de país ou ligou/desligar VPN no meio da sessão, feche a aba completamente e abra a loja novamente em uma sessão nova antes de testar. --- # **✅ Passo 10: Verifique os produtos Upsell** Às vezes o widget carrega corretamente, mas não tem nada para exibir — nesse caso ele se esconde automaticamente. Abra sua configuração Upsell → **Conteúdo** tab → **Selecione produtos upsell** Em seguida, verifique: * **Upsell Produtos específicos / Upsell Colecções específicas** → pelo menos um produto ou coleção é realmente selecionado * Os produtos selecionados (ou os produtos dentro das coleções selecionadas) são **em stock e disponível** — o elemento indica apenas os produtos que podem ser adquiridos * **Upsell mesmo produto (Como na página do produto)** → este tipo só funciona em páginas de produto, uma vez que precisa de um "produto atual" para exibir * **AI Upsell (Comprados Freqüentemente Juntos)** → funciona melhor quando produtos relacionados ou complementares são configurados em ShopifyPesquisa & Discovery app; caso contrário, ele cai de volta para produtos aleatórios da sua loja Exemplo: Se todas as variantes do seu produto upsell selecionado estão fora de estoque, o widget inteiro permanece escondido até que pelo menos um produto fique disponível novamente. --- # **✅ Passo 11: Verifique o Atraso do Tempo no Site** O widget pode ser configurado para aparecer apenas após o visitante ter passado algum tempo na página. Abra sua configuração Upsell → **Colocação** tab → **Segmentação no local** Se **Mostrar depois de algum tempo** está selecionado, o widget só aparecerá após o número configurado de segundos (até 300). Isto não é um erro — mas durante o teste pode parecer que o widget está faltando. Aguarde que o atraso passe, ou mude temporariamente para **Mostrar sempre (Padrão)**. --- # **✅ Passo 12: Atualizar Difícil Sua Página** Às vezes Shopify ou seu navegador armazena temporariamente os ativos do storefront, incluindo a configuração de upsell publicada. Uma atualização dura geralmente corrige isso instantaneamente. ### **Janelas** `Ctrl + Shift + R` ### **Mac** `Cmd + Shift + R` Isso força o navegador a recarregar os ativos mais recentes do storefront em vez de usar versões em cache. ℹ️ Nota: As configurações publicadas podem levar alguns minutos para chegar ao storefront. Se você acabou de publicar, espere um momento e depois se refresque. --- # **✅ Passo 13: Verifique na janela do Incógnito** Certas condições de visibilidade podem se comportar de forma diferente para os visitantes que retornam. Por exemplo: * Cache temporário existente * Dados de localização ou sessão recordados * Ser conectado como cliente (ou não) todos podem mudar se o widget aparece. Tente: * Abrindo sua loja em **Modo Incógnito** * Usando outro navegador * Ensaio noutro dispositivo Isso ajuda a confirmar se o problema está relacionado ao cache/sessão — e se suas configurações de segmentação o tratam de forma diferente de um novo visitante. --- # **✅ Passo 14: Verifique se o tema Styling conflitos** Em alguns casos, o widget está realmente carregando corretamente — mas o estilo do tema pode estar escondendo visualmente. Isto geralmente acontece devido a: * CSS personalizado de outros aplicativos * Substituição do tema * Estilo agressivo de construtores de páginas ou aplicativos de animação * Temas fortemente personalizados onde o ponto de colocação automático não existe Abrir o **Desenho** aba dentro do aplicativo e alterar temporariamente: * Cor de fundo * Cor do texto * Cor do botão Então... **Gravar** muda e atualiza o storefront. Se suas mudanças de estilo ainda não aparecerem, seu tema pode não ter os elementos de colocação padrão que o aplicativo procura (por exemplo, um formulário padrão Adicionar ao Carrinho ou recipiente de carrinho). Nesse caso: * Mudar a colocação para **Posição personalizada** e coloque o widget exatamente onde você quer usando o bloco app (ver Passo 5) * Ou contate sua equipe de suporte ao desenvolvedor / tema --- # **Uma nota rápida sobre o direcionamento da fonte de tráfego (UTM)** Se você tiver usado outro Hoppy apps, você pode estar procurando restrições UTM ou de origem de tráfego. A versão atual de Upsell & Cross Sell faz **não** incluir segmentação baseada em UTM — então a fonte de tráfego nunca pode ser a razão pela qual seu widget está escondido. --- # **Ainda não apareceu?** Se você tentou todos os passos acima e o Upsell & Cross Sell widget ainda não está visível: 1. Gravar novamente a configuração 2. Publicar novamente 3. Reinicie o aplicativo Incorpore e salve o tema 4. Teste em uma página de produto ao vivo (e a página do carrinho / gaveta do carrinho, dependendo do seu tipo de colocação) 5. Teste em Modo Incógnito com **Mostrar Sempre** habilitado Se o problema continuar, não hesite em contactar-nos diretamente de dentro do Hoppy Upsell & Cross Sell app — basta clicar **Suporte de Contato** no painel ou dentro de qualquer página de configuração. Para nos ajudar a solucionar problemas mais rápido, por favor inclua: * Guardar o URL * Tipo de colocação (Página do produto / Cart Page / Cart Gaveta / Posição personalizada) * Imagem da sua configuração * URL da página onde o elemento deverá aparecer * Nome do tema Ficaremos felizes em ajudar. 🙌 ---