Step 1 – Style your templates using the Recommender Designer within the PureClarity Admin area

Click here to find out about the Recommender designer

Step 2 – By default, Zones are only shown to admin users on the frontend. When you are ready, press the “Go live” button to show Zones to all customers.

Pressing the “Go live” button will disable “Admin only” mode of the module, which means all customers will be able to see the PureClarity Zones. This can be re-enabled at any time by changing the flag on the settings page. See the Environment & Credentials section for more information.

The PureClarity addon comes with 10 default Zones that you can choose to enable on the Settings page. These are as follows:

Home Page

Product Page

Basket Page

Order Confirmation Page

If you click on the “Set up zones” button, you will be taken to the relevant section of the settings page.

INSTALL CUSTOM ZONES

You may want to add additional Zones on other areas of your site. This can easily be done by using the template editor in X-Cart. See the Zones section of this documentation for more information.

Step 3 – Customize your Campaigns and Segments within the PureClarity Admin Area to optimize the performance of your Zones

The PureClarity Academy has documentation on how to manage Zones, Campaigns, Segments and the strategies you can use to improve the performance of your personalization.

“Data Feeds” is the mechanism by which Data is sent data from your store to PureClarity. The data feed cron processes within the addon generate the data for each type of feed.

NOTE: Feeds and Deltas are submitted using scheduled tasks. Please ensure these are enabled. See the X-Cart scheduled task documentation for more information

Once the feeds have been generated, they will be submitted to PureClarity. To see when the data has been processed you can log into the PureClarity admin console, select Settings > Data Feeds to see a list of the feeds along with their import statuses. If there are any issues with the feeds, see the F.A.Q section.

There are 5 types of feeds that the X-Cart addon can send:

PRODUCTS

This feed will contain data for all visible & enabled products in your store. It will send data for all product attributes and will send default pricing.

CATEGORIES

This feed will contain data for all visible & enabled categories in your store. It will send data for all category attributes.

USERS

This feed contains data for all X-Cart Customers within your store. It will send basic information about each customer that can then be used to Segment them within PureClarity.

BRANDS

When enabled, this feed will send “Brand” information. This could also be a Vendor or Manufacturer. A brand under most circumstances requires a name and an image to activate the Brand recommender and search functionality in PureClarity. See the “Enabling Brand feed” section for more information.

ORDER HISTORY

A set of data regarding the last 12 months of orders, including which customers ordered what products. This helps to activate and kick start the data that PureClarity collects by allowing the system to begin mining common purchase patterns and associating buying activities to users.

Orders should only be imported only once. If orders are imported a second time they are dropped by the system to avoid duplicate data.

DAILY FEED

By default, Product, Category and User feeds are run nightly at 3 am. This is done via a cron process and full feeds of each type are sent.

DELTAS

The PureClarity addon has a mechanism called “Deltas” to handle Product & Category data changes. When a Product or Category is changed within X-Cart, a record of the ID that has changed is made in a database table and a cron process runs every minute to collate and send the updated data to PureClarity. This means that changes within X-Cart should be reflected in PureClarity within minutes. This is enabled by default.

MANUALLY

As outlined above changes to data are updated automatically by the PureClarity addon. However, should you wish to manually submit a full feed to PureClarity you can follow this process at any time.

1) On the PureClarity Dashboard page within X-Cart, click the “Run Feeds Manually” button within the “Data Feeds” panel.

This will bring up the feed selection popup:

Choose types of feeds you want to send, then click the “Run feeds now” button. This will request that the selected feeds are run as soon as possible. A cron process runs every minute to check for these requests and then generates and sends the feeds to PureClarity.

A panel on the dashboard page gives you an overview of the status of each of the types of feed.

NOT SENT

If no feeds have yet been sent from your store, then this status will show.

WAITING FOR FEED RUN TO START

If feeds have been requested, but the cron job that runs them has not started yet, then this status will show.

IN PROGRESS: X% / WAITING FOR OTHER FEEDS TO FINISH

If the feed runner cron job has started and is processing a feed, then this status will show.

LAST SENT – YYYY-MM-DD HH:MM:SS

Once feeds have run successfully, this status will show.

ERROR, PLEASE SEE LOGS FOR MORE INFORMATION

If an error occurs when transmitting the feed to PureClarity, then this status will show. See the troubleshooting section for more info.

NOT ENABLED

If PureClarity is disabled on your store, or the Brand feed is not set up, then “Not Enabled” will show.

The PureClarity X-Cart Addon handles Brand feeds through the use of Categories. This is done by creating a parent Category, for example with the name “Brands”, that will have a list of subcategories for each of your brands. This will allow you to give each Brand a name, an image and add the products that belong to that Brand. The parent Category and Subcategories can be set to hidden from menus, but they must be enabled

Once your Brand categories are configured and you’ve added your products to them, you can set the parent Category, such as Brands, under the “Brand Parent Category” drop-down box under the Brand Feed section on the PureClarity settings page. This tells PureClarity to treat all the first-level children of this Category as Brands.

IN PURECLARITY ADMIN

