# Produktfeed 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 Produktfeed an KI-Agenten für die Suche und den Einkauf zu verteilen. Beginnen Sie mit einer vollständigen Einreichung des Produktfeeds und senden Sie dann inkrementelle Bestandsfeed-Updates, um Lagerbestände und Verfügbarkeit auf dem neuesten Stand zu halten. ## Produktfeed-Spezifikation Verwenden Sie die Produktfeed-Spezifikation, um Ihre vollständigen strukturierten Produktdaten bereitzustellen (z. B. Titel, Beschreibungen, Kennungen, Preise, Versand und Medien). Jede Zeile steht für ein Produkt oder eine Variante. 1. Formatieren Sie Ihre Produktdaten anhand der Feldreferenz in diesem Dokument. Zu jedem Feld finden Sie Beispielwerte, Validierungsregeln sowie Angaben dazu, ob das Feld erforderlich, empfohlen oder optional ist. 1. Senden Sie Ihre Produktdaten sicher über die Stripe API im CSV-Format. 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 werden und alle Feldanforderungen erfüllen, bevor Sie in die Produktion gehen. 1. Halten Sie Ihre Daten auf dem neuesten Stand und aktualisieren Sie Ihren Feed regelmäßig. Aktualisieren Sie Änderungen an Produktattributen, Preisen oder Details der Ausführung, wenn sie auftreten, um das Vertrauen der Kundin/des Kunden zu erhalten und veraltete Einträge zu verhindern. Wir validieren und bereinigen Ihre Daten, indizieren sie im Stripe-Produktfeed und konvertieren sie in das Format, das jeder Agent benötigt. ### Feedverarbeitungsmodus Beim Hochladen von Produktfeeds wird der Modus *upert* (A combined operation that updates an existing record if it exists or inserts it if it doesn’t) 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 löschen, fügen Sie die optionale Spalte `Löschen` in Ihre CSV ein. Legen Sie ihn für alle Produkte, die Sie löschen möchten, auf `Wahr` fest. Legen Sie ihn für Produkte, die Sie behalten möchten, auf `Falsch` fest oder lassen Sie das Feld leer. Wenn `delete=true` ist, liest Stripe nur die Spalten `id` und `Löschen` für diese Zeile und ignoriert alle anderen Spalten. ### Reine Discovery-Produkte Produkte mit `disable_Checkout=true` werden zur Erkennung an KI-Agenten weitergeleitet, können jedoch nicht direkt über den Agenten gekauft werden. Wenn ein Agent ein Produkt anzeigt, das nur zur Erkennung bestimmt ist, leitet er die/den Nutzer/in auf die `link`-URL des Produkts weiter, damit diese/r den Kauf auf Ihrer Website abschließen kann. Reine Discovery-Produkte unterliegen denselben Regeln für die Feed-Verarbeitung wie andere Produkte. Agenten können sie indexieren, durchsuchen und bewerten. Der einzige Unterschied besteht darin, dass die Kaufaktion auf Ihre Website weiterleitet, anstatt eine Checkout-Sitzung innerhalb des Agenten zu starten. Weitere Informationen zum Festlegen dieses Felds finden Sie unter [Anleitung zur Feed-Verarbeitung](https://docs.stripe.com/agentic-commerce/product-feed.md#feed-processing-instructions). ## Referenz für das Feld „Produktfeed“ In den folgenden Abschnitten finden Sie das vollständige Schema, das vom Stripe-Produktfeed 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 | Anforderung | | ------------ | ------------------------------------------------ | ------------ | | ID | Zeichenfolge (alphanumerisch)Maximal 100 Zeichen | Erforderlich | Die eindeutige Kennung Ihres Produkts. Verwenden Sie nach Möglichkeit die SKU des Produkts und behalten Sie die ID bei, wenn Sie Ihre Daten aktualisieren.**Beispiel: SKU 12AB3456** | | Titel | Zeichenfolge (UTF-8-Text)Maximal 150 Zeichen | Erforderlich | Der Titel Ihres Produkts. Beschreiben Sie Ihr Produkt genau und stimmen Sie die Beschreibung mit dem Titel auf Ihrer Zielseite ab. Die durchgehende Verwendung von Großbuchstaben sollte vermieden werden.**Beispiel: Herren-Poloshirt mit Blumenmuster** | | Beschreibung | Zeichenfolge (UTF-8-Text)Maximal 5000 Zeichen | Erforderlich | Beschreibung Ihres Produkts. Diese sollte nur Informationen über das Produkt umfassen. Fügen Sie keine Links zu Ihrem Shop, Verkaufsinformationen, Details zu Wettbewerbern, anderen Produkten oder Zubehör hinzu. Nur Klartext (Klarschrift).**Beispiel: Bringen Sie mit diesem floralen Herren-Poloshirt eine Menge Spaß in Ihr Golfspiel** | | Link | URL (RFC 1738) | Erforderlich | Die Zielseite Ihres Produkts. Verwenden Sie Ihren verifizierten Domainnamen, beginnend mit `https` (bevorzugt) oder `http`. Muss mit `HTTP 200` aufgelöst werden (keine defekten Links).**Beispiel: https://example.com/product/SKU12AB3456** | ### Produktkennungen Verwenden Sie diese weltweit bekannten Kennungen, um Ihre Produkte für die Suche und die Zuordnung zu differenzieren. | Feld | Datentyp | Anforderung | | --------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------ | | Marke | Zeichenfolge | 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 anerkannt wird. Maximal 70 Zeichen.**Beispiel: Stripe** | | GTIN (Globale Artikelidentnummer) | Zeichenfolge (Numerische GTIN, UPC, ISBN) | Empfohlen | Die globale Artikelidentnummer (GTIN) Ihres Produkts. Maximal 50 Zeichen. Bindestriche und Leerzeichen ausgenommen.**Beispiel: 3234567890126** | | MPN | Zeichenfolge (alphanumerisch) | Erforderlich, wenn GTIN fehlt | Die Hersteller-Teilenummer (MPN) Ihres Produkts. Reichen Sie nur vom Hersteller zugewiesene MPNs ein. Maximal 70 Zeichen.**Beispiel: STR12345** | ### Medien Stellen Sie visuelle und optionale Rich Media zur Verfügung, um das Produkt genau darzustellen. | Feld | Datentyp | Anforderung | | --------------------- | -------------------- | ------------ | | image_link | URL (RFC 1738) | Erforderlich | Die URL des Hauptbildes Ihres Produkts. Verwenden Sie das JPEG- oder PNG-Format. Muss mit `http` oder `https` beginnen (`https` bevorzugt). Muss öffentlich zugänglich sein. Empfohlene Mindestgröße: 800 × 800 px. Vermeiden Sie Wasserzeichen, Textüberlagerungen oder Werbegrafiken.**Beispiel: https://example.com/image1.jpg** | | additional_image_link | URL-Array (RFC 1738) | Optional | Die URLs zusätzlicher Bilder für Ihr Produkt. Es gelten die gleichen Anforderungen wie bei `image_link`. Es werden maximal 10 Bilder unterstützt. Verwenden Sie mehrere Winkel, Verpackungen oder kontextbezogene Ansichten. - Um ein Bild einzureichen, übermitteln Sie die (kodierte) URL: **https://www.example.com/image2.jpg**. - Um mehr als ein Bild zu übermitteln (bis zu 10), trennen Sie jede URL durch ein Komma (zum Beispiel **https://www.example.com/image2.jpg,https://www.example.com/image3.jpg**). Kodieren Sie alle Kommas (als `%2C`) innerhalb der URL, aber nicht das Komma, das jede Bild-URL trennt: **https://www.example.com/image2%2C3.jpg,https://www.example.com/image2%2C4.jpg**.**Example: https://example.com/image2.jpg,…** | | video_link | URL (RFC 1738) | Optional | Ein Produktvideo, das Ihr Produkt in Gebrauch oder beim Auspacken zeigt. Muss öffentlich zugänglich sein (zum Beispiel YouTube, Vimeo oder ein direkter MP4 Link). Empfohlene Formate: MP4, MOV oder WebM. Empfohlene Dauer: 15–60 Sekunden. Fügen Sie Audio nur dann ein, wenn es für das Produkt relevant ist (zum Beispiel eine Tondemo). Stellen Sie sicher, dass Sie dasselbe Produkt wie auf dem Hauptbild anzeigen.**Beispiel: https://youtu.be/12345** | | model_3d_link | URL (RFC 1738) | Optional | Ein zusätzlicher Link, der ein 3D-Modell Ihres Produkts anzeigt. Bevorzugte Formate: GLB oder GLTF. Muss öffentlich zugänglich sein. Halten Sie die Dateigröße unter 20 MB, um ein optimales Laden zu gewährleisten. Stellen Sie sicher, dass das Modell die physische Form und Farbe des Produkts genau darstellt.**Beispiel: https://www.example.com/products/xyz.glb** | ### Artikelinformationen Geben Sie physische Merkmale und die Klassifizierung für eine genaue Filterung und Taxonomie-Einstufung an. | Feld | Datentyp | Anforderung | | ----------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | | Bedingung | Enumeration (`neu`, `überholt`, `gebraucht`) | Erforderlich, wenn der Produktzustand vom Neuzustand abweicht | Der Zustand Ihres Produkts zum Zeitpunkt des Verkaufs. - `Neu`: Brandneuer Artikel in ungeöffneter Originalverpackung. - `Erneuert`: Professionell wieder in den funktionsfähigen Zustand versetzt, einschließlich Garantie, doch die Originalverpackung kann fehlen. - `gebraucht`: Zuvor verwendet, mit geöffneter oder fehlender Originalverpackung.**Beispiel: neu** | | google_product_category | StringValue aus der Google-Produkttaxonomie. Die numerische Kategorie-ID oder der vollständige Pfad der Kategorie. | Empfohlen | Vordefinierte Google-Produktkategorie. Geben Sie nur die relevanteste Kategorie an. Geben Sie entweder den vollständigen Kategoriepfad oder die numerische Kategorie-ID an, aber nicht beides. Verwenden Sie nach Möglichkeit die Kategorie-ID.**Beispiel: 2271** oder **Bekleidung & Accessoires > Kleidung > Kleider** | | product_category | Zeichenfolge (Kategorie-Taxonomie) | Erforderlich, wenn `google_product_category` fehlt | Produktkategorie, die Sie für Ihr Produkt definieren. Verwenden Sie `>` als Trennzeichen. Fügen Sie die vollständige Kategorie hinzu. Bindestriche und Leerzeichen ausgenommen.**Beispiel: Bekleidung & Accessoires > Kleidung > Oberbekleidung** | | age_group | Enumeration (`Neugeborenes`, `Säugling`, `Kleinkind`, `Kind`, `Erwachsene/r`) | Optional | Demografische Gruppe, für die Ihr Produkt bestimmt ist. - `Neugeborenes`: 0 bis 3 Monate alt. - `Säugling`: 3 bis 12 Monate alt. - `Kleinkind`: 1 bis 5 Jahre alt. - `Kinder`: 5 bis 13 Jahre alt. - `Erwachsene`: Jugendliche oder älter.**Beispiel: Kleinkind** | | Material | Zeichenfolge | Erforderlich, wenn es für die Unterscheidung verschiedener Produkte in einer Reihe von Varianten relevant ist | Der Hauptstoff oder das Hauptmaterial Ihres Produkts. Maximal 100 Zeichen.**Beispiel: Leder** | | Länge | Anzahl und Einheit (`cm` und `Zoll`) | Optional | Länge Ihres Produkts. Verwenden Sie für jedes Dimensionsattribut die gleiche Maßeinheit (einschließlich `Länge`, `Breite` und `Höhe`). Dezimalwerte werden unterstützt.**Beispiel: 20 cm** | | Weite | Anzahl und Einheit (`cm` und `Zoll`) | Optional | Breite Ihres Produkts. Verwenden Sie für jedes Dimensionsattribut die gleiche Maßeinheit (einschließlich `Länge`, `Breite` und `Höhe`). Dezimalwerte werden unterstützt.**Beispiel: 20 cm** | | Höhe | Anzahl und Einheit (`cm` und `Zoll`) | Optional | Höhe Ihres Produkts. Verwenden Sie für jedes Dimensionsattribut die gleiche Maßeinheit (einschließlich `Länge`, `Breite` und `Höhe`). Dezimalwerte werden unterstützt.**Beispiel: 20 cm** | | Gewicht | Anzahl und Einheit (`kg`, `oz`, `g`, `kg`) | Optional | Das Gewicht Ihres Produkts. Verwenden Sie das tatsächliche Gewichts des montierten Produkts für dieses Attribut. Dezimalwerte werden unterstützt.**Beispiel: 2,5 kg** | ### 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 `Posten_Gruppe_ID` angeben. | Feld | Datentyp | Anforderung | | ---------------- | ---------------------------------------------- | ------------------------------------------- | | item_group_id | Zeichenfolge | Erforderlich, wenn Varianten vorhanden sind | ID für eine Gruppe von Produkten, die in verschiedenen Varianten erhältlich sind. Verwenden Sie einen eindeutigen Wert für jede Gruppe von Varianten. Verwenden Sie nach Möglichkeit die übergeordnete SKU. Behalten Sie den Wert beim Aktualisieren Ihrer Produktdaten gleich. Maximal 70 Zeichen. Verwenden Sie denselben Satz von Variantenattributen für alle Produkte, die dieselbe `Posten_group_id` haben. Wenn beispielsweise ein Kleid in zwei Farben und zwei Größen verfügbar ist, muss jede Variante Angaben sowohl zur Farbe als auch zur Größe enthalten.**Beispiel: Schuh1234** | | item_group_title | Zeichenfolge (UTF-8-Text) | Optional | Der Titel Ihrer Produktgruppe. Verwenden Sie einen klaren, menschenlesbaren Namen, der die Gruppe verwandter Varianten darstellt (zum Beispiel „Herrenlaufschuhe“). Maximal 150 Zeichen. Durchgehende Großbuchstaben sollten vermieden werden.**Beispiel: Schuhe** | | Farbe | Zeichenfolge | Empfohlen (Bekleidung) | Die Farbe Ihres Produkts. Wenn Ihr Produkt mehrere Farben aufweist, listen Sie die Hauptfarbe auf. Empfohlene Länge: 40 Zeichen oder weniger. Maximale Länge: 100 Zeichen.**Beispiel: Schwarz** | | Größe | Zeichenfolge | Empfohlen (Bekleidung) | Die Größe Ihres Produkts. Maximal 20 Zeichen.**Beispiel: 10** | | size_system | Ländercode (ISO 3166) | Empfohlen (Bekleidung) | Größensystem. Zweistelliger Ländercode.**Beispiel: US** | | Geschlecht | Enumeration (`männlich`, `weiblich`, `unisex`) | Empfohlen (Bekleidung) | Das vorgesehene Geschlecht der Käuferin oder des Käufers Ihres Produkts.**Beispiel: männlich** | ### Benutzerdefinierte Variantenoptionen Definieren Sie nicht standardmäßige Merkmale für Ihre Produktvarianten, die noch nicht im Abschnitt „Varianten“ enthalten sind, mithilfe von Name-Wert-Paaren (z. B. „Material/Eiche“ oder „Muster/Blumen“). | Feld | Datentyp | Anforderung | | --------------------------------- | ------------------------- | ----------- | | custom_variant_option_name_{1-3} | Zeichenfolge (UTF-8-Text) | Optional | Definiert maximal drei benutzerdefinierte Produktvariantenoptionen. Nummerieren Sie jede Spalte in der CSV-Datei mit 1-3: `custom_variant_option_name_1`, `custom_variant_option_name_2`, `custom_variant_option_name_3`. Jeder Name einer Variantenoption wird dem Wert mit derselben Nummer zugeordnet. Beispielsweise wird `custom_variant_option_name_1` `custom_variant_option_value_1` zugeordnet. **Example: Material** | | custom_variant_option_value_{1-3} | Zeichenfolge (UTF-8-Text) | Optional | Legt benutzerdefinierte Produktvariantenwerte für die Varianten fest, die durch benutzerdefinierte Variantenoptionsnamen definiert sind. Nummerieren Sie jede Spalte in der CSV-Datei mit 1-3: `custom_variant_option_value_1`, `custom_variant_option_value_2`, `custom_variant_option_value_3`. Jeder Variantenoptionswert wird dem Namen mit derselben Nummer zugeordnet. Beispielsweise ist `custom_variant_option_value_1` der Wert für `custom_variant_option_name_1`. **Beispiel: Eiche** | ### Verfügbarkeit und Bestand Geben Sie den Status und die Mengen des Live-Bestands an, um die Kaufgenauigkeit aufrechtzuerhalten. | Feld | Datentyp | Anforderung | | --------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | Verfügbarkeit | Enum (`in_stock`, `out_of_stock`, `preorder`, `backorder`) | Erforderlich für alle Produkte | Verfügbarkeit Ihres Produkts.**Beispiel: in\_stock** | | availability_date | Datum (ISO 8601) | Erforderlich, wenn die Produktverfügbarkeit auf `preorder` eingestellt ist | Das Datum, an dem ein vorbestelltes Produkt zur Lieferung verfügbar wird.**Beispiel: 24.02.2026** | | expiration_date | Datum (ISO 8601) | Optional | Das Datum, ab dem Ihr Produkt nicht mehr angezeigt wird.**Beispiel: 31.12.2026** | | inventory_not_tracked | Boolean (`true` oder `false`) | Optional | Gibt an, ob der Bestand Ihres Produkts nachverfolgt wird. - `true`: Der Bestand wird nicht nachverfolgt (z. B. digitale Waren oder Sonderanfertigung). - `inventory_quantity` muss leer sein. - `false`: Bestand wird nachverfolgt und `inventory_quantity` ist erforderlich.**Beispiel: false** | | inventory_quantity | Ganzzahlig (nicht negative Ganzzahl) | Erforderlich, wenn `inventory_not_tracked` `false` ist. Lassen Sie es leer, wenn `true`. | Verkaufbare, verfügbare Einheiten für diesen Posten. Lassen Sie dies leer, wenn `inventory_not_tracked` `true` ist.**Beispiel: 100** | ### Preis und Werbeaktionen Geben Sie Preisinformationen für Anzeige- und Werbelogik an. | Feld | Datentyp | Anforderung | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Preis | Nummer und Währung (ISO 4217) | Erforderlich für alle Produkte | Preis Ihres Produkts.**Beispiel: 15,00 USD** | | sale_price | Nummer und Währung (ISO 4217) | Optional | Ermäßigter Preis.**Beispiel: 12,99 USD** | | sale_price_effective_date | Datum (ISO 8601) | Erforderlich, wenn Sie `sale_price` angegeben haben | Verkaufsfenster. Trennen Sie Start- und Enddatum mit `/`.**Beispiel: 15.12.2025/15-12-2025** | | stripe_product_tax_code | Zeichenfolge (Produkt-Steuercode (PTC) von Stripe) | Erforderlich bei Verwendung von Stripe Tax zur Berechnung von Steuern | Verwenden Sie die Produktsteuercodes von Stripe, um Ihr Produkt für die Steuerberechnung zu klassifizieren. Diese Codes helfen Stripe, den korrekten Steuersatz basierend auf Produkttyp und Zuständigkeitsbereich zu ermitteln.**Beispiel: txcd\_99999999** | | third_party_tax_code | Zeichenkette`provider:tax_code`Unterstützte Anbieter: `avalara`, `sphere` Maximal 100 Zeichen | Optional. Erforderlich, wenn `stripe_product_tax_code` nicht angegeben wird und Sie einen unterstützten [externen Steueranbieter](https://docs.stripe.com/tax/third-party-apps.md) verwenden. | Verwenden Sie dieses Feld, um Ihr Produkt bei einem unterstützten [externen Steuerdienstleister](https://docs.stripe.com/tax/third-party-apps.md) zu klassifizieren. Geben Sie den Wert im Format `:`mit dem Namen des Anbieters in Kleinbuchstaben ein. Unterstützte Anbieter sind `avalara` und `sphere`. Verwenden Sie dieses Feld anstelle von `stripe_product_tax_code`, wenn Sie Produkte speziell für Avalara oder Sphere klassifizieren.**Beispiel: avalara:PC030000** | | tax_behavior | Enumeration (`inklusive` oder `exklusive`) | Optional | Gibt an, ob der Preis Ihres Produkts die geltenden Steuern enthält (inklusive) oder nicht (exklusive). Wenn Sie dieses Feld weglassen, ist der Standardwert `exklusive`.**Beispiel: exklusive** | | 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. | Optional (erforderlich, wenn regulatorische oder regionale Gebühren anfallen) | Verwenden Sie dieses Feld, um Stückpreise und Zuschläge je nach Produkttyp und Region anzugeben. Diese Gebühren sind nicht im Grundpreis des Produkts enthalten. Verwenden Sie sie als separate Posten beim Bezahlvorgang und in der Berichterstattung. Formatieren Sie jede Gebühr als durch Doppelpunkt getrennten Wert: - `country` (Erforderlich): ISO 3166-1-Alpha-2-Ländercode (z. B. USA oder DE). - `Region` (Erforderlich): Geben Sie Region, Bundesstaat, Gebiet oder Präfektur an (zum Beispiel CA). Verwenden Sie `ALLE`, 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 Gebühr pro Stück unter Verwendung eines Zeitraums als Dezimaltrennzeichen und ISO 4217 Währungscode (z. B. 5,00 USD).**Beispiel: USA:CA:Recyclinggebühr:0,25 USD,DE:ALLE:Flaschenpfand:0,10 EUR** | ### Ausführung Geben Sie Versandoptionen, Preise und geschätzte Lieferzeiten an. | Feld | Datentyp | Anforderung | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | Versand | Zeichenfolge(`country:delivery_area:service:speed_range:price`: Legen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas.) | Erforderlich, wenn das Produkt versandfähig ist (zum Beispiel eine physische Ware) | Die Versandkosten Ihres Produkts, die Versandgeschwindigkeiten und die Orte, an die Ihr Produkt versendet wird. Formatieren Sie jede Versandoption als durch Doppelpunkt getrennten Wert: - `Land` (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 oder DE). - `Liefer_gebiet` (Erforderlich): Einer der folgenden Werte, der definiert, wohin Sie das Produkt liefern können: - `Region`: Region, Bundesstaat, Gebiet oder Präfektur mit dem ISO 3166-2-Unterteilungscode ohne Länderpräfix (zum Beispiel `VA` oder `NY`). Verwenden Sie `ALLE`, um anzugeben, dass die Regel für jede Region oder Provinz innerhalb des Landes gilt. - `Post_leitzahl`: eine Postleitzahl oder ein Postleitzahlenbereich (derzeit nur für die USA unterstützt). Zulässige Formate: - Einzelne Postleitzahl: `94012` - Bereich: `73114-74547` - Platzhalter am Ende: `94*` - Bereiche mit mehreren Platzhaltern: `94*-95*` - `Service` (Erforderlich): Menschlich lesbarer Name der Dienstleistung (z. B. Standard- oder Express-Versandoptionen). - `Geschwindigkeit_Spanne` (Optional): Mindest- und Höchstanzahl der Tage, die für den Versand benötigt werden (z. B. `3-5`). - `Preis` (Erforderlich): Feste Versandkosten mit einem Zeitraum als Dezimaltrennzeichen und ISO 4217 Währungscode (z. B. `3,00 USD`).**Beispiel (Region): US:ALLE:Standardversand:3-5:0,00 USD,US:ALLE:Expressversand:1-2:12,99 USD\****Beispiel (Postleitzahl): US:94012:Standardversand:3-5:0,00 USD,US:73114-74547:Expressversand:1-2:9,99 USD,US:94*:Expressversand:1-2:9,99 USD,US:94*-95*:Standardversand:2-5:0,00 USD** | | shipping_cost_basis | Enum (`per_order`, `per_item`) | Optional | Gibt an, wie die im Feld `Versand` definierten Versandkosten angewandt werden, wenn Kundinnen und Kunden mehrere Einheiten derselben SKU kaufen. Wenn Sie diese Einstellung weglassen, gilt das Standardverhalten `per_order`. - `per_Bestellung`: Der Versandpreis wird für den passenden Versanddienst unabhängig von der Menge einmal pro Bestellung berechnet. - `per_item`: Berechnung des Versandpreises pro Einheit dieser SKU (d. h. multipliziert mit der gekauften Menge).**Beispiel: per\_item** | | free_shipping_threshold | Zeichenfolge`country:region:service:price_threshold`: Legen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas.) | Optional | Definiert eine Regel für kostenlosen Versand auf Bestellebene. Wenn die Zwischensumme der Bestellung den festgelegten Schwellenwert erreicht oder überschreitet, werden die Versandkosten für den entsprechenden Versanddienst mit `0,00` angesetzt. Formatieren Sie jede Versandoption als durch Doppelpunkt getrennten Wert: - `Land` (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 oder DE). - `Region` (Erforderlich): Region, Bundesstaat, Gebiet oder Präfektur mit dem ISO 3166-2-Unterteilungscode ohne Länderpräfix (zum Beispiel VA oder NY). Verwenden Sie `ALLE`, um für alle Regionen oder Provinzen innerhalb des angegebenen Landes zu gelten. - `Service` (erforderlich): Name des Versanddienstleisters. Muss mit einer im `Versandfeld` definierten Dienstleistung übereinstimmen (z. B. Standard- oder Expressversand). - `price_threshold` (Erforderlich): Zwischensumme der Bestellung nach Abzug von Stückrabatten und vor Steuern und Versandkosten, angegeben in Betrag und Währung. Verwenden Sie ein Komma als Dezimaltrennzeichen und den ISO 4217-Währungscode (zum Beispiel `50,00 USD`).**Beispiel US:ALLE:Standardversand:50,00 USD,US:ALLE:Expressversand:100,00 USD** | ### 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 | Anforderung | | --------------------- | ------------------------------------ | ---------------------------------------------------------- | | popularity_score | Zahl (0–5-Skala) | Empfohlen | Aggregierter Beliebtheitsindikator für dieses Produkt oder diese Variante. Verwenden Sie eine einheitliche Skala von 0 bis 5 in Ihrem Feed (0 ist der niedrigste, 5 ist der höchste Wert). Leiten Sie dies aus Signalen wie Ansichten, Ereignissen des Hinzufügens in den Warenkorb, Konversionen oder Verkaufsrang ab. Verwenden Sie ein einheitliches Aggregationsfenster (zum Beispiel die letzten 90 Tage), um diesen Wert aktuell zu halten.**Beispiel: 4.7** | | return_rate | Zahl0–100 (`%`-Symbol weglassen) | Empfohlen | Prozentsatz der für dieses Produkt oder diese Variante zurückgegebenen Einheiten. Express als numerischer Prozentsatz zwischen 0 und 100 (z. B. `2.0` für 2 % verwenden). Verwenden Sie ein konsistentes Aggregationsfenster (z. B. die letzten 90 Tage).**Beispiel: 2.0** | | product_review_count | Ganzzahlig (nicht negative Ganzzahl) | Empfohlen | Gesamtzahl der mit diesem Produkt oder dieser Variante verknüpften Bewertungen. Stimmen Sie diese mit der Population ab, die zur Berechnung der `product_review_rating` verwendet wurde. Verwenden Sie `0`, wenn keine Bewertungen vorhanden sind. Spiegeln Sie nach Möglichkeit verifizierte Kaufbewertungen wider.**Beispiel: 124** | | product_review_rating | Zahl (1–5-Skala) | Erforderlich, wenn `product_review_count` größer als 0 ist | Durchschnittliche Bewertung für dieses Produkt oder diese Variante. Verwenden Sie in Ihrem Feed eine einheitliche Skala von 1 bis 5 (1 ist der niedrigste, 5 ist der höchste Wert). Dieser Wert muss demselben Datensatz entsprechen wie `product_review_count`. Lassen Sie dieses Feld leer, wenn `product_review_count` `0` ist.**Beispiel: 4,3** | ### Produktbeziehungen Legen Sie Produktverknüpfungen wie Upselling, Cross-Selling und verwandte Produkte für die Produktsuche und Empfehlungen fest. | Feld | Datentyp | Anforderung | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | related_products | Zeichenkette`relationship_type:target_id`: Setzen Sie jede Option als durch Doppelpunkt getrennten Wert fest und trennen Sie mehrere Einträge durch Kommas. | Optional | Hier werden Produktzuordnungen für diesen Artikel definiert. Geben Sie jede Zuordnung als durch Doppelpunkte getrennten Wert an: - `relationship_type` (erforderlich): Muss entweder `upsell`, `cross_sell`, `substitute` oder `accessory` sein. - `target_id` (Erforderlich): Die eindeutige Kennung des Produkts. Wenn das Ziel nicht mit einer vorhandenen `ID` in den importierten Produktdaten übereinstimmt, entfernen wir die Verknüpfung, bevor die Daten an den Agenten weitergeleitet werden. - Keine Selbstverweise: `target_id` darf nicht mit dem aktuellen Produkt übereinstimmen. - In dieser Zeile dürfen keine doppelten `target_id`-Werte vorkommen: Sie können nicht mehrere Beziehungstypen angeben (Sie können beispielsweise nicht in einer Zeile sowohl `upsell` als auch `cross_sell` von diesem Produkt zum selben Zielprodukt angeben). - Maximal 10 Produktbeziehungen pro Produktzeile. **Beispiel: upsell:SKU12AB3457,cross\_sell:SKU12AB3458,accessory:SKU12AB3459** | ### Anweisungen zur Feedverarbeitung Definieren Sie Betriebsfelder, die steuern, wie das System jede Zeile im Feed verarbeitet. | Feld | Datentyp | Anforderung | | ---------------- | ----------------------------- | ----------- | | löschen | Boolean (`true` oder `false`) | Optional | Markieren Sie das Produkt oder die Variante für die dauerhafte Entfernung. Bei `true`, entfernen wir das durch die `ID` identifizierte Produkt und ignorieren alle anderen Spalten in dieser Zeile. Bei Weglassen oder `false`, verarbeiten wir die Zeile als *Aktualisieren/Einfügen („Upsert“)* (A combined operation that updates an existing record if it exists or inserts it if it doesn’t).**Beispiel: true** | | disable_checkout | Boolean (`true` oder `false`) | Optional | Schließen Sie dieses Produkt von den Checkout-Abläufen innerhalb des Agenten aus. Bei der Einstellung `true` wird das Produkt weiterhin zur Auffindbarkeit an KI-Agenten weitergeleitet, doch leiten die Agenten die Nutzer/innen zur `link`-URL des Produkts weiter, um den Kauf abzuschließen, anstatt eine Checkout-Sitzung innerhalb des Agenten zu starten. Wenn Sie dieses Feld weglassen oder auf `false` setzen, bleibt der Checkout aktiviert, sofern das Unternehmen die Checkout-Konfiguration abgeschlossen hat.**Beispiel: true** | ## Bestandsfeed-Spezifikation verwenden Verwenden Sie den Bestandsfeed, um die Produktverfügbarkeit und Lagermengen zu aktualisieren, ohne Ihren vollständigen Produktfeed 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. 1. **Halten Sie Ihren Produktfeed auf dem neuesten Stand**: Die `id`-Werte in Ihrer Bestandsdatei müssen bereits im Haupt-Produktfeed vorhanden sein. 1. **Häufige Bestandsdateien senden**: Push-Aktualisierungen über die Stripe API im CSV-Format. 1. **Teilaktualisierungen senden**: Fügen Sie nur geänderte SKUs hinzu – fehlende SKUs behalten ihren letzten bekannten Bestandsstatus. ## Inventarfeed-Feldreferenz Verwenden Sie die folgende Referenz, um Ihre Inventar-Feed-Felder zu formatieren. ### Inventarfeed-Felder Geben Sie den Status und die Mengen des Live-Bestands an, um die Kaufgenauigkeit aufrechtzuerhalten. | Feld | Datentyp | Anforderung | | ------------------ | ---------------------------------------------------------- | -------------------------------------------------------------------------- | | ID | Zeichenfolge (alphanumerisch) | Erforderlich | Muss mit der `ID` in Ihrem primären Produktfeed übereinstimmen. Dieser Wert ist die Schlüsselkennung.**Beispiel: SKU12AB3456** | | Verfügbarkeit | Enum (`in_stock`, `out_of_stock`, `preorder`, `backorder`) | Erforderlich für alle Produkte | Verfügbarkeit Ihres Produkts.**Beispiel: in\_stock** | | availability_date | Datum (ISO 8601) | Erforderlich, wenn die Produktverfügbarkeit auf `preorder` eingestellt ist | Das Datum, an dem ein vorbestelltes Produkt zur Lieferung verfügbar wird.**Beispiel: 24.02.2026** | | inventory_quantity | Ganzzahlig (nicht negative Ganzzahl) | Erforderlich für alle Produkte | Verkaufbare Einheiten.**Beispiel: 100** | ## Preisfeed-Spezifikation verwenden Verwenden Sie den Preisfeed, um Preisinformationen für die Anzeige und Werbeaktionen zu aktualisieren, ohne Ihren vollständigen Produktfeed erneut übermitteln zu müssen. 1. **Halten Sie Ihren Produktfeed auf dem neuesten Stand**: Die `id`-Werte in Ihrer Preisdatei müssen bereits im Haupt-Produktfeed vorhanden sein. 1. **Häufige Preisdateien senden**: Push-Aktualisierungen über die Stripe API im CSV-Format. 1. **Teilaktualisierungen senden**: Fügen Sie nur geänderte SKUs hinzu – fehlende SKUs behalten ihre zuletzt bekannten Preisinformationen bei. ## Referenz für Feld „Preisfeed“ Verwenden Sie die folgende Referenz, um Ihre Preisfeed-Felder zu formatieren. ### Preisfeed-Felder Geben Sie Preisinformationen für Anzeige- und Werbelogik an. | Feld | Datentyp | Anforderung | | ------------------------- | ----------------------------- | --------------------------------------------------- | | ID | Zeichenfolge (alphanumerisch) | Erforderlich | Muss mit der `ID` in Ihrem primären Produktfeed übereinstimmen. Dieser Wert ist die Schlüsselkennung.**Beispiel: SKU12AB3456** | | Preis | Nummer und Währung (ISO 4217) | Erforderlich für alle Produkte | Preis Ihres Produkts.**Beispiel: 15,00 USD** | | sale_price | Nummer und Währung (ISO 4217) | Optional | Ermäßigter Preis.**Beispiel: 12,99 USD** | | sale_price_effective_date | Datum (ISO 8601) | Erforderlich, wenn Sie `sale_price` angegeben haben | Verkaufsfenster. Trennen Sie Start- und Enddatum mit `/`.**Beispiel: 15.12.2025/15-12-2025** |