Skip to main content

Shopify V2 -integrointiopas

Tässä osiossa näytetään, kuinka lisätä Kleep AI Sizing Shopify-kauppaasi.

Vaihe vaiheelta videoläpikäynti

Seuraa Tango-opastamme lisätäksesi Kleep-painikkeen kauppaasi Online Store 2.0 -teemoilla.

Shopify V1 -integrointiopas

1. Koon määrittäminen

Tässä osiossa näytetään, kuinka lisätä Kleep AI Sizing Shopify-koodikantaasi.

Haluatko visuaalisen läpikäynnin?

Katso vaihe vaiheelta Tango-opas Kleepin asentamiseen Shopify V1 -kauppaan.

Vaiheet

Vaihe 1: Ota App Embed käyttöön Varmista, että Kleep-sovellus on aktivoitu sovellusupotuksissa. Capture d’écran 2025-08-13 à 14.29.30.png Vaihe 2: Renderöi painikekatkelmä Liitä seuraava koodi sinne, missä haluat Kleepin näkyvän. Sen on oltava osa Product info -lohkoa snippets-kansiossa.
Vaihe 3: Luo painikekatkelmätiedosto Luo uusi tiedosto nimeltä kleep-button.liquid snippets-kansiossasi. Laita seuraava sisältö siihen:
Vaihe 4: Lisää asetuskaaviovaihtoehdot Lisää seuraavat vaihtoehdot asetuskaavioosi sivun loppuun:
Lisätäksesi omia CSS-tyylejä:
  • Muuttaaksesi ulkoasua (värit, välistys, fontit jne.) liitä CSS:si “Input custom CSS styles” -kenttään Kleep App Embed -asetuksissa.
Esimerkiksi: Screenshot 2025-08-13 at 13.25.30.png Vaihe 5: Lisää englanninkieliset käännökset Lisää englanninkieliset käännökset teemasi kieliasetuksiin.
Vaihe 6: Lisää muut kielikäännökset Lisää muut käännökset teemasi kieliasetuksiin.
  1. Validoi päivitykset Shopify-teeman mukauttamisalueella. Konfiguroi visuaaliset asetukset tuotetietolohkon asetuksissa.
  2. Jos haluat lisätä toissijaisen painikkeen, sinun on luotava uusi tiedosto nimeltä kleep-secondary-button.liquid snippets-kansiossasi. Laita seuraava sisältö siihen:
Liitä seuraava koodi sinne, missä haluat Kleepin näkyvän. Sen on oltava osa Product info -lohkoa snippets-kansiossa.

2. Samankaltaiset tuotteet


Asenna “Samankaltaiset tuotteet” V1 Shopify -teemoihin

Tässä tapauksessa sinun on lisättävä Liquid-katkelma manuaalisesti.

Vaihe 1 - Luo katkelma

Luo: snippets/kleep-similar-button.liquid Lisää seuraava koodi:

Vaihe 2 - Renderöi katkelma tuotepohjaan

Lisää tämä rivi sinne, missä haluat painikkeen näkyvän:
Tyypillinen sijoituspaikka: varianttivaihtoehtojen alla tai Lisää ostoskoriin -lomakkeen lähellä.

Vaihe 3 - Ota oikea tila käyttöön V1-teemoille

Koska V1-teemat eivät voi lisätä OS2.0-lohkoja, widgetin on käytettävä jotakin seuraavista:
  • custom_buttons
  • popup+custom
  • button+custom

Asenna “Samankaltaiset tuotteet” V2 (Online Store 2.0) -kaupoille

Nykyaikaiset Shopify-teemat tukevat sovellusupotuksia ja mukautettuja lohkoja. Koodimuutoksia ei tarvita.

Vaihe 1 — Ota Kleep App Embed käyttöön

  1. Siirry kohtaan Verkkokauppa → Teemat → Mukauta.
  2. Avaa Sovellusupotukset-osio.
  3. Ota Kleep-sovellus käyttöön.
  4. Tallenna teema.
Tämä aktivoi ydiskriptin, joka hallinnoi Samankaltaiset tuotteet -logiikkaa. Screenshot 2025-12-09 at 11.55.25.png Seuraavaksi etsi ”Näytä suositellut tuotteet”

Vaihe 2 — Valitse Samankaltaiset tuotteet -näyttötila

