Fehlerbehebung und Support#

Beginnen Sie mit dem fehlerhaften Schritt in Ihrer Visualizer SDK-Integration: Laden des SDK, Zuordnen eines Produkts oder Importieren von Daten. Halten Sie den Anfragekontext verfügbar, ohne Zugangsdaten zu teilen.

Die Schaltfläche im Onlineshop erscheint nicht#

1. Prüfen Sie das Netzwerk-Panel auf https://sdk.ideal.house/sdk.js und untersuchen Sie jeden Ladefehler.
2. Stellen Sie sicher, dass genau ein Loader mit der richtigen Shop ID und dem richtigen Publishable Key vorhanden ist.
3. Öffnen Sie Dashboard → Einstellungen. Prüfen Sie, dass Allowed Origins (CORS) den exakten Origin des getesteten Onlineshops enthält. Klicken Sie nach Änderungen auf Speichern und laden Sie den Onlineshop neu. Prüfen Sie außerdem den exakten Wert von data-product-code am Zielelement. Siehe Origin-Konfiguration.
4. Stellen Sie sicher, dass das Produkt bereit ist und die ausgewählte Variante eine Zuordnung hat.
5. Prüfen Sie bei selbst erstellten Schaltflächen, ob Ihre Styles den validierten aktiven Zustand sichtbar werden lassen.

Machen Sie eine noch nicht validierte Schaltfläche nicht zwangsweise sichtbar, um die Eignungsprüfung zu umgehen. Folgen Sie dem Plattformleitfaden und dem Zuordnungsleitfaden.

Das falsche Produkt wird geöffnet#

Untersuchen Sie das Ziel nach dem Ändern der Variante, dem Öffnen einer Schnellansicht oder der Navigation ohne Neuladen. Räumen Sie veraltete SDK-Attribute gemäß dynamische Seiten auf und stellen Sie sicher, dass Ihr Plattform-Callback tatsächlich ausgeführt wird.

Ein Import wurde angenommen, aber Produkte fehlen#

Eine 202 Accepted-Antwort startet asynchrones Arbeiten. Lesen Sie den Auftragsstatus, untersuchen Sie Elementfehler und verwenden Sie Fehler und Wiederholungsversuche. Der Status-Endpunkt gibt den aktuellen oder letzten Shop-Job zurück; er ist keine Historiensuche nach beliebiger Job-ID.

Was Sie an den Support senden sollten#

Verwenden Sie den während der Onboarding-Phase bereitgestellten Supportkanal oder die Kontaktmöglichkeit in Ihrem Konto. Fügen Sie die betroffene Storefront-URL, die Shop ID (soweit relevant), den Produktcode oder die Import-Job-ID, die ungefähre Zeit, den Browser, das erwartete Ergebnis und die bereinigte Fehlerantwort bei. Entfernen Sie Client Secret, API-Schlüssel, Tokens und private Kundenbilder, bevor Sie Protokolle oder Screenshots teilen.