Enables you to manage all your product information
We expect to receive all the items sold and searchable on your website.
1 item = 1 sku = 1 line in your CSV/text (or 1 item in XML)
If you have variants (for instance a tee shirt in several color and sizes) we need to receive each sku as a line/item in the feed, as well as the “parent id” information in the attribute “item_group_id”.
However, the parent product must not be a line in the feed.
Sensefuel product data specification is mainly inherited from Google Merchant Center (Google Shopping)
https://support.google.com/merchants/answer/7052112?hl=en
CSV/text
- Encoding in UTF-8 or Latin1
- Recommended separator is | (pipe)
- Use of double quotes is recommended on all attributes and values to avoid any potential conflict with the column separator
- Multi-values within attributes are allowed on some Google Merchant Center attributes (see tables in next pages) and on all additional attributes
- The catalog feed is extensible with any attribute and values. The name of the attribute cannot contain a space (if any then replace with an underscore for instance)
XML
- Encoding in UTF-8
- Syndication format allowed are RSS 2.0, RSS 1.0 & Atom 1.0
- Using <![CDATA][value]]> in attributes can be mandatory to avoid conflict of interpretation with XML markup.
However empty CDATA is not allowed when your attributes does not contain any value - Multi-values within attributes are allowed on some GMC attributes (see tables in next pages) and on all additional attributes.
Most of the time in XML you repeat the attributes tags as many times as necessary to define all possible values for an attribute - The catalog feed is extensible with any attribute and values. The name of the attribute cannot contain a space (if any then replace with an underscore for instance)
List of attributes
| Attribute | Criticality | Sensefuel specification (if different from GMC) or annotations |
| id | Mandatory |
Use the product’s SKU. Must be a unique value for each product. Maximum 50 characters. |
| item_group_id | Optional | ID for a group of products that come in different versions (variants of color, size, etc) and would be mandatory for some websites. This enables Sensefuel to group these variation on a single product tile. |
| product_type | Mandatory | Expected data should represent the nature of the article, its typology, presented as a breadcrumb without the home level and the product detail page level. •Each level must be separated by « space »>« space » •temporary categorization such as « promotions », « sales », « our selection » must not be present in this attribute •Multivalued is only allowed when the feed is in XML format |
| title | Mandatory |
Product title on your website eventually without the brand, size (or gender) as this data should already be in other attributes. No HTML allowed. Maximum 150 characters. |
| brand | Optional |
No HTML allowed Maximum 70 characters. |
| description | Optional | HTML not recommended and to be avoided. Maximum 5000 characters. |
| link | Mandatory | No relative url allowed, only absolute url are allowed and must match with your website domain. |
| image_link | Mandatory | No relative url allowed, only absolute url are allowed. Image size/weight must be around 50ko |
| availability | Mandatory |
Values allowed : “in stock” and “out of stock” out_of_stock products will be buried in the ranking |
| price | Mandatory |
Numeric data only. Currency must be included. (ISO 4217) |
| sale_price | Optional | Numeric data only. Would be mandatory when the product is discounted. Sale_price cannot be higher than the price. Currency must be included.(ISO 4217) |
| sale_price_effective_date | Optional |
The date range during which the sale price applies. Use together with the sale_price attribute. Attribute is only useful if you provide a sale_price before their application. If you don’t submit this attribute, the sale_price provided always applies. |
| age_group | Optional | Supported values are : « newborn », « infant », « toddler », « kids » and « adult ». More details here https://support.google.com/merchants/answer/6324463?visit_id=638409963578915778-3343682162&rd=1 |
| gender | Optional | Supported values are : « male », « female » and « unisex ». More details here : https://support.google.com/merchants/answer/6324479?visit_id=638409963578915778-3343682162&rd=1 |
| color | Optional | Would be recommended or mandatory regarding your business context. (especially when the item_group_id is provided) Main colors are recommended to be provided here and if necessary, specify the exact color in a custom attribute. |
| size | Optional | Would be recommended or mandatory regarding your industry or business context. (especially when the item_group_id is provided |
| material | Optional | Main material instead of the product composition. Multivalued allowed |
| pattern | Optional | Use this attribute to describe the pattern or graphic print on your product. Multivalued allowed |
| unit_pricing_measure | Optional |
The measure and dimension of your product as it is sold. Supported units Volume US imperial: floz, pt, qt, gal Volume metric: ml, cl, l, cbm Length: in, ft, yd, cm, m Area: sqft, sqm Per unit: ct |
| unit_pricing_base_measure | Optional |
The product’s base measure for pricing (for example, 100ml means the price is calculated based on a 100ml units). Supported units: Volume US imperial: floz, pt, qt, gal Volume metric: ml, cl, l, cbm Length: in, ft, yd, cm, m Area: sqft, sqm Per unit: ct |
| gtin | Optional | Your product’s Global Trade Item Number. (EAN in Europe / GTIN-13) |
| mpn | Optional | Your product’s Manufacturer Part Number |
| canonical_link | Optional |
Can be mandatory if your product can have multiple URLs on your website. The canonical_link works similarely to the « canonical URL » markup tag and allows you to influence which URLs Google uses for your products in our web search index. https://support.google.com/merchants/answer/9340054?hl=en&sjid=15567907824574762433-AP |
| condition | Optional | The condition of your product at time of sale. Supported values : “new”, “refurbished”, “used” |
| multipack | Optional | Submit the number of products in your multipack (for example, you're selling 6 bars of soap together). Integer data expected. |
| is_bundle | Optional | Indicates a product is a merchant-defined custom group of different products featuring one main product. Boolean data |
| google_product_category | Optional | Google-defined product category for your product. |
| size_type | Optional | Your apparel product’s cut. Supported values : « regular », « petite », « maternity », « big », « tall », « Plus » |
| adult | Optional | Indicate a product includes sexually suggestive content. Boolean data. |
| energy_efficiency_class | Optional |
Your product’s energy label. Available for the EU and EFTA countries and the UK. To be used in combination with energy efficiency class [energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to D). |
| min_energy_efficiency_class | Optional |
Your product’s energy label Available for the EU and EFTA countries and the UK. To be used in combination with energy efficiency class [energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to D). |
| max_energy_efficiency_class | Optional |
Your product’s energy label Available for the EU and EFTA countries and the UK. To be used in combination with energy efficiency class [energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to D). |
| scope_id | Optional | Provide the category id of your product (only useful if you use Sensefuel to build your navigation Product List Pages or ranking) |
| linked_products | Optional | Provide linked products of your information system to inherit them dynamically and automatically in your product recommendations of your product detail pages. Multivalued attribute. Each value must be separated by a coma, without space before or after the coma. Example : 233696,586997,452674 |