Kleep-widgetin konfiguraatiossa valitse, miten Samankaltaiset tuotteet näkyvät tuotesivulla:
  • disabled – poistaa ominaisuuden kokonaan käytöstä
  • popup – lisää automaattisesti ponnahdusikkunan variantti-/kokovaihtoehtojen yläpuolelle työpöydällä ja korvaa oletusnappulan mobiilissa
  • button – lisää automaattisesti CTA-painikkeen Lisää ostoskoriin -alueen lähelle, kun valittu variantti on loppuunmyyty
  • custom_buttons – poistaa kaiken automaattisen sijoittelun; kauppiaan on lisättävä yksi tai useampi “Kleep Similar Button” -lohko manuaalisesti
  • popup+custom – pitää automaattisen ponnahdusikkunan ja ottaa myös käyttöön teemaan lisätyt mukautetut painikkeet
  • button+custom – pitää automaattisen CTA-painikkeen ja ottaa myös käyttöön teemaan lisätyt mukautetut painikkeet
Screenshot 2025-12-09 at 11.48.24.png Sen jälkeen tallenna vain teema, ja se ilmestyy välittömästi kauppaasi (tuotesivu). Vaihe 3 — Lisää mukautetut painikkeet (vain custom_buttons, popup+custom, button+custom) Jos valittu tila sisältää mukautettuja painikkeita:
  1. Avaa Verkkokauppa → Mukauta.
  2. Siirry Tuotesivu-malliin.
  3. Halutussa osiossa napsauta Lisää lohko.
  4. Valitse Kleep Similar Button.
  5. Tallenna teema.
Mukautetut painikkeet näkyvät vain, kun valittu variantti on loppuunmyyty. image.png

Useiden “Samankaltaiset tuotteet” -painikkeiden lisääminen (ensisijainen ja toissijainen)

Voit lisätä minkä tahansa määrän Samankaltaiset tuotteet -painikkeita tuotesivulle. Tämä toimii sekä OS 2.0 -teemoissa että V1/vanhoissa teemoissa.

Ota käyttöön tila, joka tukee mukautettuja painikkeita

Useiden painikkeiden sallimiseksi widgetin on oltava asetettu johonkin seuraavista:
  • custom_buttons
  • popup+custom
  • button+custom
Nämä tilat aktivoivat manuaalisen sijoittelun, joten kauppias voi lisätä niin monta painiketta kuin tarvitaan.

Online Store 2.0 -kaupoille (nykyaikaiset teemat)

OS 2.0 -teemat mahdollistavat painikkeiden lisäämisen visuaalisesti teemaeditorin kautta. Vaiheet:
  • Siirry kohtaan Verkkokauppa → Mukauta
  • Avaa Tuotesivu-malli
  • Napsauta Lisää lohko → Kleep Similar Button
  • Lisää painike mihin tahansa haluamaasi kohtaan
  • Toista, jos haluat 2+ painiketta sivulle
Jokainen painike ilmestyy automaattisesti vain, kun valittu variantti on loppuunmyyty.

V1/vanhoille teemoille

Vanhat teemat eivät tue lohkoja, mutta voit renderöidä katkelman useita kertoja. Lisää tämä katkelma sinne, missä haluat painikkeen: {% render 'kleep-similar-button' %} Useiden painikkeiden luomiseksi sijoita tämä koodi tuotesivupohjan eri alueille. Jokainen katkelmakutsu luo lisäpainikkeen.

Yhteenveto

Useiden Samankaltaiset tuotteet -painikkeiden lisäämiseksi: Ota käyttöön jokin mukautettuja painikkeita tukeva tila → lisää useita OS 2.0 -lohkoja tai useita katkelmakutsuja → kaikki painikkeet toimivat automaattisesti, kun variantti on loppuunmyyty.
CTA:n sijainti PDP:llä Sijainti määritellään DOM-valitsimilla KleepSDK.getConstants()-funktiossa. targetProductInfoBlockQueries – missä tuotetiedot sijaitsevat. Tämä on valitsimien taulukko, joka osoittaa tuotetietojen pääsäiliöön (otsikko, hinta, koot jne.). Skripti iteroi näiden valitsimien läpi ja käyttää ensimmäistä löytämäänsä CTA:n tai ponnahdusikkunoiden lisäyspisteenä. targetVariantQueries – missä koko-/varianttivaihtoehdot sijaitsevat: Kun tuotetietolohko on löydetty, skripti etsii sen sisältä varianttielementtejä (kuten kokovaihtoehtoja). Jokainen variantti <label> (tai vastaava) tulee ponnahdusikkunan CTA:n kiinnityskohteeksi. Ponnahdusikkuna vs. Painike (Työpöytä vs. Mobiili) Laitetyyppi havaitaan checkIfMobile()-funktiolla: Tämä funktio tarkistaa selaimen navigator.userAgent-merkkijonon mobiililaitteiden luetteloa vasten (esim. iPhone, Android, iPad).
  • Jos kyseessä on työpöytä, CTA näytetään hoveraus-ponnahdusikkunoina varianttitunnisteiden vieressä.
  • Jos kyseessä on mobiili, skripti korvaa hoveraus-ponnahdusikkunat yksittäisellä painikkeella, koska hoveraus-vuorovaikutukset eivät toimi kosketusnäytöillä.
