Wie Sie einen Feed aus Mergado mit dem OpenAI Ads Manager verbinden#

Damit Ihre Produkte in Anzeigen in ChatGPT erscheinen können, benötigt der OpenAI Ads Manager Ihren Produktfeed. Mergado bereitet ihn im Format ChatGPT Shopping vor und sorgt dafür, dass er regelmäßig zugestellt wird. Die Konten von Mergado und Ads Manager werden dabei nicht miteinander verknüpft. Mergado sendet lediglich den aktuellen Feed an den Ort, den Sie festlegen.

In diesem Artikel erfahren Sie, welche Anbindungsart Sie wählen sollten, wie Sie die empfohlene Anbindung per SFTP Schritt für Schritt einrichten, sowohl beim Erstellen eines neuen Projekts als auch bei einem bestehenden Projekt, und was zu tun ist, wenn die Produkte im Ads Manager nicht stimmen.

Welche Anbindungsart Sie wählen sollten#

Der Ads Manager bietet beim Erstellen eines Feeds drei Möglichkeiten:

Vor SFTP müssen Sie keine Angst haben. Es klingt technisch, wird aber nur einmal eingerichtet. Die Zugangsdaten erzeugt der Ads Manager für Sie, danach sendet Mergado den Feed selbstständig.

Bevor Sie beginnen#

• Prüfen Sie die Qualität des Feeds im Tool Mergado Audit. Der Ads Manager gibt zu Fehlern in den Daten kaum Rückmeldung, daher ist es besser, sie vorab zu beheben. Am häufigsten fehlt die Beschreibung (description) oder die Marke (brand).
• Öffnen Sie zwei Fenster nebeneinander: Ads Manager und Mergado. Die Zugangsdaten kopieren Sie vom einen ins andere.

Schritt 1: Feed im Ads Manager erstellen#

1. Wechseln Sie im Ads Manager zu Tools → Feeds.
2. Klicken Sie auf Create Feed.
3. Füllen Sie Display name aus, zum Beispiel mit dem Namen des Onlineshops und dem Land.
4. Wählen Sie bei How will you send products? die Option SFTP connection.
5. Klicken Sie auf Create.

Schritt 2: SFTP-Zugangsdaten erzeugen#

Nach dem Erstellen des Feeds öffnet sich das Panel Connect your feed via SFTP.

1. Wählen Sie im Bereich Choose authentication die Anmeldung per Passwort und erzeugen Sie ein Passwort.
2. Kopieren und speichern Sie das Passwort sofort. Nach dem Schließen des Fensters sehen Sie es nicht mehr. Wenn Sie es verlieren, müssen Sie ein neues erzeugen und es auch in Mergado Keychain ändern (siehe FAQ).
3. Im Bereich Add connection details finden Sie die Daten, die Sie in Mergado benötigen:
   • Host: Serveradresse, zum Beispiel sftp.commerce.openai.com oder sftp-prod3.commerce.openai.com
   • Username: eine lange Zeichenkette, die mit oaiproductfeedprod beginnt
   • Upload path: /
   • Port: 443

⚠️ Die Serveradresse (Host) unterscheidet sich von Feed zu Feed. Kopieren Sie sie immer exakt aus dem Ads Manager. Benutzername und Passwort funktionieren für einen anderen Server nicht.

Lassen Sie das Panel geöffnet, Sie kopieren daraus Daten in Mergado.

Schritt 3: Anbindung in Mergado ausfüllen#

Sie können die Anbindung in Mergado auf zwei Arten einrichten, je nachdem, ob Sie das Projekt gerade erst anlegen oder es bereits haben:

• Legen Sie ein neues Projekt an? Dann füllen Sie die Anbindung direkt im Assistenten zur Projekterstellung aus (Variante A). Nachträglich müssen Sie dann nichts mehr einrichten.
• Haben Sie das Projekt bereits, zum Beispiel nur mit der Adresse des Ausgabefeeds und ohne SFTP? Dann ergänzen Sie die Anbindung in den Projekteinstellungen (Variante B).

Variante A: beim Erstellen eines neuen Projekts#

Dieses Vorgehen zeigt das Video:

