Managing Data Events

Events are real-time records of actions users take - such as clicking a button, completing a purchase, or reaching the end of a page. By tracking these activities, you can trigger automated campaigns and build dynamic segments based on exactly how people engage (or fail to engage).  

How do events works?

While a Custom Field represents persistent information you know about a person (like their Last Purchase or First Visit Location), an Event represents point-in-time data about an action a person took.

In our APIs and SDKs, you use the sendEvent JavaScript API to record these actions or the track events REST API.

Events can trigger automations, set goals, or define segment criteria - ensuring you respond instantly to exactly what people are doing on your website or in your app.

Anatomy of an Event

Every event you send consists of two core components:

• DailyStory Unique Id: This is the unique identifier of the associated DailyStory contact.
• Event Name: This is the unique identifier (e.g., whitepaper_download) used to target specific behaviors in your automation workflows.
• Event Data: This is the metadata associated with the action. You can reference this information to personalize messages, or use it to filter segment criteria.

What types of tracked events are available?

DailyStory supports reserved events, such as conversions and page visits, but also allows customers to create custom tracked events that start automations.

1. Custom event tracking: Instantly launch a "Welcome" or "Re-engagement" automation when a specific event is received.
2. Conversion tracking: Measure the success of your marketing by marking a goal as "Achieved" once a user performs a specific action that is related back to a conversion funnel. Conversion tracking is a built-in event that is integrated with the conversion funnel.
3. Page visit tracking: Track pages that contacts visit and run automations. For example, when a contact visits the licensing and pricing page. Page visit tracking is a built-in event that is integrated throughout DailyStory.

Event name and data

While event data is highly flexible and can take any structure, we recommend maintaining a consistent data schema for events sharing the same name. Consistency ensures that your automation logic remains reliable and your reporting stays clean.

Below are some recommended patterns.

Recommended naming patterns for events

• [category]:[item] - For example, new_user:sign_up_button. This let's us know that the sign_up_button was clicked on the new user page.
• Descriptive name - For example, new_user_sign_up_button. Similar to the event name above.

You can leverage this data to display personalized information in your messages, or use it in segments to filter users who performed the same action but with different values (such as filtering by a specific product category or price point).

Accessing Event Data

Depending on your integration - whether via JavaScript or the REST API - the method for sending data may vary slightly. However, you can always access nested event data within your campaigns and segments using standard JSON dot notation.

Best Practices

• Consistency is Key: If the purchase event includes order_id as a string once, keep it as a string for all future logs to prevent segment errors.
• Flatten When Possible: While we support nested JSON, keeping your most important data points at the "top level" of your event_value makes it even faster to query in the dashboard.
• Type Awareness: Remember that our segment builder treats 100 (number) and "100" (string) differently. Ensure your SDK sends the correct data type for accurate filtering.