X-Cart:Abandoned Cart Reminder

From X-Cart 4 Classic
Jump to: navigation, search


What Abandoned Cart Reminder does

X-Cart's Abandoned Cart Reminder add-on module helps you recapture lost sales by following up with the customers who added some products to the shopping cart but did not complete the purchase for some reason. The module collects the shopping cart content of such customers and allows you to remind them they have an abandoned cart by sending an automatic email notification (or multiple notifications - if you choose to send the reminder email more than once). If you wish you can include a discount coupon for the customer's next order to stimulate the purchase. The module works for both registered and anonymous customers (anonymous customers need to have specified their email address).

Why Abandoned Cart Reminder?

X-Cart's Abandoned Cart Reminder add-on module:

  • Promotes your business by giving you more potential orders. You will be the first to know that an order remained unfinished and will be able to contact your customers even before they contact you.
  • Increases the conversion rate by giving customers an option to eventually finish their order with a discount.
  • Helps to take care of your clients by providing tools for following them up. Eventually, it brings your merchant to customer relationship to a higher level.
  • Provides professional, easy to use and time-efficient facilities to create orders with one button click in the store's Admin area, if your customers contact you about an unfinished transaction by phone (in versions 4.5.3 and later).
  • Can work in fully automatic mode. Just set up a cron task, and the module will flick through the abandoned carts and send email notifications automatically.
  • Provides an opportunity for admin to set the time period between the abandonment and the reminder along with a number of reminder emails.
  • Allows customers to recover their shopping cart content with a single click. Your customers will not need to add items to the bag from scratch.
  • Admin can manage abandoned carts: seek, update and remove them
  • Allows admin to check how much revenue Abandoned Cart Reminder recovered
  • Works both with registered and anonymous customers.
  • Automatically logs in registered customers.
  • Automatically populates address fields for anonymous customers.
  • Works with product options and variants.


System requirements

To be able to successfully install and use the Abandoned Cart Reminder module, you must have a working copy of X-Cart GOLD or GOLD PLUS version 4.4.3 or later installed on your server. Make sure that the version of the module is the same as the version of the installed copy of X-Cart.

Note: If you do not remember the version of installed X-Cart, find it in the Environment info section of the Summary page in X-Cart Admin area.


To install the module for X-Cart 4.4.3 or higher:

  1. Obtain a distribution package for the Abandoned Cart Reminder add-on module by downloading it from the File Area section of your X-Cart Account. The distribution package you need is contained in the archive file x-abandoned-cart-reminder-x.y.z.tgz where x, y and z are the version numbers of the module. Make sure the version of the module is the same as the version of the installed X-Cart.
  2. Copy the distribution package to the X-Cart root directory on your server or hosting account.
    • If you are using a Windows-based server, or a UNIX-based server without terminal access:
    a) Decompress the archive with the Abandoned Cart Reminder distribution package to a directory on your system using your favorite compression program (WinZIP or any other archiver with support for TAR files).
    b) Use an FTP client to upload all the files contained in the archive (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
    • If you are using a UNIX-based server with terminal access:
    a) Use an FTP client to upload the archive with the distribution package to the X-Cart root directory on your server or your hosting account.
    b) Decompress the package using the following command:
    tar -xzvf x-abandoned-cart-reminder-x.y.z.tgz
    Important: Make sure you keep the directory structure while unpacking and uploading the distribution package, otherwise some necessary files can be overwritten!
  3. In a web browser, run the module installation script:
    For X-Cart versions 4.4.3-4.6.4, use httр://<YOUR_XCART_DOMAIN>/install-abandoned-cart-reminder.php
    For X-Cart versions 4.6.5 and later, use httр://<YOUR_XCART_DOMAIN>/install-abcr.php
    (Be sure to replace the variable <YOUR_XCART_DOMAIN> with the actual domain name of your X-Cart store).
  4. Enter the Auth code, accept the License Agreement and click Next.
  5. The installation script patches the files and activates the module. Click Next to continue the installation.
    Note: if you are using custom skin, you will need to manually apply the patches to it. Otherwise, the module will not work in this skin.
  6. The installation script generates a new system fingerprint. Click Next to complete the installation.
  7. Use the ADMINISTRATOR AREA link to log in to the Admin area.

