Scenario Tester

The Scenario Tester lets you validate your DataLayer Guard scenarios live on-screen before you activate them. You watch each step run in a real browser, so you can debug selectors, check dataLayer objects, and fix configuration errors right away. Your background checks only go live once they work correctly.

New to scenarios? Start with Monitoring via Page Scenarios.

What will you do?

• Open the Scenario Tester from the portal
• Select and run one or more scenarios
• Follow 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

• Step 1 – Open the Scenario Tester
• Step 2 – Select scenarios and start the test
• Step 3 – Follow the test in real time
• Step 4 – Review and export the results
• The Scenario Tester window
• Scenario selector
• Status indicator
• Test statistics
• Livestream
• Live step panel
• Live logs panel
• Results panel
• Troubleshooting
• Next steps

Step 1 – Open the Scenario Tester

1. Go to the DataLayer Guard configuration page in the Code-Cube.io portal
2. Open Monitoring via page scenarios
3. Click Test scenario. The Scenario Tester window opens

Step 2 – Select scenarios and start the test

1. Click the dropdown in the top-left corner of the Scenario Tester window
2. Select one or more scenarios, or leave it set to All scenarios to test every scenario
3. Click Start

💡 Tip: Running a single scenario saves time when you're working on a specific part of your configuration.

⚠️ Important: The scenario selector is disabled while a test is running. Stop the test first if you want to change your selection.

Step 3 – Follow the test in real time

While the test runs, three areas of the window show you what's happening:

• Livestream (right): the browser that DataLayer Guard is controlling, live
• Live step panel (bottom left): each step as it runs, with a pass or fail status
• Live logs panel (bottom right): timestamped system messages and errors

💡 Tip: Click any step in the live step panel to go straight to it in the scenario editor, fix it, and run the test again.

Step 4 – Review and export the results

When the test finishes, the results panel opens automatically.

1. Check the summary at the top:
• X events collected: the total number of dataLayer events found
• Y events have errors: the number of events with validation errors
2. Click a scenario to expand it and see:
• Each step with its pass or fail status
• The collected dataLayer objects, shown as formatted JSON
• For failed steps: the expected value next to the actual value for each parameter
3. Export the results if needed:
• Download PDF: a formatted PDF report
• Download Excel: the results as an XLSX file

The Scenario Tester window

Expand a part of the window for more detail.

Troubleshooting

For specific error messages, see the error guide below.

Scenario Tester error guide

Still stuck? Email support@code-cube.io.

Next steps

• Monitoring via Page Scenarios: activate your tested scenarios (Step 6)
• Reusable components: share common steps across scenarios