Product Integration (XML Feed)

Sizebay supports product integration via XML feeds based on the Google Merchant Center standard. This approach simplifies implementation while ensuring compatibility with e-commerce best practices.

1. Requirements

The XML feed should be segmented by each unique combination of country, language, and currency to ensure accurate localization.

Parameter	Description	Required for Separate Feed?
target_country	Country where the product is sold	✅
content_language	Language used for product content	✅
currency	Currency in which the product is priced	✅

Rule of thumb: You must provide one XML feed per unique combination of target_country + content_language + currency

2. XML Tags & Descriptions

Field	Description	Required
id	Unique ID of the variant (e.g. color + size)	✅
item_group_id	Common ID for all variants of a product	✅
title	Product title (localized)	✅
description	Product description (localized)	✅
link	Product detail page URL (localized)	✅
image_link	Main image of the variant	✅
additional_image_link	Additional images for the variant	✅ if available
brand	Product brand	✅
product_type	Product taxonomy (breadcrumb-style format)	✅
price	Regular price	✅
sale_price	Promotional price (if applicable)	❌
sale_price_effective_date	Promotion date range (ISO 8601 format)	❌
availability	Stock status (in stock, out of stock)	✅
size	Variant size	✅
color	Variant color	✅
gender	Target gender (male, female, unisex)	✅
age_group	Target age group (adult, kids)	✅
gtin	GTIN / EAN / UPC	✅ if available

3. Sample XML Entry

<item>
  <id>12345-RED-M</id>
  <item_group_id>12345</item_group_id>
  <title>Basic Men's T-Shirt - Red</title>
  <description>Comfortable cotton t-shirt for daily wear.</description>
  <link>https://store.com/en/product/basic-tshirt-red</link>
  <image_link>https://store.com/img/12345-red.jpg</image_link>
  <additional_image_link>https://store.com/img/12345-red_1.jpg</additional_image_link>
  <brand>Nike</brand>
  <product_type>Apparel & Accessories > Clothing > Tops > T-Shirts</product_type>
  <price>49.90 USD</price>
  <sale_price>39.90 USD</sale_price>
  <sale_price_effective_date>2025-06-01T00:00:00/2025-06-07T23:59:59</sale_price_effective_date>
  <availability>in stock</availability>
  <size>M</size>
  <color>Red</color>
  <gender>male</gender>
  <age_group>adult</age_group>
  <gtin>7891234567890</gtin>
</item>

4. Feed Update Frequency

Sizebay fetches your XML feed once per day at 05:00 AM (GMT+0).

• If the product does not exist, it will be automatically added to our system.

• If the product already exists, it will be updated based on changes in:

• title

• price

• sale_price

• sale_price_effective_date

• availability

Make sure your XML is accessible and up-to-date before the scheduled fetch time.