Documentație XML Facebook

Documentație fișier XML – format Facebook

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 Facebook

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

g:id – identificator unic al poziției (variantei)

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

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

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

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

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

g:gtin (EAN) – cod de bare unic atribuit unei variante specifice (mărimi)

g:item_group_id – identificator al produsului principal (modelului)

Câmpul g:id este un identificator tehnic al poziției în fișier (de ex. 2772-21231) și nu ar trebui folosit ca cheie principală de mapare a produselor.

Coduri de produs (MPN) și identificarea variantei

g:mpn – codul variantei (de obicei conține mărimea)

g:brand – marca produsului

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

Dacă integrarea necesită un SKU sau cod de variantă, cel mai des este utilizat câmpul g:mpn, în timp ce pentru identificarea neechivocă a variantei este recomandat g:gtin.

Prețuri și disponibilitate

g:price – prețul variantei

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

g:availability – disponibilitatea variantei

g:quantity_to_sell_on_facebook – cantitatea disponibilă pentru variantă

g:status – statusul poziției în fișier

Prețurile și disponibilitatea sunt transmise separat pentru fiecare variantă, deoarece fiecare mărime constituie o poziție separată în fișier.

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 standard

g:gender – atribut (de ex. female)

g:age_group – atribut (de ex. adult)

Rezumat tehnic

În acest fișier, fiecare variantă de mărime este o poziție separată, iar variantele unui model sunt grupate logic.

1 mărime = 1 item g:size g:item_group_id EAN per variantă preț și 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