Facebook-XML-Dokumentation

XML-Dateidokumentation – Facebook-Format

Wichtige Informationen zu Varianten:
In dieser Datei erscheint jede Größenvariante des Produkts als eigener <item>-Eintrag. Varianten (z. B. XS, S, M, L, XL) werden innerhalb eines Modells mithilfe des Feldes g:item_group_id gruppiert, und die Variantengröße wird im Feld g:size übermittelt.

Struktur der Produktvarianten

Jedes <item>-Element beschreibt eine einzelne Produktvariante (eine bestimmte Größe). Das bedeutet, dass es für ein Modell mehrere Elemente (items) in der Datei gibt – eines für jede Größe.

Der Produktname (title) enthält am Ende Informationen zur Größe, was die Unterscheidung von Varianten in E-Commerce-Systemen erleichtert.

Beispiel für die XML-Dateistruktur im Facebook-Standard

Unten finden Sie ein Beispielfragment einer XML-Datei. Der Code wird in technischer Form angezeigt und kann kopiert werden.

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
		<channel>
		<title><![CDATA[Google Shopping Feed]]></title>
		<description><![CDATA[Feed produktów Google Shopping]]></description>

			<item>
			  <g:id>2063-18128</g:id>
			  <title><![CDATA[478-1 MAYA Sukienka z dłuższym tyłem, dekoltem i paskiem - RÓŻOWE KWIATY - M]]></title>
			  <description><![CDATA[Maya - asymetryczna <strong>sukienka z dłuższym tyłem</strong>, dekoltem i paskiem. Wzór: różowe kwiaty na miętowym tle. Spódnica z dłuższym tyłem sprawdzi się idealnie w tańcu. Produkcja polska. Marka <strong>Numoco</strong>.<div class="sizes">Wymiary mierzone są na płasko - bez rozciągania materiału (+/- 2 cm)<br>Modelka na zdjęciu ma 170cm wzrostu i ma ubrany rozm. XS.</div>]]></description>
			  <link><![CDATA[https://www.numoco.com/p2063,478-1-maya-sukienka-z-dluzszym-tylem-dekoltem-i-paskiem-r-owe-kwiaty.html]]></link>
			  <g:image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15067.jpg]]></g:image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15068.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15066.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15069.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15070.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15064.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15065.jpg]]></g:additional_image_link>
			  <g:price>300.00 PLN</g:price>
			  <g:availability>in stock</g:availability>
			  <g:condition>new</g:condition>
			  <g:brand><![CDATA[numoco]]></g:brand>
			  <g:gtin>5903133866923</g:gtin>
			  <g:mpn><![CDATA[478-1-M]]></g:mpn>
			  <g:item_group_id>2063</g:item_group_id>
			  <g:size>M</g:size>
			  <g:gender>female</g:gender>
			  <g:age_group>adult</g:age_group>
			  <g:product_type><![CDATA[Moda damska / Sukienki]]></g:product_type>
			  <g:google_product_category>Apparel & Accessories > Clothing > Dresses</g:google_product_category>
			</item>
			<item>
			  <g:id>2063-18129</g:id>
			  <title><![CDATA[478-1 MAYA Sukienka z dłuższym tyłem, dekoltem i paskiem - RÓŻOWE KWIATY - L]]></title>
			  <description><![CDATA[Maya - asymetryczna <strong>sukienka z dłuższym tyłem</strong>, dekoltem i paskiem. Wzór: różowe kwiaty na miętowym tle. Spódnica z dłuższym tyłem sprawdzi się idealnie w tańcu. Produkcja polska. Marka <strong>Numoco</strong>.<div class="sizes">Wymiary mierzone są na płasko - bez rozciągania materiału (+/- 2 cm)<br>Modelka na zdjęciu ma 170cm wzrostu i ma ubrany rozm. XS.</div>]]></description>
			  <link><![CDATA[https://www.numoco.com/p2063,478-1-maya-sukienka-z-dluzszym-tylem-dekoltem-i-paskiem-r-owe-kwiaty.html]]></link>
			  <g:image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15067.jpg]]></g:image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15068.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15066.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15069.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15070.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15064.jpg]]></g:additional_image_link>
			  <g:additional_image_link><![CDATA[https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15065.jpg]]></g:additional_image_link>
			  <g:price>300.00 PLN</g:price>
			  <g:sale_price>240.00 PLN</g:sale_price>
			  <g:availability>in stock</g:availability>
			  <g:condition>new</g:condition>
			  <g:brand><![CDATA[numoco]]></g:brand>
			  <g:gtin>5903133866916</g:gtin>
			  <g:mpn><![CDATA[478-1-L]]></g:mpn>
			  <g:item_group_id>2063</g:item_group_id>
			  <g:size>L</g:size>
			  <g:gender>female</g:gender>
			  <g:age_group>adult</g:age_group>
			  <g:product_type><![CDATA[Moda damska / Sukienki]]></g:product_type>
			  <g:google_product_category>Apparel & Accessories > Clothing > Dresses</g:google_product_category>
			</item>
		<item>

	</channel>
