Feed Format
The product feed should be passed to Fit Analytics either via (S)FTP or HTTP(S) dynamic link, which should be automatically updated at least once every day.
That link should direct to a CSV or XML (RSS/Atom) feed 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 square brackets below.
If you already have a 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 |
Code |
Short description |
Example/ Notes |
Size variant ID
|
[id] |
Size variant ID uniquely identifies a size variant of a garment. |
12345-250-11
12345-BLACK-S
|
Item subgroup ID
|
[item_subgroup_id] |
Item subgroup ID groups all sizes for a specific combination of color, material, pattern, etc.
E.g. all sizes of a given red T-shirt should have the same item subgroup ID, but the same T-shirt in blue (or in a different material or pattern) should have a different item subgroup ID.
|
1234567
12345-250
12345-BLACK
|
Item group ID
|
[item_group_id] |
The item group ID groups variants in your product data. 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
|
[brand] |
The brand indicates the product’s brand name, manufacturer or designer, allowing us to customize recommendations by brand. |
Esprit
Nike
Adidas
Puma
|
Gender
|
[gender] |
The Fit Finder flow differs between men’s and women’s products, e.g. recommendations for women require bra information. It 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
|
[age_group] |
The age group attribute displays 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 - 5-13 years
adult - Typically teens or older (13 years old or more)
|
size
|
[size] |
The size attribute describes the standardized size of a product. The standardized size allows Fit Analytics to group together purchase data for equivalent sizes, thus enabling Fit Analytics to provide machine-learning-based size recommendations for more products and improving the quality of those recommendations by increasing the amount of data they’re based on. |
32
6.5
2XL
10-12
29W 34L
|
Display size
|
[display_size] |
The localized size attribute describes the localized size string that is displayed to shoppers on the product detail page.
We recommend adding the sizing 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
|
[size_system] |
With the size system attribute you can explain which country’s sizing system your product uses. |
UK
US
EU
|
Size type
|
[size_type] |
The size type describes the cut/fit of a product. |
Petite [petite]
Plus [plus]
Tall [tall]
Maternity [maternity]
|
Image link
|
[image_link] |
When users click on a product, they’re sent to a landing page on the shop website for that product. Set the URL for this landing page with the link attribute. |
http://au.exampleshop.com/TZZ12345-105-51.html
|
Title
|
[title] |
The title attribute identifies the product you’re selling. |
Adidas trainer
Long sleeve blouse
|
Google Product Category
|
[google_product_category] |
The Google product category specifies the garment type, which 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
or
Apparel & Accessories > Clothing > Dresses
|
Availability
|
[availability] |
The availability indicates whether a product is or out of stock. |
in_stock
out_of_stock
|
Description
|
[description] |
The description gives detailed information about a product, listing product features, technical specifications, and visual attributes. |
|
Price
|
[price] |
The price indicates how much you’re charging for your product. |
15.00 USD
25€
|
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 |
Code |
Short description |
Example/ Notes |
GTIN
|
[gtin] |
Global Trade Item Number (GTIN), also known as an EAN or UPC, that uniquely identifies a size variant of a garment in a globally standard way. |
3234567890126
|
Color
|
[color] |
The product’s color. |
Green
|
Material
|
[material] |
The main fabric or material that your product is made of. |
Cotton
|
Pattern
|
[pattern] |
The pattern or graphic print on your product. |
striped
|
Additional image link
|
[additional_image_link] |
The URL of an additional image for your product. |
https://www.example.com/image2.jpg
|
Product type
|
[product_type] |
The product type according to your own product categorization system. |
Home > Women > Dresses > Maxi Dresses
|
Disabled features
|
[disabled_features] |
You can use this attribute to let us know if you’d prefer not to use Fit Finder for specific apparel or footwear products that would normally be eligible for Fit Finder. |
FIT_FINDER if Fit Finder should be disabled for the item, or blank if Fit Finder should be enabled
|