Skip to main content

Shopify V2 Integrationsguide

Dette afsnit viser, hvordan du tilføjer Kleep AI Sizing til din Shopify-butik.

Trin-for-trin videogennemgang

Følg vores Tango-tutorial for at tilføje Kleep-knappen til din butik på Online Store 2.0-temaer.

Shopify V1 Integrationsguide

1. Sizing

Dette afsnit viser, hvordan du tilføjer Kleep AI Sizing til din Shopify-kodebase.

Foretrækker du en visuel gennemgang?

Se den trin-for-trin Tango-tutorial til installation af Kleep på en Shopify V1-butik.

Trin

Trin 1: Aktiver App Embed Sørg for, at Kleep-appen er aktiveret i dine App embeds. Capture d'écran 2025-08-13 à 14.29.30.png Trin 2: Gengiv knappesnippet Indsæt følgende kode, hvor du ønsker Kleep at vises. Det skal være en del af Product info-blokken i mappen snippets.
Trin 3: Opret knappesnippetfilen Opret en ny fil med navnet kleep-button.liquid i din mappe snippets. Indsæt følgende indhold:
Trin 4: Tilføj indstillingsskemavalg Tilføj følgende valg til dit indstillingsskema i slutningen af siden:
For at tilføje dine egne CSS-stilarter:
  • For at ændre udseendet (farver, afstand, skrifttyper osv.) skal du indsætte din CSS i boksen “Input custom CSS styles” i Kleep App Embed-indstillingerne.
For eksempel: Screenshot 2025-08-13 at 13.25.30.png Trin 5: Tilføj engelske oversættelser Tilføj engelske oversættelser til dine temalokaliseringer.
Trin 6: Tilføj oversættelser til andre sprog Tilføj andre oversættelser til dine temalokaliseringer.
  1. Validér opdateringer i Shopify Theme Customize-området. Konfigurér visuelle elementer i produktinformationsblokindstillingerne.
  2. Hvis du vil tilføje en sekundær knap, skal du oprette en ny fil med navnet kleep-secondary-button.liquid i din mappe snippets. Indsæt følgende indhold:
Indsæt følgende kode, hvor du ønsker Kleep at vises. Det skal være en del af Product info-blokken i mappen snippets.

2. Lignende Produkter


Installer “Lignende Produkter” til V1 Shopify-temaer

I dette tilfælde skal du tilføje et Liquid-snippet manuelt.

Trin 1 - Opret et snippet

Opret: snippets/kleep-similar-button.liquid Indsæt følgende kode:

Trin 2 - Gengiv snippettet inde i produktskabelonen

Indsæt denne linje, hvor du ønsker knappen at vises:
Typisk placering: under variantsvælgerne eller nær formularen Læg i kurv.

Trin 3 - Aktivér den korrekte tilstand til V1-temaer

Da V1-temaer ikke kan indsætte OS2.0-blokke, skal widgetten bruge én af:
  • custom_buttons
  • popup+custom
  • button+custom

Installer “Lignende Produkter” til V2 (Online Store 2.0) Butikker

Moderne Shopify-temaer understøtter app embeds og brugerdefinerede blokke. Der kræves ingen kodeændringer.

Trin 1 — Aktivér Kleep App Embed

  1. Gå til Online Store → Themes → Customize.
  2. Åbn sektionen App embeds.
  3. Aktivér Kleep-appen.
  4. Gem temaet.
Dette aktiverer det centrale script, der styrer logikken for Lignende Produkter. Screenshot 2025-12-09 at 11.55.25.png Find derefter “Show recommended products”

Trin 2 — Vælg visningstilstanden for Lignende Produkter

I Kleep-widgetkonfigurationen skal du vælge, hvordan Lignende Produkter skal vises på produktsiden:
  • disabled – slukker funktionen helt
  • popup – tilføjer automatisk et popup over variant-/størrelsessvælgere på desktop og erstatter standardknappen på mobil
  • button – indsætter automatisk en CTA-knap nær Læg i kurv-området, når den valgte variant er udsolgt
  • custom_buttons – deaktiverer al automatisk placering; forhandleren skal tilføje én eller flere “Kleep Similar Button”-blokke manuelt
  • popup+custom – beholder det automatiske popup og aktiverer også brugerdefinerede knapper tilføjet i temaet
  • button+custom – beholder den automatiske CTA-knap og aktiverer også brugerdefinerede knapper tilføjet i temaet
Screenshot 2025-12-09 at 11.48.24.png Gem derefter blot temaet, og det vil straks vises i din butik (produktside). Trin 3 — Tilføj brugerdefinerede knapper (kun til custom_buttons, popup+custom, button+custom) Hvis din valgte tilstand inkluderer brugerdefinerede knapper:
  1. Åbn Online Store → Customize.
  2. Gå til skabelonen Produktside.
  3. I den ønskede sektion skal du klikke på Tilføj blok.
  4. Vælg Kleep Similar Button.
  5. Gem temaet.
Brugerdefinerede knapper vises kun, når den valgte variant er udsolgt. image.png

Tilføjelse af flere “Lignende Produkter”-knapper (Primær & Sekundær)

Du kan tilføje et vilkårligt antal Lignende Produkter-knapper på produktsiden. Dette fungerer for både OS 2.0-temaer og V1/legacy-temaer.

Aktivér en tilstand, der understøtter brugerdefinerede knapper

For at tillade flere knapper skal widgetten indstilles til én af:
  • custom_buttons
  • popup+custom
  • button+custom
Disse tilstande aktiverer manuel placering, så forhandlere kan indsætte så mange knapper som nødvendigt.

