ProduktkatalogPrivate Vorschau

Erfahren Sie, wie Sie strukturierte Produkt- und Bestandsdaten zur Erkennung von KI-Agenten mit Stripe teilen.

Verwenden Sie die Produktspezifikation und die Bestandsfeed-Spezifikation, um strukturierte Produkt- und Bestandsdaten mit Stripe zu teilen und Ihren Katalog an KI-Agenten für die Suche und den Einkauf zu verteilen. Sie können mit einer vollständigen Einreichung des Produktfeeds beginnen und dann inkrementelle Bestandsfeed-Updates senden, um Lagerbestände und Verfügbarkeit auf dem neuesten Stand zu halten.

Produktfeed-Spezifikation

Verwenden Sie den Produktfeed, um Ihren vollständigen strukturierten Katalog bereitzustellen (z. B. Titel, Beschreibungen, Kennungen, Preise, Ausführung und Medien). Jede Zeile stellt ein Produkt oder eine Variante dar.

Feed vorbereiten: Formatieren Sie Ihren Katalog mithilfe der Feldreferenz in diesem Dokument. Jedes Feld enthält Beispielwerte, Validierungsregeln und Angaben dazu, ob es erforderlich, empfohlen oder optional ist.
Feed übermitteln: Senden Sie den Feed sicher über die Stripe API im CSV-Format (Details zur Integration folgen). Jede Zeile stellt ein Produkt oder eine Variante dar. Reichen Sie einen vollständigen Erstfeed an den Sandbox-Endpoint ein, um sicherzustellen, dass Ihre Daten korrekt analysiert (geparst) werden und alle Feldanforderungen erfüllen, bevor Sie in die Produktion gehen.
Indizieren und Bereinigen Ihrer Daten: Wir validieren und bereinigen Ihre Daten, indizieren sie im Stripe-Katalog und konvertieren sie in das Format, das jeder Agent benötigt.
Keep your data current: Refresh your feed frequently. Any changes to product attributes, pricing, or fulfillment details should be updated as soon as they occur to maintain customer trust and prevent stale listings.

Feedverarbeitungsmodus

Beim Hochladen von Produktfeeds wird der Modus upert verwendet, wobei jede Zeile eine Einfügung oder Aktualisierung für ein Produkt darstellt, das durch seine ID identifiziert wird.

Wenn die ID nicht existiert, erstellen wir das Produkt.
Wenn die ID bereits vorhanden ist, aktualisieren wir das Produkt mit den in dieser Zeile angegebenen Werten.
Nicht in der Datei enthaltene Produkte bleiben unverändert.

Löschverhalten

Um ein Produkt oder eine Variante über den Feed zu entfernen, fügen Sie die optionale Spalte delete in Ihre CSV ein. Legen Sie für alle Produkte, die Sie löschen möchten, true fest. Legen Sie für Produkte, die Sie behalten möchten, false fest oder lassen Sie das Feld leer.

Feldreferenz für Produktkatalog

In den folgenden Abschnitten prüfen Sie das vollständige Schema, das vom Stripe-Katalog verwendet wird. In jeder Tabelle sind Datentypen, Beispiele und Anforderungen aufgeführt.

Grundlegende Produktdaten

Geben Sie die wesentlichen Kennungen und den beschreibenden Text an, die jedes Produkt eindeutig definieren.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
ID	Zeichenfolge (alphanumerisch)	`SKU12AB3456`	Erforderlich	Die eindeutige Kennung Ihres Produkts Verwenden Sie nach Möglichkeit die SKU des Produkts Maximal 100 Zeichen Lassen Sie die ID beim Aktualisieren Ihrer Daten gleich
Titel	Zeichenfolge (UTF-8-Text)	`Mens Floral Polo Shirt`	Erforderlich	Titel Ihres Produkts Beschreiben Sie Ihr Produkt genau und stimmen Sie die Beschreibung mit dem Titel auf Ihrer Zielseite ab. Maximal 150 Zeichen Durchgehende Großbuchstaben vermeiden
Beschreibung	Zeichenfolge (UTF-8-Text)	`Bring a burst of fun to your golf game with this Men's Floral Polo`	Erforderlich	Beschreibung Ihres Produkts Geben Sie nur Informationen über das Produkt an. Fügen Sie keine Links zu Ihrem Shop, Verkaufsinformationen, Details zu Wettbewerbern, anderen Produkten oder Zubehör hinzu Maximal 5000 Zeichen Nur Klartext
Link	URL (RFC 1738)	`https://example.com/product/SKU12AB3456`	Erforderlich	Zielseite Ihres Produkts Ihren Verifizierten Domainnamen verwenden Beginnen Sie mit `http` oder `https` (`https` bevorzugt) Muss mit `http` 200 aufgelöst werden (keine defekten Links)

