Feed Format
Your product feed should be shared via an HTTP(S) or (S)FTP URL hosted by you pointing to a CSV or XML (RSS/Atom) file using UTF-8 encoding. There must be a separate feed entry for each size variant, and the attribute names must match the names in the "Attribute" column of the tables below.
If the previously mentioned methods are not feasible for you, we can also accommodate data feeds hosted on your Azure Blob Storage, AWS S3, or Google Cloud Storage bucket.
If you already have a Facebook or Google product feed, you’ll likely only need a few adjustments, the main one being the addition of an item_subgroup_id attribute.
If you have multiple online stores or versions of your store with different sizing, product availability or languages, we require a separate product feed for each.
- Example 1: If you have French and Dutch language versions of your Belgian store, we require separate French and Dutch feeds.
- Example 2: If your European stores all share the same sizing, product availability and language (e.g. English), then it’s fine to provide a single European feed.
Feed Mandatory Data
Fit Services like Fit Finder can only be enabled if all of the following attributes are provided for the product in question. If you can’t provide the values as requested, please contact us so we can suggest how you could solve this.
Mandatory Data Table
Attribute |
Short description |
Examples |
id
|
An ID that uniquely identifies a size variant of a garment. |
12345-250-11
12345-BLACK-S
|
item_subgroup_id
|
An ID that uniquely identifies a color variant of a garment, grouping together all sizes for a specific combination of color, material, pattern, etc.
For example, all sizes of a given red dress should have the same item subgroup ID, but the same dress in blue (or in a different material or pattern) should have a different item subgroup ID.
|
1234567
12345-250
12345-BLACK
|
item_group_id
|
An ID that groups together all variants of a garment. Variants are a group of similar products that only differ from one another by product details like the size, color, material or pattern.
|
12345
|
brand
|
The product’s brand name, manufacturer or designer, which allows us to customize recommendations by brand. |
Esprit
Nike
Adidas
Puma
|
gender
|
The Fit Finder flow differs between men’s and women’s products, e.g. recommendations for women require bra information. The [gender] also allows us to tailor size recommendations, e.g. men’s sizes typically fit differently than women’s sizes. Products should be classifed as unisex if that product can be recommended for women and men.
|
male
female
unisex
|
age_group
|
The demographic that your product is designed for. Correctly distinguishing between adults’ and kids’ products is important. A kids’ product that is mistakenly marked as for adults might lead to inaccurate size recommendations for the product in question and might pollute our machine learning data, skewing recommendations for other products.
|
kids
adult
|
size
|
The localized size string that is displayed to shoppers on the product detail page.
We recommend adding the size system in the size strings on the PDP and in the product feed, e.g. UK 10 rather than just 10, to reduce confusion for your shoppers.
|
32
UK 6.5
Small
XXXL
|
size_system
|
The country’s sizing system that your product uses. |
UK
US
EU
|
size_type
|
The body type for which the garment is designed. |
regular
petite
plus
tall
big
maternity
|
link
|
A URL pointing to the product detail page on the shop website. |
http://au.exampleshop.com/TZZ12345-105-51.html
|
image_link
|
A URL pointing to the main product image. |
http://au.exampleshop.com/TZZ12345-105-51.jpg
|
title
|
A brief description of the product. |
Adidas trainer
Long sleeve blouse
|
fb_product_category
or
google_product_category
|
The product category according to the Facebook product taxonomy (preferred) or the Google product taxonomy. At least one of the two must be provided, since the product category affects the Fit Finder user experience and size recommendations. For example, shoppers are asked to input bra information for tops, but not for bottoms, and a size M for a dress may fit differently than a size M for shorts.
|
2271
Apparel & Accessories > Clothing > Dresses
clothing & accessories > clothing > women's clothing > dresses
|
product_type
|
The product type according to your own product categorization system. |
Home > Women > Dresses > Maxi Dresses
|
availability
|
Whether a product is in or out of stock. |
in_stock
out_of_stock
|
Feed Optional Data
The following attributes help with detecting feed data quality issues that could affect size and style recommendations, and tuning for which products Fit Services are enabled.
Optional Data Table
Attribute |
Short description |
Examples |
gtin
|
The Global Trade Item Number (GTIN), also known as the EAN or UPC, that uniquely identifies a size variant of a garment in a globally standard way.
|
3234567890126
|
color
|
The product’s color. |
Green
|
material
|
The main fabric or material that your product is made of. |
Cotton
|
pattern
|
The pattern or graphic print on your product. |
striped
|