The following guide will provide instructions to test the following integration components.
Each section will outline the key network requests that should be sent to Listrak and the query string parameters that should be seen in the header data.
To find these network requests:
Open your browser's developer tools.
Navigate to your network window.
Filter with the keyword 'listrakbi'
To view the query parameter data:
Navigate to the header window.
Scroll down to find the query parameter data.
Framework
Request Name: script.js
Query String Parameters
Key | Value |
m | Merchant ID |
v | Framework version |
⚠️ Test Cases
Action | Expected Result |
Load any page. | Framework loads and the script.js request is sent to Listrak. Ensure that this is loading on all pages. |
Conversion Tracking
Request Name: T.ashx
Query String Parameters
Key | Value |
on | Order number |
ot | Order total |
tt | Tax total |
st | Shipping total |
ht | Handling total |
it | Item total |
e | Email address |
fn | First name |
ln | Last name |
id | Product SKU |
q | Product quantity |
p | Product price |
⚠️ Test Cases
Action | Expected Result |
Place an order. | T.ashx request is sent to Listrak containing accurate order and order-item data. |
Email Capture
Request Name: fieldUpdate
Query String Parameters
Key | Value |
Email address |
⚠️ Test Cases
Action | Expected Result |
Enter an email address in an email input element. | fieldUpdate request is sent to Listrak containing the email address. Ensure this works for any form on the website that allows a user to enter their email address. |
Browse Abandonment
Page Browse
Request Name: your unique merchant ID
Query String Parameters
Key | Value |
t | 'PageBrowse' |
k | Page URL |
BLS Page Browse
Legacy (Non-NextGen) Page Browse
⚠️ Test Cases
Action | Expected Result |
Load any page. | Respective request is sent to Listrak containing the current URL. |
If integrating with a single-page application, navigate to a new virtual page. | Respective request is sent again containing the new URL. |
Product Browse
Request Name: your unique merchant ID
Query String Parameters
Key | Value |
t | 'ProductBrowse' |
k | Product SKU |
BLS Product Browse
Legacy (non-NextGen) Product Browse
⚠️ Test Cases
Action | Expected Result |
Load a product page. | Respective request is sent to Listrak containing the product's SKU. |
Cart Abandonment
Add/Remove from Cart
Request Name: update
Query String Parameters
Key | Value |
q | Product quantity |
p | Product price |
n | Product title |
iu | Product image URL |
lu | Product link URL |
smx | Cart-level meta field #x |
BLS Cart Update
Legacy (non-NextGen) Cart Update
⚠️ Test Cases
Action | Expected Result |
Add a product to your cart. | update request is sent to Listrak containing the full cart contents. |
Add a second product to your cart. | update request is sent to Listrak containing the full cart contents including the new product. |
Remove one item from your cart. | update request is sent to Listrak containing the full cart contents excluding the product you just removed. |
Clearing Cart
Request Name: update
Query String Parameters
Key | Value |
cc | 'true' |
BLS Clear Cart
Legacy (non-NextGen) Clear Cart
⚠️ Test Cases
Action | Expected Result |
Clear the cart using a clear button. | update request is sent to Listrak containing the clear cart flag. |
Clear the cart by removing all products manually. | update request is sent to Listrak containing the clear cart flag. |
Add to Cart
Request Name: your unique merchant ID
Query String Parameters
Key | Value |
t | 'ProductAddedToCart' |
k | Product SKU |
⚠️ Test Cases
Action | Expected Result |
Add a product to your cart. | Respective request is sent to Listrak containing the product's SKU. |
Alerts
Sign Up
Request Name: Set.ashx
Query String Parameters
Key | Value |
e | Email address |
s | Product SKU |
ac | Alert definition code |
⚠️ Test Cases
Action | Expected Result |
Sign up for product alerts. | Set.ashx request is sent to Listrak containing the user's email address, product SKU, and alert definition code. |