Analytics event reference
This page lists the exact event names and details Apollos sends to your analytics tools, so you can find the right event when you build a chart or funnel in Amplitude.
How it works
Every time a member does something meaningful in your app, TV apps, or website embeds, Apollos records an event. Each event has a name and a set of properties: extra details, like which fund a gift went to or how long a member's daily habit streak is.
Event names always follow the same pattern: the thing, then what happened to it, with each word capitalized. For example, Donation Completed, Community Joined, Poll Viewed. Property names are lowercase with underscores, like is_recurring or group_id.
To learn what these events mean for your church, see Understanding engagement metrics. This page is the lookup table.
Details on every event
Most events carry the same three details about who did it, in addition to their own properties:
| Property | What it tells you |
|---|---|
user_id | The Apollos ID of the member who did it |
group_id | Your church's Apollos identifier |
is_logged_in | Whether the member was signed in at the time (true / false) |
Use is_logged_in to separate signed-in members from guests. Guests can still browse, watch, and give from web embeds.
Key engagement events
These are the moments Apollos treats as the strongest signs of a healthy app community. They make good end steps for funnels.
| Event | When it's recorded | Useful properties |
|---|---|---|
| Signup Completed | A member finishes creating their account | signup_type: match if they matched a person already in your ChMS, new if they didn't |
| Daily Habits Completed | A member finishes their daily habits for the day | streak: their current streak in days; is_shared: whether they shared their completion |
| Community Joined | A member joins a community | name: the community's name |
| Content Viewed | A member opens a content item | content_id, title: which item they opened |
| Comment Saved | A member posts a comment | text: what they wrote |
| Donation Completed | A gift goes through in your website giving embed | amount; fund; schedule: one-time or the recurring interval; is_recurring: true / false |
Everyday activity events
These events cover the everyday activity around the key moments. They're useful as the first steps of a funnel. For example, a member taps "Give" (Button Used) before they complete a gift (Donation Completed).
| Event | When it's recorded | Useful properties |
|---|---|---|
| Button Used | A member taps a button or link | label: the button's text; action: what it did; component: where on the screen it was; component_url: its link, if any |
| Form Submitted | A member submits a form or search | name: the form's title; type: what kind of form it is; url: where the form lives |
| Deep Link Opened | A link opens your app to a specific screen | url: where the link took them |
| Push Notification Received | A push notification arrives while a member has the app open | title, body: what the notification said |
| Push Notification Tapped | A member taps a push notification | title, body: what the notification said |
| Screen and page views | A member opens a screen in the app or a page on the web | title: the screen or page name |
Poll events
If your church uses polls, these events show how members engage with them on mobile and the web. Poll events name their properties in a slightly different style, with capital letters inside the name instead of underscores (for example, pollTitle).
| Event | When it's recorded | Useful properties |
|---|---|---|
| Poll Viewed | A poll appears on a member's screen | pollId, pollTitle; pollStatus: Active, Closed, or Inactive; optionCount: number of choices; hasExistingVote: whether they've already voted |
| Poll Option Selected | A member selects or clears a choice before voting | pollId; optionValue: the choice's text; action: selected or deselected |
| Poll Vote Submitted | A member's vote is saved | pollId, pollTitle; optionValues: the choices they picked; mode: SingleChoice or MultiChoice; isChangeVote: whether they changed an earlier vote |
| Poll Vote Failed | A vote couldn't be saved | pollId; error: what went wrong |
Poll Viewed followed by Poll Vote Submitted is a simple funnel for measuring poll participation.
Find an event in Amplitude
- In Amplitude, open Data > Event Stream to watch events arrive live. This is a quick way to confirm an event name before you build a chart.
- Start a new chart (for example, New > Event Segmentation).
- In the events panel, search for the event name exactly as it appears on this page, such as Daily Habits Completed.
- Click where to filter by a property (for example,
is_recurringis true), or use Group by to split the chart by one (for example,fund).
For more chart ideas, see Amplitude for deeper analysis.
Troubleshooting
Why don't I see an event listed here in Amplitude?
An event only shows up in Amplitude after a member has done that action at least once. For example, you won't see Donation Completed until someone gives through your website giving embed, or poll events until you publish a poll. Check Data > Status in Admin to make sure your Amplitude connection is active.
Why is a property blank on some events?
Some details only apply in certain cases. component_url only appears on buttons that open a link, and user_id is blank for guests who aren't signed in. Filter by is_logged_in to look at signed-in members only.
Can Apollos track a new event for us?
Apollos decides which events to track across all churches, and new ones are added over time. If you have a question you can't answer with the events on this page, tell your Apollos contact what you're trying to measure.