You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-[Develop a Tracking Plan](#develop-a-tracking-plan)
18
-
-[Using the Tracking Plan Google Sheets template](#using-the-tracking-plan-google-sheets-template)
19
18
-[Plan your Identify and Group calls](#plan-your-identify-and-group-calls)
20
19
-[Plan your Track events](#plan-your-track-events)
21
20
-[Define your Track event properties](#define-your-track-event-properties)
@@ -60,11 +59,11 @@ With your business objectives documented and mapped to user actions, it's time t
60
59
61
60
When you're first starting out, we recommend that you limit your tracking plan to a few core events, but add lots of properties to provide context about them. We generally see more success with the “less is more” philosophy of tracking data, but you might also decide to take a more liberal “track more and analyze later” approach. Like everything, each alternative has pros and cons that are important to consider especially as it relates to your company's needs.
62
61
63
-
### Shortcut! Check if a Business Spec meets your needs
62
+
### Shortcut: Check if a Business Spec meets your needs
64
63
65
-
Segment maintains several "Business Specs", which are recommendations based on your type of business that give recommendations on what to track, what additional traits or properties to collect, and how to format them. The two most common are the B2B (business-to-business) Spec, Ecommerce Spec, and our Mobile and Video specs.
64
+
Segment maintains several "Business Specs", which are recommendations based on your type of business that give recommendations on what to track, what additional traits or properties to collect, and how to format them. The two most common are the B2B (business-to-business) Spec, Ecommerce Spec, and Mobile and Video specs.
66
65
67
-
If these specs meet your business needs, you're in luck! These specs are built into our tracking plan templates, so you don't need to start from a blank slate.
66
+
If these specs meet your business needs, you're in luck. These specs are built into Segment tracking plan templates, so you don't need to start from a blank slate.
68
67
69
68
#### B2B Spec
70
69
@@ -90,9 +89,9 @@ Regardless of approach, here are some important best practices to keep in mind:
90
89
91
90
-**Pick a casing convention:** We recommend *Title Case* for event names and *snake_case* for property names. Make sure you pick a casing standard and enforce it across your events and properties.
92
91
93
-
-**Pick an event name structure:** As you may have noticed from our [specs](/docs/connections/spec/semantic/), we're big fans of the Object (`Blog Post`) + Action (`Read`) framework for event names. Pick a convention and stick to it!
92
+
-**Pick an event name structure:** As you may have noticed from our [specs](/docs/connections/spec/semantic/), we're big fans of the Object (`Blog Post`) + Action (`Read`) framework for event names. Pick a convention and stick to it.
94
93
95
-
-**Don't create event names dynamically:** Avoid creating events that pull a dynamic value into the event name (for example, `User Signed Up (11-01-2019)`). If and when you send these to a warehouse for analysis, you end up with huge numbers of tables and schema bloat!
94
+
-**Don't create event names dynamically:** Avoid creating events that pull a dynamic value into the event name (for example, `User Signed Up (11-01-2019)`). If and when you send these to a warehouse for analysis, you end up with huge numbers of tables and schema bloat.
96
95
97
96
-**Don't create events to track properties:** Avoid adding values to event names when they could be a property. Instead, add values as a property. For example, rather than having an event called "Read Blog Post - Best Tracking Plans Ever", create a "Blog Post Read" event and with a property like `"blog_post_title":"Best Tracking Plans Ever"`.
98
97
@@ -101,15 +100,15 @@ Regardless of approach, here are some important best practices to keep in mind:
101
100

102
101
103
102
104
-
Got all that? Great! You're now ready to develop a Tracking Plan.
103
+
Got all that? Great. You're now ready to develop a Tracking Plan.
105
104
106
105
<!--Source: /docs/protocols/data-quality/whats-a-tracking-plan/ or /docs/protocols/tracking-plan/ -->
107
106
108
107
## Develop a tracking plan
109
108
110
109
A [tracking plan](https://segment.com/blog/what-is-a-tracking-plan/){:target="_blank"} clarifies what events to track, where those events live in the code base, and why you're tracking those events (from a business perspective). **A good tracking plan represents the single source of truth about what data you collect, and why.**
111
110
112
-
Your tracking plan is probably maintained in a spreadsheet (unless you use our tracking-plan tool, [Protocols](/docs/protocols/)), and serves as a project management tool to get your organization in agreement about what data to use to make decisions. A tracking plan helps build a shared understanding of the data among marketers, product managers, engineers, analysts, and any other data users.
111
+
Your tracking plan is probably maintained in a spreadsheet (unless you use Segment's tracking-plan tool, [Protocols](/docs/protocols/)), and serves as a project management tool to get your organization in agreement about what data to use to make decisions. A tracking plan helps build a shared understanding of the data among marketers, product managers, engineers, analysts, and any other data users.
113
112
114
113
### Plan your Identify and Group calls
115
114
@@ -155,7 +154,7 @@ For an Ecommerce company, however, the main events might be something like:
155
154
-**Order Completed**
156
155
157
156
> success ""
158
-
> **Tip**: As we mentioned [above](#shortcut-check-if-a-business-spec-meets-your-needs), Segment has a set of “reserved” event names specifically for ecommerce, called our[Ecommerce Spec](/docs/connections/spec/ecommerce/v2). Check it out to see which events we cover and how they are used in our downstream destinations.
157
+
> **Tip**: As mentioned [above](#shortcut-check-if-a-business-spec-meets-your-needs), Segment has a set of “reserved” event names specifically for ecommerce, called the[Ecommerce Spec](/docs/connections/spec/ecommerce/v2). Check it out to see which events Segment covers and how they are used in downstream destinations.
159
158
160
159
An online community, on the other hand, has an entirely different set of actions that indicate engagement, as listed below. For example, a community might want to track actions like:
0 commit comments