📝 NOTE: It is assumed you know how to create custom Dashboards and Charts, and have an understanding of chart Types, Presets, and Metrics. If not, read this article before proceeding.
When building your own Dashboard Charts, you can pull data from various data sources to view different types of analytics events.
- In this article, we're going to focus on the Community Events data source, which tracks all Event activity across your Higher Logic Vanilla (Vanilla) community.
Overview
The Community Event data source tracks when:
- an event is added
- an event is updated
- an event is deleted
- users RSVP to an event
For each Event activity logged, you can see:
- the Type of action that occurred
- the Event Name or ID
- the Event Location
- the Event Start Date
- the Event End Date
- the Parent Record Type
- the Parent Record ID
- the Subcommunity Name or ID
- information about the User who initiated the action
When users RSVP to an event, you will also be able to see:
- the response received aka Responding User Event Attending
- information about the Responding User
Filter Chart data
Controlling what data is shown in a Chart is accomplished via the Group By and Filter options.
- The Group By options (available for pie graphs, line graphs, bar graphs, and tables) enable you to view data by event name/ID, event location, subcommunity, user name/ID, and more.
- You can add Filters to your query to drill into or exclude specific types of events (e.g., exclude guests from traffic data or focus your Chart on traffic seen in a specific category).
✔️ TIP: You can add one or multiple Group By and Filter options to dissect the data how you see fit. Generally speaking, you'll select Group By options to view a specific slice of data, and, if needed, use Filters to dig deeper.
Let's learn about each of the available Group By and Filter options.
Type
Each Event action logged has a type. The type parameter defines what happened.
- add: An event was added
- edit: An event was edited
- delete: An event was deleted
- responseReceived: A user RSVP'ed to an event
Event info
Each Event action logged is associated with a specific Event. You can group and/or filter Event data based on the following event parameters:
- Event Name: The name of the event
- Event ID: The event ID
- Event Location: Where the event is being hosted
- Event Start Date: When the event is scheduled to start
- Event End Date: When the event is scheduled to end
- Parent Record Type: If the event was posted in a group OR category
- Parent Record ID: The ID of the group or category the event was posted in
- Subcommunity Name: The name of the subcommunity the event was posted in
- Subcommunity ID: The ID of the subcommunity the event was posted in
Responding User Event Attending
The Responding User Event Attending parameter will only appear on responseReceived activity, and defines the RSVP response received. This will either be Yes, No, or Maybe. If "Other" is listed, your Chart includes other types of event activity such as add, edit, or delete.
Responding User Name/ID
The Responding User Name and Responding User ID will only appear on responseReceived activity, and defines the user RSVP'ing to the event. Typically, this will be the same as the User Name and User ID info, but can differ if an RSVP is being logged via the API.
User Info
Each Event activity is triggered by a user. This parameter will define the user who added, edited, or deleted an event, OR the user who has RSVP'ed to the event. You can group and filter Event data using the following user parameters:
- User Name
- User ID
- User UUID
- User Role Type
- User Rank ID
- User Rank Name
