Facebook XML Документация

Документация на XML файл – Facebook формат

Важна информация за вариантите:
В този файл всеки вариант на размера на продукта се появява като отделна позиция <item>. Вариантите (напр. XS, S, M, L, XL) са групирани в рамките на един модел с помощта на полето g:item_group_id, а размерът на варианта се предава в полето g:size.

Структура на продуктовите варианти

Всеки елемент <item> описва единичен вариант на продукта (конкретен размер). Това означава, че за един модел във файла има няколко позиции (items) – по една за всеки размер.

Името на продукта (title) съдържа информация за размера в края, което улеснява разграничаването на вариантите в системите за електронна търговия.

Пример за структура на XML файл по стандарт Facebook

По-долу е примерен фрагмент от XML файл. Кодът се показва в техническа форма и може да бъде копиран.

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

Групиране на варианти

g:item_group_id – общ идентификатор на модела на продукта

g:id – уникален идентификатор на позицията (варианта)

g:size – размер на варианта (напр. XS, S, M, L)

title – име на продукта (съдържа размер)

Всички варианти на един модел имат един и същ g:item_group_id, но всеки вариант има собствен g:id, g:gtin и g:size.

Идентификатори – как най-добре да се картографират продукти при интеграция

За изграждане на връзки и актуализиране на продукти в системите за електронна търговия, препоръчваме интеграцията да се базира на полетата g:gtin и g:item_group_id.

g:gtin (EAN) – уникален баркод, присвоен на конкретен вариант (размер)

g:item_group_id – идентификатор на основния продукт (модел)

Полето g:id е технически идентификатор на позицията във файла (напр. 2772-21231) и не трябва да се използва като основен ключ за картографиране на продуктите.

Продуктови кодове (MPN) и идентификация на варианта

g:mpn – код на варианта (обкновено съдържа размера)

g:brand – марка на продукта

g:gtin – баркод (EAN) на варианта

Ако интеграцията изисква SKU или код на варианта, най-често се използва полето g:mpn, докато за еднозначна идентификация на варианта се препоръчва g:gtin.

Цени и наличност

g:price – цена на варианта

g:sale_price – промоционална цена (ако има такава)

g:availability – наличност на варианта

g:quantity_to_sell_on_facebook – налично количество за варианта

g:status – статус на позицията във файла

Цените и наличността се предават отделно за всеки вариант, тъй като всеки размер представлява отделна позиция във файла.

Снимки и връзки

link – връзка към продукта

g:image_link – основна снимка на продукта

g:additional_image_link – допълнителни снимки (0+)

Описание на продукта

Описанието на продукта се намира в полето description и може да съдържа текст и просто HTML форматиране.

Информацията за размерите може да бъде включена в описанието, докато размерът на варианта винаги произтича от полето g:size.

Категории и допълнителни атрибути

g:product_type – вътрешна продуктова категория

g:google_product_category – стандартна категория

g:gender – атрибут (напр. female)

g:age_group – атрибут (напр. adult)

Техническо обобщение

В този файл всеки вариант на размера е отделна позиция, а вариантите на един модел са логически групирани.

1 размер = 1 item g:size g:item_group_id EAN за вариант цена и наличност за вариант

Незабавна доставка

Поръчки, направени и платени до 12:00, се изпращат същия ден (важи за работни дни).

Следващата доставка за::

час.

мин.

сек.