Skip to main content

Product Feeds

Product Feeds

In order to get the most out of the Size Me Up Virtual Assistant, we ask for a product feed. This feed should be in the Google Shopping format, which is a standard format, well-defined, with some clear requirements. Information about these requirements can be found here.

Faslet Requirements

For Faslet to process your feed correctly, there are a few required fields. We also provide a handy validation tool!

FieldRequiredDescription
idYesThe unique identifier for the product variant.
item_group_idYesThe unique identifier for the product. This should be the same as the Size Chart/Product Identifier passed with the PDP integration.
titleYesThe title of the product.
brandYesThe brand of the product. For a single brand store, this should be your brand.
genderYesThe gender of the product. Allowed values: male, female, unisex
availabilityYesThe availability of the product. Allowed values: in stock, out of stock, in_stock, out_of_stock, preorder, backorder
sizeYesThe size of the product.
linkYesThe URL of the product.
image_linkYesThe URL of the product image.
descriptionYesThe description of the product.
priceYesThe price of the product.
age_groupYesThe target age group of the product. Supported values: kids, adult

Note that this is a superset of the Google Shopping requirements. Every item that the Faslet can be shown on, should have these fields.

Faslet will also read the GTIN (EAN/UPC/JAN) if it is provided. If it is provided, please make sure that it is a GTIN, and not your store's product ID. It is beneficial for your store to leave it out (and set identifier exists to False) if you do not have a valid GTIN.

What is an Item Group ID

As per Google's Documentation:

Use the item group ID [item_group_id] attribute to group product variants in your product data. Variants are a group of similar products that only differ from one another by product details like size [size], color [color], material [material], pattern [pattern], age group [age_group], and gender [gender].

What this means, is that if you have a product with multiple variants (i.e. sizes or colors), you should use the same item_group_id for all of them.

Visually, you can think of it like this:

item group ids

In this case, we have 2 distinct item groups (products), with item_group_id 100 and 200. Note that there ID values (e.g. 100 or 100-01-01) are purely made up and can have any format.

Validation

Enter your feed in the Portal

In the Faslet Partner Portal, under your store, you will find a field to fill in your Google Shopping Feed. This field has a button next to it, to trigger validation.

product feed validations

Validate your feed

Once you've put your feed URL in the field, click the validation button. If your feed is valid, the button will turn into a green checkmark:

valid feed

If your feed is not valid, you will see a popup with the errors and warnings:

invalid feed

In this popup, you can see the information that Faslet gets from your feed. In this case, the item_group_id is missing. Depending on how you generate your feeds, this can be simple to fix. The item_group_id should be mapped to the parent product's ID, or whatever your developer has implemented as the ProductId that is being sent to Faslet. Below is an example of the Finalize screen in Channable:

channable mapping screen

Once your feed has been updated, return to valdating your feed. Repeat this process until all the Errors are gone. Faslet cannot process any items that have errors.

tip

Some items might not have Sizes, Genders or Item Group IDs. These are probably products that do not show the Faslet button. If these items show errors in the validation, they will simply be ignored.

Help

In case of any questions, please don’t hesitate to contact us on support@faslet.me