Facebook XML dokumentācija

XML faila dokumentācija – Facebook formāts

Svarīga informācija par variantiem:
Šajā failā katrs produkta izmēra variants parādās kā atsevišķa pozīcija <item>. Varianti (piem., XS, S, M, L, XL) tiek grupēti viena modeļa ietvaros, izmantojot lauku g:item_group_id, bet varianta izmērs tiek nodots laukā g:size.

Produktu variantu struktūra

Katrs elements <item> apraksta vienu produkta variantu (konkrētu izmēru). Tas nozīmē, ka vienam modelim failā ir vairāki elementi (items) – pa vienam katram izmēram.

Produkta nosaukums (title) beigās satur informāciju par izmēru, kas atvieglo variantu atšķiršanu e-komercijas sistēmās.

Piemērs XML faila struktūrai Facebook standartā

Zemāk ir XML faila fragmenta piemērs. Kods tiek parādīts tehniskā formā un to var kopēt.

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

Variantu grupēšana

g:item_group_id – kopīgs produkta modeļa identifikators

g:id – unikāls pozīcijas (varianta) identifikators

g:size – varianta izmērs (piem., XS, S, M, L)

title – produkta nosaukums (satur izmēru)

Visiem viena modeļa variantiem ir viens un tas pats g:item_group_id, bet katram variantam ir savs g:id, g:gtin un g:size.

Identifikatori – kā vislabāk kartēt produktus integrācijā

Lai veidotu savienojumus un atjauninātu produktus e-komercijas sistēmās, iesakām integrāciju balstīt uz laukiem g:gtin un g:item_group_id.

g:gtin (EAN) – unikāls svītrkods, kas piešķirts konkrētam variantam (izmēram)

g:item_group_id – galvenā produkta (modeļa) identifikators

Lauks g:id ir tehnisks pozīcijas identifikators failā (piem., 2772-21231) un to nevajadzētu izmantot kā galveno atslēgu produktu kartēšanai.

Produktu kodi (MPN) un varianta identifikācija

g:mpn – varianta kods (parasti satur izmēru)

g:brand – produkta zīmols

g:gtin – varianta svītrkods (EAN)

Ja integrācija pieprasa SKU vai varianta kodu, visbiežāk tiek izmantots lauks g:mpn, savukārt viennozīmīgai varianta identifikācijai ieteicams g:gtin.

Cenas un pieejamība

g:price – varianta cena

g:sale_price – akcijas cena (ja ir)

g:availability – varianta pieejamība

g:quantity_to_sell_on_facebook – variantam pieejamais daudzums

g:status – pozīcijas statuss failā

Cenas un pieejamība tiek nodotas atsevišķi katram variantam, jo katrs izmērs ir atsevišķa pozīcija failā.

Attēli un saites

link – saite uz produktu

g:image_link – galvenais produkta attēls

g:additional_image_link – papildu attēli (0+)

Produkta apraksts

Produkta apraksts atrodas laukā description un var saturēt tekstu un vienkāršu HTML formatējumu.

Informācija par izmēriem var būt iekļauta aprakstā, bet varianta izmērs vienmēr izriet no lauka g:size.

Kategorijas un papildu atribūti

g:product_type – iekšējā produkta kategorija

g:google_product_category – standarta kategorija

g:gender – atribūts (piem., female)

g:age_group – atribūts (piem., adult)

Tehniskais kopsavilkums

Šajā failā katrs izmēra variants ir atsevišķa pozīcija, un viena modeļa varianti ir loģiski sagrupēti.

1 izmērs = 1 item g:size g:item_group_id EAN par variantu cena un pieejamība par variantu

Neatliekama nosūtīšana

Pasūtījumi, kas veikti un apmaksāti līdz plkst. 12:00, tiek nosūtīti tajā pašā dienā (attiecas uz darbadienām).

Nākamā nosūtīšana pēc::

stundas

minūtes

sekundes