Tracking and Debugging Events
Learn how you can track events, debug issues, and verify event flows using Ours Privacy’s tools, including the Recent Events dashboard and test tokens.
Tracking and Debugging Events
The Ours Privacy platform provides tools to help you track and debug events as they flow through the system. This guide will show you:
- How you can track events and verify they are being received.
- Debugging tools available in the Ours platform.
- Best practices for identifying and resolving issues.
Verifying Tracked Events
You can verify events have been sent in the Recent Events Dashboard in the Ours app. This dashboard gives you complete visibility into how events are processed.
How to Access the Dashboard
- Navigate to the Recent Events section in the Ours app.
- Search for your event by name (e.g., "FormSubmit").
- Click on the event to view its details, including:
- Event Properties: Key-value pairs describing the action.
- User Properties: Information about the user, such as email or city (hashed or redacted).
- Destinations: The platforms the event was forwarded to.
Debugging Event Issues
If your event does not appear in the Recent Events dashboard in the Ours app or does not behave as you expect, you can follow these debugging steps:
1. Check Your Installation
- Verify that your tracking script or server-to-server integration is set up correctly. See the Installation guide for details.
- Confirm that the script is loaded on all pages where events are tracked.
2. Confirm the Event is in your Allow List
- Ensure the event is added to your Event Allowlist in the Ours platform. Only events allowlisted for a specific destination are dispatched to it. For more details, see Adding Events to Your Allowlist.
3. Inspect the Browser Console
- Open your browser’s developer tools and look for errors related to the
ours
function. - Use
console.log
to verify that your event properties are being sent correctly.
4. Review Mappers and Privacy Rules
- Check if a custom mapper is modifying your event data before it is sent to destinations. See Data Mapping for more details.
- Ensure that privacy rules, such as hashing or redaction, are not unintentionally altering critical data.
5. Inspect Destinations
- Confirm that your destinations are correctly configured in the Ours platform. Each destination may have specific requirements for the event structure. See the Destinations Overview.
Test Mode
What is Test Mode?
Test Mode is a safe environment where you can validate your analytics setup without sending actual data to your configured destinations. It allows you to:
- Debug your analytics implementation
- Verify event tracking configurations
- Test integrations
- Ensure everything works as expected before going live
Setting Up Test Mode
Using Test Tokens
- Log into the Ours platform
- Navigate to your source (Web SDK, GTM, or API)
- Copy the test token provided
- Use this test token in your implementation
Any event sent using a test token will automatically be processed in test mode.
How Test Mode Works
Event Processing
When you use Test Mode:
- ✅ Events are fully captured and processed
- ✅ Events are stored in the Ours platform
- ✅ Dispatch objects are created
- ❌ No data is sent to external destinations
Viewing Test Events
- Go to the Recent Events view in the Ours app
- Look for events marked with a "Test" indicator
- Review the intended destinations (where events would be sent in live mode)
Debugging Workflow
- Implement: Set up your analytics with the test token
- Trigger: Generate events on your site or application
- Validate: Check the Recent Events view to confirm proper tracking
- Review: Verify event properties and intended destinations
- Go Live: Switch to your live token once everything is working correctly
Benefits
- Debug without affecting production data
- Safe testing environment
- Full visibility into event processing
- Real-time validation
- Verify destination configurations
Next Steps
Once you've completed testing:
- Replace the test token with your live token
- Verify that events are being sent to their intended destinations
- Monitor your live events to ensure everything continues working as expected
Common Debugging Scenarios
Missing Event in the Ours Platform
- Cause: The script is not properly installed or your trigger is not sending the event to Ours Privacy.
- Solution: Check your GTM setup or custom track code setup to make sure Ours Privacy is loaded and sending the event.
Incorrect User Properties
- Cause: User properties are not being set or formatted correctly.
- Solution: Ensure the
ours('track', 'Event Name', {color: 'red'}, {email: '[email protected]' })
function includes the correct user properties. See User Properties Overview.
Event Not Forwarded to Destinations
- Cause: Destination configuration issues, or the event name is missing from the allow list.
- Solution: Verify destination setup and check custom mapper rules in Data Mapping.
Best Practices for Tracking and Debugging
- Use the Test Token:
- Debugging with a test token helps avoid cluttering production data.
- Add Events to Allowed Event List Early:
- Add events to your Event Allowlist before tracking them.
- Inspect Events Regularly:
- Use the Recent Events dashboard in the Ours app to monitor event flow and catch issues early.
- Validate Destinations:
- Test each destination’s setup to ensure events are formatted and sent correctly.
- Leverage Custom Mappers.
Updated 17 days ago