Implementation Guides

PureClarity accepts one product data feed format:

• Option 1: A JSON document defined by PureClarity.

You can also send Product Feed Deltas (individual product changes) however this is only supported using the PureClarity JSON format (Option 1). If you want to include account pricing into the feeds please see B2B Account Pricing.

How Products and Variants are handled

Important information about a product (its title, description, image, price, etc.) and product variants are held within PureClarity so they can be analysed and rendered in the search results and recommenders within milliseconds.

It is important to understand that PureClarity will only surface Products in the search results and merchandising zones - it will never surface a product’s variants.  However, variant information is used to create the facet attributes within the search results navigation.   

The example below gives an illustration of how products and variants are structured in the product data feeds.

In this example, consider a product (P1):

Now, this product has 2 variants, a “small” and large”:

All this information is sent in the feed to PureClarity. It merges it all together and stores it. This means that if the user on the site searches for “product 1” it will be able to show the correct title, description, image URL and link URL – based on the data sent over in the P1 record.

Now, because it has merged all the variant information together, it will also be able to show the price for P1 (between $5 and $10).

If the user on the site searches for “adult” or “child” it will also be able to surface Product 1 (as one or more of its variants has the search term in its data). The facets in the search results will include “Size” with both “Child” and “Adult” available.

Note that if a product doesn't have any variants, then all the data is sent in a single record for the product without any ParentIds.

Feed Management

In the Admin Console you can manually setup a new feed and exam the result for failure.  You can find this under the 'Configurations' menu in the console.