This guide walks you through using the Scenario Tester. The Scenario Tester allows you to validate your configurations live on-screen before activating them. By simulating the execution path in real time, you can debug selectors, verify JSON objects, and fix configuration errors instantly. This saves time and ensures your background checks only go live when they are 100% correct. to validate your DataLayer Guard scenario configuration.
What will you do?
- Launch the Scenario Tester from the portal
- Select and run one or more scenarios
- Monitor the livestream and step panel in real time
- Review and export the results
⏰ Estimated time: 5–10 minutes
🔧 Requirements: Access to the Code-Cube.io portal and at least one configured scenario
How to use the Scenario Tester
Step 1: Open the Scenario Tester
Before running a test, navigate to the correct location in the portal so you can access the Scenario Tester window.
- Access the DataLayer Guard configurations page in the Code-Cube.io portal.
- Go to Monitoring via Page Scenarios.
- Click the Test scenario button.
💡 The Scenario Tester window will open after clicking Test scenario.
Step 2: Select a scenario and start the test
Choose which scenario(s) you want to validate. You can choose to run multiple scenarios, however, running a single scenario saves time when you are working on a specific part of your configuration.
- Click the dropdown in the top-left corner of the Scenario Tester window.
- Select one or more scenarios from the list. Leave it set to All scenarios to test every created scenario.
- Press the Start button.
⚠️ Important: The scenario selector is disabled while a test is running. Stop the test first if you need to change your selection.
Step 3: Monitor the test in real time
While the test runs, two panels at the bottom of the window give you a live view of progress and system activity.
- Watch the Live step panel (bottom-left) to see each step appear with a “pass” or “fail” status.
- Watch the Live logs panel (bottom-right) to see timestamped system messages and any errors.
- Monitor the livestream on the right side of the window to see the real-time DataLayer Guard actions in the browser.
Step 4: Review and export the results
Once the test finishes, the results panel appears automatically. You can inspect everything that was collected and validated.
- Review the summary badges at the top of the results panel:
- X events collected: total number of dataLayer events found.
- Y events have errors: number of events with validation errors.
- Click on any scenario to expand it and see:
- Individual steps with their pass/fail status.
- Collected dataLayer objects shown as formatted JSON.
- For failed steps: a detailed error breakdown showing the expected value versus the actual value for each parameter.
- Export the results if needed:
- Download PDF: exports a formatted PDF report.
- Download Excel: exports the results as an XLSX file.
Interface & component breakdown
Scenario selector
Status indicator
Test statistics
Livestream
Live step panel
Live logs panel
Results panel
Troubleshooting
Issue | Likely cause | What to do |
Livestream shows "Waiting for browser feed…" indefinitely | Browser connection failed to establish. | Stop the test and start it again. Check your network connection. |