Events

Record what users do in your app, so you can measure campaigns, build funnels and trigger automations.

An event is something a user did: installed the app, signed up, started a booking, paid. notifySphere records some events for you and lets you send your own. The same events power attribution, funnels and automations.

Events recorded automatically#

  • install: the first time a device registers through the SDK.
  • signup: the first time a user registers with your own user ID (applicationUserId) in registerUser.

Send your own events#

Call postEvent after registerUser has completed. Use short, consistent names in snake_case; names are matched without regard to case.

React Native#

javascript
await NotifySphere.postEvent({
  event: 'booking_completed',
  data: { revenue: 2500, order_id: 'ORD123' },
});

Flutter#

dart
await FlutterNotifySphere().postEvent(
  event: 'booking_completed',
  data: {'revenue': 2500, 'order_id': 'ORD123'},
);
FieldTypeRequiredDescription
eventstringYesThe event name, for example booking_completed.
dataobjectNoExtra details. Put the amount under revenue to get revenue totals.
nsClickstringNoOptional campaign click from a deep link, to credit the event to that campaign.

Event metrics: count and revenue on dashboards#

In Setting → Event Metrics, add a metric for each event you want as a tile and column on the campaign and event reports. For each metric:

FieldTypeRequiredDescription
Metric nameTextYesThe name shown on dashboards, for example Bookings.
ShowCount, AmountYesShow the number of events, the total amount, or both.
Amount keyTextNoThe key in data that holds the amount. Default: revenue.
Metric eventsListNoWhich event names count toward this metric. When set, only those events with an amount count.
StatusOptionNoTurn a metric off without deleting it.

See events#

Engage → Event lists your events with their count and revenue. Filter by campaign or organic source, by event metric, and by user.

Stuck or something unclear? Contact us and we'll help.