Discord Alerts

How to Track Events with Your Dashboard

Learn the step-by-step process for setting up event categories, using the tracking API, and monitoring incoming events in real-time.

Introduction

Tracking events like sales, user sign-ups, and custom actions is vital for understanding user behavior and driving business growth. With our tool, tracking events is simple, efficient, and actionable. This guide explains the process step-by-step: from creating an event category to monitoring real-time event data in your dashboard.

Step 1: Create a Category in the Dashboard

  1. Log in to your dashboard.
  2. Click New Event Category.
  3. Enter a name for your category (e.g., sale, user-signup).
  4. Select a color and emoji to visually represent your event category.
  5. Click Create Category to save.

Your category will now appear on the dashboard with an event card showing details like “Last Ping,” “Unique Fields,” and “Events this Month.”

Step 2: View and Copy the Tracking API

  1. Navigate to the category you created in the dashboard.
  2. Click View All to access the category details.
  3. Copy the example tracking API code provided.

Step 3: Get Your API Key

  1. Go to the API Key tab in the dashboard sidebar.
  2. Copy your unique API key. This key is required to authenticate requests.
  3. Keep your API key secure by storing it in environment variables or a secure credentials manager.

Step 4: Add the JavaScript Code to Your Application

Insert the JavaScript tracking API code into your application where you want to trigger the event. For example:

// Add this code in your backend or frontend logic where the event should be triggered.
await fetch('https://beepsify.com/api/v1/events', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    category: 'sale',
    fields: {
      field1: 'value1', // e.g., user ID
      field2: 'value2'  // e.g., user email
    }
  })
});

Step 5: Listen to Incoming Events

  1. Once the event is sent, return to the dashboard and select the category you created.
  2. The event card will update with the following details:
    • Last Ping: The most recent time an event was received.
    • Unique Fields: The number of unique data points tracked.
    • Events This Month: The total number of events received in that category.
  3. Use the real-time event data to analyze performance, track user activity, and gain actionable insights.

Best Practices

  1. Secure Your API Key: Store your API key in a safe location to prevent unauthorized access.
  2. Send Relevant Data: Include meaningful information in the fields section to ensure your event tracking is useful.
  3. Test Your Events: Use tools like Postman or Insomnia to validate your API requests before deploying them in production.

Conclusion

By creating categories, copying the tracking API, and using your unique API key, you can start tracking events with ease. With real-time updates in the dashboard, you’ll have actionable insights to make informed decisions and optimize your business. Log in today and start tracking your events effortlessly! Try our tool for free and experience the power of real-time alerts today!