Event Tracking Overview
GoSquared's event tracking captures user actions and associates them with visitor profiles for comprehensive behavioral analysis.
Basic Event Tracking
Track Events
_gs('event', 'Event Name');
// With properties
_gs('event', 'Event Name', {
property: 'value',
another: 123
});
Common Events
// Signup
_gs('event', 'Signed Up', {
plan: 'Pro',
source: 'website'
});
// Purchase
_gs('event', 'Purchase', {
value: 99.99,
product: 'Premium Plan'
});
// Feature usage
_gs('event', 'Used Feature', {
feature: 'Export',
format: 'PDF'
});
User Identification
Identify Users
_gs('identify', {
id: 'user_123',
email: 'user@example.com',
name: 'John Doe',
custom: {
plan: 'premium',
company: 'Acme Inc'
}
});
Update Properties
_gs('properties', {
plan: 'enterprise',
seats: 10
});
Transaction Tracking
Record Transactions
_gs('transaction', {
id: 'order_123',
revenue: 99.99,
quantity: 1
});
With Item Details
_gs('transaction', {
id: 'order_456',
revenue: 249.99,
items: [
{ name: 'Product A', price: 149.99 },
{ name: 'Product B', price: 100.00 }
]
});
Page Tracking
Virtual Page Views
For single-page applications:
_gs('track'); // Track current URL
// Or specify URL
_gs('track', '/virtual-page');
Best Practices
- Use consistent event names
- Include relevant properties
- Identify users as early as possible
- Test events before deployment