Google XML dokumentacija

XML failo dokumentacija – „Google“ formatas

Svarbi informacija apie variantus:
Šiame faile kiekvienas dydžio variantas pateikiamas kaip atskira <item> pozicija. Variantai (pvz., XS, S, M, L, XL) yra grupuojami viename modelyje naudojant lauką g:item_group_id, o varianto dydis perduodamas lauke g:size.

Produktų variantų struktūra

Kiekvienas elementas <item> aprašo vieną produkto variantą (konkretų dydį). Tai reiškia, kad vienam modeliui faile yra keli elementai (items) – po vieną kiekvienam dydžiui.

Produkto pavadinime (title) pabaigoje yra informacija apie dydį, kas palengvina variantų atskyrimą el. prekybos sistemose.

XML failo struktūros pavyzdys „Google“ standarte

Žemiau pateikiamas pavyzdinis XML failo fragmentas. Kodas rodomas technine forma ir gali būti kopijuojamas.

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

Variantų grupavimas

g:item_group_id – bendras produkto modelio identifikatorius (grupuoja variantus)

g:id – unikalus pozicijos (varianto) identifikatorius faile

g:size – varianto dydis (pvz., XS, S, M, L)

title – produkto pavadinimas (dažnai su dydžiu)

Visi vieno modelio variantai turi tą patį g:item_group_id, tačiau kiekvienas variantas (dydis) turi savo g:id bei g:size.

Identifikatoriai – kaip geriausia susieti produktus integracijoje

Produktų susiejimui ir atnaujinimui el. prekybos sistemose rekomenduojame integraciją grįsti laukais g:gtin bei g:item_group_id.

g:gtin (EAN) yra unikalus variantui (dydžiui) ir geriausiai tinka kaip pagrindinis varianto identifikatorius integracijose.

g:item_group_id leidžia atpažinti pagrindinį produktą (modelį) ir susieti su juo visus dydžius.

Laukas g:id yra techninis pozicijos identifikatorius faile. Jūsų sraute jis yra sudėtinio formato (pvz., 539-15475) ir neturėtų būti naudojamas kaip pagrindinis susiejimo raktas.

Produkto kodai (MPN) ir varianto identifikavimas

g:mpn – varianto kodas (paprastai su dydžiu, pvz., 114-3-S)

g:brand – prekės ženklas (pvz., numoco)

g:gtin – varianto brūkšninis kodas (EAN)

Jei jūsų integracija reikalauja SKU/varianto kodo, dažniausiai naudojamas g:mpn. Vienareikšmiam varianto atpažinimui rekomenduojamas g:gtin.

Kainos ir prieinamumas

g:price – varianto kaina

g:sale_price – reklaminė kaina (jei yra)

g:availability – varianto prieinamumas (pvz., in stock / out of stock)

g:condition – produkto būklė (new)

Kainos ir prieinamumas taikomi konkrečiam variantui (dydžiui), nes kiekvienas dydis yra atskira prekė (item).

Nuotraukos ir nuorodos

link – nuoroda į produktą

g:image_link – pagrindinė produkto nuotrauka

g:additional_image_link – papildomos nuotraukos (0+)

Produkto aprašymas

Produkto aprašymas yra lauke description ir gali turėti tekstą bei paprastą HTML formatavimą.

Informacija apie išmatavimus gali būti aprašyme, tačiau varianto dydis visada nurodomas lauke g:size.

Kategorijos ir papildomi atributai

g:product_type – vidinė produkto kategorija

g:google_product_category – kategorija pagal „Google“ standartą

g:gender – atributas (pvz., female)

g:age_group – atributas (pvz., adult)

Techninis apibendrinimas

Šiame faile kiekvienas dydis yra atskira pozicija, o vieno modelio variantai yra sugrupuoti. Rekomenduojamas susiejimas: g:gtin (variantas) + g:item_group_id (modelis).

1 dydis = 1 item g:size g:item_group_id EAN per variantą kaina/prieinamumas per variantą

Nedelsiant pristatymas

Užsakymai, pateikti ir apmokėti iki 12:00, išsiunčiami tą pačią dieną (taikoma darbo dienomis).

Artimiausias siuntimas už::

val.

min.

sek.