website logo
Navigate through spaces
⌘K
OVERVIEW
ORDER MANAGEMENT (OMS)
SHIPPING - SETUP
Shipping Methods
Shipping Zones
Shipping Method Setup Examples
TAXES - Setup
Tax Automation with Stripe Tax
Tax Automation with Avalara
CONTENT MANAGEMENT (CMS)
DATA
CUSTOMER LIFETIME REVENUE
Customer Lifetime Revenue Explanation
Customer Lifetime Revenue and Purchase Likelihood
Recency Frequency and Monetary
CLR and RFM Data Table Glossary
RFM and CLR in the Hub
LOOKER
Modifying a Dashboard
Timestamp differences between Looker, OMS and Shopify
How to create custom calculations in Looker
Looker and Shopify data models
Custom fields
How to 'Save and Schedule' reports
Creating Custom Reports or Look
Looks vs Dashboards
Login Looker FAQ
Looker Glossary
SEGMENT EVENT TRACKING
What are event tracking
Adding Tracking
What is the Tracking Plan?
The Chord Tracking Plan
The Shopify Tracking Plan
Event Tracking FAQ
EVENT UPDATES PAGE
Email Subscription Payment Event Update
Product Feed Setup
Getting Segment to Production
Consent Management
Installing in Next.js
Installing in Gatsby
Integrations
👩‍💻Developer Tools
Using Chord with Shopify
Docs powered by archbee 

What is the Tracking Plan?

11min



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:


Document image



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").


Document image



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.

Validating events

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:


Document image



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 help@chord.co



Updated 26 Apr 2023
Did this page help you?
Yes
No
PREVIOUS
Adding Tracking
NEXT
The Chord Tracking Plan
Docs powered by archbee 
TABLE OF CONTENTS
What's in the tracking plan?
Using the Protocols Tracking Plan
Validating events