Hinweis: Bevor Sie diesen Artikel lesen, stellen Sie sicher, dass Sie den Artikel über das Einrichten der Fnac Offers+Orders API gelesen haben.
Wie funktionieren die beiden verschiedenen Fnac-API-Verbindungen?
Diese beiden Verbindungen machen einen Unterschied zwischen Ihrem Angebot und Ihrem Inhalt. Die Offers + Orders API ermöglicht es Ihnen, Produkte, die bereits bei Fnac bekannt sind, auf der Grundlage von EAN-Codes durchzuschicken.
Wenn Ihre EAN-Codes unbekannt sind, zeigt die Offers + Orders API im Vorschau-Schritt einen Fehler namens "ERR_026: Product not found" an. Dies bedeutet, dass Fnac Ihre Produkte nicht kennt und Sie die Produktdaten dieser Produkte der Fnac-Datenbank hinzufügen müssen. Um diese Produktdaten zu Fnac hinzuzufügen, haben wir die Fnac Products-API entwickelt. Befolgen Sie die folgenden Schritte, um solch eine API einzurichten.
Einrichtung der Fnac-Produkte-API
Wichtig! Im Moment ist es möglich, die Fnac Products-API nur für die französischen Fnac-Konten zu verwenden. Wenn Ihr Fnac-Konto aus einem anderen Land stammt, können Sie von Ihrem Konto aus keinen API-Schlüssel erstellen, so dass Sie die API für Fnac-Produkte nicht verwenden können. Um neue Produkte zu versenden, müssen Sie die von Fnac zur Verfügung gestellten Vorlagen verwenden, die Sie von Ihrer Fnac-Kontaktperson erhalten können.
Schritt 1: Generieren Sie Ihre API-Schlüssel in Ihrem Mirakl Fnac-Konto
Die Fnac Products-API verwendet die Mirakl-Plattform, d.h. Sie benötigen ein Mirakl-Konto, um Ihre Produktdaten an Fnac zu senden.
Wenn Sie ein Mirakl Fnac-Konto haben, melden Sie sich an und navigieren Sie zu My user Settings, indem Sie oben rechts auf Ihre E-Mail-Adresse klicken. Danach gehen Sie zur Registerkarte "API key" und klicken auf "generate API key" - falls noch kein Schlüssel verfügbar ist. Wenn ein API-Schlüssel verfügbar ist, können Sie diesen verwenden, Sie müssen keinen neuen erstellen. Kopieren Sie den API-Schlüssel, Sie benötigen diesen für den nächsten Schritt.
Als nächstes müssen Sie Ihre Shop-ID in Ihrer Verkäuferzentrale finden. Wählen Sie zunächst in der oberen rechten Ecke den Shop aus, an den Sie Produkte senden möchten. Als Nächstes gehen Sie zu My Account > Settings, um Ihre Shop-ID zu finden. Kopieren Sie auch Ihre Shop-ID, Sie benötigen diese für den nächsten Schritt.
Schritt 2: Erstellen einer neuen Fnac-Produkte-API in Channable
Gehen Sie zu Channable, öffnen Sie Ihr Projekt und gehen Sie zu APIs > Neue API hinzufügen. Es öffnet sich ein neuer Bildschirm mit den API-Einstellungen, wo Sie auf die Schaltfläche "+ Neue Verbindung hinzufügen" klicken können.
Sie werden zu einer Übersicht weitergeleitet, wo Sie zwei Fnac-Verbindungen sehen, die Sie auswählen können. Achten Sie darauf, die Verbindung mit dem Namen "Fnac Products" auszuwählen, nicht die mit dem Namen "Fnac Offers + Orders".
Geben Sie unter "Label" den Namen für die Verbindung ein, wir empfehlen, die Verbindung Fnac Products-API zu nennen. Füllen Sie den API-Schlüssel und die Shop-ID aus, die Sie in Schritt 1 kopiert haben, und klicken Sie auf die Schaltfläche "Erstellen", um Ihre Verbindung zu speichern.
Sie werden dann zum Schritt API-Einstellungen 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 neue Fnac Products-API zu erstellen.
Schritt 3: Erstellen Sie Ihre Produktdaten in Channable
Nachdem Sie die Fnac Products-API erstellt haben, können Sie Ihre Produktdaten einrichten, indem Sie den Schritten der API folgen.
- Kategorien
Damit Ihre Produktdaten erstellt werden können, benötigen Ihre Produkte eine Kategorie. Fügen Sie Ihren Produkten Kategorien hinzu, indem Sie die Funktion Kategorien generieren verwenden, oder erstellen Sie von Grund auf neue Kategorien. - Regeln
Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. Beispiele finden Sie in unserem Support-Artikel über häufig benutzte Regeln. - Aufbau
Hier finden Sie unsere voreingestellte Vorlage für die Produktlistings. Sie brauchen sie nur auszufüllen, indem Sie auf das Feld selbst klicken und auswählen, was Sie damit verbunden haben möchten. Zum Beispiel sollte das Feld 'Titel' den Titel Ihres Produktes anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktangebote fertig sind, klicken Sie einfach 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
Fast fertig! Als nächstes müssen Sie die Felder im Attribute-Schritt ausfüllen. Wählen Sie zunächst die Kategorie aus, die Sie optimieren möchten. Ein Beispiel für das, was jetzt vor Ihnen liegen sollte, sehen Sie auf dem Screenshot unten. Eine detailliertere Erklärung, was im Schritt "Attribute" zu tun ist, finden Sie in unserem Support-Artikel über den Attribute-Builder.
Schritt 4: Senden Sie Ihre Produktdaten an Fnac
Fast fertig, Ihre Produktlistings sind versandfertig. Wenn Sie Ihren Webshop noch nicht aktiviert haben, gehen Sie zu den Einstellungen auf der linken Seite des Bildschirms und klicken Sie auf 'Webshop aktivieren'. Danach gehen Sie zurück zur API-Übersicht und gehen Sie zu "Ihr Fnac 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 "Jetzt ausführen", um Ihre Produktangebote an Fnac zu senden.
Schritt 5: Prüfen Sie Ihre Produktdaten auf Fehler
Wenn Sie Ihre Produktdaten an Fnac gesendet haben, gehen Sie auf die Registerkarte Vorschau Ihrer Fnac-Produkt-API. Klicken Sie im Filter auf 'Fehler'. Jetzt können Sie sehen, welche Produktlistings Fehler aufweisen und nicht platziert sind. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen darüber zu erhalten, was den Fehler verursacht, und sehen Sie sich unseren Abschnitt Fehlerlösungen an, in dem Sie erfahren, wie Sie Fehler korrigieren können.
Schritt 6: Deaktivieren Sie die Fnac-Produkte-API
Es ist nicht notwendig, dass die Produkt-API die ganze Zeit aktiviert ist, da sie nur für die Aktualisierung des Inhalts der Produkte verwendet wird. Überprüfen Sie den Schritt Vorschau der Fnac Offers+Orders API (wenn Sie noch keine Fnac Offers+Orders-API haben, lesen Sie unseren Support-Artikel), um zu sehen, ob ein Fehler namens "ERR_026: Products not found" vorliegt. Wenn die Vorschau diesen Fehler anzeigt, sollte die Fnac Inhalts-API (die in diesem Artikel beschriebene Fnac-Produkte-API) aktiviert werden. Wenn die Vorschau diesen Fehler nicht anzeigt, sollte die Fnac-Inhalts-API deaktiviert werden.