Skip to main content
RichRelevance

SKU Feed

Overview

The SKU feed is only needed if you’re participating in our program for SKU functionality. 

This SKU Feed must be included in the Product Feed that is uploaded every day as a .zip or .gz file. In addition to the SKU feed, you will need to add SKUs to your instrumentation in order to support this functionality.

Note: Currently support for SKUs is not compatible with support for regions.

File Specification

Edit section

The SKU Feed is much like the Product Attribute Feed with the key difference that it can only be accepted in row-based format. Take care around this point to avoid issues when first developing this feed. Unless otherwise noted, all IDs must be made up of alphanumeric characters.

SKU Feed

Edit section

Filename: sku_full_sitename_YYYY_MM_DD.txt requireD

Name Type Required? Definition
id ASCII Yes ID for the main (parent) product. This must be the same ID that is used in the Catalog Feed as well as in your site's instrumentation.
sku_id ASCII Yes ID for this specific SKU variant of this product.
attr_name text Yes The name of the SKU attribute being defined. Examples: "color," "size," etc.
attr_value text Yes The value or values being assigned to the SKU attribute for this SKU. Multiple values are permitted and are delimited by a period. See example below.

Example

product_id|sku_id|attr_name|attr_value
1001|abc|available|T
1001|abc|color|red
1001|abc|hat_size|7.5
1002|zyz|available|F
1002|zyz|color|blue
1002|zyz|shirt_size|XL
1002|wyz|available|T
1002|wyz|color|blue
1002|wyz|shirt_size|XL

Note: There should be only one entry per product_id, sku_id, and attr_name combination. This means that if you have multiple values to assign to an attribute for any given SKU of a single product ID, it must be done using a list of values on one line.

Note: In order to avoid confusion with the recommendable attribute in the Product Full Feed,available is recommended as an attribute name to signify if the specific SKU is available for recommendation or sale.

Size Types

When you’re considering size preference for a shopper, you need to be able to differentiate between different types of sizes. A single shopper might wear size 8 shoes, size 4 dresses, and size S t-shirts. But if the only information given to the system is the sizes themselves, there may be unneccessary confusion between them.

When the shopper buys a pair of shoes, for example, it’s not enough to record that this shopper is a size 8. You need to know that the shopper is an 8 in shoes because you don’t want to later recommend size 8 dresses to that same shopper.

If you are able to send sizes as unique attributes like shirt_size, hat_size, or us_women_shoe_size for example, no further work is needed; that will be enough to keep this information appropriately separated and unconfused.

If you are not able to do this, then there is a workaround. You can create an attribute called SizeType to differentiate between the different types of sizes represented in your catalog. You then associate this parameter with each product in the SKU feed and can be log it each time a user shows a preference for a size. 

Example
product_id|sku_id|attr_name|attr_value
1001|abc|available|T
1001|abc|color|red
1001|abc|size|7.5
1001|abc|SizeType|hat
1002|zyz|available|F
1002|zyz|color|blue
1002|zyz|size|XL
1002|zyz|SizeType|shirt