Enabling the Abandoned Cart Reminder add-on module

After the Abandoned Cart Reminder add-on module installation has been completed, the module you have installed needs to be enabled in your store:

  1. In Admin area, go to the Modules section (Settings menu->Modules).
  2. Choose the Abandoned Cart Reminder module by selecting the respective check box on the left.
  3. Click the Apply changes button. This activates the module.

Configuring the Abandoned Cart Reminder add-on module

After the Abandoned Cart Reminder add-on module has been enabled in your store, you should check and adjust its configuration:

  1. In the Modules section (Settings menu->Modules), click the Configure link opposite the module name ('Abandoned Cart Reminder').
    The module configuration page (titled by the name of the module) opens.
  2. Adjust the settings on the module configuration page. Detailed information regarding the Abandoned Cart Reminder add-on module configuration settings is available below.
  3. Click the Apply changes button to save the changes.
Note: After the module is enabled the first time, it will work in manual mode and no automatic messages will be sent. You will need to set it up to work in fully automated mode

Abandoned Cart Reminder add-on module configuration settings

Here is an explanation of the Abandoned Cart Reminder add-on module configuration settings:

  • Handle sending out notifications manually or automatically? The mode in which you would like abandoned cart reminder email notifications to be sent.
    Manually corresponds to the mode in which abandoned cart notifications are not sent until you specifically instruct the module to send them. In this mode you yourself decide which users should be notified, when the notifications should be sent, with or without a coupon, etc.
    Automatically corresponds to the mode in which sending of abandoned cart notifications is initiated by a cron job. In this mode the number of times that a notification message should be sent, the time of sending the initial and subsequent notifications, whether the notification should include a discount coupon or not, etc are defined based on the add-on module configuration settings. Note that, if you choose the automated mode, you will need to make sure that the script for periodic tasks is properly set up in your store (See: X-Cart:Cron.php - Script for Periodic Tasks).

The following settings affect the work of the module only if the module is working in the automated mode:

  • After how many hours customer should be notified of abandoned cart: The number of hours to wait after cart abandonment before sending an abandoned cart reminder notification to the cart owner.
    Note: For stores sending multiple abandoned cart notifications about each abandoned cart this reflects the number of hours before the first notification is sent.
  • How many notifications should be sent: The number of reminder notifications that should be sent about each abandoned cart. The recommended value is 1. If you wish to notify the users about each abandoned cart more than once, you can specify a greater value here.
    Note: Although it is possible to send multiple notifications, it is not recommended to do so, because customers may be annoyed by too many notifications and even mark them as spam.
  • Delay between notifications (in hours): (This needs to be specified if you are going to send more than one notification about each abandoned cart.) The length of period between reminder notifications being sent to the same user about a specific abandoned cart. Note that setting this value to "0" (zero) will result in that each user will be notified only once.

    If you use the following configuration:
    Acr conf settings ex1.png
    abandoned cart owners will receive a reminder notification on the 6th, 18th and 30th hours after their abandoned cart has been registered by the module.

  • Type of discount coupon that should be attached to notifications: If you want to offer a discount to the users whom you notify about an abandoned cart, you can specify what type of coupon it should be. Choose one of the following options:
    None -- no coupon will be attached to the notification;
    $ off -- a “flat amount off“ coupon will be attached to the notification;
    % off -- a “percentage amount off” coupon will be attached to the notification.

  • Discount coupon value: This setting is related to the previous one; it allows you to specify the value of the discount given by the coupon.
    Two examples below will clarify how it works.

    Example 1.
    If you use the configuration below:
    Acr conf settings ex2.png
    the coupon attached to the notification will give the user a 20$ discount off the purchase.

    Example 2.
    If you use the following configuration:
    Acr conf settings ex3.png
    the coupon attached to the notification will give the user a 10% discount.

  • Period of abandoned cart expiration (Number of days after which email notifications to customer will no longer be sent and the coupon associated with the abandoned cart will become invalid): This setting defines when an abandoned cart as well as all the coupons associated with it should be deleted from the system.

