ideal.shop

Loslegen

Verbinden Sie Ihren Webshop und überprüfen Sie Search, Recommendations und das Tracking.
ideal.shop integration settings for Clerk.io

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.

  1. Gehen Sie in ideal.shop zu Indstillinger > Integrationer und öffnen Sie Clerk.io.
  2. Öffnen Sie in my.clerk.io Ihren Store und gehen Sie zu Developers > API Keys.
  3. Kopieren Sie den öffentlichen API-Schlüssel in Public API key in ideal.shop.
  4. Kopieren Sie den Legacy Private API-Schlüssel in Private API key.
  5. Aktivieren Sie Aktivér tracking. Aktivieren Sie Feed offentligt nur, wenn Sie den alternativen nativen JSON-Feed verwenden möchten.
  6. 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.

  1. 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.
  2. Richten Sie Recommendations mit geprüften Seiten-IDs und Platzierungszielen ein.
  3. Richten Sie Search für Ihre Desktop- und Mobile-Eingabefelder ein.
  4. 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.