Produktkennungen

Verwenden Sie diese weltweit bekannten Kennungen, um Ihre Produkte für die Suche und die Zuordnung zu differenzieren.

Feld Datentyp Beispiel Anforderung Hinweise

Feld	Datentyp	Beispiel	Anforderung	Hinweise
Marke	Zeichenfolge	`Stripe`	Erforderlich für alles außer bei Filmen, Büchern und Marken von Musikaufnahmen	Der Markenname Ihres Produkts Geben Sie den Markennamen des Produkts an, der von den Verbraucherinnen und Verbrauchern allgemein erkannt wird. Maximal 70 Zeichen
GTIN	Zeichenfolge (Numerische GTIN, UPC, ISBN)	`3234567890126`	Empfohlen	Die weltweit eindeutige Identifikationsnummer für Ihr Produkt („Global Trade Item Number“, GTIN) Maximal 50 Zeichen Bindestriche und Leerzeichen ausschließen
MPN	Zeichenfolge (alphanumerisch)	`STR12345`	Erforderlich, wenn GTIN fehlt	Hersteller-Teilenummer (MPN) Ihres Produkts Reichen Sie nur vom Hersteller zugewiesene MPNs ein Maximal 70 Zeichen

Marke

Zeichenfolge

Stripe

Erforderlich für alles außer bei Filmen, Büchern und Marken von Musikaufnahmen

Der Markenname Ihres Produkts

Geben Sie den Markennamen des Produkts an, der von den Verbraucherinnen und Verbrauchern allgemein erkannt wird.
Maximal 70 Zeichen

GTIN

Zeichenfolge

(Numerische GTIN, UPC, ISBN)

3234567890126

Medien

Stellen Sie visuelle und optionale Rich Media zur Verfügung, um das Produkt genau darzustellen.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
image_link	URL (RFC 1738)	`https://example.com/image1.jpg`	Erforderlich	Die URL des Hauptbilds Ihres Produkts JPEG- oder PNG-Format verwenden Muss mit `http` oder `https` beginnen (`https` bevorzugt) Muss öffentlich zugänglich sein Empfohlene Mindestgröße: 800 × 800 px Wasserzeichen, Textüberlagerungen oder Werbegrafiken vermeiden
additional_image_link	URL-Array (RFC 1738)	`https://example.com/image2.jpg,…`	Optional	Die URLs zusätzlicher Bilder für Ihr Produkt Befolgen Sie die gleichen Anforderungen wie `image_link` Maximal 10 unterstützte Bilder Mehrere Winkel, Verpackungen oder kontextbezogene Ansichten verwenden Um ein Bild einzureichen, übermitteln Sie die (kodierte) URL: `https://www.example.com/image2.jpg` Um mehr als ein Bild einzureichen (bis zu 10), trennen Sie jede URL durch ein Komma (zum Beispiel `https://www.example.com/image2.jpg,https://www.example.com/image3.jpg`) Vergewissern Sie sich, dass Sie alle Kommas (als %2C) innerhalb der URL kodieren, aber kodieren Sie nicht das Komma, das Sie zur Trennung jeder Bild-URL verwenden: `https://www.example.com/image2%2C3.jpg,https://www.example.com/image2%2C4.jpg`
video_link	URL (RFC 1738)	`https://youtu.be/12345`	Optional	Ein Produktvideo, das Ihr Produkt im Gebrauch oder beim Auspacken zeigt Muss öffentlich zugänglich sein (z. B. YouTube, Vimeo oder ein direkter MP4 Link) Empfohlene Formate: MP4, MOV oder WebM Empfohlene Dauer: 15–60 Sekunden Audio nur dann aufnehmen, wenn es für das Produkt relevant ist (z. B. Sound-Demo) Stellen Sie sicher, dass Sie das gleiche Produkt wie auf dem Hauptbild deutlich zeigen
model_3d_link	URL (RFC 1738)	`https://www.example.com/products/xyz.glb`	Optional	Zusätzlicher Link zur Darstellung eines 3D-Modells Ihres Produkts Bevorzugte Formate: GLB oder GLTF Muss öffentlich zugänglich sein Dateigröße unter 20 MB für optimales Laden Stellen Sie sicher, dass das Modell die physische Form und Farbe des Produkts genau darstellt

