Skip to main content

Guia de Integração Shopify V2

Esta secção mostra como adicionar o Kleep AI Sizing à sua Loja Shopify.

Tutorial em vídeo passo a passo

Siga o nosso tutorial Tango para adicionar o botão Kleep à sua loja em temas Online Store 2.0.

Guia de Integração Shopify V1

1. Dimensionamento

Esta secção mostra como adicionar o Kleep AI Sizing ao código da sua loja Shopify.

Prefere uma demonstração visual?

Veja o tutorial Tango passo a passo para instalar o Kleep numa loja Shopify V1.

Passos

Passo 1: Ativar o App Embed Certifique-se de que a aplicação Kleep está ativada nos seus App embeds. Capture d'écran 2025-08-13 à 14.29.30.png Passo 2: Renderizar o snippet do botão Cole o seguinte código onde pretende que o Kleep apareça. Deve fazer parte do bloco Product info dentro da pasta snippets.
Passo 3: Criar o ficheiro do snippet do botão Crie um novo ficheiro com o nome kleep-button.liquid dentro da pasta snippets. Insira o seguinte conteúdo:
Passo 4: Adicionar opções ao esquema de Definições Adicione as seguintes opções ao seu esquema de Definições no final da página:
Para adicionar os seus próprios estilos CSS:
  • Para alterar o aspeto (cores, espaçamento, tipos de letra, etc.), cole o seu CSS na caixa “Input custom CSS styles” nas definições do Kleep App Embed.
Por exemplo: Screenshot 2025-08-13 at 13.25.30.png Passo 5: Adicionar traduções em inglês Adicione traduções em inglês aos locales do seu tema.
Passo 6: Adicionar traduções noutros idiomas Adicione outras traduções aos locales do seu tema.
  1. Valide as atualizações na área de Personalização do Tema Shopify. Configure os visuais nas definições do bloco de informações do produto.
  2. Se pretender adicionar um botão secundário, terá de criar um novo ficheiro com o nome kleep-secondary-button.liquid dentro da pasta snippets. Insira o seguinte conteúdo:
Cole o seguinte código onde pretende que o Kleep apareça. Deve fazer parte do bloco Product info dentro da pasta snippets.

2. Produtos Similares


Instalar “Produtos Similares” para Temas Shopify V1

Neste caso, deve adicionar um snippet Liquid manualmente.

Passo 1 - Criar um snippet

Crie: snippets/kleep-similar-button.liquid Insira o seguinte código:

Passo 2 - Renderizar o snippet dentro do template de produto

Insira esta linha onde pretende que o botão apareça:
Posição típica: abaixo dos seletores de variante ou perto do formulário Adicionar ao Carrinho.

Passo 3 - Ativar o modo correto para temas V1

Como os temas V1 não podem inserir blocos OS2.0, o widget deve usar um dos seguintes modos:
  • custom_buttons
  • popup+custom
  • button+custom

Instalar “Produtos Similares” para Lojas V2 (Online Store 2.0)

Os temas Shopify modernos suportam app embeds e blocos personalizados. Não são necessárias alterações de código.

Passo 1 — Ativar o Kleep App Embed

  1. Vá a Loja Online → Temas → Personalizar.
  2. Abra a secção App embeds.
  3. Ative a Aplicação Kleep.
  4. Guarde o tema.
Isto ativa o script principal que gere a lógica de Produtos Similares. Screenshot 2025-12-09 at 11.55.25.png Em seguida, localize “Show recommended products”

Passo 2 — Selecionar o modo de visualização de Produtos Similares

Dentro da configuração do widget Kleep, escolha como os Produtos Similares devem aparecer na Página de Produto:
  • disabled – desativa completamente a funcionalidade
  • popup – adiciona automaticamente um popup acima dos seletores de variante/tamanho no ambiente de trabalho, e substitui o botão predefinido no móvel
  • button – insere automaticamente um botão CTA perto da área Adicionar ao Carrinho quando a variante selecionada está esgotada
  • custom_buttons – desativa todo o posicionamento automático; o comerciante deve adicionar um ou mais blocos “Kleep Similar Button” manualmente
  • popup+custom – mantém o popup automático e também ativa quaisquer botões personalizados adicionados no tema
  • button+custom – mantém o botão CTA automático e também ativa quaisquer botões personalizados adicionados no tema
Screenshot 2025-12-09 at 11.48.24.png Depois disso, basta guardar o tema e aparecerá imediatamente na sua loja (página de Produto). Passo 3 — Adicionar Botões Personalizados (apenas para custom_buttons, popup+custom, button+custom) Se o modo selecionado incluir botões personalizados:
  1. Abra Loja Online → Personalizar.
  2. Vá ao template de Página de produto.
  3. Na secção desejada, clique em Adicionar Bloco.
  4. Selecione Kleep Similar Button.
  5. Guarde o tema.
Os botões personalizados só aparecerão quando a variante selecionada estiver esgotada. image.png

Adicionar Múltiplos Botões de “Produtos Similares” (Principal e Secundário)

Pode adicionar qualquer número de botões de Produtos Similares na Página de Produto. Isto funciona tanto para temas OS 2.0 como para temas V1 / legacy.

Ativar um Modo que Suporte Botões Personalizados

Para permitir múltiplos botões, o widget deve estar definido para um dos seguintes modos:
  • custom_buttons
  • popup+custom
  • button+custom
Estes modos ativam o posicionamento manual, para que os comerciantes possam inserir tantos botões quantos necessários.

Para Online Store 2.0 (Temas Modernos)