Managing Abandoned Carts

You can review the abandoned carts registered by the module on the Orders->Abandoned Carts page in your store's Admin area:

Acr abandoned carts page.png

Each record displays information about an abandoned cart:

  • Email: Email address specified by the abandoned cart owner.
  • Login: User login of the abandoned cart owner - if the abandoned cart owner is a registered customer.
  • Products: Shopping cart content including selected options.
  • Subtotal: Total price of all the products in the shopping cart.
  • Coupon: Coupon code (if any is applied).
  • Date: When the abandoned cart was last updated by the customer.
  • Is notified? Whether the abandoned cart owner was notified, how many times and when the last notification was sent. Abandoned carts whose owners have been notified previously are highlighted in green color (See the screenshot above).

What you can do using the controls of the Orders->Abandoned Carts page:

  • Search for abandoned carts
    You can search for abandoned carts:
a) by date (Specify the start and end dates of the period when the abandoned cart was registered by the module);
b) by customer login or email address that were used by the cart owner.
  • Notify cart owners about their abandoned cart
    You can notify the users who did not complete their orders about the carts they abandoned:
  1. Specify the carts whose owners you want to notify by selecting the check boxes on the left-hand side in the abandoned carts list.
  2. Click the Send notifications to selected cart owners button at the bottom of the page.
If you want to attach a discount coupon to the abandoned cart reminder notifications:
  1. Select the Attach coupon option near the Send notifications to selected cart owners button.
  2. Specify the coupon parameters below:
    :Acr coupon.png
Please note that abandoned cart notifications cannot be sent for carts in which all the products have become unavailable for sale or have gone out of stock - unless the inventory tracking feature is disabled in the store. If you make an attempt to send a notification for such a cart, you will get an error message saying that the notification has not been sent.
  • Create an order based on a specific abandoned cart
    Sometimes a user may abandon their shopping cart because of some technical issue that prevented them from completing the purchase. If this happens, you can offer the user to create the order for them based on the contents of their abandoned cart:
  1. In the abandoned carts list, click the Create order button in the record that represents the abandoned cart for which you need to create an order. This opens a page where you will be able to create the new order. See Advanced Order Management operations for more information.
  2. Provide the required information about the order:
  • Customer info;
  • Order’s total.
  • Delete abandoned carts
    You can delete the abandoned carts you no longer need:
  1. Specify the carts you want to delete by selecting the check boxes on the left-hand side in the abandoned carts list.
  2. Click the Delete selected button at the bottom of the page.

Setting up the module to work automatically

To set up the module to work automatically:

  1. Go to the module’s configuration settings and set the option Handle sending out notifications manually or automatically? to Automatically.
  2. Adjust the rest of the configuration settings on the page:
    • how many notifications should be sent and when,
    • coupon parameters,
    • when to consider an abandoned cart expired.
  3. Save the changes.
  4. Make sure that periodical tasks are correctly set up in your store according to the following article: X-Cart:Cron.php - Script for Periodic Tasks

Abandoned Cart Reminder will add two more jobs to existing periodic tasks in your store:

  1. Sending notifications to abandoned carts.
  2. Deleting expired abandoned carts.

Customizing the email notification messages sent by the module

By default the messages sent to your customers look as follows:

Notification without a coupon:
Acr notification wo coupon.png

Notification with a coupon:
Acr notification with coupon.png

You can change the way these messages appear to your customers by adjusting the following Smarty templates:

  • skin/common_files/mail/abandoned_cart_notification.tpl (plain version of the notification)
  • skin/common_files/mail/abandoned_cart_notification_subj.tpl (header of the notification)
  • skin/common_files/mail/html/abandoned_cart_notification.tpl (HTML version of the notification)

In addition to that you may want to change the following language variables:

  • eml_abcr_notification_message
  • eml_abcr_notification_without_coupon_message
  • eml_abcr_visit_us

Viewing your shopping cart recovery statistics

Information on the number of orders that have been recovered using the Abandoned Cart Reminder module is available via the Cart recovery statistics page (Orders->Cart recovery statistics):

Acr statistics.png