1. Beginnen Sie mit dem Anlegen eines neuen Projekts gemäß der Anleitung Wie Sie in Mergado ein neues Projekt erstellen.
2. Wählen Sie im Schritt mit der Auswahl des Ausgabeformats das Land und als Ausgabeformat ChatGPT Shopping (zum Beispiel ChatGPT Shopping [CZ] TSV).
3. Aktivieren Sie unter der Formatauswahl den Schalter Upload output feed to OpenAI SFTP (optional) (Ausgabefeed auf OpenAI SFTP hochladen). Die Verbindung zu OpenAI ist bereits vorausgefüllt, Sie müssen nur die Zugangsdaten ergänzen.
4. Füllen Sie Username (Benutzername) aus (den Username aus dem Ads Manager), lassen Sie die Anmeldung per Password (Passwort) ausgewählt und fügen Sie das im Ads Manager erzeugte Passwort ein.
5. Klicken Sie auf Show advanced settings (Erweiterte Einstellungen anzeigen) und prüfen Sie Server URL (Serveradresse). Vorausgefüllt ist sftp.commerce.openai.com. Wenn der Ads Manager für Ihren Feed einen anderen Host angibt, überschreiben Sie die Adresse. Lassen Sie den Port 443 und das Remote-Verzeichnis / unverändert.
6. Führen Sie den Assistenten bis zum Ende fort.

Auf dem letzten Bildschirm des Assistenten sehen Sie eine grüne Meldung, dass die Datei an den externen SFTP-Dienst exportiert wird, samt der Serveradresse. Die Verbindung wird im Hintergrund in Mergado Keychain gespeichert, und Mergado lädt den Feed gleich nach dem ersten Export dorthin hoch. Fahren Sie mit Schritt 4 fort.

Variante B: bei einem bestehenden Projekt#

Auch dieses Vorgehen zeigt ein Video:

1. Öffnen Sie in Mergado das Projekt mit der Ausgabe ChatGPT Shopping und wechseln Sie zu Settings (Einstellungen).
2. Suchen Sie den Bereich SFTP/FTP/FTPS server und klicken Sie auf New connection (Neue Verbindung).
3. Füllen Sie das Formular aus:
   • Connection type (Verbindungstyp): SFTP
   • Username: der Username aus dem Ads Manager
   • Authentication (Anmeldeart): Password
   • Password: das im Ads Manager erzeugte Passwort
   • Server URL: der Host aus dem Ads Manager
   • Port: 443 (überschreiben Sie den Standardwert 22)
   • Remote directory (Remote-Verzeichnis): /
   • File name (Dateiname): beliebig, zum Beispiel chatgpt-shopping-cz
   • Connection name (Verbindungsname): optional, hilft Ihnen, Verbindungen zu unterscheiden, wenn Sie mehrere haben
4. Klicken Sie auf Save (Speichern).

In der Verbindungsübersicht erscheint dann die neue Verbindung mit dem Status Connected (Verbunden). Die Verbindung wird auch in Mergado Keychain gespeichert, sodass Sie sie auch bei weiteren Projekten verwenden können.

💡 In den Projekteinstellungen können Sie eine Verbindung nur erstellen, anzeigen oder trennen. Eine bestehende Verbindung bearbeiten, zum Beispiel das Passwort oder die Serveradresse ändern, können Sie nur in Mergado Keychain.

Schritt 4: Upload prüfen#

1. Klicken Sie bei einem bestehenden Projekt (Variante B) in den Settings des Projekts auf Regenerate changed (Geänderte neu generieren). Mergado erstellt den Export und lädt ihn sofort per SFTP hoch. Bei einem neuen Projekt (Variante A) laufen der erste Export und der Upload nach Abschluss des Assistenten automatisch. Alle weiteren Uploads erfolgen automatisch nach jeder Neugenerierung des Projekts.
2. Prüfen Sie den Upload in Mergado:
   • in der Overview (Übersicht) des Projekts in der Zeile Last upload to external storage (Letzter Upload auf externen Speicher),
   • in der History (Verlauf) des Projekts nach dem Filtern auf das Ereignis External storage (Externer Speicher). Bei einem fehlgeschlagenen Upload sehen Sie hier auch den Grund.
