Voraussetzung: ein Zugang bei OpenAI, entweder ein Werbekonto für ChatGPT Ads oder die Freischaltung für ChatGPT Shopping. Wie man ihn bekommt, steht auf der Seite Registrierung bei OpenAI (ChatGPT Ads und Shopping).
Installation
Plugin im Shopware Store erwerben oder die ZIP-Datei unter Erweiterungen › Meine Erweiterungen hochladen.
Plugin installieren und aktivieren. Shopware installiert dabei automatisch die benötigte SFTP-Bibliothek (phpseclib) per Composer nach.
Die Konfiguration öffnen: Erweiterungen › Meine Erweiterungen › OpenAI Merchant Feed › Konfigurieren.
Einrichtung mit ChatGPT Ads (empfohlen für DE/EU)
Im ChatGPT Ads Manager einen Advertiser-API-Key mit Berechtigung für Produkt-Feeds erzeugen. Falls Produkt-Feeds für das Konto nicht freigeschaltet sind, beim OpenAI-Account-Team bzw. Support im Ads Manager anfragen.
Oben in der Plugin-Konfiguration den Verkaufskanal wählen, für den der Feed gelten soll. Dann Händlerinformationen und Eigenschaften-Zuordnung ausfüllen (siehe Seite Konfiguration).
Unter OpenAI Ads API den API-Key und die Länder des Feeds eintragen (z. B.
DEoderDE,AT,CH) und speichern.Im Bereich Feed-Status beim Verkaufskanal auf Über Ads API einrichten klicken und bestätigen. Das Plugin legt den Feed im Werbekonto an, aktiviert die Katalog-Ersetzung (gelöschte Produkte verschwinden innerhalb eines Tages), erzeugt die SFTP-Zugangsdaten und speichert sie. Die Seite lädt danach neu.
Verbindung testen und anschließend Feed jetzt erzeugen klicken.
Nach einigen Minuten über Upload-Ergebnisse von OpenAI prüfen, wie viele Produkte OpenAI angenommen oder abgelehnt hat. Danach im Ads Manager eine Produkt-Feed-Kampagne anlegen.
Wichtig: „Über Ads API einrichten“ erzeugt jedes Mal ein neues SFTP-Passwort. Ein zuvor genutztes Passwort für diesen Feed wird dabei ungültig.
Einrichtung mit eigenen SFTP-Zugangsdaten (z. B. ChatGPT Shopping)
Nach der Freischaltung durch OpenAI (Bewerbung über chatgpt.com/merchants) die SFTP-Zugangsdaten bereithalten.
Unter Upload zu OpenAI (SFTP) „Feed per SFTP hochladen“ aktivieren und die Verbindungs-URI eintragen, z. B.
sftp://benutzer@host:22.Authentifizierung wählen: Passwort oder SSH-Schlüssel. Für SSH-Schlüssel den privaten Schlüssel (OpenSSH- oder PEM-Format) eintragen und den öffentlichen Schlüssel bei OpenAI hinterlegen.
Speichern, im Feed-Status Verbindung testen und danach Feed jetzt erzeugen klicken.
Mehrere Verkaufskanäle: Jeder Verkaufskanal braucht einen eigenen Feed bei OpenAI, also eigene SFTP-Zugangsdaten oder einen eigenen Dateinamen. Laden zwei Kanäle in dieselbe Datei hoch, bricht das Plugin den Upload ab, damit sich die Kataloge nicht gegenseitig überschreiben. SFTP- und Ads-Einstellungen deshalb beim jeweiligen Verkaufskanal eintragen, nicht unter „Alle Verkaufskanäle“.
Feed-Status und Kontrolle
Im Bereich Feed-Status der Konfiguration steht je Verkaufskanal: Domain, SFTP-Ziel, letzte Erzeugung (Anzahl Produkte, übersprungene Produkte, Dateigröße), letzter Upload und ein Download-Link zur erzeugten Datei. Die Buttons erzeugen den Feed sofort, testen die Verbindung, richten den Ads-Feed ein oder laden die Upload-Ergebnisse von OpenAI.
Auf der Konsole:
bin/console openai-feed:generate [-s <Verkaufskanal-ID>] [--no-upload]
bin/console openai-feed:status [--test-connection]