1. Under Settings > Zones create the Zone for the relevant page type. e.g. to add a “Home Page” Zone, Select “Homepage” in the “Select zone” dropdown.
2. In the Campaigns section, create a new Campaign for the new Zone

IN X-CART

1. Log in to your Admin Area as a user with editing permissions.
2. Go to the frontend and to the page you want to add the Zone to.
3. Click “Template Editor” at the bottom of the page.

4. Enable “pick templates from page” so that you can click on the area you want to insert the Zone

5. When you’ve clicked the template on the page, insert the html in the template that appears at the bottom of the page, for example:

<div data-pureclarity="bmz:BMZ-ID"></div>

HTML

Copy

The BMZ-ID should match the Zone ID you created in the PureClarity admin.

NOTE: Zone HTML should be added to templates that are specific to the page you’re adding them on. If you add them to generic areas of the site, they may appear on all pages.

6. Press the save button at the top-right hand side of the template editor.

Your new Zone should start displaying once.

NOTE: Custom Zones will not show debug mode, you will need to inspect the source of the page to determine if your custom Zones are embedded properly.

If you want to see the location of the default Zones when they’re not being populated, navigate to the PureClarity configuration page and set the “Enable Debug Mode” in the Zones section to “On”. Zones will then be rendered with their name and id.

By default, when you sign up or configure from the dashboard page, your account details will be populated here already. But should you need to change them for any reason, you can use this section of the settings page.

ENABLE PURECLARITY PERSONALISATION

If you need to turn PureClarity off for any reason, you can do so by changing this setting to “Off”. This will stop the PureClarity addon from displaying Zones on the frontend, stop sending daily feeds and stop Deltas from sending Product & Category updates.

ACCESS KEY

The Access Key for your PureClarity application. You can find this under the My Account > Integration menu within the PureClarity admin site.

SECRET KEY

The Secret Key for your PureClarity application. You can find this under the My Account > Integration menu within the PureClarity admin site.

REGION

The Region for your PureClarity application. This should always be the same as what was chosen during the signup process.

SHOW TO ADMIN USERS ONLY

If you set “Show to Admin users only” to “On” then only users who have administrator permissions will be able to see zones on the frontend of the site. This is useful when you are placing a custom Zone or previewing how the Zones will look on your site.

SEND NIGHTLY FEEDS

This setting controls whether feeds are sent on a nightly basis (at 3 am). Setting this to “Off” will disable the nightly feeds.

SEND DELTAS

This setting controls whether deltas are sent when products and Categories are changed. Setting this to “Off” will disable the deltas.

ENABLE BRAND FEED

This setting enables/disables the Brand feed. For more informaiton, see the Brand feed section.

BRAND FEED PARENT CATEGORY

This setting determines which category is used to send brands to PureClarity. For more information, see the Brand feed section.

EXCLUDE OUT OF STOCK PRODUCTS

If you want to exclude out of stock products from the product feed, you can do so via this setting.

ENABLE ZONE DEBUG

If you want to enable Zone Debug, set this to “on”. For more information, see the “How to debug Zones” section.

ENABLE ZONE [ZONE-ID]

You can use each of these settings to enable/disable each of the default Zones. For more information, see the “Setting up Zones within X-Cart” section.

You can augment each product with additional information, sent in the data feed, to control how PureClarity displays products.

Go to Catalogue > Products and select a Product to edit. Scroll down towards the bottom of the page and in the PureClarity section you’ll see the PureClarity attributes you can set against the product:

SEARCH TAGS

Search Tags are used in recommenders based on Search. You can add search tags to products, e.g. ‘Summer’, to boost the relevance of products based on visitors’ search terms. Enter a comma-separated list of words or phrases that you’d like to be sent to PureClarity as Search Tags.

EXCLUDE FROM PRODUCT FEED

Set this to yes to stop a product from sent in the feed at all.

EXCLUDE FROM RECOMMENDERS

Set this to yes to stop a product from being included in PureClarity recommenders, but still sent to PureClarity in the feed. You may want to do this for small priced items.

SHOW IN RECOMMENDERS FOR SET TIME PERIOD

Set this to yes and a start/end date will appear underneath. Use these dates to determine a date range during which the product will appear in recommenders.

NEW ARRIVAL

Set if a product should be treated as a new arrival by PureClarity. This enhances recommenders and helps to target customers by showing hot new arrival products that may interest them.

ON OFFER

Set if a product should be treated as an on-offer product. This enhances recommenders and helps to target customers by showing them products that are on promotion. PureClarity will do this automatically if products are on sale, however, you may want to override this if a product doesn’t currently have a special price, but you’d like it to be treated as a promoted product.

You can set an additional option for PureClarity against each category. To do this go to the PureClarity section on a categories properties page. The options available are:

EXCLUDE FROM PURECLARITY CATEGORY FEED

Set this to yes to stop a category from being sent in PureClarity Category feed.

EXCLUDE FROM PURECLARITY RECOMMENDERS

Set this to yes to stop a category from being included in PureClarity recommenders, but still sent to PureClarity in the Feed.

EXCLUDE PRODUCTS IN THIS CATEGORY FROM THE PURECLARITY PRODUCT FEED

Set this to yes to stop any products in this Category from being sent in the Product Feed.