</rss>

Gruppierung von Varianten

g:item_group_id – gemeinsamer Identifikator des Produktmodells

g:id – eindeutiger Identifikator der Position (Variante)

g:size – Variantengröße (z. B. XS, S, M, L)

title – Produktname (enthält Größe)

Alle Varianten eines Modells haben dieselbe g:item_group_id, aber jede Variante hat ihre eigene g:id, g:gtin und g:size.

Identifikatoren – wie Produkte bei der Integration am besten zugeordnet werden

Zum Aufbau von Verbindungen und zur Aktualisierung von Produkten in E-Commerce-Systemen empfehlen wir, die Integration auf die Felder g:gtin und g:item_group_id zu stützen.

g:gtin (EAN) – eindeutiger Barcode, der einer bestimmten Variante (Größe) zugewiesen ist

g:item_group_id – Identifikator des Hauptprodukts (Modells)

Das Feld g:id ist ein technischer Identifikator der Position in der Datei (z. B. 2772-21231) und sollte nicht als Hauptschlüssel für die Produktzuordnung verwendet werden.

Produktcodes (MPN) und Variantenidentifikation

g:mpn – Variantencode (enthält normalerweise die Größe)

g:brand – Produktmarke

g:gtin – Barcode (EAN) der Variante

Wenn die Integration eine SKU oder einen Variantencode erfordert, wird am häufigsten das Feld g:mpn verwendet, während zur eindeutigen Identifizierung der Variante g:gtin empfohlen wird.

Preise und Verfügbarkeit

g:price – Variantenpreis

g:sale_price – Aktionspreis (falls vorhanden)

g:availability – Variantenverfügbarkeit

g:quantity_to_sell_on_facebook – verfügbare Menge für die Variante

g:status – Status der Position in der Datei

Preise und Verfügbarkeit werden für jede Variante separat übermittelt, da jede Größe eine eigene Position in der Datei darstellt.

Bilder und Links

link – Link zum Produkt

g:image_link – Hauptproduktbild

g:additional_image_link – zusätzliche Bilder (0+)

Produktbeschreibung

Die Produktbeschreibung befindet sich im Feld description und kann Text und einfache HTML-Formatierung enthalten.

Informationen zu Abmessungen können in der Beschreibung enthalten sein, während sich die Variantengröße immer aus dem Feld g:size ergibt.

Kategorien und zusätzliche Attribute

g:product_type – interne Produktkategorie

g:google_product_category – Standardkategorie

g:gender – Attribut (z. B. female)

g:age_group – Attribut (z. B. adult)

Technisches Resümee

In dieser Datei ist jede Größenvariante eine separate Position, und Varianten eines Modells sind logisch gruppiert.

1 Größe = 1 item g:size g:item_group_id EAN pro Variante Preis und Verfügbarkeit pro Variante

Sofortiger Versand

Bestellungen, die bis 12:00 Uhr aufgegeben und bezahlt wurden, werden noch am selben Tag versandt (gilt für Werktage).

Nächster Versand am::

Std.

Min.

Sek.