Mukauttaminen
  • Muita sijoittelu-/asetteluvaihtoehtoja ei tarjota valitsimien ja CSS:n säätämisen lisäksi.
  • Muuttaaksesi ulkoasua (värit, välistys, fontit jne.) liitä CSS:si “Input custom CSS styles” -kenttään Kleep App Embed -asetuksissa. Screenshot 2025-08-13 at 13.25.30.png

3. Haku


Huomio: Sinun ei tarvitse muuttaa teemakoodia Kleep Searchin asettamiseksi Shopify V1:ssä. Avaa Teemaeditori, ota käyttöön Kleep App Embed, ota käyttöön Mukautettu haku, sitten korvaa oletusnappulan hakublokki Kleep Search -blokilla. Muuttaaksesi ulkoasua (värit, välistys, fontit jne.) liitä CSS:si ”Input custom CSS styles” -kenttään Kleep App Embed -asetuksissa. Kaikki nämä asiat on kuvattu alla Avaa teemaeditori Siirry kohtaan Verkkokauppa > Teemat, etsi teema, jota haluat muokata, ja napsauta Mukauta. Ota Kleep App Embed käyttöön Avaa Sovellusupotukset-osio. Etsi Kleep-sovellus ja kytke se päälle. Ota mukautettu haku käyttöön (valinnainen) Ota Kleep-asetuksissa käyttöön “Enable custom search”. Screenshot 2025-07-28 at 17.17.44.png Korvaa oletusnappulan haku Avaa teemaeditorista Haku-malli (siirry Hakusivun malliin). Screenshot 2025-07-28 at 17.18.59.png Poista tai piilota oletusnappulan hakuosio teemasta. Screenshot 2025-07-28 at 17.19.32.png Lisää Kleep Search -blokki (Sovellukset-välilehdestä) ja sijoita se sinne, missä oletusnappulan haku oli. Screenshot 2025-07-28 at 17.19.48.png Tallenna teemamuutokset. Hakuominaisuus on integroitu Liquid-osiona sovelluksessa, ei erillisenä Liquid-koodina. Aktivointi ohjataan: {% 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%} Tämä varmistaa, että vain tietyt kaupat (toimialueet) voivat ottaa hakuominaisuuden käyttöön.Asettelu ja tyylit
  • Ruudukko- vs. lista-näkymä vaihdetaan vain sovelluksen products_search_grid_layout -asetuksella.
Tee tämä siirtymällä jo lisättyyn hakuun ja oikealla puolella näet konfigurointiasetuksen Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Lisätyylit (fontit, värit, välistys) toteutetaan meiltä koodissa, kauppakohtaisesti, tarvittaessa.
  • Kaikki toiminnallisuus on sidottu tähän Liquid-osioon ja otetaan käyttöön kleep_enable_custom_search-asetuksella sovelluksessa, ei lisäämällä Liquid-koodia teeman asetuksiin.
  • Muuttaaksesi ulkoasua (värit, välistys, fontit jne.) liitä CSS:si “Input custom CSS styles” -kenttään Kleep App Embed -asetuksissa. Screenshot 2025-08-13 at 13.25.30.png

Evästeet ja tietosuoja

Kleep on täysin kävijän suostumuksen takana: skripti latautuu vasta sen jälkeen, kun suostumus on kerätty CMP:n kautta, ja sinun on ehdollistettava sen lataaminen vastaavasti. Täydellinen luettelo seuraimista, käsitellyistä tiedoista, tarkoituksista ja oikeusperusteista, isännöinnistä, alikäsittelijöistä ja tietoturvasta löytyy kohdasta Evästeet, CMP ja tietosuoja.