Data Tags

Learn how to organize and segment your data using tags in Oppla

Data Tags

Learn how to use data tags to organize, segment, and analyze your tracking data in Oppla.

What are Data Tags?

Data tags are labels you can add to your events and users to:

• Organize related data
• Create segments
• Filter analytics
• Group similar events

Adding Tags to 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']
});

User Tags

Adding User Tags

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']
  }
});

Updating User Tags

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

1. Be Consistent: Use consistent tag names
2. Be Specific: Use descriptive tags
3. Be Organized: Group related tags
4. 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’)

Using Tags in Analysis

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

Compare Metrics

Compare tagged data over time

Node Client

Server-side tag management