Magento Integration Guide
Diese Anleitung zeigt dir, wie du Magento 1 (inklusive OpenMage) oder Magento 2 / Adobe Commerce mit Libers Suite verbindest. Libers Suite liest deine Produkte über die Schnittstelle von Magento. Du wählst die Produkte aus, erstellst Knowledge Packs, und Libers Suite schreibt Meta-Title, Meta-Description und Keywords zurück in Magento. Für Schema.org fügst du zusätzlich das Header-Script in dein Theme ein.
Magento 1 und 2
Im Formular wählst du die Version deines Shops. Die Felder passen sich an.
Sichere Freigabe
Bei Magento 1 gibst du den Zugriff in deinem Magento-Admin frei. Dein Passwort gibst du nur dort ein.
Gezielte Auswahl
Du wählst die Produkte aus, die in KI-Suchen sichtbar werden sollen.
Magento 1 / OpenMage
Die Menü- und Button-Namen unten stammen aus der englischen Admin-Oberfläche von OpenMage 20.16. Ist dein Admin auf Deutsch, heisst der Menüpunkt je nach Sprachpaket anders, zum Beispiel Webdienste.
Schritt 1: Magento 1 vorbereiten
Du richtest im Magento-Admin unter System, Web Services drei Dinge ein. Du brauchst dafür deinen Admin-Benutzer.
1. REST-Rolle anlegen
Öffne System, Web Services, REST - Roles und klick auf Add Admin Role. Gib als Namen „Libers Suite“ ein. Im Reiter Role API Resources wählst du bei Resource Access „Custom“ und setzt bei Catalog, Product, Catalog Product die Häkchen bei Retrieve und Update. Im Reiter Role Users wählst du deinen Admin-Benutzer aus. Ist die Liste leer, klick auf Reset Filter. Beim Speichern über Save Role fragt Magento nach Current Admin Password. Damit bestätigst du deine Anmeldung.
2. Produktfelder freigeben
Öffne System, Web Services, REST - Attributes und klick auf Admin. Setz unter Catalog, Product, Catalog Product diese Häkchen:
- Read: SKU, Name, Description, Short Description, Price, Status, URL Key
- Read und Write: Meta Title, Meta Description, Meta Keywords
Nutzt du im Shop-Formular die KI-optimierte Beschreibung, setzt du auch bei Description das Häkchen in der Spalte Write. Speichern.
3. Zugang für Libers Suite anlegen
Öffne System, Web Services, REST - OAuth Consumers und klick auf Add New. Gib als Namen „Libers Suite“ ein. Die Felder Callback URL und Rejected Callback URL lässt du leer. Magento füllt Key und Secret auf diesem Formular bereits aus. Trag Current Admin Password ein und klick auf Save. Key und Secret trägst du im nächsten Schritt in Libers Suite ein.
Schritt 2: Shop in Libers Suite verbinden
Öffne in Libers Suite Shops und leg einen Shop an über Shop hinzufügen. Im Formular klickst du auf Shop erstellen. Einen bestehenden Shop bearbeitest du über Bearbeiten und speicherst über Shop aktualisieren.
Wähl Magento / Adobe Commerce und als Version Magento 1 / OpenMage.
- Shop-URL: die Adresse deines Shops, zum Beispiel https://www.dein-shop.de.
- Admin-URL: die Adresse, unter der du dich im Magento-Admin anmeldest, zum Beispiel https://www.dein-shop.de/meinadmin. Die Adresse beginnt mit https.
- Consumer Key und Consumer Secret aus Schritt 1.
Nach dem Speichern öffnet Libers Suite deinen Magento-Admin. Melde dich an und klick auf Authorize. Danach bist du zurück in Libers Suite und der Shop ist verbunden. Den Button Mit Magento verbinden findest du jederzeit auch auf der Shop-Karte.
Schritt 3: Produkte auswählen
Klick auf der Shop-Karte auf Import per SKU oder Kategorie-ID.
SKU-Liste
Füg die SKUs ein, eine pro Zeile oder mit Komma getrennt, bis zu 500 auf einmal.
Kategorie-ID
Öffne im Magento-Admin Catalog, Manage Categories und klick links im Baum auf die Kategorie. Die ID steht rechts in der Überschrift, zum Beispiel „Zubehör (ID: 42)“. Die Zahl in Klammern im Baum zeigt die Anzahl Produkte. Libers Suite lädt die Produkte, die der Kategorie direkt zugeordnet sind. Für eine Unterkategorie gibst du deren ID ein.
Libers Suite zeigt dir die gefundenen Produkte. Du wählst aus und startest den Import. Produkte ohne SKU zeigt Libers Suite als Anzahl an, importiert werden die Produkte mit SKU.
Synchronisieren auf der Shop-Karte holt den ganzen Katalog. Das passt für kleine Shops.
Zugriff verwalten
Unter System, Web Services, REST - OAuth Authorized Tokens siehst du die Freigabe für Libers Suite. In der Liste wählst du die Aktion Revoke und klickst auf Submit. Für eine neue Freigabe klickst du in Libers Suite auf Mit Magento verbinden.
Magento 2 / Adobe Commerce
Du trägst Benutzername und Passwort eines Admin-Benutzers mit Zugriff auf den Katalog ein. Ist bei deinem Shop die Zwei-Faktor-Anmeldung für Admins aktiv (Standard ab Magento 2.4), richten wir die Verbindung gemeinsam mit dir ein. Schreib uns dazu an hello@libers.ai.
Schritt 2: Shop in Libers Suite verbinden
Öffne in Libers Suite Shops und leg einen Shop an. Einen bestehenden Shop bearbeitest du über Bearbeiten. Wähl Magento / Adobe Commerce und als Version Magento 2 / Adobe Commerce. Trag die Shop-URL ein, zum Beispiel https://www.dein-shop.de, dazu Benutzername und Passwort. Klick auf Shop erstellen. Einen bestehenden Shop speicherst du über Shop aktualisieren.
Schritt 3: Produkte auswählen
Klick auf der Shop-Karte auf Kategorie-Import. Du wählst eine Kategorie und danach die Produkte, die in KI-Suchen sichtbar werden sollen. Synchronisieren auf der Shop-Karte holt den ganzen Katalog. Das passt für kleine Shops.
Knowledge Packs und Tags
Knowledge Packs erstellst und prüfst du wie in der allgemeinen Dokumentation. Bei Magento laufen Meta-Tags und Schema.org über zwei Wege.
Meta-Tags über Magento
Beim Veröffentlichen schreibt Libers Suite Meta-Title, Meta-Description und Keywords in die Magento-Produktfelder. Magento setzt sie in den HTML-Kopf deiner Produktseiten.
Schema.org über das Header-Script
JSON-LD, Open Graph und Twitter-Karten kommen über das Header-Script im Theme.
Magento 1 / OpenMage: System, Configuration, dort unter General der Eintrag Design, Gruppe HTML Head, Feld Miscellaneous Scripts.
Magento 2 / Adobe Commerce: Content, Design, Configuration, HTML Head, Feld Scripts and Style Sheets. Dieser Pfad steht so in der Anleitung zum Header-Script.
Die sichtbare Beschreibung ändert Libers Suite, wenn du im Shop-Formular KI-optimierte Beschreibung einschaltest.
Wenn etwas nicht klappt (Magento 1)
Signatur ungültig
Magento prüft jede Anfrage gegen die eigene Shop-Adresse. Läuft dein Shop hinter einem Proxy oder Load Balancer, muss Magento seine Adresse mit https kennen. Das prüft deine Agentur oder dein Hoster.
Keine Berechtigung
Prüf REST-Rolle, Role Users und REST Attributes aus Schritt 1.
Webserver lässt Änderungen nicht zu
Dein Hoster gibt PUT für /api/rest frei.
Häufige Fragen
Funktioniert das mit Magento 1 und Magento 2?
Ja. Du wählst in Libers Suite Magento / Adobe Commerce und im Formular die Version. Magento 1 inklusive OpenMage verbindest du über einen OAuth Consumer. Danach gibst du den Zugriff in deinem Magento-Admin frei. Bei Magento 2 trägst du Benutzername und Passwort eines Admin-Benutzers mit Zugriff auf den Katalog ein. Ist bei deinem Shop die Zwei-Faktor-Anmeldung für Admins aktiv (Standard ab Magento 2.4), richten wir die Verbindung gemeinsam mit dir ein. Schreib uns dazu an hello@libers.ai.
Werden die Produkte automatisch synchronisiert?
Du startest den Import selbst. Bei Magento 2 über Kategorie-Import, bei Magento 1 per SKU-Liste oder Kategorie-ID. Synchronisieren holt den ganzen Katalog.
Was ist, wenn ich mehrere tausend Produkte habe?
Wähl gezielt die Produkte aus, die in KI-Suchen sichtbar werden sollen. Bei Magento 2 über eine Kategorie, bei Magento 1 per SKU-Liste oder Kategorie-ID. Wie viele Knowledge Packs du erstellen kannst, hängt von deinem Plan ab.
Welche Zugangsdaten brauche ich?
Bei Magento 1 Shop-URL, Admin-URL, Consumer Key und Consumer Secret. Den Consumer legst du unter System, Web Services, REST - OAuth Consumers an. Danach gibst du den Zugriff in Magento frei. Bei Magento 2 trägst du Shop-URL, Benutzername und Passwort eines Admin-Benutzers mit Zugriff auf den Katalog ein. Ist bei deinem Shop die Zwei-Faktor-Anmeldung für Admins aktiv (Standard ab Magento 2.4), richten wir die Verbindung gemeinsam mit dir ein. Schreib uns dazu an hello@libers.ai.
Wie kommen die Tags auf die Magento-Seite?
Beim Veröffentlichen schreibt Libers Suite Meta-Title, Meta-Description und Keywords in die Magento-Produktfelder. Magento setzt sie in den HTML-Kopf deiner Produktseiten. JSON-LD, Open Graph und Twitter-Karten kommen über das Header-Script im Theme.