1.1 Product Feed Introduction

General Introduction

As a global sizing leader, the world's best apparel and footwear companies trust us to solve sizing and help them sell smarter. Our Fit Services have been proven to boost conversion rates and slash returns by leveraging the data that we collect about products and shopper behavior.

The importance of high data quality in maximizing the impact cannot be overstated. In particular, precise and accurate data in your product feed allows us to

  • enable our services for more products, thus increasing shoppers' exposure to our services,
  • correctly tailor the user experience,
  • improve the accuracy of our recommendations, and
  • integrate smoothly, allowing Fit Services to go live faster.

Purpose

This product feed specification provides the guidelines and rules to which the feed should conform. It is a guide to help you understand the mandatory data requirements for your product feed and it defines in detail what the format of the data should be with examples and best practices. This document is meant to be the data specifications support material from the sales deck of the Fit Finder Standard service. The product feed is the most critical part of the Fit Finder integration and requires high quality information and data structure. A high impact product feed allows Fit Analytics to import garment information to the Fit Finder database.

Good data quality ensures a smooth Fit Finder integration and leads to strong size recommendations, ensuring the best tailored experience to users.

1.2 Product Feed Requirements

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

1.3 Product Feed Example

Find a product feed example here for download. For a CSV version, please check this link instead.

1.4 Feed Attributes Details

Item Subgroup ID [item_subgroup_id]

Use the item subgroup ID [item_subgroup_id] attribute to group together all sizes for a specific combination of color, material, pattern, etc. For example, 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.

  • Required for each product
  • Format: String (Unicode characters. Recommended: ASCII only); 1–70 characters
  • Examples: 1234567, 12345-250, 12345-BLACK
  • Matching item subgroup IDs must be available on product detail pages (PDPs) and order confirmation pages (OCPs) on your website and mobile apps.
  • The item subgroup ID must not be reused later for a different garment. It must be unique in the history of your shop.
  • The item subgroup ID must be locale-independent. For example, if 12345-BLACK appears in the product feed for your US store, then it must also appear as 12345-BLACK (not e.g. 12345-NOIR) in your French store.
  • Avoid changing item subgroup IDs. Doing so may lead to an interruption of Fit Services if for example the IDs on PDPs are updated before a product feed with the new IDs has been ingested into the Fit Analytics database. It may also lead to a gap in training data for our size recommendation models if we aren’t able to link Fit Finder inputs, purchases and returns due to mismatched IDs.

Display size [display_size]

Use the display size [display_size] attribute to describe the localized size string that should be displayed to shoppers on the Fit Finder result screen.

  • Required for each apparel or footwear product if the size [size] attribute doesn’t match the size strings on the product detail page.
  • Format: String (Unicode characters. Recommended: ASCII only); 1–100 characters
  • Examples: 32, UK 6.5, Small, XXXL
  • The display size must exactly match the size strings on the product detail page.
  • We recommend adding the sizing system in the size strings on the product detail page (PDP) and in the product feed, e.g. UK 10 rather than just 10, to reduce confusion for your shoppers.

Disabled features [disabled_features]

Use the disabled features [disabled_features] 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.

  • Optional for apparel or footwear products that would normally be eligible for Fit Finder
  • Note that there’s no need to explicitly disable Fit Finder for other products like accessories, because Fit Finder wouldn’t be enabled for such products anyway.
  • Supported values:
    • FIT_FINDER if Fit Finder should be disabled for the item
    • otherwise, if Fit Finder should be enabled, the attribute should be left blank

2.1 Returns Feed Introduction

To benefit from the complete Fit Finder experience and the machine learning process of the recommendation engine, Fit Analytics requires a returns feed. That feed allows us to import returns data to our database and matches the return to the purchases for your shop. When sharing the file, it’s important to pay attention not only to the attributes and format but also to the data quality:

  • Good data quality leads to a quicker, smoother import of data into the database.
  • Good data quality leads to better size recommendations, ensuring a good user experience.

Fit Analytics requires an HTTP(S) or (S)FTP URL pointing to a CSV feed using UTF-8 encoding. If your shop is live in multiple countries, we require returns for all locales where Fit Finder is supported and live in. Important details regarding the format, frequency and availability of the feed:

  • Returns must be exported on a daily basis.
  • The filename must include the export date in the format YYYYMMDD.
  • The files should only include new returns that came in since the previous export.
  • Files should remain available for some time (ideally at least a month), so that Fit Analytics can re-ingest them in case of an erro

2.2 Returns Feed Details

Returns Feed Details Table

+
Attribute Code Short description Example/ Notes Mandatory
 Order ID   order_id   The order ID uniquely identifies the purchased order and matches which order the returned item belongs to. ID must match the order number on OCP.  
        1234567
        1234568
        865002
        
 YES 
 Item ID   item_id   The size variant ID uniquely identifies a size variant of a garment. It must not be reused later for a different garment. It must be unique in the history of your shop. 
        12345-250-11
        12345-BLACK-S
    
 YES 
 Quantity   quantity   Use the quantity to state the quantity of the items being returned 
        1
        2
     
 YES 
 Return Reason   return_reason   The return reason indicates why an item was returned. Used for improving the recommendation system and for reporting.Only required if a shop collects return reasons.  
        big
        small
        fit 
        style
        other
     
 YES (if applicable) 
 Is Cancelled   is_cancelled   If the user has the option to cancel a purchase on your website, use the is canceled attribute to state if the returned item was canceled. 
        true
        false
        is cancelled
     
 YES (if applicable) 
 Size   size   Indicates the purchased/returned size 
        US 9
        M
        33/31
     
 YES 
 Product Code   item_subgroup_id   The item subgroup ID groups together 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
     
 RECOMMENDED 
 GTIN(EAN)   gtin   A GTIN or EAN uniquely identifies your product. The 13-digits universal barcode identifies the product and size and links purchased and returned product. 
3234567890126
 RECOMMENDED 

2.3 Returns Feed Example

Find a return feed example here for download. For a CSV version of the return feed, please check this link instead.

Questions?

We're happy to help. Send your question to support@fitanalytics.com.