Event Streams Overview

This guide explains how to configure and use Event Streams in the Extole platform.

What Are Event Streams?

The Event Stream provides real-time visibility into every event sent through the Extole platform, making it an essential QA and troubleshooting tool. It’s designed to help you validate and debug data flows, track user activity, and verify that key actions and customer journeys are working as expected - all without technical expertise. Use it regularly during program setup and testing to ensure a seamless and rewarding customer experience.

Why Use Event Streams?

Event Streams help you:

  • Validate event integration
  • Debug data transfer issues
  • Investigate anomalies
  • Analyze live program behavior
  • Monitor events

How to Access Event Streams

Event Streams, found in the Tech Center of your My Extole account.

You can filter your Event Streams using multiple filters combined with an AND operator:

FilterDescription
Event NameThe name of a specific event in a program (e.g., login, share).
Event TypeThe type of event (e.g., INPUT, REWARD).
Application TypeThe type of application events are coming from (e.g., Web App, API).
Person IDThe specific ID of the person who performed the event.
SandboxThe name of the sandbox the event occurred in (e.g. container-test).

Write expressions to explore and extract specific data using a specialized query language: Event Stream Query Language →

The event stream does not start automatically; you need to click the Start Streaming button to begin.

You can edit or delete the event stream from the current page or update the stop date.

To stop an active stream, click on the timer section.

To view events click on the event stream name, and you’ll be redirected to the stream’s event page.

On the event page, you can:

  • Search for events
  • Edit the filter
  • Pause or stop the stream
  • View events as JSON (pretty or raw)
  • Copy the JSON
  • Refresh the stream to load new events into the view

Additional meta-event entries will be recorded to indicate when the stream has been paused, ensuring clarity that no events were produced during those periods.

Common Use Cases for Marketers

  1. QA During Program Testing
    When testing your referral program, you can use the Event Stream to follow the sequence of actions triggered by your test accounts.
    Confirm that key events (such as sharing, registering, purchasing, or rewarding) are firing as expected, with the correct values.
  2. Troubleshooting Missing Rewards or Referrals
    If a test or live user doesn't receive a reward, use the Event Stream to trace what happened:
    • Was the share link created and clicked?
    • Did the registration or purchase event reach Extole?
    • Was the friend email tied to the correct advocate? etc.
  3. Validating Event Attribution
    Ensure that events are being correctly associated with the referral journey by checking data like:
  • Advocate or friend email
  • Referral code
  • Campaign name or ID

Best Practices for Marketers

  • Always review the Event Stream after testing key steps in your program.
  • If something goes wrong (such as a missing reward), the Event Stream is your first stop for verifying what happened.
  • When sharing issues with your implementation or tech team, include a screenshot or copy of relevant event details - this will speed up resolution.
  • Maintain a list of test emails or campaigns you frequently use for easier filtering and validation.

Scenario 1: Tracking Actions by a Specific Person

Use Case

When testing a referral program, it's often necessary to verify that a specific user — for example, Sarah — has completed the referral journey successfully. After entering her email as the advocate, the following points can be reviewed:

  • What actions the user took
  • Whether those actions were recorded correctly
  • Whether the referred friend signed up and triggered a reward

Outcome

The event stream confirms that Sarah generated a referral link, the link was clicked, the friend registered, and a reward was issued. This validates that the end-to-end referral flow worked as expected for that user and that the program is functioning properly for real participants.

Scenario 2: Troubleshooting When Something Isn’t Working

Use Case

During referral program testing, a scenario may arise where no reward is triggered after a friend signs up using a referral link. In this example, two test emails were used:

The goal is to determine why the reward was not issued.

Possible Issues Identified

  • The friend may not have fully completed the required action (e.g., registration or purchase)
  • The expected event (e.g., registration) may not have reached Extole due to a tracking or integration issue
  • A delay or timing issue may have prevented the event from being processed in real time

Next Steps

  • Verify whether the friend completed the intended action or abandoned the process.
  • Confirm that the relevant event (e.g., registration or purchase) is correctly implemented and sent to Extole.
  • If the action was completed but no corresponding event appears in the Event Stream, escalate to the implementation or support team for further investigation