Documentație XML Google

Documentație fișier XML – format Google

Informații importante despre variante:
În acest fișier, fiecare variantă de mărime a produsului apare ca o poziție <item> separată. Variantele (de ex. XS, S, M, L, XL) sunt grupate în cadrul unui singur model folosind câmpul g:item_group_id, iar mărimea variantei este transmisă în câmpul g:size.

Structura variantelor de produse

Fiecare element <item> descrie o singură variantă de produs (o mărime specifică). Aceasta înseamnă că pentru un model, în fișier există mai multe elemente (items) – unul pentru fiecare mărime.

Numele produsului (title) conține la sfârșit informația despre mărime, ceea ce facilitează distincția variantelor în sistemele de e-commerce.

Exemplu de structură fișier XML în standardul Google

Mai jos se află un fragment de exemplu dintr-un fișier XML. Codul este afișat în formă tehnică și poate fi copiat.

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

Gruparea variantelor

g:item_group_id – identificator comun al modelului de produs (grupează variantele)

g:id – identificator unic al poziției (variantei) în fișier

g:size – mărimea variantei (de ex. XS, S, M, L)

title – numele produsului (adesea conține și mărimea)

Toate variantele unui model au același g:item_group_id, dar fiecare variantă (mărime) are propriul g:id și g:size.

Identificatori – cum să mapați cel mai bine produsele în integrare

Pentru construirea conexiunilor și actualizarea produselor în sistemul de e-commerce, recomandăm bazarea integrării pe câmpurile g:gtin și g:item_group_id.

g:gtin (EAN) este unic pentru variantă (mărime) și funcționează cel mai bine ca identificator principal al variantei în integrări.

g:item_group_id permite recunoașterea produsului principal (modelului) și asocierea tuturor mărimilor cu acesta.

Câmpul g:id este un identificator tehnic al poziției în fișier. În feed-ul tău are un format complex (de ex. 539-15475) și nu ar trebui folosit ca cheie principală de mapare.

Coduri de produs (MPN) și identificarea variantei

g:mpn – codul variantei (de obicei conține mărimea, de ex. 114-3-S)

g:brand – marca (de ex. numoco)

g:gtin – codul de bare (EAN) al variantei

Dacă integrarea necesită un SKU/cod de variantă, cel mai des se utilizează g:mpn. Pentru identificarea neechivocă a variantei se recomandă g:gtin.

Prețuri și disponibilitate

g:price – prețul variantei

g:sale_price – preț promoțional (dacă există)

g:availability – disponibilitatea variantei (de ex. in stock / out of stock)

g:condition – starea produsului (new)

Prețurile și disponibilitatea se referă la o variantă specifică (mărime), deoarece fiecare mărime este un item separat.

Imagini și link-uri

link – link către produs

g:image_link – imaginea principală a produsului

g:additional_image_link – imagini suplimentare (0+)

Descrierea produsului

Descrierea produsului se află în câmpul description și poate conține text și formatare HTML simplă.

Informațiile despre dimensiuni pot fi incluse în descriere, în timp ce mărimea variantei rezultă întotdeauna din câmpul g:size.

Categorii și atribute suplimentare

g:product_type – categorie internă a produsului

g:google_product_category – categorie în standardul Google

g:gender – atribut (de ex. female)

g:age_group – atribut (de ex. adult)

Rezumat tehnic

În acest fișier, fiecare mărime este o poziție separată, iar variantele unui model sunt grupate. Mapare recomandată: g:gtin (variantă) + g:item_group_id (model).

1 mărime = 1 item g:size g:item_group_id EAN per variantă preț/disponibilitate per variantă

Expediere imediată

Comenzile plasate și plătite până la ora 12:00 sunt expediate în aceeași zi (valabil în zilele lucrătoare).

Următoarea expediere în::

ore

minute

secunde