3. Prüfen Sie das Ergebnis im Ads Manager. Im Panel des SFTP-Feeds gibt es den Bereich Upload and verify, der die hochgeladene Datei selbst erkennt und das Ergebnis der Verarbeitung anzeigt. Wenn sich nichts tut, klicken Sie auf Refresh. Die Gesamtzahl der Produkte finden Sie dann unter Tools → Feeds in der Spalte Products, Details zu den einzelnen Uploads im Tab Upload History.

Die Verarbeitung auf Seiten von OpenAI kann eine Weile dauern. Die Produktanzahl wird daher möglicherweise nicht sofort nach dem Upload aktualisiert.

Die Zahlen an beiden Stellen können sich unterscheiden. Upload History zeigt, wie viele Produkte die hochgeladene Datei enthielt, einschließlich nicht vorrätiger Produkte. Die Spalte Products im Tab Feed Connection zeigt nur die Produkte, die OpenAI verarbeitet hat und in Anzeigen verwenden kann. Die genaue Aufschlüsselung sehen Sie, wenn Sie mit der Maus über das Symbol neben der Zahl fahren.

Was tun, wenn etwas nicht funktioniert#

Im Ads Manager sehe ich viel mehr Produkte, als mein Feed enthält#

OpenAI liest alle Dateien ein, die im SFTP-Ordner des Feeds liegen, und zählt die Produkte daraus zusammen. Wenn Sie die Anbindung mehrmals eingerichtet oder den Dateinamen geändert haben, ist auf dem Server eine alte Datei geblieben, deren Produkte weiterhin mitgezählt werden.

Lösung:

• Löschen Sie die alte Datei. Verbinden Sie sich mit denselben Daten wie in Mergado mit dem SFTP-Server, zum Beispiel über FileZilla oder Cyberduck, und löschen Sie alle Dateien außer derjenigen, deren Name dem File name in den Projekteinstellungen entspricht. Die Datei status.json gehört OpenAI, lassen Sie sie liegen.
• Oder beginnen Sie mit einem leeren Feed. Erstellen Sie im Ads Manager einen neuen Feed mit neuen Zugangsdaten, sein Ordner ist leer. Trennen Sie dann in Mergado die alte Verbindung und füllen Sie die neue aus. Kampagnen, die mit dem alten Feed verbunden sind, müssen Sie mit dem neuen verbinden.

Im Ads Manager sehe ich weniger Produkte, als mein Feed enthält#

OpenAI verarbeitet für Anzeigen keine Produkte, die nicht vorrätig sind, also Produkte mit dem Wert out_of_stock im Element availability. Im Tab Upload History sehen Sie sie trotzdem unter den hochgeladenen Produkten, in der Spalte Products im Tab Feed Connection fehlen sie jedoch. Einen kleineren Teil der Differenz machen meist Produkte aus, die OpenAI nicht freigegeben hat. Ihre Anzahl sehen Sie in der Zeile Not approved, wenn Sie mit der Maus über das Symbol neben der Produktanzahl fahren.

Lösung:

• Blenden Sie nicht vorrätige Produkte aus. Erstellen Sie eine Produktauswahl, die nicht vorrätige Produkte anhand des Verfügbarkeitselements in Ihrem Feed auswählt, und verwenden Sie sie in der Regel Produkt ausblenden. Der Feed enthält dann nur Produkte, die in Anzeigen erscheinen können, und die Zahlen in Mergado und im Ads Manager stimmen überein. Sobald ein Produkt wieder vorrätig ist, erscheint es automatisch wieder im Feed.
• Prüfen Sie die nicht freigegebenen Produkte in Mergado Audit. Der Ads Manager nennt den Grund für die Ablehnung meist nicht, am häufigsten fehlen Pflichtangaben wie die Marke.

Der Upload per SFTP funktioniert nicht#

Den Grund des Fehlers sehen Sie in der History des Projekts beim Ereignis External storage. Die häufigsten Ursachen:

