ChatGPT Produktfeed
Sie können ChatGPT einen Einzelhandelkatalog hochladen bzw. vom Server laden lassen (csv-feed). Unter TOOLS-> SCHNITTSTELLEN exportieren Sie die CSV auf den Server. Zum Test könnten Sie auch den nebenstehenden Link in den Browser kopieren so laden Sie die CSV herunter. Dieser Link ist auch der Link, den Sie bei ChatGPT angeben.
So funktionieren Einzelhandelskataloge
Wenn du den URL-Link für deine gehostete Datenquelle bereitstellst, greifen wir täglich auf deine Datenquelle zu, damit wir für jedes Produkt in deinem Einzelhandelskatalog dynamisch Produkt-Pins erstellen können. Stelle sicher, dass deine aktualisierte Datenquelle jeden Tag verfügbar ist und deine Produktdetails auf dem neuesten Stand sind. Du kannst die Dateneinpflege sogar im Voraus planen.
Wenn du deine Datenquelle manuell hochlädst, greifen wir auf deine Datenquelle zu, wenn sie hochgeladen wird, und jedes Mal, wenn du eine aktualisierte Datenquelle hochlädst, damit wir für jedes Produkt in deinem Einzelhandelskatalog Produkt-Pins erstellen oder die Metadaten für vorhandene Pins aktualisieren können.
Fehler sollten so schnell wie möglich geprüft und behoben werden, um sicherzustellen, dass deine Produktinformationen genau und aktuell sind. Ein Fehler kann bedeuten, dass der gesamte Feed nicht aktualisiert wird, dass einige Artikel im Feed nicht aktualisiert werden oder dass du ein paar Änderungen an der Formatierung vornehmen musst.
Datenquelle vorbereiten
Anforderungen an das Hosting von Datenquellen.
Das ist nur relevant, wenn du keinen Flow® Mietshop hast und deine Datenquelle selbst hostest. Wenn du deine Datenquelle manuell hochlädst, kannst du diesen Abschnitt ebenfalls überspringen.
Hoste deine eigene Datenquelle auf einem FTP-/SFTP-/WebDAV-Server oder mit einem direkten HTTP-/HTTPS-Link zum Herunterladen. Der Speicherort muss für einen User Agent zugänglich sein und darf nicht erfordern, dass IP-Adressen oder SSH-Schlüssel auf eine Whitelist gesetzt werden. Falls du einen direkten Link zum Herunterladen verwendest, darf keine zusätzliche Navigation erforderlich sein, damit ChatGPT auf die Datei zugreifen kann.
Integrationsübersicht
Bevor Sie Produktdaten angeben, müssen sich Händler unter chatgpt.com/merchants anmelden.
Dateiformat
Unterstützte Formate sind jsonl.gz und csv.gz (gzip-komprimiert).
Der von uns zur Verfügung gestellte Feed ist daher eine gezippte CSV-Datei.
Häufigkeit aktualisieren
Das OpenAi-System akzeptiert alle 15 Minuten Updates.
Anfangslast
Senden Sie ein Beispiel oder einen vollständigen Anfangsfeed, damit unser Indexierungsteam das Parsing validieren kann, bevor Live-Updates beginnen.
Feldreferenz
Um Ihre Produkte in ChatGPT auffindbar und käuflich zu machen, bieten Händler einen strukturierten Produktfeed an, den OpenAI erfasst und indiziert. Diese Spezifikation definiert das vollständige Schema: Feldnamen, Datentypen, Einschränkungen und Beispielwerte, die für genaue Suche, Preisgestaltung und Checkout-Erfahrungen benötigt werden.
Jede Tabelle unten gruppiert Attribute nach Kategorie (Basisdaten, Medien, Preise usw.) und gibt deutlich an, ob ein Feld erforderlich, empfohlen oder optional ist, zusammen mit Validierungsregeln, die Ihrem Engineering-Team helfen, einen konformen Feed zu erstellen und zu pflegen.
Die Bereitstellung aller erforderlichen Felder stellt sicher, dass Ihre Produkte korrekt angezeigt werden können, während empfohlene Felder Relevanz und Benutzervertrauen bereichern.
OpenAI Flags
Verwenden Sie diese Flags, um zu steuern, ob ein Produkt in ChatGPT auffindbar und/oder erhältlich ist. Diese Felder haben keinen Einfluss darauf, wie das Produkt auf Ihrer eigenen Website angezeigt wird, sondern aktivieren oder deaktivieren einfach die ChatGPT-Integrationen.
Die Variable "enable_checkout" ist auf "false" eingestellt, damit die Produktdaten auch ohne Inkäufe von ChatGPT (ohne ChatGPT-Checkout-.API) funktionieren.
CSV/Datenfeed-Aufbau
In der CSV sind die Tabellentrenner Kommas.
| Attribut | Beschreibung | Beispiel | Anforderung | Regeln |
| item_id | Artikel-ID | 12-1 | notwendig | max 100 Zeichen; muss mit der Zeit stabil bleiben |
| gtin | GTIN / UPC / ISBN | 123456789543 | optional | 8–14 Ziffern; keine Bindestriche oder Leerzeichen |
| mpn | Mpn Teilenummer | optional | max 70 Zeichen | |
| title | Artikelname | Krawatte | notwendig | maximal 150 Zeichen; bitte keine Großbuchstaben verwenden. |
| description | Artikelbeschreibung | Waterproof trail shoe with cushioned sole… | notwendig | maximal 5.000 Zeichen; nur Klartext |
| url | Link zur Artikeldetailseite | https://example.com/product/SKU12345 | notwendig | muss https haben |
| condition | Zustand des Artikels (neu bzw. gebraucht) | new | optional | Kleinbuchstaben (new bzw. used) |
| product_category | Kategoriepfad des Shops | Apparel & Accessories > Shoes | optional | Trennzeichen: > |
| brand | Marke | OpenAI | notwendig | maximal 70 Zeichen |
| image_url | Titelbild | https://example.com/image1.jpg | notwendig | jpeg/png; https bevorzugt |
| additional_image_urls | Zusätzliche Artikelbilder | https://example.com/image2.jpg,… | optional | Kommagetrennte Liste |
| video_url | Artikel-Video | https://example.com/image1.mp4 | optional | muss öffentlich zugänglich sein |
| price | regulärer Preis | 79.99 EUR | notwendig | |
| sale_price | reduzierter Preis | 59.99 EUR | optional | muss ≤ als reglülärer Preis sein |
| availability | Lagerstand | in_stock | notwendig | in_stock bzw. out_of_stock |
| group_id | Variantengruppen-ID | 1 | notwendig | max 70 Zeichen |
| listing_has_variations | wenn der Artikel Varianten hat | true | notwendig | true bzw. false |
| store_name | Shopname | Example Store | notwendig | max, 70 Zeichen |
| seller_url | Verkäufershop-URL | https://example.com/store | notwendig | |
| seller_privacy_policy | Link zur Datenschutzerklärung | https://example.com/privacy | optional | nur notwendig, wenn "is_eligible_checkout" auf "true" ist |
| seller_tos | Link zur AGB | https://example.com/terms | optional | nur notwendig, wenn "is_eligible_checkout" auf "true" ist |
| return_policy | Link zur Widerrufserklärung | https://example.com/returns | notwendig | https bevorzugt |
| return_window | Widerrufszeit | 14 | notwendig | positive ganze Zahl. Diese ist auf 14 Tage festgelegt, da es keine artikelbezogene individuelle Einstellung gibt. Änderungen könnten manuell nach dem Export vorgenommen werden |
| target_countries | Zielländer des Artikels (erster Eintrag verwendet) | DE | notwendig | ISO 3166-1 Alpha-2-Codes |
| store_country | Land, in dem der Artikel gelagert wurde | DE | notwendig | ISO 3166-1 Alpha-2-Codes |
| is_eligible_search | damit Artikel in der ChatGPT-Suche berücksichtig werden | true | notwendig | true bzw. false |
| is_eligible_checkout | In-Käufe über OpenAI muss deaktiv sein | false | notwendig | true bzw. false |
Richtlinie für verbotene Produkte
Um ChatGPT zu einem sicheren Ort für alle zu machen, erlaubt OpenAI (ChatGPT) nur Produkte und Dienstleistungen, die legal, sicher und für ein allgemeines Publikum geeignet sind. Verbotene Produkte umfassen unter anderem Inhalte für Erwachsene, Produkte mit Altersbeschränkung (z. B. Alkohol, Nikotin, Glücksspiel), schädliche oder gefährliche Stoffe, Waffen, verschreibungspflichtige Medikamente, nicht lizenzierte Finanzprodukte, gesetzlich beschränkte Waren, illegale Aktivitäten oder irreführende Geschäftspraktiken.
Händler sind dafür verantwortlich, dass ihre Produkte und Inhalte nicht gegen die oben genannten Bestimmungen oder geltendes Recht verstoßen. OpenAI behält sich das Recht vor, bei Verstößen gegen diese Richtlinien Korrekturmaßnahmen zu ergreifen, wie z. B. die Entfernung eines Produkts oder den Ausschluss eines Händlers von ChatGPT.
Für Entwickler
API-Doku-Link: https://developers.openai.com/commerce/specs/feed
