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) inregisterUser.
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#
await NotifySphere.postEvent({
event: 'booking_completed',
data: { revenue: 2500, order_id: 'ORD123' },
});Flutter#
await FlutterNotifySphere().postEvent(
event: 'booking_completed',
data: {'revenue': 2500, 'order_id': 'ORD123'},
);| Field | Type | Required | Description |
|---|---|---|---|
event | string | Yes | The event name, for example booking_completed. |
data | object | No | Extra details. Put the amount under revenue to get revenue totals. |
nsClick | string | No | Optional 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:
| Field | Type | Required | Description |
|---|---|---|---|
Metric name | Text | Yes | The name shown on dashboards, for example Bookings. |
Show | Count, Amount | Yes | Show the number of events, the total amount, or both. |
Amount key | Text | No | The key in data that holds the amount. Default: revenue. |
Metric events | List | No | Which event names count toward this metric. When set, only those events with an amount count. |
Status | Option | No | Turn 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.