• Sie haben das Passwort geändert. Wenn Sie im Ads Manager ein neues Passwort erzeugen, verliert das alte seine Gültigkeit. Ändern Sie das neue Passwort bei der bestehenden SFTP-Verbindung in Mergado Keychain. In den Projekteinstellungen lässt sich die Verbindung nicht bearbeiten.
• Die Serveradresse stimmt nicht. Jeder Feed kann einen anderen Host haben. Vergleichen Sie die Server URL der Verbindung in Mergado Keychain mit dem Wert Host im Ads Manager und korrigieren Sie sie dort gegebenenfalls.
• Falscher Port. OpenAI verwendet den Port 443, nicht den Standardport 22.

Der Feed hat 0 Produkte oder der Ads Manager hat ihn ohne Angabe von Gründen abgelehnt#

Der Ads Manager gibt oft nicht an, was ihn an den Daten stört. Prüfen Sie den Feed in Mergado Audit, das zu jedem Fehler auch das Vorgehen zur Behebung zeigt. Beheben Sie die Fehler dann mit Regeln in Mergado, nicht manuell Produkt für Produkt.

Die Anbindung per Hosted URL lässt sich nicht speichern oder der Feed wird nicht geladen#

Bei der Anbindung per URL kennen wir Fälle, in denen der Ads Manager sie nicht akzeptiert, obwohl derselbe Feed per SFTP problemlos durchgeht. Wenn die URL bei Ihnen nicht funktioniert, wechseln Sie gemäß dieser Anleitung zu SFTP.

Feed oder Bilder werden wegen einer Firewall nicht heruntergeladen#

Wenn Ihr Onlineshop durch Cloudflare oder eine andere Firewall geschützt ist, kann diese das Herunterladen des Eingabefeeds und der Bilder blockieren. Gehen Sie nach der Anleitung Wie Sie Cloudflare einrichten, damit es das Herunterladen von Feeds und Bildern nicht blockiert vor.

FAQ#

Muss ich den Feed per SFTP anbinden?#

Nein, SFTP ist nicht verpflichtend. Sie können den Feed im Ads Manager auch als Hosted URL einfügen. Wir empfehlen jedoch SFTP, weil es zuverlässiger ist und Mergado den Feed nach jeder Neugenerierung dorthin hochlädt.

Kann ich SFTP bei einem bereits bestehenden Projekt ergänzen?#

Ja. Gehen Sie nach Variante B in Schritt 3 vor. Sie müssen das Projekt nicht neu anlegen.

Wie oft wird der Feed im Ads Manager aktualisiert?#

Mergado lädt den aktuellen Feed nach jeder Neugenerierung des Projekts per SFTP hoch. Wann OpenAI ihn verarbeitet, bestimmt der Ads Manager.

Kann ich mehrere Projekte aus Mergado in einen Feed im Ads Manager senden?#

Davon raten wir ab. OpenAI liest alle Dateien im Ordner ein und zählt die Produkte zusammen, sodass sie sich in einem Feed vermischen würden. Erstellen Sie für jedes Projekt einen eigenen Feed im Ads Manager.

Werden die Produkte aus dem Feed auch in den regulären Antworten von ChatGPT angezeigt?#

Nein. Der in den Ads Manager hochgeladene Feed dient nur für bezahlte Anzeigen. Die organische Anzeige von Produkten in ChatGPT ist ein separates Programm von OpenAI.

Ich habe das SFTP-Passwort verloren. Was nun?#

Das Passwort wird im Ads Manager nur einmal angezeigt. Gehen Sie so vor:

1. Erzeugen Sie im Ads Manager in den Einstellungen der SFTP-Verbindung des Feeds ein neues Passwort. Das alte verliert damit seine Gültigkeit.
2. Öffnen Sie in Mergado Mergado Keychain, suchen Sie die bestehende SFTP-Verbindung zu OpenAI und ändern Sie dort das Passwort.
3. Speichern Sie. Bei der nächsten Neugenerierung des Projekts meldet sich Mergado bereits mit dem neuen Passwort an.

Ändern Sie das Passwort in Keychain, nicht in den Projekteinstellungen. Dort lässt sich die Verbindung nicht bearbeiten, Sie können sie nur trennen oder eine neue erstellen.