Sending Events
Track contact actions and behavior by sending events to Positive User. Events require an identified contact - call ping() first if you haven't done so yet. See Contact Data.
Event types
| Type | When to use |
|---|---|
| Custom events | Anything specific to your app - button taps, feature usage, form submissions |
| Product events | E-commerce actions - add to cart, purchase, view, refund, and more |
| Screen events | Screen visits and navigation |
Event attribute types
All event methods accept a params dictionary. Supported value types:
| Type | Example |
|---|---|
String | "checkout" |
Int | 3 |
Double | 49.99 |
Bool | true |
| ISO 8601 date string | "2024-09-28T12:51:33.137Z" |
The SDK automatically attaches the contact identifier and a timestamp to every event.