Checking your setup
Step by step guide for checking that our client script is tracking events on your site.
- 1.
- 2.Load the debug toolbar by appending
nostodebug=trueto your store's URL e.g.https://example.com?nostodebug=true - 3.Click the login link and navigate to the session view.
Click the login button
After logging in, the session tab should be visible on the left-hand side
Navigate to a category page and verify that the View Category event is tracked with the following details:
- Target matches the viewed category.
Viewing the "Bags" 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.
Viewing product 784735895612
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.
Viewing product 789528674364 from recommendation slot productpage-nosto-14-high-upsell
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.
Buy product 789528674364 from recommendation slot productpage-nosto-14-high-upsell.
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_placementsParse the DOM and find placements on the page. Performed before a recommendations request is sent.nosto.load_recommendationsSend the recommendations request and handle the recommendation result. This encompasses measuring the recommendations request andnosto.inject_campaigns.nosto.inject_campaignsInject both dynamic and static campaigns into the DOM. This encompasses bothnosto.inject_static_campaignsandnosto.inject_dynamic_campaigns.nosto.inject_static_campaignsInject static campaigns into the DOM.nosto.inject_dynamic_campaignsInject dynamic campaigns into the DOM.nosto.evaluate_jsExtract and evaluate embedded JavaScript from recommendation templates.
- 1.Right click and select Inspect.
- 2.Navigate to the Lighthouse tab.
- 3.Ensure the Performance category is enabled.
- 4.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.
