Skip to main content

Guia de Integração Shopify V2

Esta seção mostra como adicionar o Kleep AI Sizing à sua loja Shopify.

Tutorial em vídeo passo a passo

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

Guia de Integração Shopify V1

1. Dimensionamento

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

Prefere um tutorial visual?

Assista ao tutorial passo a passo do Tango para instalar o Kleep em uma loja Shopify V1.

Passos

Passo 1: Ativar o App Embed Certifique-se de que o aplicativo Kleep está ativado nos seus App embeds. Capture d'écran 2025-08-13 à 14.29.30.png Passo 2: Renderizar o trecho do botão Cole o código a seguir onde deseja que o Kleep apareça. Deve fazer parte do bloco Product info dentro da pasta snippets.
Passo 3: Criar o arquivo do trecho do botão Crie um novo arquivo chamado kleep-button.liquid dentro da pasta snippets. Coloque o seguinte conteúdo:
Passo 4: Adicionar opções ao esquema de configurações Adicione as seguintes opções ao seu esquema de configurações no final da página:
Para adicionar seus próprios estilos CSS:
  • Para alterar a aparência (cores, espaçamento, fontes, etc.), cole seu CSS na caixa “Input custom CSS styles” nas configuraçõ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 em outros idiomas Adicione outras traduções aos locales do seu tema.
  1. Valide as atualizações na área de personalização de temas do Shopify. Configure os visuais nas configurações do bloco de informações do produto.
  2. Se quiser adicionar um botão secundário, você precisará criar um novo arquivo chamado kleep-secondary-button.liquid dentro da pasta snippets. Coloque o seguinte conteúdo:
Cole o código a seguir onde deseja 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, você deve adicionar um trecho Liquid manualmente.

Passo 1 - Criar um trecho

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

Passo 2 - Renderizar o trecho no template de produto

Insira esta linha onde deseja que o botão apareça:
Posicionamento típico: abaixo dos seletores de variante ou próximo ao formulário de Adicionar ao Carrinho.

Passo 3 - Ativar o modo correto para temas V1

Como os temas V1 não suportam 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)

Temas modernos do Shopify suportam app embeds e blocos personalizados. Nenhuma alteração de código é necessária.

Passo 1 — Ativar o App Embed do Kleep

  1. Vá em Loja Online → Temas → Personalizar.
  2. Abra a seção App embeds.
  3. Ative o Aplicativo Kleep.
  4. Salve o tema.
Isso ativa o script principal que gerencia a lógica de Produtos Similares. Screenshot 2025-12-09 at 11.55.25.png Em seguida, localize a opção “Mostrar produtos recomendados”

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

Nas configurações do widget Kleep, escolha como os Produtos Similares devem aparecer na Página do Produto:
  • disabled – desativa completamente o recurso
  • popup – adiciona automaticamente um popup acima dos seletores de variante/tamanho no desktop e substitui o botão padrão no mobile
  • button – insere automaticamente um botão CTA próximo à área de Adicionar ao Carrinho quando a variante selecionada está fora de estoque
  • custom_buttons – desativa todo o posicionamento automático; o lojista 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 ao tema
  • button+custom – mantém o botão CTA automático e também ativa quaisquer botões personalizados adicionados ao tema