Artikelinformationen

Geben Sie physische Merkmale und die Klassifizierung für eine genaue Filterung und Taxonomie-Einstufung an.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
Bedingung	Enumeration (`new`, `refurbished`, `used`)	`new`	Erforderlich, wenn der Produktzustand vom Neuzustand abweicht	Der Zustand Ihres Produkts zum Zeitpunkt des Verkaufs `new`: Brandneuer Artikel in ungeöffneter Originalverpackung `refurbished`: Professionell wieder in den funktionsfähigen Zustand versetzt, einschließlich Garantie, doch die Originalverpackung kann fehlen `used`: Zuvor verwendet, mit geöffneter oder fehlender Originalverpackung
google_product_category	Zeichenfolge (Wert aus der Google-Produkttaxonomie. Die numerische Kategorie-ID oder der vollständige Pfad der Kategorie.)	`2271` oder `Apparel & Accessories > Clothing > Dresses`	Empfohlen	Vordefinierte Google-Produktkategorie Nur die relevanteste Kategorie angeben Geben Sie entweder den vollständigen Kategoriepfad oder die numerische Kategorie-ID an, aber nicht beides. Verwenden Sie nach Möglichkeit die Kategorie-ID.
product_category	Zeichenfolge (Kategorie-Taxonomie)	`Apparel & Accessories > Clothing > Outerwear`	Erforderlich, wenn `google_product_category` fehlt	Produktkategorie, die Sie für Ihr Produkt definieren `>` als Trennzeichen verwenden Vollständige Kategorie angeben Bindestriche und Leerzeichen ausschließen
age_group	Enumeration (`newborn`, `infant`, `toddler`, `kids`, `adult`)	`infant`	Optional	Demografische Gruppe, für die Ihr Produkt bestimmt ist `newborn`: 0-3 Monate alt `infant`: 3-12 Monate alt `toddler`: 1-5 Jahre alt `kids`: 5-13 Jahre alt `adult`: Jugendliche oder älter
Material	Zeichenfolge	`leather`	Erforderlich, wenn es für die Unterscheidung verschiedener Produkte in einer Reihe von Varianten relevant ist	Hauptgewebe oder Hauptmaterial Ihres Produkts Maximal 100 Zeichen
Länge	Nummer und Einheit (`cm` und `in`)	`20 in`	Optional	Länge Ihres Produkts Verwenden Sie dieselbe Maßeinheit für jedes Produktdimensionsattribut (einschließlich Produktlänge, -breite und -höhe) Dezimalwerte werden unterstützt
Breite	Nummer und Einheit (`cm` und `in`)	`20 in`	Optional	Breite Ihres Produkts Verwenden Sie dieselbe Maßeinheit für jedes Produktdimensionsattribut (einschließlich Produktlänge, -breite und -höhe) Dezimalwerte werden unterstützt
Höhe	Nummer und Einheit (`cm` und `in`)	`20 in`	Optional	Die Höhe Ihres Produkts Verwenden Sie dieselbe Maßeinheit für jedes Produktdimensionsattribut (einschließlich Produktlänge, -breite und -höhe) Dezimalwerte werden unterstützt
Gewicht	Nummer und Einheit (`lb`, `oz`, `g`, `kg`)	`2.5 lb`	Optional	Gewicht Ihres Produkts Verwenden Sie das tatsächliche Gewicht des fertig montierten Produkts für dieses Attribut Dezimalwerte werden unterstützt

