Dokumentacja XML Google

Dokumentacja pliku XML – format Google

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 Google

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 (grupuje warianty)

g:id – unikalny identyfikator pozycji (wariantu) w pliku

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

title – nazwa produktu (często zawiera również rozmiar)

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

Identyfikatory – jak najlepiej mapować produkty w integracji

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

g:gtin (EAN) jest unikalny dla wariantu (rozmiaru) i najlepiej sprawdza się jako główny identyfikator wariantu w integracjach.

g:item_group_id pozwala rozpoznać produkt główny (model) i powiązać z nim wszystkie rozmiary.

Pole g:id jest identyfikatorem technicznym pozycji w pliku. W Twoim feedzie ma format złożony (np. 539-15475) i nie powinno być używane jako główny klucz mapowania.

Kody produktu (MPN) i identyfikacja wariantu

g:mpn – kod wariantu (zwykle zawiera rozmiar, np. 114-3-S)

g:brand – marka (np. numoco)

g:gtin – kod kreskowy (EAN) wariantu

Jeśli Twoja integracja wymaga SKU/kodu wariantu, najczęściej wykorzystuje się g:mpn. Do jednoznacznego rozpoznania 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 (np. in stock / out of stock)

g:condition – stan produktu (new)

Ceny i dostępność dotyczą konkretnego wariantu (rozmiaru), ponieważ każdy rozmiar jest osobnym itemem.

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 Google

g:gender – atrybut (np. female)

g:age_group – atrybut (np. adult)

Podsumowanie techniczne

W tym pliku każdy rozmiar jest osobną pozycją, a warianty jednego modelu są grupowane. Rekomendowane mapowanie: g:gtin (wariant) + g:item_group_id (model).

1 rozmiar = 1 item g:size g:item_group_id EAN per wariant cena/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.