Möchten Sie interaktiv alle Grundlagen für die Erstellung eines API-Exports erlernen oder wie man ein fortgeschrittenes Setup für eine API in Channable vornimmt? Erfahren Sie in diesem Helpcenter-Artikel, wie Sie ein Channacademy-Konto in der Channable-App erstellen und beginnen Sie mit dem Kurs Basic APIs oder Expert APIs.
Schritt 1: Fügen Sie eine Blokker Connect! Verbindung hinzu
Die Blokker Connect! API nutzt die Mirakl-Plattform, d.h. Sie benötigen einen Mirakl-Account, um Ihre Produktangebote an Blokker Connect! zu senden.
Wenn Sie ein Mirakl Blokker Connect! Konto haben, loggen Sie sich ein und navigieren Sie zu "[Ihr Unternehmen] Einstellungen (oben rechts) > Verbindungen > Verbindung hinzufügen". Klicken Sie auf "+ Verbindung hinzufügen" und Sie gelangen zu einem Bildschirm, auf dem Sie Blokker Connect! auswählen können. Geben Sie ein Label für Ihre Verbindung ein, zum Beispiel: "Blokker Connect!". Klicken Sie dann auf "Verbinden mit Blokker Connect!". Sie werden zu einer Umgebung weitergeleitet, in der Sie sich mit Ihren Mirakl-Zugangsdaten anmelden können. Nach dem Einloggen werden Sie zurück zu Channable weitergeleitet, wo die Verbindung verfügbar sein wird.
Schritt 2: Erstellen Sie eine neue Blokker Connect! API in Channable
Gehen Sie nun zur API-Übersicht in Ihrem Projekt. Klicken Sie auf "+ Neue API hinzufügen", wählen Sie die soeben erstellte Blokker Connect!-Verbindung aus und geben Sie Ihrer neuen API einen Namen.
Wählen Sie das Feld, welches Sie als eigene ID pro Item verwenden möchten (wir empfehlen das Feld "id") und das Land, in dem Sie verkaufen möchten. Sie können hier auch eine Masterregelgruppe hinzufügen, wenn Sie möchten. Klicken Sie auf "Weiter", um die Erstellung der neuen Blokker Connect!-API abzuschließen.
Schritt 3: Erstellen Sie Ihre Produktangebote in Channable
Sobald Sie die Blokker Connect!-API erstellt haben, können Sie Ihre Produktdaten bearbeiten/erstellen, indem Sie den Schritten der API folgen.
-
Kategorien
Damit Ihre Produktdaten erstellt werden können, benötigen Ihre Produkte eine Kategorie. Fügen Sie Kategorien zu Ihren Produkten hinzu, indem Sie die Funktion "Kategorien generieren" verwenden, oder erstellen Sie neue Kategorien manuell. -
Regeln
Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. Beispiele finden Sie in unserem Artikel zur Unterstützung von häufig benutzten Regeln. -
Aufbau
Hier finden Sie unsere vor-eingestellte Vorlage für die Produktanzeigen. Sie brauchen diese lediglich auszufüllen, indem Sie auf das Feld selbst klicken und auswählen, was Sie dort angeben möchten. Zum Beispiel sollte das Feld 'Preis' den Preis Ihres Produktes anzeigen etc. Wenn Sie mit der Einrichtung der Produktanzeigen fertig sind, klicken Sie unten auf dem Bildschirm auf 'Speichern'.Tipp! Beachten Sie das Fragezeichen hinter jedem Feld. Wenn Sie mit der Maus über das Fragezeichen fahren, sehen Sie die Beschreibung des Feldes und Vorschläge für mögliche Werte. -
Attribute
Als nächstes werden die Felder im Schritt 'Attribute' ausgefüllt. Wählen Sie zunächst die Kategorie aus, die Sie optimieren möchten. Eine genauere Erklärung, was im Schritt 'Attribute' zu tun ist, finden Sie in unserem Support-Artikel über Attribute.
Schritt 4: Senden Sie Ihre Produktdaten an Blokker Connect!
Fast fertig, Ihre Produktangebote sind bereit zum Senden! Falls Sie Ihr Projekt noch nicht aktiviert haben, navigieren Sie auf der linken Seite des Bildschirms in den Bereich 'Einstellungen' und klicken Sie auf 'Projekt aktivieren'. Gehen Sie danach zurück zur API-Übersicht und navigieren Sie zu "Ihr Blokker Connect! API-Name" > Einstellungen, wo Sie die API aktivieren, indem Sie 'API aktivieren' wählen. Nachdem Sie diesen Schritt abgeschlossen haben, navigieren Sie zurück zur API-Übersicht und klicken sie auf die Schaltfläche 'Aktualisieren', um Ihre Produktangebote an Blokker Connect! zu senden.
Schritt 5: Prüfen Sie Ihre Produktangebote auf Fehler
Wenn Sie Ihre Produktangebote an Blokker Connect! gesendet haben, klicken Sie auf den Resultat-Schritt Ihrer Blokker Connect! API. Klicken Sie dann auf den Reiter 'Fehler'. Nun können Sie sehen, welche Produktangebote Fehler aufweisen und nicht erstellt worden sind. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Fehlerursache zu erhalten. Wenn Sie einige Fehler durch Änderung der Einstellungen oder Produktinformationen behoben haben, führen Sie die Blocker Connect! API erneut aus, um die neuen Ergebnisse zu sehen.
Best Practices
Hinzufügen mehrerer Attributwerte: Wenn Sie mehrere Werte in ein Attributfeld für Mirakl Marketplaces eingeben, trennen Sie jeden Wert mit dem Pipe-Zeichen "|", um eine korrekte Erkennung und Verarbeitung sicherzustellen.
Die Produkt-ID des Verkäufers für einzelne/einfache Produkte: Bitte beachten Sie, dass es zwei Attribute mit den Bezeichnungen „SellerArticleId“ und „SellerProductId“ gibt. SellerProductId“ bezieht sich auf die übergeordnete ID, während sich ‚SellerArticleId‘ auf die Variantenartikel bezieht. Bei Einzelprodukten ohne Varianten müssen beide Attribute mit demselben Wert gefüllt werden.
Weitere Informationen zu Mirakl Marketplace Fehlern, Anleitungen und Best Practices finden Sie in unserem entsprechenden Artikel. Klicken Sie hier, um mehr zu lesen.