Varianten

Definieren Sie Variantenbeziehungen, wie Farbe und Größe, sodass sich zugehörige SKUs unter einem übergeordneten Element gruppieren lassen. Wenn Sie Varianten einreichen, müssen Sie für jede Variante dieselbe item_group_id angeben.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
item_group_id	Zeichenfolge	`Shoe1234`	Erforderlich, wenn Varianten vorhanden sind	ID für eine Gruppe von Produkten, die in verschiedenen Varianten erhältlich sind Verwenden Sie für jede Gruppe von Varianten einen eindeutigen Wert. Verwenden Sie nach Möglichkeit die übergeordnete SKU. Den Wert beim Aktualisieren Ihrer Produktdaten gleich lassen Maximal 70 Zeichen Verwenden Sie denselben Satz von Variantenattributen für alle Produkte, die dieselbe `item_group_id` haben. Wenn beispielsweise ein Kleid in zwei Farben und zwei Größen verfügbar ist, muss jede Variante Werte sowohl für Farbe als auch für Größe enthalten.
item_group_title	Zeichenfolge (UTF-8-Text)	`Shoes`	Optional	Titel Ihrer Produktgruppe Verwenden Sie einen klaren, menschlich lesbaren Namen, der die Gruppe verwandter Varianten darstellt (zum Beispiel „Laufschuhe für Herren“) Maximal 150 Zeichen Vermeiden Sie die Verwendung sämtlicher Großbuchstaben
Farbe	Zeichenfolge	`Black`	Empfohlen (Bekleidung)	Farbe Ihres Produkts Wenn Ihr Produkt mehrere Farben aufweist, listen Sie die Primärfarbe auf. Recommended length: ≤ 40 characters Maximum length: 100 characters
Größe	Zeichenfolge	`10`	Empfohlen (Bekleidung)	Die Größe Ihres Produkts Maximal 20 Zeichen
size_system	Ländercode (ISO 3166)	`USA`	Empfohlen (Bekleidung)	Größensystem zweistelliger Ländercode
Geschlecht	Enumeration (`male`, `female`, `unisex`)	`male`	Empfohlen (Bekleidung)	Das vorgesehene Geschlecht der Käuferin oder des Käufers Ihres Produkts

Verfügbarkeit und Bestand

Geben Sie den Status und die Mengen des Live-Bestands an, um die Kaufgenauigkeit aufrechtzuerhalten.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
Verfügbarkeit	Enumeration (`in_stock`, `out_of_stock`, `preorder`, `backorder`)	`in_stock`	Erforderlich für alle Produkte	Verfügbarkeit Ihres Produkts
availability_date	Datum (ISO 8601)	`2026-02-24`	Erforderlich, wenn die Produktverfügbarkeit auf `preorder` eingestellt ist	Das Datum, an dem ein vorbestelltes Produkt zur Lieferung verfügbar wird
expiration_date	Datum (ISO 8601)	`2026-12-31`	Optional	Das Datum, an dem Ihr Produkt nicht mehr angezeigt wird
inventory_not_tracked	Boolesch (`true` oder `false`)	`false`	Optional	Gibt an, ob der Bestand Ihres Produkts nachverfolgt wird. `true`: Der Bestand wird nicht nachverfolgt (z. B. digitale Waren oder Bestellung). `inventory_quantity` muss leer sein. `false`: Bestand wird nachverfolgt und `inventory_quantity` ist erforderlich
inventory_quantity	Ganzzahl (Nicht negative Ganzzahl)	`100`	Erforderlich, wenn `inventory_not_tracked` `false` ist. Lassen Sie es leer, wenn `true`.	Verkaufbare Einheiten für diesen Posten verfügbar. Lassen Sie dies leer, wenn `inventory_not_tracked` `true` ist.

Preis und Werbeaktionen

