What is the Tracking Plan?
The Chord tracking plan is a specification that defines the events and event properties that Chord sends to Segment. The tracking plan is a comprehensive list of all events Chord sends to Segment, including events coming from the Chord OMS source and the website front-end source via Chord's SDKs. Find an overview of Chord's tracking plan events. The Chord Tracking Plan.
Chord imports the tracking plan into Segment as a Protocols Tracking Plan, so you can use Segment's built-in features like violations reporting, which lets you see if events comply with the Protocols Tracking Plan.
We're using the words "tracking plan" to mean two different things, so let's define:
Chord tracking plan: An event spec describing all tracking events and properties that Chord will send to Segment.
Protocols Tracking Plan: A copy of the Chord tracking plan imported into Segment.
What's in the tracking plan?
Chord sends events to track the full customer journey on your site, as they add products to their cart, filter lists of products, sign into their customer account, and check out. Chord also sends events when changes take place in the OMS, as packages are shipped, customer subscriptions are renewed, and products come back in stock. All these events and event properties are described in the Chord tracking plan. Here's The Chord Tracking Plan of the events in the tracking plan.
Chord's tracking plan incorporates Segment's ecommerce spec, although it has additional events and event properties. This is important because some Segment third-party destinations expect events to follow Segment's ecommerce spec.
For a detailed view of all the events and event properties in the Chord tracking plan, you can see the copy that was imported into Segment as a Protocols Tracking Plan. Navigate to the Protocols section in Segment:
From here, you can select the tracking plan and explore a detailed view of every event and event property, including the data type of each property (e.g. "String" or "Number").
Occasionally Chord will release a new feature and add new events or event properties to the Chord tracking plan. Chord will notify you that your tracking plan will be upgraded when this happens. This means Chord will change the Protocols Tracking Plan in your Segment account. Protocols Tracking Plans have a changelog, so you can always see what has changed.
Using the Protocols Tracking Plan
When you sign up, Chord will import the Chord tracking plan into your Segment account as a Protocols Tracking Plan. Chord will also connect the Protocols Tracking Plan to your SEGMENT EVENT TRACKING. You can use it to monitor your Segment events for possible issues impacting your data reporting or third-party integrations. You can also use it to generate your analytics library if you want to send events directly to Segment.
Adding the Protocols Tracking Plan to Segment and connecting it to sources does not impact the events Chord sends to Segment. (Unless you've intentionally configured your Segment account to block events not in the Protocols Tracking Plan, which we don't recommend. We'll go into this in the next section.) Chord sends events to Segment that comply with the Chord tracking plan, whether or not a Protocols Tracking Plan is provisioned in your Segment account. Deleting an event from the Protocols Tracking Plan does not stop Chord from continuing to send the event or your connected destinations from receiving the event.
When the Protocols Tracking Plan is connected to sources, you can monitor for violations, which are incoming events that don't match the Protocols Tracking Plan. It's up to you if you want to monitor this. Chord monitors for any event violations that impact data reporting. However, it's a good starting point for troubleshooting integrations. For example, if you see an error with an integration that indicates an event property is missing, you might check for violations for that event. The violations could give you more information about how often the property is missing when it started occurring, and its expected value.
To view violations, navigate to a Segment source and select Schema > View Violations. You'll see a list of events and their violations:
If you see violations for events sent by Chord, your Protocols Tracking Plan could be out of date with Chord's tracking plan. Reach out to Chord to troubleshoot.
You can forward violations to a Segment source if you want to set up custom monitoring. You can also choose to block events that violate the Protocols Tracking Plan, but we advise against this. This can result in permanently lost data.
if you have any questions or need help, please reach out to us at email@example.com