Os temas OS 2.0 permitem adicionar botões visualmente através do Editor de Tema. Passos:
  • Vá a Loja Online → Personalizar
  • Abra o template de Página de produto
  • Clique em Adicionar bloco → Kleep Similar Button
  • Adicione o botão onde pretender
  • Repita se pretender 2+ botões na página
Todos os botões aparecem automaticamente apenas quando a variante selecionada está esgotada.

Para Temas V1 / Legacy

Os temas legacy não suportam blocos, mas pode renderizar o snippet múltiplas vezes. Insira este snippet onde pretende um botão: {% render 'kleep-similar-button' %} Para criar múltiplos botões, basta colocar este código em diferentes áreas do template de produto. Cada chamada ao snippet cria um botão adicional.

Resumo

Para adicionar múltiplos botões de Produtos Similares: Ative qualquer modo com botões personalizados → adicione vários blocos OS 2.0 ou múltiplas chamadas ao snippet → todos os botões funcionam automaticamente quando a variante está esgotada.
Posição do CTA no PDP A posição é definida por seletores DOM dentro de KleepSDK.getConstants(). targetProductInfoBlockQueries – onde estão as informações do produto. É um array de seletores que apontam para o contentor principal dos detalhes do produto (título, preço, tamanhos, etc.). O script itera por estes seletores e usa o primeiro que encontra como ponto de inserção do CTA ou dos popups. targetVariantQueries – onde estão as opções de tamanho/variante: Uma vez encontrado o bloco de informações do produto, o script pesquisa no seu interior por elementos de variante (como seletores de tamanho). Cada <label> de variante (ou equivalente) torna-se um alvo para fixar o popup CTA. Popup vs. Botão (Ambiente de Trabalho vs. Móvel) Detetamos o tipo de dispositivo usando checkIfMobile(): Esta função verifica a string navigator.userAgent do browser contra uma lista de dispositivos móveis (por exemplo, iPhone, Android, iPad).
  • Se for ambiente de trabalho, o CTA é apresentado como popups ao passar o rato perto das etiquetas de variante.
  • Se for móvel, o script substitui os popups de hover por um único botão, uma vez que as interações de hover não funcionam em ecrãs tácteis.
Personalização
  • Outras variantes de posicionamento/layout não estão disponíveis além do ajuste dos seletores e CSS.
  • Para alterar o aspeto (cores, espaçamento, tipos de letra, etc.), cole o seu CSS na caixa “Input custom CSS styles” nas definições do Kleep App Embed. Screenshot 2025-08-13 at 13.25.30.png

3. Pesquisa


Nota: Não precisa de alterar nenhum código do tema para configurar a Kleep Search no Shopify V1. Abra o Editor de Tema, ative o Kleep App Embed, ative a Pesquisa Personalizada, depois substitua o bloco de pesquisa predefinido pelo bloco Kleep Search. Para alterar o aspeto (cores, espaçamento, tipos de letra, etc.), cole o seu CSS na caixa “Input custom CSS styles” nas definições do Kleep App Embed. Tudo isto será descrito abaixo Abrir o Editor de Tema Vá a Loja Online > Temas, encontre o tema que pretende editar e clique em Personalizar. Ativar o Kleep App Embed Abra a secção App embeds. Encontre a aplicação Kleep e ative-a. Ativar a Pesquisa Personalizada (Opcional) Nas definições do Kleep, ative “Enable custom search”. Screenshot 2025-07-28 at 17.17.44.png Substituir a Pesquisa Predefinida No editor de tema, abra o template de Pesquisa (navegue até ao template da página de Pesquisa). Screenshot 2025-07-28 at 17.18.59.png Remova ou oculte a secção de pesquisa predefinida do tema. Screenshot 2025-07-28 at 17.19.32.png Adicione o bloco Kleep Search (a partir do separador Aplicações) e coloque-o onde estava a pesquisa predefinida. Screenshot 2025-07-28 at 17.19.48.png Guarde as alterações do tema. A funcionalidade de pesquisa está integrada como uma secção Liquid dentro da aplicação, não como código Liquid separado. A ativação é controlada por: {% if block.settings.kleep_enable_custom_search and '[kookai.fr](http://kookai.fr/), [gualap.com](http://gualap.com/), [gualap.fr](http://gualap.fr/), [www.molli.com](http://www.molli.com/), [getkleep.myshopify.com](http://getkleep.myshopify.com/)' contains domain%} Isto garante que apenas lojas específicas (domínios) podem ativar a funcionalidade de pesquisa.Layout e Estilos
  • A alternância entre vista em grelha e lista é controlada apenas através da definição products_search_grid_layout na aplicação.
Para isso, vá à pesquisa que já adicionou e no lado direito verá a opção para a configurar Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Estilos adicionais (tipos de letra, cores, espaçamento) são implementados por nós no código, por loja, se necessário.
  • Toda a funcionalidade está ligada a esta secção Liquid e é ativada via kleep_enable_custom_search na aplicação, não através da adição de código Liquid às definições do tema.
  • Para alterar o aspeto (cores, espaçamento, tipos de letra, etc.), cole o seu CSS na caixa “Input custom CSS styles” nas definições do Kleep App Embed. Screenshot 2025-08-13 at 13.25.30.png

Cookies e privacidade de dados

O Kleep está totalmente condicionado ao consentimento do visitante: o script só carrega após a recolha do consentimento através do seu CMP, e deve condicionar o seu carregamento em conformidade. Para a lista completa de trackers, os dados processados, as finalidades e bases legais, alojamento, subprocessadores e segurança, consulte Cookies, CMP e Privacidade de Dados.