Geben Sie Preisinformationen für Anzeige- und Werbelogik an.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
Preis	Nummer und Währung (ISO 4217)	`15,00 USD`	Erforderlich für alle Produkte	Der Preis Ihres Produkts
sale_price	Nummer und Währung (ISO 4217)	`12,99 USD`	Optional	Ermäßigter Preis
sale_price_effective_date	Datum (ISO 8601)	`2025-12-01/2025-12-15`	Erforderlich, wenn Sie `sale_price` angegeben haben	Verkaufsfenster Start- und Enddatum mit `/` trennen
stripe_product_tax_code	Zeichenfolge (Produkt-Steuercode (PTC) von Stripe)	`txcd_99999999`	Erforderlich bei Verwendung von Stripe Tax zur Berechnung von Steuern	Verwenden Sie die Produkt-Steuercodes von Stripe, um Ihr Produkt für eine genaue Steuerberechnung zu klassifizieren. Diese Codes helfen Stripe, den korrekten Steuersatz basierend auf Produkttyp und Zuständigkeitsbereich zu ermitteln.
tax_behavior	Enumeration (`inclusive` oder `exclusive`)	`exclusive`	Optional	Gibt an, ob der Preis Ihres Produkts anfallende Steuern enthält (inklusiv) oder nicht (exklusiv). Wird dies weggelassen, ist der Standardwert exklusiv.
applicable_fees	Zeichenfolge (`country:region:fee_label:fee_amount`: Setzen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas.)	`US:CA:Recycling Fee:0.25 USD,DE:ALL:Bottle Deposit:0.10 EUR`	Optional (erforderlich, wenn regulatorische oder regionale Gebühren anfallen)	Verwenden Sie dieses Feld, um Gebühren und Zuschläge je nach Produkttyp und Region anzugeben. Diese Gebühren sollten nicht im Grundpreis des Produkts enthalten sein; sie sollen als separate Posten beim Bezahlvorgang und in der Berichterstattung erscheinen. Formatieren Sie jede Transaktionsgebühr als durch Doppelpunkt getrennten Wert: `country` (Erforderlich): ISO 3166-1-Alpha-2-Ländercode (z. B. USA oder DE). `region` (Erforderlich): Geben Sie eine Region, einen Bundesstaat, ein Territorium oder eine Präfektur an (zum Beispiel CA). Verwenden Sie `ALL`, um Ihre Auswahl für alle Regionen oder Provinzen innerhalb des angegebenen Landes festzulegen. `fee_label` (Erforderlich): Menschlich lesbarer Name für die Transaktionsgebühr (z. B. Transaktionsgebühr für Recycling, Flaschenpfand oder ökologische Zahlung). Doppelpunkte dürfen nicht in dem Namen verwendet werden. `fee_amount` (Erforderlich): Feste Transaktionsgebühr pro Einheit mit einem Punkt als Dezimaltrennzeichen und ISO 4217-Währungscode (z. B. 5.00 USD).

Ausführung

Geben Sie Versandoptionen, Preise und geschätzte Lieferzeiten an.

Feld Datentyp Beispiel Anforderung Hinweise

Feld	Datentyp	Beispiel	Anforderung	Hinweise
Versand	Zeichenfolge (`country:region:service:speed_range:price`: Legen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas.)	`US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD`	Erforderlich, wenn das Produkt versandfähig ist (zum Beispiel eine physische Ware)	Die Versandkosten Ihres Produkts, die Versandgeschwindigkeiten und die Standorte, an die Ihr Produkt geliefert wird. Formatieren Sie jede Versandoption als durch Doppelpunkt getrennten Wert: `country` (Erforderlich): Geben Sie einen ISO 3166-1-Alpha-2-Ländercode für das Land an, in das das Produkt geliefert werden kann (z. B. USA, DE) `region` (Erforderlich): Geben Sie eine Region, einen Bundesstaat, ein Gebiet oder eine Präfektur mit dem ISO 3166-2-Unterteilungscode (US-Unterteilungscode) ohne Länderpräfix an (z. B. VA oder NY). Verwenden Sie ALL (ALLE) als Platzhalter, um anzugeben, dass die Versandregel für alle Regionen oder Provinzen innerhalb des angegebenen Landes gilt. `service` (Erforderlich): Menschlich lesbarer Name der Dienstleistung (z. B. Standard oder Express-Versandoptionen). `speed_range` (Optional): Mindest- und Höchstanzahl der Tage, die für den Versand benötigt werden (z. B. 3-5) `price` (Erforderlich): Geben Sie eine feste Versandkostenangabe an und verwenden Sie einen Punkt als Dezimaltrennzeichen und den Währungscode ISO 4217 (z. B. 3.00 USD)
free_shipping_threshold	Zeichenfolge (`country:price`)	`US:16.00 USD`	Optional	Gesamter Bestellwert, ab dem der Versand kostenlos ist `country` (Erforderlich): ISO 3166-1-Alpha-2-Ländercode `price_threshold` (Erforderlich): Gesamter Bestellwert, ab dem der Versand kostenlos ist

