Set up Qubit on Magento
In this article...
We'll cover the steps involved in implementing the Qubit Tracking extension in your Magento store.
Compatibility
This extension is compatible with Community and Enterprise versions 1.8, 1.8.1, 1.9, 1.9.1, 1.9.2, 1.9.3.
Installation
Before getting started, we recommend making a full backup of your Magento website. This is a good practice that should be followed before installation of any Magento modules. See Creating a Backup for more information.
Step 1
Navigate to the Magento Marketplace and enter Qubit in the search field provided. Then select Qubit Integration from the search results. Alternatively, navigate to Qubit Integration
Step 2
Add the extension to your cart and complete the checkout process. Once you have completed the order, select Install and copy the installation key. In our example, this is:
https://connect20.magentocommerce.com/6126cf80c523c2e0cfd4bf12d375e446/qubit+Qubit_Tracking-0.1.2Step 3
Login to your Magento Administration Panel, then navigate to System > Magento Connect > Magento Connect Manager. Select the Extensions tab and paste the key you copied into the field provided
Select Install to complete the installation process
Step 4
Clear your cache, log out of the Administration Panel and log in again
Configuration
Step 1
Login to the admin area for your Magento store. Typically, this is the URL specified during the installation of Magento, with the addition of /admin. Enter your admin username and password:
Step 2
Select System from the toolbar:
Then select Qubit > Qubit Tracking from the side menu:
Step 3
Configure the extension as required, referring to the following table as a guide:
Value | Expected Value | Description |
|---|---|---|
Qubit Enabled | Yes/No | Whether to enable the Qubit Tracking extension for your Magento store |
Emit Events | Yes/No | Whether to enable the emission of Qubit events for your Magento store |
Tracking Id | String | The tracking Id for your property. This is provided by Qubit during onboarding. |
Package | Pro/Aura | Which Qubit package you have purchased |
Smartserve URL | String | The URL of smartserve.js |
Smartserve Location | End of HEAD/End of BODY | The page location to inject smartserve.js |
Smartserve Asynchronous | Yes/No | Whether to load smartserve asynchronously or not |
Namespace | String | The custom namespace, required to send custom events to Qubit |
Send Product Listing Events | Yes/No | Whether to emit events on product listing pages |
Product Listing Event Limit | Integer | The maximum number of events that will be sent on product listing pages |
Product Stock Data | Yes/No | Whether to include the product stock level in product events |
Always Send Basket Events | Yes/No | Whether to send basket events on every page or just the checkout funnel |
In the following example, we can see some of the configuration settings:
Known issues
For assistance in resolving these issues, please reach out to Customer Support at Qubit.
Checkout
If your Magento store has a custom checkout functionality or plugin, the following events might be prevented from triggering:
- ecBasketItem
- ecBasketSummary
- ecBasketItemTransaction
- ecBasketTransactionSummary
minicart.js
When using the default minicart component minicart.js, it is possible that basket item events will not be sent, including:
- ecBasketItem
- ecBasketSummary
The Qubit Tracking extension rectifies this issue by extending the JavaScript object updateItem method.
If you are using a custom minicart implementation rather than the default minicart.js, you will need to replicate the logic to ensure basket item events are sent.
Configurable product
If your Magento store has a different configurable product implementation, with modifications in the default configurable.js file, and specifically the Product.Config.prototype.configureElement method, it is possible that the ecProduct event will not be sent when a visitor makes a product option selection.
Themes
If your Magento store has a different theme that is not using minicart.js and/or configurable.js files, it is likely that the issues reported above will be reproducible. For more information, reach out to your CSM at Qubit.