Check your setup
Step by step guide for checking that our client script is tracking events on your site.
Last updated
Step by step guide for checking that our client script is tracking events on your site.
Last updated
Navigate to your site in incognito mode.
Load the debug toolbar by appending nostodebug=true
to your store's URL e.g. https://example.com?nostodebug=true
Click the login link and navigate to the session view.
Navigate to a category page and verify that the View Category event is tracked with the following details:
Target matches the viewed category.
If the category doesn't appear in the session, these pages might help
Navigate to a product page and verify that the View Product event is tracked with the following details:
Target matches the viewed product ID.
If the product doesn't appear in the session, these pages might help:
Click on a product recommendation and verify that the View Product event is tracked with the following details:
Target matches the viewed product ID.
Ref matches the previously viewed recommendation slot ID.
If the product id and recommendation slot id don't appear in the session, these pages might help:
Add the product to cart and verify that the cart’s contents are correct. Ensure that the product details in the cart match the product that was previously viewed.
Product ID
Price & Currency
Quantity
If the cart doesn't correctly show in the session view, these pages might help:
Purchase the product and verify that the Buy Product event is tracked with the following details:
Ref matches the recommendation slot id
Target matches the product id
Wait 30 minutes for the session to expire and then verify that the order shows up in the orders page of the Nosto admin UI.
If the order doesn't correctly show in the session view, these pages might help:
If it’s not possible to perform a test order, the Nosto admin UI's orders page can be used to review that orders link to known products in the catalogue and that some items have click attribution towards the visible recommendations.
We’ve integrated with the User Timing API to be able to show some performance measurements of our client script. The supported measurements are:
nosto.get_dynamic_placements
Parse the DOM and find placements on the page. Performed before a recommendations request is sent.
nosto.load_recommendations
Send the recommendations request and handle the recommendation result. This encompasses measuring the recommendations request and nosto.inject_campaigns
.
nosto.inject_campaigns
Inject both dynamic and static campaigns into the DOM. This encompasses both nosto.inject_static_campaigns
and nosto.inject_dynamic_campaigns
.
nosto.inject_static_campaigns
Inject static campaigns into the DOM.
nosto.inject_dynamic_campaigns
Inject dynamic campaigns into the DOM.
nosto.evaluate_js
Extract and evaluate embedded JavaScript from recommendation templates.
Chrome's lighthouse tool can be opened by doing the following:
Right click and select Inspect.
Navigate to the Lighthouse tab.
Ensure the Performance category is enabled.
Click Generate Report
Once the report is generated, you can expand the “User Timing marks and measures” section under the Diagnostics section to see some basic information like how long after the page started to load the measurements start and how long each measurement took.
You can scroll back up and click the View Original Trace button to view a timeline of the measurements. You may need to expand the Timings section to view the client script’s recorded measurements. You can zoom in an out of this graph and swipe side to side to get a better view of things.