Versand

Zeichenfolge

(country:region:service:speed_range:price: Legen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas.)

US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD

Erforderlich, wenn das Produkt versandfähig ist (zum Beispiel eine physische Ware)

Die Versandkosten Ihres Produkts, die Versandgeschwindigkeiten und die Standorte, an die Ihr Produkt geliefert wird.

Formatieren Sie jede Versandoption als durch Doppelpunkt getrennten Wert:
- country (Erforderlich): Geben Sie einen ISO 3166-1-Alpha-2-Ländercode für das Land an, in das das Produkt geliefert werden kann (z. B. USA, DE)
- region (Erforderlich): Geben Sie eine Region, einen Bundesstaat, ein Gebiet oder eine Präfektur mit dem ISO 3166-2-Unterteilungscode (US-Unterteilungscode) ohne Länderpräfix an (z. B. VA oder NY). Verwenden Sie ALL (ALLE) als Platzhalter, um anzugeben, dass die Versandregel für alle Regionen oder Provinzen innerhalb des angegebenen Landes gilt.
- service (Erforderlich): Menschlich lesbarer Name der Dienstleistung (z. B. Standard oder Express-Versandoptionen).
- speed_range (Optional): Mindest- und Höchstanzahl der Tage, die für den Versand benötigt werden (z. B. 3-5)
- price (Erforderlich): Geben Sie eine feste Versandkostenangabe an und verwenden Sie einen Punkt als Dezimaltrennzeichen und den Währungscode ISO 4217 (z. B. 3.00 USD)

free_shipping_threshold

Zeichenfolge

(country:price)

US:16.00 USD

Optional

Gesamter Bestellwert, ab dem der Versand kostenlos ist

country (Erforderlich): ISO 3166-1-Alpha-2-Ländercode
price_threshold (Erforderlich): Gesamter Bestellwert, ab dem der Versand kostenlos ist

Leistungs- und Bewertungssignale

Teilen Sie Leistungs- und Bewertungssignale, um KI-Agenten und Ranking-Systeme bei der Identifizierung hochwertiger, vertrauenswürdiger Produkte zu unterstützen.

Diese Felder sind optional, werden aber empfohlen. Sie verbessern die Erkennung, das Ranking und die Personalisierung auf allen agentenspezifischen Schnittstellen.
Geben Sie nur aggregierte Metriken an und schließen Sie alle Nutzerdaten oder personenbezogene Daten aus.
Aktualisieren Sie diese Metriken regelmäßig (zum Beispiel wöchentlich), um die Genauigkeit zu gewährleisten.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
popularity_score	Nummer (Skala 0-5)	`4.7`	Empfohlen	Aggregierter Beliebtheitsindikator für dieses Produkt oder diese Variante Verwenden Sie eine einheitliche Skala von 0-5 für Ihren Katalog (0 = am niedrigsten, 5 = am höchsten) Leiten Sie dies aus Signalen wie Ansichten, In-Warenkorb-legen-Ereignissen, Konversionen oder Verkaufsrang ab Verwenden Sie ein einheitliches Aggregationsfenster (z. B. die letzten 90 Tage), um die Aktualität zu gewährleisten
return_rate	Nummer (0–100 (`%`-Symbol weglassen))	`2.0`	Empfohlen	Prozentsatz der für dieses Produkt oder diese Variante zurückgegebenen Einheiten Als numerischen Prozentsatz zwischen 0 und 100 (z. B. 2.0 für 2 %) ausdrücken Ein einheitliches Aggregationsfenster verwenden (z. B. die letzten 90 Tage)
product_review_count	Ganzzahl (Nicht negative Ganzzahl)	`124`	Empfohlen	Gesamtanzahl der mit diesem Produkt oder dieser Variante verknüpften Bewertungen Entspricht der Population, die zur Berechnung der `product_review_rating` verwendet wurde Verwenden Sie 0, wenn keine Bewertungen vorhanden sind Verifizierte Kaufbewertungen nach Möglichkeit widerspiegeln
product_review_rating	Nummer (Skala 1-5)	`4.3`	Erforderlich, wenn `product_review_count` größer als 0 ist	Durchschnittliche Bewertung für dieses Produkt oder diese Variante prüfen Verwenden Sie eine einheitliche Skala von 1–5 für Ihren Katalog (1 = am niedrigsten, 5 = am höchsten) Muss demselben Datensatz entsprechen wie `product_review_count` Lassen Sie dieses Feld leer, wenn `product_review_count` 0 ist

