Loslegen

Verbinden Sie ideal.shop mit Clerk.io über eine KI-Integration für die Datensynchronisierung sowie die integrierte Integration für Clerk.js und Verkaufs-Tracking. Konfigurieren Sie anschließend Search und Recommendations für Ihr Theme.
Integration aktivieren #
Verbinden Sie den passenden Clerk.io Store, bevor Sie Ihre Storefront-Elemente einrichten.
- Gehen Sie in ideal.shop zu Indstillinger > Integrationer und öffnen Sie Clerk.io.
- Öffnen Sie in my.clerk.io Ihren Store und gehen Sie zu Developers > API Keys.
- Kopieren Sie den öffentlichen API-Schlüssel in Public API key in ideal.shop.
- Kopieren Sie den Legacy Private API-Schlüssel in Private API key.
- Aktivieren Sie Aktivér tracking. Aktivieren Sie Feed offentligt nur, wenn Sie den alternativen nativen JSON-Feed verwenden möchten.
- Klicken Sie auf Gem.
Prüfen Sie auf vorhandenen Clerk.js- und Sales-Tracking-Code, bevor Sie etwas manuell hinzufügen. Das gleichzeitige Aktivieren der nativen Integration neben einer separaten Installation kann zu doppelten Anfragen oder Verkaufsevents führen.
Produkte konfigurieren #
Importieren Sie zuerst die Daten, damit Ihre Designs, Filter und Seitenkontexte reale Webshop-Daten verwenden.
- Folgen Sie Sync Data, um einen API-Nutzer zu erstellen, die empfohlene KI-Integration für alle Datentypen zu konfigurieren und Seiten über die Sitemap einzubinden.
- Richten Sie Recommendations mit geprüften Seiten-IDs und Platzierungszielen ein.
- Richten Sie Search für Ihre Desktop- und Mobile-Eingabefelder ein.
- Belassen Sie die Elemente in In preview während des Testens.
Selektoren, Modul-IDs, Layouts und native JavaScript-Funktionen unterscheiden sich je nach Theme. Die Fodmagasinet-Beispiele in diesen Anleitungen zeigen, wie Sie ein Theme untersuchen; überprüfen Sie jeden Wert in Ihrem eigenen Webshop.
Dynamische Navigation #
Einige Themes ersetzen Seiteninhalte, ohne die Seite vollständig neu zu laden. Clerk.io muss die ersetzten Inhalte erkennen und die aktuellen IDs verwenden.
Überprüfen Sie in my.clerk.io Settings > Features > SPA Auto Detect Changes. Damit kann Clerk.js dynamisch geladene Inhalte erkennen. Testen Sie die Navigation nach dem Aktivieren dieser Option: Die Einstellung allein garantiert nicht, dass jedes Theme-Update funktioniert.
Überprüfen Sie die Navigation von Produkt zu Produkt, Kategorisierung, Warenkorb-Updates sowie Zurück/Vorwärts. Wenn Empfehlungen verschwinden oder eine frühere Seiten-ID verwenden, folgen Sie dem navigation FAQ.
Einrichtung überprüfen #
Verwenden Sie diese Checkliste, bevor Sie Elemente von der Vorschau auf Live umstellen. Beachten Sie die allgemeinen Best Practices für Recommendations und Search bei der Auswahl der Experiences.
- Öffnen Sie die gewünschten Seiten mit
?clerk_content_mode=preview(oder&clerk_content_mode=preview, wenn bereits eine Abfrage besteht). Überprüfen Sie den Modus nach nativer Paginierung oder Navigation erneut. - Prüfen Sie Desktop- und Mobile-Layouts: native Seitenbreite, lesbare Karten, klare Preise, scharfe Bilder, funktionierende Slider-Pfeile und kein horizontaler Seitenüberlauf.
- Besuchen Sie zwei verschiedene Produkte, Kategorien und Artikel. Bestätigen Sie, dass jedes Element die aktuelle importierte ID sendet.
- Fügen Sie Produkte zu einem vereinbarten Testwarenkorb hinzu, entfernen oder ändern Sie die Mengen. Bestätigen Sie, dass Empfehlungen die aktuellen Produkt-IDs verwenden und einen leeren Warenkorb verarbeiten.
- Testen Sie Käufe mit Einzelprodukten, erforderliche Variantenauswahlen, nicht verfügbare Produkte und Fehlermeldungen. Stellen Sie anschließend den Testwarenkorb wieder her.
- Öffnen, tippen, schließen und erneut öffnen Sie Search. Testen Sie Escape, Pfeiltasten-Auswahl, Enter und Mobile-Steuerungen. Das Schließen von Search soll die zugrunde liegende Seite und Scroll-Position beibehalten.
- Wiederholen Sie Navigation und Zurück/Vorwärts nach Verwendung von Search. Überprüfen Sie auf fehlende Elemente, veraltete Ergebnisse, doppelte Platzierungen oder doppelte Anfragen des gleichen Elements.
- Bestätigen Sie, dass Clerk.js über die native Integration geladen wird und nur eine Installation den Store initialisiert. Überwachen Sie Browser-Netzwerkanfragen und Konsolenfehler.
- Prüfen Sie das Sales-Tracking anhand einer abgestimmten Testbestellung oder einer bestehenden, abgeschlossenen Bestellung mit Tracking-Nachweis. Überprüfen Sie die Bestell-ID, Produkt-IDs, Mengen, Preise und ein einzelnes Verkaufsevent. Ein erfolgreicher Data Sync allein bestätigt kein Frontend-Tracking.
- Öffnen Sie explizit
?clerk_content_mode=live, um die Vorschau zu beenden. Das Entfernen des Vorschau-Parameters allein kann Vorschau aktiv lassen. Bestätigen Sie das gewünschte Live-Erlebnis.
Halten Sie temporäre Lösungen aus der Standardinstallation fern. Siehe die FAQ für Feed-, Theme- und Navigations-Sonderfälle.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.