How to Set up Events on Crowd
Events in Crowd capture user actions on your app or website, like clicks, form submissions, or errors, unlocking
powerful insights when paired with Crowd’s analytics tools. Use events to build funnels, filter user data, or create
targeted cohorts. This guide walks you through setting up events using the Crowd Events API, from identifying goals to
implementing the code and leveraging events in Crowd.
1. Why Set Up Events with the Events API?
The Crowd Events API lets you programmatically send events to Crowd, enabling:
- Detailed tracking of user actions (e.g., button clicks, errors).
- Filtering of user data to uncover insights (e.g., users who encountered an error).
- Building funnels and cohorts based on specific user behaviors.
For a broader overview of events, see the Tracking Events on Your Website's Guide.
2. Step-by-Step Setup
2.1 Identify the Main Goals for Your App or Website
Start by defining your primary goals. These could include increasing conversions, reducing errors, tracking user
engagement, or monitoring A/B test performance. Here are some common use cases to inspire your goals:
- Filter user data to compare A/B test variants.
- Identify users who encounter errors to debug issues.
- Track engagement with key features (e.g., form submissions).
2.2 Decide What Events Support These Goals
List specific events that align with your goals. These are the actions you’ll track using the Crowd Events API. Examples
include:
- A click on a specific button (e.g., "Submit Order").
- An error message being triggered
Tie your goals to events. For example: “Track an event when an error occurs (the event) to filter user data and resolve
issues (the goal).”
2.3 Implement the Crowd Events API Code
The Crowd Events API allows you to send events programmatically.
Here’s how to implement the API directly:
1. Add Custom Code: Use the crowd.track() method to send events to Crowd. Depending on your technical expertise, you
may need a developer to assist with implementation.
2. Example Code: Below is a sample for tracking whether a payment was added successfully on a checkout page.
fetch('/api/add-payment', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
})
.then((response) => response.json())
.then((data) => {
crowd.track('payment_added_success', { amount: 99, currency: 'USD' });
// Handle backend response.
})
.catch(error => {
crowd.track('payment_added_failed', { error: error.message });
});
Note: This is an example. Consult your developers to tailor the code to your app’s needs and goals.
2.4 Steps to Modify Created Events on Crowd
After creating events, you can edit or archive them directly in the Crowd dashboard. Follow these steps:
1. Navigate to the Dashboard:
- Log in to your Crowd account and go to the homepage.
- Click on User Activities in the sidebar menu.
- From the dropdown, click Events to view your created events.
*Screenshot: Shows the Events dashboard listing existing events (e.g., header text on homepage, banner image click)
with an "Active" status indicating successful creation. *
2. Modify an Event:
- Locate the event you want to modify and click the ellipsis (three dots) on the far right.
- Select Edit to open the edit modal.
- Raw Event Name: The original event name (e.g., payment_added_success).
Event Aliases: Alternative names for the event (e.g., payment_success).
Description: A brief explanation (e.g., "Tracks successful payment additions").
- Update the fields as needed and click Save.
- Note: An "Active" status confirms the event is successfully integrated; use "Archive" to deactivate events no
longer needed.
3.0 Start Using Events in Crowd
Once the Events API code is implemented and events are modified as needed, events will appear in Crowd’s tools. You can
now:
- Use events to build funnels (e.g., "Sign up to Payment Added").
- Filter user data by events (e.g., users who triggered payment_added_failed).
- Create cohorts based on event activity (e.g., users with multiple successful payments).
4.0 Best Practices
- Align Events with Goals: Ensure each event supports a specific goal (e.g., track errors to improve UX).
- Use Descriptive Names: Name events clearly in snake_case (e.g., payment_added_success).
- Avoid Overloading Events: Track meaningful actions, not every interaction.
- Test Before Scaling: Verify events appear in Crowd before using them in funnels or cohorts.
4. Next Steps
With events set up, explore building funnels or creating cohorts. Check out the Creating Funnels on Crowd guide to get
started.
For assistance, contact support via the in-app chat or email support@crowdapp.io