Til Online Store 2.0 (Moderne temaer)

OS 2.0-temaer giver mulighed for at tilføje knapper visuelt via temaredigeringsværktøjet. Trin:
  • Gå til Online Store → Customize
  • Åbn produktsidens skabelon
  • Klik på Tilføj blok → Kleep Similar Button
  • Tilføj knappen, hvor du ønsker den
  • Gentag, hvis du ønsker 2+ knapper på siden
Alle knapper vises automatisk kun, når den valgte variant er udsolgt.

Til V1 / Legacy-temaer

Legacy-temaer understøtter ikke blokke, men du kan gengive snippettet flere gange. Indsæt dette snippet, hvor du ønsker en knap: {% render 'kleep-similar-button' %} For at oprette flere knapper skal du blot placere denne kode på forskellige steder i produktskabelonen. Hvert snippet-kald opretter en ekstra knap.

Oversigt

For at tilføje flere Lignende Produkter-knapper: Aktivér en tilstand med brugerdefinerede knapper → tilføj flere OS 2.0-blokke eller flere snippet-kald → alle knapper fungerer automatisk, når varianten er udsolgt.
CTA-placering på PDP Placeringen er defineret af DOM-selektorer inde i KleepSDK.getConstants(). targetProductInfoBlockQueries – hvor produktinformationen er. Dette er et array af selektorer, der peger på den overordnede container med produktdetaljer (titel, pris, størrelser osv.). Scriptet itererer gennem disse selektorer og bruger den første det finder som indsætningspunkt for CTA’en eller popups. targetVariantQueries – hvor størrelses-/variantvalg er: Når produktinformationsblokken er fundet, søger scriptet inde i den efter variantelementer (som størrelsessvælgere). Hver variant <label> (eller tilsvarende) bliver et mål for tilknytning af popup-CTA’en. Popup vs. Knap (Desktop vs. Mobil) Vi registrerer enhedstypen ved hjælp af checkIfMobile(): Denne funktion tjekker browserens navigator.userAgent-streng mod en liste over mobilenheder (f.eks. iPhone, Android, iPad).
  • Hvis desktop, vises CTA’en som hover-popups ved siden af variantetiketterne.
  • Hvis mobil, erstatter scriptet hover-popups med en enkelt knap, da hover-interaktioner ikke fungerer på touchskærme.
Tilpasning
  • Andre varianter af placering/layout er ikke tilgængelige ud over justering af selektorer og CSS.
  • For at ændre udseendet (farver, afstand, skrifttyper osv.) skal du indsætte din CSS i boksen “Input custom CSS styles” i Kleep App Embed-indstillingerne. Screenshot 2025-08-13 at 13.25.30.png

3. Søgning


Bemærk: Du behøver ikke ændre nogen temakode for at opsætte Kleep-søgning i Shopify V1. Åbn temaredigeringsværktøjet, slå Kleep App Embed til, aktivér Brugerdefineret søgning, og erstat derefter standardsøgeblokken med Kleep-søgeblokken. For at ændre udseendet (farver, afstand, skrifttyper osv.) skal du indsætte din CSS i boksen “Input custom CSS styles” i Kleep App Embed-indstillingerne. Alt dette vil blive beskrevet nedenfor Åbn temaredigeringsværktøjet Gå til Online Store > Themes, find det tema du ønsker at redigere, og klik på Customize. Aktivér Kleep App Embed Åbn sektionen App embeds. Find Kleep-appen og slå den til. Aktivér brugerdefineret søgning (valgfrit) Aktivér “Enable custom search” i Kleep-indstillingerne. Screenshot 2025-07-28 at 17.17.44.png Erstat standardsøgning Fra temaredigeringsværktøjet skal du åbne søgeskabelonen (naviger til søgesidens skabelon). Screenshot 2025-07-28 at 17.18.59.png Fjern eller skjul standardsøgesektionen fra temaet. Screenshot 2025-07-28 at 17.19.32.png Tilføj Kleep-søgeblokken (fra fanen Apps) og placer den, hvor standardsøgningen var. Screenshot 2025-07-28 at 17.19.48.png Gem temaændringerne. Søgefunktionen er integreret som en Liquid-sektion i appen, ikke som separat Liquid-kode. Aktivering styres af: {% 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%} Dette sikrer, at kun specifikke butikker (domæner) kan aktivere søgefunktionen.Layout og stilarter
  • Gitter- vs. listevisning skiftes kun via indstillingen products_search_grid_layout i appen.
For at gøre dette skal du gå til den søgning, du allerede har tilføjet, og på højre side vil du se muligheden for at konfigurere den Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Yderligere stilarter (skrifttyper, farver, afstand) implementeres af os i koden, pr. butik, efter behov.
  • Al funktionalitet er knyttet til denne Liquid-sektion og aktiveret via kleep_enable_custom_search i appen, ikke ved at tilføje Liquid-kode til temaindstillingerne.
  • For at ændre udseendet (farver, afstand, skrifttyper osv.) skal du indsætte din CSS i boksen “Input custom CSS styles” i Kleep App Embed-indstillingerne. Screenshot 2025-08-13 at 13.25.30.png

Cookies og databeskyttelse

Kleep er fuldt ud styret af besøgenes samtykke: scriptet indlæses kun efter samtykke er indsamlet via din CMP, og du skal betinge dets indlæsning derefter. For den komplette liste over trackere, behandlede data, formål og retsgrundlag, hosting, underbehandlere og sikkerhed, se Cookies, CMP & Databeskyttelse.