As Drupal is a PHP-based platform, you should use our PHP SDK to sync data between your store and PureClarity.

​
Getting Started

You will need to complete 3 steps in order to start using PureClarity.

​
Step 1: Send Products to PureClarity

Send a Product feed using the PHP SDK. This will allow PureClarity to know what Products are available on your site.
We allow up to 4 product feeds per day and each product feed needs to be 150MB or less.

​
Step 2: Add JavaScript Snippets

We require the use of JavaScript Snippets on the frontend of your store. These load PureClarity onto each page, and allow PureClarity to track the users actions so their experience is personalized.

​
Step 3: Add Zones

Add Zones to relevant pages. Create some HTML div elements for your PureClarity Zones that will show personalized content.
Start with these three basic steps to get PureClarity working on your Drupal site, then implement the advanced features outlined below for maximum personalization impact.

​
Advanced Implementation

​
Overview

In order to maximize your use of PureClarity, there are some further steps that we recommend:

​
Historic Order Feed

This feed “seeds” PureClarity with existing orders. It allows PureClarity to learn about what products are bought with which other products, and what your existing customers have already purchased so their experience is personalized from day 1. This can be done using the PHP SDK.

​
Send Category & Brands Feeds

These allow PureClarity to track which categories and brands your customers are purchasing in. These mean that you can get:
  • Brands on the PureClarity Autocomplete: When users enter text into the Autocomplete, links appear for applicable brands
  • PureClarity Category and Brand recommenders: Recommenders such as “Recommended for you in Clothing” and “Best Selling Brands” are available to use
You can use the PHP SDK to send the Category and Brand Feeds.

​
Send a User Feed

This feed allows you to pass custom information you have about your customers to PureClarity. This can be used to help Segment your customers which are used in Campaigns. You can use the PHP SDK to send the User Feed.

​
Use Product Deltas

If your product catalogue is regularly updated several times a day, then you can use the PureClarity Product Deltas to send up to date product information. You can use the PHP SDK to send the Deltas.
Product deltas ensure your recommendations always show current pricing, availability, and product information without waiting for the next full feed.

​
Offline Orders

If your customers can place orders from another channel for example in a physical store or over the phone – then you can ensure that PureClarity is aware of these orders by sending a daily feed of these offline orders. This means when your customers return to your website, their personalized experience will take into account their offline orders. This can use the same process as the “Historic” orders as outlined above.

​
Terminology

Below is a guide to Drupal terms and their equivalent in PureClarity. Note that products and variants are very similar in both implementations.

​
Store

PureClarity equivalent: Store View We recommend that your PureClarity setup is the same as your Drupal setup. Therefore if you have 5 Drupal Stores, we recommend you have 5 PureClarity Store Views.
There is an additional charge for having multiple PureClarity Store Views. Each Store View has a separate product data set. Each store view can support multiple currencies. Personalization is unique to each Store View.

​
Product

PureClarity equivalent: Product PureClarity operates at the product level. Products are surfaced in recommenders in Zones. Clicking on them will take the user to your product page, which will allow them to select the variant they want to purchase. See the Product Data Feed Overview for more information.

​
Variant / Product Variation

PureClarity equivalent: Variant Variant information is sent over in the PureClarity product feed. The variant record contains details about the variant, and the parent product it is part of. This is used to surface the correct products in the Zones. See the Product Data Feed Overview for more information.

​
Attribute / Product Attribute Value

PureClarity equivalent: Attribute Products and Variants in the PureClarity product feed can contain any attributes from your site. Each record in the product feed will contain all the attributes for that product or variant, with all of the attribute values. PureClarity uses this data in the facets (filters on the search results and product listing pages). The data can also be used in PureClarity templates to control how the Product looks when it is displayed. See the Product Data Feed Overview for more information.

​
Currency

PureClarity equivalent: Currency Each product or variant in PureClarity can contain prices in multiple currencies. The PureClarity Currency Tracking Event is used to switch which currency PureClarity is using.

​
Implementation Best Practices

​
Data Feed Strategy

  1. Start with Product Feed: Implement the product feed first to see immediate results
  2. Add Categories and Brands: Enhance recommendations with category and brand data
  3. Import Historic Orders: Seed the system with existing purchase data
  4. Implement Deltas: Keep data fresh with real-time updates

​
JavaScript Integration

  1. Page Tracking: Ensure tracking is implemented on all relevant pages
  2. Event Tracking: Track key user actions like purchases, add to cart, etc.
  3. Currency Switching: Implement currency tracking for multi-currency sites

​
Zone Placement

  1. Strategic Placement: Position zones where they’ll have maximum impact
  2. Page-Specific Zones: Use different zone IDs for different page types
  3. Testing: A/B test zone positions to optimize performance
Ensure your PHP SDK implementation includes proper error handling and logging to troubleshoot any data feed issues.

​
Support and Resources

For detailed implementation guidance:
The PureClarity team can provide custom implementation guidance for complex Drupal setups. Contact support for assistance with your specific integration requirements.