Anweisungen zur Feedverarbeitung

Definiert Betriebsfelder, die steuern, wie das System jede Zeile im Feed verarbeitet.

Feld Datentyp Beispiel Anforderung Hinweise

Feld	Datentyp	Beispiel	Anforderung	Hinweise
löschen	Boolesch (`true` oder `false`)	`true`	Optional	Markiert das Produkt oder die Variante für die dauerhafte Entfernung Wenn `true`, entfernen wir das durch `id` identifizierte Produkt und ignorieren alle anderen Spalten in dieser Zeile Wird der Wert weggelassen oder `false`, wird die Zeile normal als Upsert verarbeitet

löschen

Boolesch

(true oder false)

true

Optional

Markiert das Produkt oder die Variante für die dauerhafte Entfernung

Wenn true, entfernen wir das durch id identifizierte Produkt und ignorieren alle anderen Spalten in dieser Zeile
Wird der Wert weggelassen oder false, wird die Zeile normal als Upsert verarbeitet

Bestandsfeed-Spezifikation verwenden

Verwenden Sie den Bestandsfeed, um die Produktverfügbarkeit und Lagermengen zu aktualisieren, ohne Ihren vollständigen Katalog erneut einzureichen. Senden Sie häufige Updates von Ihrem Lager, Point of Sale oder Ihren Ausführungssystemen, damit Ihre Produkte den genauen Status des Lagerbestands über alle agentischen Schnittstellen hinweg widerspiegeln.

Ihren Produktfeed synchron halten: Die ID-Werte in Ihrer Bestandsdatei müssen bereits im Hauptkatalogfeed vorhanden sein.
Häufige Bestandsdateien senden: Push-Aktualisierungen über die Stripe API im CSV-Format.
Teilaktualisierungen senden: Fügen Sie nur geänderte SKUs hinzu – fehlende SKUs behalten ihren letzten bekannten Bestandsstatus.

Inventarfeed-Feldreferenz

Inventarfeed-Felder

Geben Sie den Status und die Mengen des Live-Bestands an, um die Kaufgenauigkeit aufrechtzuerhalten.

Feld	Datentyp	Beispiel	Anforderung	Hinweise
ID	Zeichenfolge (alphanumerisch)	`SKU12AB3456`	Erforderlich	Muss mit der `ID` in Ihrem primären Produktfeed übereinstimmen. Dieser Wert ist die Schlüsselkennung
Verfügbarkeit	Enumeration (`in_stock`, `out_of_stock`, `preorder`, `backorder`)	`in_stock`	Erforderlich für alle Produkte	Verfügbarkeit Ihres Produkts
availability_date	Datum (ISO 8601)	`2026-02-24`	Erforderlich, wenn die Produktverfügbarkeit auf `preorder` eingestellt ist	Das Datum, an dem ein vorbestelltes Produkt zur Lieferung verfügbar wird
inventory_quantity	Ganzzahl (Nicht negative Ganzzahl)	`100`	Erforderlich für alle Produkte	Verkaufbare Einheiten