Dokumentacja XML Facebook

Dokumentacja pliku XML – format Facebook

Ważna informacja o wariantach:
W tym pliku każdy wariant rozmiarowy produktu występuje jako osobna pozycja <item>. Warianty (np. XS, S, M, L, XL) są grupowane w ramach jednego modelu za pomocą pola g:item_group_id, a rozmiar wariantu przekazywany jest w polu g:size.

Struktura wariantów produktów

Każdy element <item> opisuje pojedynczy wariant produktu (konkretny rozmiar). Oznacza to, że dla jednego modelu w pliku znajduje się kilka itemów – po jednym dla każdego rozmiaru.

Nazwa produktu (title) zawiera na końcu informację o rozmiarze,co ułatwia rozróżnienie wariantów w systemach e-commerce.

Przykład struktury pliku XML w standardzie Facebook

Poniżej znajduje się przykładowy fragment pliku XML. Kod wyświetlany jest w formie technicznej i może zostać skopiowany.

<?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>

Grupowanie wariantów

g:item_group_id – wspólny identyfikator modelu produktu

g:id – unikalny identyfikator pozycji (wariantu)

g:size – rozmiar wariantu (np. XS, S, M, L)

title – nazwa produktu (zawiera rozmiar)

Wszystkie warianty jednego modelu posiadają ten sam g:item_group_id, ale każdy wariant ma własne g:id, g:gtin oraz g:size.

Identyfikatory – jak najlepiej mapować produkty w integracji

Do budowania powiązań i aktualizacji produktów w systemach e-commerce zalecamy opierać integrację na polach g:gtin oraz g:item_group_id.

g:gtin (EAN) – unikalny kod kreskowy przypisany do konkretnego wariantu (rozmiaru)

g:item_group_id – identyfikator produktu głównego (modelu)

Pole g:id jest identyfikatorem technicznym pozycji w pliku (np. 2772-21231) i nie powinno być używane jako główny klucz mapowania produktów.

Kody produktu (MPN) i identyfikacja wariantu

g:mpn – kod wariantu (zwykle zawiera rozmiar)

g:brand – marka produktu

g:gtin – kod kreskowy (EAN) wariantu

Jeśli integracja wymaga SKU lub kodu wariantu, najczęściej wykorzystywane jest pole g:mpn, natomiast do jednoznacznej identyfikacji wariantu rekomendowany jest g:gtin.

Ceny i dostępność

g:price – cena wariantu

g:sale_price – cena promocyjna (jeśli występuje)

g:availability – dostępność wariantu

g:quantity_to_sell_on_facebook – ilość dostępna dla wariantu

g:status – status pozycji w pliku

Ceny i dostępność przekazywane są osobno dla każdego wariantu, ponieważ każdy rozmiar stanowi oddzielną pozycję w pliku.

Zdjęcia i linki

link – link do produktu

g:image_link – główne zdjęcie produktu

g:additional_image_link – dodatkowe zdjęcia (0+)

Opis produktu

Opis produktu znajduje się w polu description i może zawierać tekst oraz proste formatowanie HTML.

Informacje o wymiarach mogą być zawarte w opisie, natomiast rozmiar wariantu zawsze wynika z pola g:size.

Kategorie i atrybuty dodatkowe

g:product_type – kategoria wewnętrzna produktu

g:google_product_category – kategoria w standardzie

g:gender – atrybut (np. female)

g:age_group – atrybut (np. adult)

Podsumowanie techniczne

W tym pliku każdy wariant rozmiarowy jest osobną pozycją, a warianty jednego modelu są logicznie grupowane.

1 rozmiar = 1 item g:size g:item_group_id EAN per wariant cena i dostępność per wariant

Natychmiastowa wysyłka

Zamówienia złożone i opłacone do godz. 12:00 wysyłane są tego samego dnia (dotyczy dni roboczych).

Najbliższa wysyłka za::

godz.

min.

sek.