Preparing, uploading, and managing your data

Sitecore Discover defines catalog attributes that it relies on to provide platform-wide functionality. Preparing and transferring your catalog datasets to Sitecore Discover is a key part of your Sitecore Discover integration. As part of your Discover onboarding, a Sitecore integration specialist works with you to identify standard product attributes you must include in your product data feed for Discover to create the experiences you want to create for your website or business users.

In addition to product and category data feeds, you might also transfer:

  • A cross-category feed, to enable cross-category recommendations.

  • A sales feeds, to perform an initial warm up of on-line and optionally off-line product sales (from in-store sales).

  • A fitment feed, if you are a seller of parts and accessories, to provide search and recommendation experiences based on your product compatibility with third-party products.

Preparing product and category data feeds

Discover defines a standard set of product and category attributes. To prepare your catalog dataset, you must map your product attributes to the relevant Discover product attributes. You then create a delimited text file that contains this product data, and another file that defines your categories. You transfer your data feed file to Discover SFTP service.

For a complete list of Discover attributes for product and category, see:

If your Discover implementation requires support for cross-category recommendations, you must upload an additional feed for cross-category data.

Fitment feed

A fitment feed consists of attributes that represent parts or accessories of third party products such as vehicles, appliances, or any other items that you do not sell, but for which you sell compatible parts or accessories.

If your products are parts or accessories that have strict compatibility mappings to third party products, you must include a fitment feed as well as a product feed. The fitment feed enables your customers to search for products (for example parts, or accessories) based on compatibility attributes with third-party products. The Discover fitment data feed specifications lists fitment attributes available by default.

Sales feed

Sitecore Discover gains insights into product performance and rankings based on sales data it collects over time. By uploading historical sales data at the start of your implementation, you give the learning engine a jump-start to identify patterns for bestselling and co-bought products.

In addition to this one-time sales feed during on-boarding, you can also set up a recurring feed of off-line sales.

Patterns in historical sales feed that Discover can learn from, include:

  • Bestselling products and categories overall or by region

  • Products that a customer frequently purchases together

Discover can use recurring sales feed from your in-store sales, you web-only sales, or a combination of both to determine best-selling and co-bought patterns.

The Discover sales data feed specifications lists all the attributes.

Transferring data set to Discover

You use SFTP to transfer your product, categories and sales feeds.

Sitecore Discover SFTP service polls the SFTP site for new data files every 15 minutes. The presence of a new data feed file on the SFTP site triggers a process whereby the new dataset is queued for transfer into the Discover system. The actual transfer of data into Discover is subject to system resources availability.

After the initial data feed, it is critical that you keep Discover up-to-date with your latest catalog information, including new products and removed products. You use the full product feed to add new products. You can also use the full product feed to remove product.

Note

To make updates to existing products, you have the option to use the Incremental Feed API.

You can set up a recurring data transfer to the SFTP site or transfer new data files on an as-needed basis. You do not have control over the moment that Discover chooses to process the data you send to the SFTP site. If you have a requirement for Discover to process your data at specific times, inform your Sitecore integration specialist.

Important

We recommend that you set up an automated data feed to refresh your product data on the SFTP site at least once a day.

During onboarding, your Sitecore Discover integration specialist helps determine the optimal data feed interval based on your business requirements and the size of your dataset.

You can monitor the status of your recurring data feeds in the Customer Engagement Console.

Updating existing product data

The full data feeds refreshes your entire product dataset and allows Discover to recognize new products added and removed products since the last full feed run. Between each full feed runs, you might have to make near real-time updates to some attributes of existing products in Discover. The Discover Incremental Feed API lets you update existing product attributes in Discover, as these changes occur in your systems of records. For example, you might have to update product availability, inventory or pricing information on your e-commerce site.

Note

You cannot use the Incremental feed API to add new products to your Discover catalog. To add new products to your catalog, you must use the full product data feed process.

Do you have some feedback for us?

If you have suggestions for improving this article,