Data Tags
Learn how to use data tags to organize, segment, and analyze your tracking data in Oppla.
Data tags are labels you can add to your events and users to:
- Organize related data
- Create segments
- Filter analytics
- Group similar events
Using Data Attributes
Add tags to your events using data attributes:
<!-- Basic tagging -->
<button
id="signup-button"
data-oppla-event="Button Clicked"
data-oppla-event-tags="conversion,signup,homepage">
Sign up
</button>
<!-- Tag categories -->
<button
id="search-button"
data-oppla-event="Feature Used"
data-oppla-event-feature="search"
data-oppla-event-tags-category="core-feature"
data-oppla-event-tags-priority="high"
data-oppla-event-tags-stage="beta">
Search
</button>
Using JavaScript
Add tags programmatically:
// Browser implementation
window.oppla.track('Button Clicked', {
buttonId: 'signup-button',
tags: ['conversion', 'signup', 'homepage']
});
// With tag categories
window.oppla.track('Feature Used', {
feature: 'search',
tags: {
category: 'core-feature',
priority: 'high',
stage: 'beta'
}
});
// Node.js implementation
oppla.track('Button Clicked', {
buttonId: 'signup-button',
tags: ['conversion', 'signup', 'homepage']
});
Tag users for segmentation:
// Browser implementation
window.oppla.identify({
userId: 'user_123',
traits: {
name: 'John Doe',
tags: ['premium', 'active', 'beta-tester']
}
});
// Node.js implementation
oppla.identify({
userId: 'user_123',
traits: {
name: 'John Doe',
tags: ['premium', 'active', 'beta-tester']
}
});
Update user tags over time:
// Browser implementation
window.oppla.identify({
userId: 'user_123',
traits: {
tags: {
add: ['power-user'],
remove: ['beta-tester']
}
}
});
// Node.js implementation
oppla.identify({
userId: 'user_123',
traits: {
tags: {
add: ['power-user'],
remove: ['beta-tester']
}
}
});
Tag Management
Best Practices
- Be Consistent: Use consistent tag names
- Be Specific: Use descriptive tags
- Be Organized: Group related tags
- Be Careful: Don’t use too many tags
Common Tag Categories
- User type (e.g., ‘free’, ‘premium’)
- Feature usage (e.g., ‘uses-search’, ‘uses-analytics’)
- User stage (e.g., ‘new’, ‘active’, ‘churned’)
- Campaign (e.g., ‘summer-sale’, ‘winter-promo’)
Filtering Data
Filter your analytics by tags:
// Browser implementation
window.oppla.analytics.getEvents({
tags: ['conversion', 'signup']
});
window.oppla.analytics.getUsers({
tags: ['premium', 'active']
});
// Node.js implementation
oppla.analytics.getEvents({
tags: ['conversion', 'signup']
});
Creating Segments
Create user segments based on tags:
// Browser implementation
window.oppla.analytics.createSegment({
name: 'Power Users',
tags: ['premium', 'active', 'power-user']
});
// Node.js implementation
oppla.analytics.createSegment({
name: 'Power Users',
tags: ['premium', 'active', 'power-user']
});
Next Steps
