Skip to main content

JavaScript Website Integration Testing

How to test your JavaScript website integration.

Updated this week

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:

  1. Open your browser's developer tools.

  2. Navigate to your network window.

  3. Filter with the keyword 'listrakbi'

To view the query parameter data:

  1. Navigate to the header window.

  2. 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

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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

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

A screenshot of a computer

AI-generated content may be incorrect., Picture


Legacy (Non-NextGen) Page Browse

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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

A screenshot of a computer

AI-generated content may be incorrect., Picture

Legacy (non-NextGen) Product Browse

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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

A screenshot of a computer

AI-generated content may be incorrect., Picture

Legacy (non-NextGen) Cart Update

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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

A screenshot of a computer

AI-generated content may be incorrect., Picture

Legacy (non-NextGen) Clear Cart

A screenshot of a computer

AI-generated content may be incorrect., Picture

⚠️ 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

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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

A screenshot of a computer

AI-generated content may be incorrect., Picture


⚠️ 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.

Did this answer your question?