Organizing your tracking plan
Avo provides multiple, complementary ways to organize a tracking plan at any scale. Use them together to keep data consistent, navigable, and accountable:
- Workspaces: centralized tracking plan and release workflow
- Stakeholder teams: ownership and dependencies across teams
- Sources: scope and tailor data per codebase
- Destinations: document and configure downstream tools
- Categories: visual grouping across items
- Tags: flexible labels for governance and workflow
- Property bundles: reusable sets of properties
- Metrics: outcomes that tie everything together
Below we cover each, then how they work together, and practical examples.
Workspaces
A workspace in Avo houses the tracking plan for a product or organization, where all data structures share the same namespace - events and properties are re‑used across the product(s) the workspace applies to. A workspace is also where the end to end Avo workflow happens: define goals and metrics, design events and properties, request implementation, validate, and publish. With Inspector connected, the workspace surfaces discrepancies between your plan and live tracking so you can keep the plan accurate over time.
Most organizations are best served by a single workspace for their tracking plan - even if they have more than one product. Some organizations, however, have multiple products that are largely unrelated and share only a small subset of events and properties. In that case, it can be best to keep a single workspace for shared events and properties and create local workspaces for products that are not related to the shared definitions.
Global workspaces
Global workspaces let a central team define core events and properties to share across multiple local workspaces. Local workspaces adopt those definitions and can extend them within the global constraints. They may create event variants and add local events where needed. This model delivers cross product consistency while preserving product level flexibility.
Learn more: Global Requirements
Stakeholder teams
Stakeholder teams represent functions or product areas and map tracking plan items to the people responsible for or dependent on them (for example, checkout or search, a central governance group, a platform like iOS, or a data consumer such as experiments or marketing). They clarify accountability and make cross team impact visible.
Tips and usage:
- When creating new events and properties, set your team as a stakeholder (and owner if applicable)
- When editing existing events and properties, review the impact on other stakeholders and minimize scope where possible
- When a branch is ready, add impacted stakeholders as reviewers
Example in practice: Organizations with multiple product verticals often create a stakeholder team per vertical so analysts own day to day analytics in their area and the teams are pulled into review when data they depend on is being modified. Core events leveraged across the org can list the governance team as a stakeholder so they are pulled into reviews.
Learn more: Stakeholders
Sources
Sources represent your codebases (Web, iOS, Android, Backend). They document which events should be sent from which codebase and allow tailoring event/property shapes per source.
Tips and usage:
- Keep track of which events are sent from each codebase and filter the tracking plan by source
- Define events and properties per source and set source specific shapes (not all properties are sent from all platforms)
- Document triggers per source and provide per source implementation diffs to developers
- Monitor discrepancies between plan and live tracking per source; scope Inspector filters and alerts by source
- When defining new events, set the source(s) they should be sent from; review and code changes screens are segmented by source
Learn more: Sources
Destinations
Destinations are downstream tools in your data stack (analytics tools, CDPs, etc.). Use them to document where events are sent and from which sources; destinations can also be configured per event when needed.
Tips and usage:
- Typically set up when adding a new source or when introducing a new destination to your stack
- Configure per event destination behavior where applicable
Learn more: Destinations
Categories
Categories group and organize your tracking plan across the Events and Metrics views. Each category has a details view that shows its description and the full list of items in the category (metrics, events, variants, and properties).
Tips and usage:
- The default Events table view is organized by category
- You can filter the Metric, Event, Property and Inspector issue views by category, and also when adding items to a stakeholder team or deciding which events to publish
- Teams often mirror product areas as categories to get focused, relevant views
- Items can belong to multiple categories
- Categories can be published to supported destinations (for example, Mixpanel and Amplitude) so your analytics tools mirror the same grouping
Tags
Tags are lightweight labels for workflows and governance across Events, Variants, and Properties. Items can have multiple tags and tags are shared across items. Use tags to encode policies and processes.
Tips and usage:
- Document item priority (P0, P1, P2)
- Label PII sensitive events and properties
- Mark items for deprecation or lifetime
- Track missing/outdated screenshots or documentation
- Encode operational ownership (e.g., implementation owner) until teams are formalized
- Filter event, property and Inspector issue views by tags
Property bundles
Property bundles let you package commonly used event properties into reusable sets you can attach to many events at once. They speed up data design, reduce mistakes, and keep shared definitions consistent across your tracking plan.
Tips and usage:
- Create bundles for recurring groups like Product, Cart, Game, etc.
- Attach a bundle to multiple events to apply all included properties at once
- Use bundles to standardize naming, types, and constraints across similar events
Learn more: Event property bundles
Metrics
Metrics define desired outcomes and link the events, variants, and properties used to analyze them.
Tips and usage:
- Start with outcomes: define the metric first, then list what is needed to measure it
- Associate events, variants, and properties to each metric and create missing items from the metric view
- Use categories and tags on metrics to aid discovery and navigation in large plans
Learn more: Metrics
How these work together
The table below summarizes each organizer, what it’s for, which items it applies to, and whether it’s published downstream.
Organizer | Primary purpose | Metrics | Events | Variants | Properties | Published downstream |
---|---|---|---|---|---|---|
Workspaces | Central governance with local flexibility | ✅ | ✅ | ✅ | ✅ | ✅ |
Stakeholder teams | Ownership & dependencies | ❌ | ✅ | ✅ | ✅ | ✅ (Webhook) |
Sources | Scope data per codebase; per source design and observability | ❌ | ✅ | ✅ | ✅ | ✅ |
Destinations | Document and configure downstream tooling | ❌ | ✅ | ✅ | ✅ | ✅ (per destination) |
Categories | Visual grouping & navigation | ✅ | ✅ | ✅ | ✅ | ✅ (Webhook, Mixpanel*, Amplitude) |
Tags | Flexible labeling & workflows | ❌ | ✅ | ✅ | ✅ | ✅ (Webhook, Mixpanel, Segment Protocols) |
Property bundles | Reusable sets of properties for consistency | ❌ | ✅ | ✅ | ✅ | ❌ |
Metrics | Analysis structure tying items together | ✅ | ✅ | ✅ | ✅ | ✅ (Webhook) |
* Mixpanel Lexicon publishing can be set to receive category in Avo as tags in Mixpanel as Mixpanel does not support categories.
Practical examples
There are many ways to organize a tracking plan, and the best approach depends on the size and complexity of your organization and the products you are tracking. Below are two common approaches for very different organizations.
Multi workspace enterprise
For organizations with several subsidiaries and multiple teams, a central data team often defines shared data structures while individual product teams extend them locally. This pattern emphasizes consistency where it matters most (user identity, revenue, core lifecycle events) and flexibility where products diverge (feature specific events and properties). It also streamlines reviews and publishing, so shared structures evolve safely across many codebases.
- Global workspace for central definitions and local workspaces for products
- Stakeholders map to analysts serving more than one development team, where each analyst leads a stakeholder team
- Sources define platform scope and per source shape (e.g., mobile vs web properties)
- Destinations document where data goes and how per event configs differ
- Categories map to product areas, sometimes representing development teams
- Tags highlight governance and workflow status (PII, priority, deprecation)
- Property bundles standardize common property sets across many events and products
- Metrics defined centrally for shared outcomes (e.g., retention, conversion); local workspaces add product specific metrics
Growth stage startup
For fast moving teams shipping from a single or few related products, a single workspace minimizes overhead and keeps planning simple. A central data person or small data team can coordinate standards by acting as a Stakeholder Team (owner/reviewer) rather than setting up a separate global workspace, preserving simplicity while still enabling ownership, review workflows, and focused filtering.
- Single workspace
- Stakeholders map to development teams, where an analyst or a PM leads stakeholder teams
- Sources clarify platform scope and enable per source presence/constraints
- Destinations capture where events are sent without over engineering
- Categories map to product areas
- Tags encode PII, priority, and lifecycle workflows
- Property bundles group recurring properties and speed up design
- Metrics drive planning: define key outcomes first, then associate events/variants/properties