# CS-Cart

This guide explains how to install and integrate the REES46 CS-Cart Add-on (hereafter REES46 add-on) with your online store built on the CS-Cart v 4.x platform. This module gives your store full access to REES46 functionality to improve you sales performance and grow your revenue.

# Install add-on

This topic explains how to integrate REES46 Add-on with your online store built on the CS-Cart 4.x platform.

# Add Your Store to REES46

Before installing the module, add your online store at rees46.com.

To add your store:

  1. Sign up for REES46 site:
  2. Note down your Store Key and Secret Key.

Note

Store Key and Secret Key are unique identifiers that look somewhat like this: 640e3aq6dd5e70c8156e75238bf4e2. They will be used to access REES46 functionality via our API.

TIP

You can always find your Store Key and Secret Key in your personal account on rees46.com (Dashboard > Settings > Shop Settings).

# Install REES46 Add-on

This section helps you install REES46 CS-Cart Add-on and integrate your store with REES46.

To install REES46 add-on:

  1. Download the rees46.tgz archive from the following following URL: for CS-Cart v 4.x (opens new window)
  2. In CS-Cart Administration Panel navigate to Manage Add-ons (Add-ons > Manage Add-ons).
  3. Click Upload & Install Add-on.
  4. In the popup window click Local and browse to choose the rees46.tgz file.
  5. On the right to the newly installed add-on, click Enable

An Add-ons tab example:

Install add-on

# Configure REES46 Add-on

This section helps you configure basic settings of REES46 Module.

To configure REES46 Module:

  1. In CS-Cart Administration Panel navigate to Manage Add-ons (Add-ons > Manage Add-ons).
  2. Find REES46 in the list of installed add-ons.
  3. On the right to the add-on, click the Settings gear button and then click Settings.
  4. In the popup window, specify your Store Key and Secret Key (see Add Your Store to REES46).
  5. Save current settings
  6. Check that the add-on is Active.

# Check Event Tracking

# How to Perform the Check

  1. Enable Developer Console in your browser.
  2. Find the Network tab, where requests are displayed when you refresh the page.
  3. Enable filtering mode to see only XHR-requests.
  4. Check there are requests leading to api.rees46.com.

# Check Event Dispatch

  1. Clear your server cache - in your internet browser open the following web address http://<your_online_store_url>/admin.php?cc. NOTE: <your_online_store_url> is a placeholder for the actual web address of your online store.
  2. Open any Product Page and make sure you can see in Developer Console a push event leading to api.rees46.com.
  3. Make sure you see event: view in the Form Data section of this push event.

Check tracking

Note

If you encounter a problem at this step, please contact us at desk@rees46.com

# Set Up & Design Product Recommendations for CS-Cart

Read detailed guide about products recommendations configuration and design in Product recommendations.

# Add recommendation block to add-on

  1. In the administrative area of the site, open the "Design" - "Layouts" section.
  2. Select the page template on which you plan to place the block.
  3. You can use an existing section to place a block or create a new one. To do this, click on the icon. Note that only a block can be added inside an existing section, and new sections are created only outside other sections.

Set recommender block

  1. Select "Add block" and in the opened window select the "Create new block" tab and REES46 template.

Set recommender block

  1. In the "General" tab enter the name of the created block. This is an internal name, so use clear expressions to easily navigate among the created blocks, for example, "Popular (on the main, vertical)" or "On the product page (horizontal)".

Set recommender block

  1. In the "Block settings" tab copy the block identifier in the "Unique code of the recommendation widget" field, obtained on the 4th step of block-creation. Also, choose the block orientation - horizontal or vertical.

Set recommender block

  1. When you finish the settings, remember to save the block and move the block inside the section, because the new block can be placed at the bottom of the section by default.

# Sync orders' statuses

There are three order types in our system: new order, complete order and cancelled order (incl. fake orders).

Main purpose of our Order Status Synchronization is to differentiate real orders from orders that will not be completed (cancelled, fake, prank). It also calculates our CPA commission and your monthly KPI. Synchronization helps increase the effectiveness of triggered emails and allows you to see a detailed KPI report anytime.

Attention!

If you change order statuses in your CS-Cart store's back office (e.g. using an external CDP for that), enabling Order Status Synchronization in REES46 account settings will result in triggered emails not working properly and mess up your statistics as well as refunds for cancelled orders.

# How to enable sync

To enable it, please send a request to desk@rees46.com.

# How to Synchronize Order Statuses

Automatically at the moment of next product feed generation (XML), if REES46 generator is used.

# Operability Test for CS-Cart

This topic explains how to perform an operability test to ensure a successful installation.

# How to Perform the Test

  1. Enable Developer Console in your browser.
  2. Find the Network tab, where requests are displayed when you refresh the page.
  3. Enable filtering mode to see only XHR-requests.
  4. Check there are requests leading to api.rees46.com.

# Test Event Dispatch

  1. Open a product page and make sure you can see in Developer Console a push event leading to api.rees46.com.
  2. Then click "Add to Cart" and make sure you can see in Developer Console a new push event leading to api.rees46.com.
  3. Go to the Cart and remove the product from it. Make sure you can see in Developer Console a push event leading to api.rees46.com.
  4. Complete this test order and make sure you can see on the final page a push event leading to api.rees46.com.

Test events tracking

# Check Recommendation Requests

  1. Open a page with embedded blocks of Product Recommendations and make sure you can see in Developer Console requests leading to api.rees46.com.
  2. Make sure that the number of requests corresponds to the number of Recommendation Blocks on the page..
  3. Do the same for other pages with embedded Recommendation Blocks (i.e. Home page, Category page, Product page, Cart page).
  4. If you embedded the "Customer Who Looked For This Item Also Bought These" block into the Search Results page, perform a search and make sure you can see a request leading to api.rees46.com.

Recommendations test