Schritt 1: Generieren Sie API-Anmeldedaten in Ihrem VidaXL-Account
Die VidaXL-API verwendet die Mirakl-Plattform. Dies bedeutet, dass Sie ein Mirakl-Konto benötigen, um Ihre Produktangebote an VidaXL zu senden.
Wenn Sie ein Mirakl VidaXL-Konto-Login haben, navigieren Sie zu 'Meine Benutzereinstellungen', indem Sie auf Ihre E-Mail-Adresse in der rechten oberen Ecke klicken. Danach gehen Sie zur Registerkarte 'API-Schlüssel' und wählen 'API-Schlüssel generieren', falls noch kein Schlüssel verfügbar ist. Wenn ein API-Schlüssel verfügbar ist, können Sie diesen verwenden und müssen keinen Neuen erstellen. Kopieren Sie den API-Schlüssel, denn Sie benötigen diesen für den nächsten Schritt.
Als nächstes müssen Sie Ihre Shop-ID in Ihrem Shop-Account finden. Wählen Sie zunächst oben rechts den Shop aus, an welchen Sie Produkte senden möchten. Als nächstes gehen Sie zu Mein Konto > Einstellungen, um Ihre Shop-ID zu finden. Kopieren Sie auch Ihre Shop-ID, Sie benötigen diese ebenfalls für den nächsten Schritt.
Schritt 2: Erstellen Sie eine neue VidaXL-API in Channable
In Channable öffnen Sie Ihr Projekt und gehen zu APIs > Neue API hinzufügen. Es öffnet sich ein neuer Bildschirm mit den API-Einstellungen, wo Sie auf die Schaltfläche '+Verbindung hinzufügen' klicken können.
Sie werden zu einer Übersicht weitergeleitet, in der Sie 'VidaXL' auswählen können, um eine neue Verbindung zu erstellen. Geben Sie unter 'Label' einen Namen für die Verbindung ein, wir empfehlen Ihre Verbindung VidaXL Deutschland oder VidaXL Niederlande zu nennen, je nachdem, mit welchem Land Sie eine Verbindung erstellen. Geben Sie den API-Schlüssel und die Shop-ID ein, die Sie in Schritt 1 kopiert haben und klicken Sie auf die Schaltfläche 'Erstellen', um Ihre Verbindung zu speichern.
Sie werden nun zum Schritt 'Einstellungen' der API zurückgeleitet, wo Sie Ihrer API einen Namen geben können. Nachdem Sie einen Namen gewählt haben, klicken Sie auf die Schaltfläche 'Weiter', um Ihre VidaXL-API fertigzustellen.
Schritt 3: Erstellen Sie Ihre Produktanzeigen in Channable
Sobald Sie die VidaXL-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 von Grund auf. - 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 eingeben möchten. Zum Beispiel sollte das Feld 'Titel' den Titel 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. Ein Beispiel hierzu sehen Sie im untenstehenden Screenshot. Eine genauere Erklärung, was im Schritt 'Attribute' zu tun ist, finden Sie in unserem Support-Artikel über Attribute.
Hinweis: Für VidaXL Belgien und Schweiz möchte VidaXL nur die Angebotsinformationen von Channable und keine inhaltlichen Informationen erhalten. Um nur die Angebote zu senden, überspringen Sie die Schritte 'Kategorien' und 'Attribute' der API und füllen Sie nur die Registerkarte Artikel im 'Aufbau' Schritt der API aus. Weitere Informationen hierzu finden Sie auf der VidaXL-Seite über grenzüberschreitende Verkäufe in gleichsprachigen Ländern.
Schritt 4: Senden Sie Ihre Produktdaten zu VidaXL
Ihre Produktanzeigen sind nun versandfertig. Wenn Sie Ihr Projekt noch nicht aktiviert haben, navigieren Sie auf der linken Seite des Bildschirms zu den 'Einstellungen' und klicken Sie auf 'Projekt aktivieren'. Danach gehen Sie zurück zur Übersicht der APIs und klicken auf 'Ihr VidaXL API-Name' > Einstellungen, wo Sie die API aktivieren, indem Sie 'API aktivieren' wählen. Nachdem Sie diesen Schritt abgeschlossen haben, gehen Sie zurück zur API-Übersicht und wählen Sie die blaue Schaltfläche 'Aktualisieren', um Ihre Produktangebote an VidaXL zu senden.
Schritt 5: Überprüfen Sie Ihre Produktanzeigen auf Fehler
Wenn Sie Ihre Produktangebote an VidaXL geschickt haben, gehen Sie zur Registerkarte 'Vorschau' Ihrer VidaXL-API. Klicken Sie beim Filter auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote Fehler aufweisen und deshalb nicht platziert werden. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Ursache des Fehlers zu erhalten und sehen Sie sich unseren Abschnitt über Fehlerlösungen an, in dem beschrieben wird, wie Fehler korrigiert werden können.
WICHTIG: Wenn Sie neue Listings (d.h. unbekannte EANs) an VidaXL senden, muss der Inhalt, den Sie für die neuen Produkte senden, erst freigegeben werden. Neben der Inhaltsprüfung des Mirakl Marketplaces hat VidaXL auch ein eigenes Freigabetool. Ihre Produkte können deshalb im Schritt 'Resultat' in Channable als 'erfolgreich' angezeigt werden (weil wir sie erfolgreich an VidaXL gesendet haben), aber trotzdem noch nicht live auf VidaXL sein. Das kann daran liegen, dass der Freigabeprozess noch nicht abgeschlossen ist, oder dass der Freigabeprozess in VidaXL zu inhaltlichen Fehlern führt. Sie können sich in Ihr VidaXL-Backend einloggen, um dies zu überprüfen. Für weitere Informationen hierzu, lesen Sie diesen Artikel.