Screenshot 2025-12-09 at 11.48.24.png Depois disso, basta salvar o tema e ele aparecerá imediatamente na sua loja (página do 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á para o template de Página do produto.
  3. Na seção desejada, clique em Adicionar Bloco.
  4. Selecione Kleep Similar Button.
  5. Salve o tema.
Os botões personalizados aparecerão apenas quando a variante selecionada estiver fora de estoque. image.png

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

Você pode adicionar qualquer número de botões de Produtos Similares na Página do Produto. Isso funciona tanto para temas OS 2.0 quanto para temas V1 / legados.

Ativar um Modo que Suporte Botões Personalizados

Para permitir múltiplos botões, o widget deve ser configurado para um dos seguintes modos:
  • custom_buttons
  • popup+custom
  • button+custom
Esses modos ativam o posicionamento manual, permitindo que os lojistas insiram quantos botões forem necessários.

Para Online Store 2.0 (Temas Modernos)

Os temas OS 2.0 permitem adicionar botões visualmente pelo Editor de Temas. Passos:
  • Vá em Loja Online → Personalizar
  • Abra o template de Página do produto
  • Clique em Adicionar bloco → Kleep Similar Button
  • Adicione o botão onde quiser
  • Repita se desejar 2+ botões na página
Cada botão aparece automaticamente apenas quando a variante selecionada está fora de estoque.

Para Temas V1 / Legados

Temas legados não suportam blocos, mas você pode renderizar o trecho várias vezes. Insira este trecho onde quiser 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 do trecho 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 de trecho → todos os botões funcionam automaticamente quando a variante está fora de estoque.
Localização do CTA na PDP A localização é definida por seletores DOM dentro de KleepSDK.getConstants(). targetProductInfoBlockQueries – onde está a informação do produto. Este é um array de seletores que apontam para o contêiner principal dos detalhes do produto (título, preço, tamanhos, etc.). O script itera por esses seletores e usa o primeiro encontrado como ponto de inserção para o CTA ou popups. targetVariantQueries – onde estão as opções de tamanho/variante: Após encontrar o bloco de informações do produto, o script busca dentro dele elementos de variante (como seletores de tamanho). Cada <label> de variante (ou equivalente) torna-se um alvo para anexar o CTA popup. Popup vs. Botão (Desktop vs. Mobile) Detectamos o tipo de dispositivo usando checkIfMobile(): Esta função verifica a string navigator.userAgent do navegador em relação a uma lista de dispositivos móveis (ex.: iPhone, Android, iPad).
  • Se for desktop, o CTA é exibido como popups ao passar o mouse sobre os rótulos de variante.
  • Se for mobile, o script substitui os popups de hover por um único botão, pois interações de hover não funcionam em telas touch.
Personalização
  • Outras variantes de posicionamento/layout não são fornecidas além do ajuste de seletores e CSS.
  • Para alterar a aparência (cores, espaçamento, fontes, etc.), cole seu CSS no campo “Input custom CSS styles” nas configurações do Kleep App Embed. Screenshot 2025-08-13 at 13.25.30.png

3. Busca


Nota: Não é necessário alterar nenhum código do tema para configurar o Kleep Search no Shopify V1. Abra o Editor de Temas, ative o Kleep App Embed, habilite o Custom Search e substitua o bloco de busca padrão pelo bloco Kleep Search. Para alterar a aparência (cores, espaçamento, fontes, etc.), cole seu CSS no campo “Input custom CSS styles” nas configurações do Kleep App Embed. Tudo isso será descrito abaixo Abrir Editor de Temas Vá em Loja Online > Temas, encontre o tema que deseja editar e clique em Personalizar. Ativar App Embed do Kleep Abra a seção App embeds. Encontre o aplicativo Kleep e ative-o. Ativar Custom Search (Opcional) Nas configurações do Kleep, ative “Enable custom search”. Screenshot 2025-07-28 at 17.17.44.png Substituir Busca Padrão No editor de temas, abra o template de Busca (navegue até o template da página de Busca). Screenshot 2025-07-28 at 17.18.59.png Remova ou oculte a seção de busca padrão do tema. Screenshot 2025-07-28 at 17.19.32.png Adicione o bloco Kleep Search (da aba Apps) e posicione-o onde estava a busca padrão. Screenshot 2025-07-28 at 17.19.48.png Salve as alterações do tema. O recurso de busca é integrado como uma seção Liquid dentro do aplicativo, não como um 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%} Isso garante que apenas lojas específicas (domínios) possam ativar o recurso de busca.Layout e Estilos
  • A visualização em grade vs. lista é alternada apenas pela configuração products_search_grid_layout no aplicativo.
Para isso, vá até a busca que você já adicionou e no lado direito você verá a opção de configurá-la Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Estilos adicionais (fontes, cores, espaçamento) são implementados por nós no código, por loja, se necessário.
  • Toda a funcionalidade está vinculada a esta seção Liquid e ativada via kleep_enable_custom_search no aplicativo, não adicionando código Liquid às configurações do tema.
  • Para alterar a aparência (cores, espaçamento, fontes, etc.), cole seu CSS no campo “Input custom CSS styles” nas configurações do Kleep App Embed. Screenshot 2025-08-13 at 13.25.30.png

Cookies e privacidade de dados

O Kleep é totalmente controlado pelo consentimento do visitante: o script só carrega após a coleta do consentimento pela sua CMP, e você deve condicionar o carregamento de acordo. Para a lista completa de rastreadores, os dados processados, as finalidades e bases legais, hospedagem, suboperadores e segurança, consulte Cookies, CMP e Privacidade de Dados.