Guides

Custom events

Send events specific to your product.

3 min readSDK 0.5.0

Automatic capture covers screens and taps. For actions that matter to your product, like a search or a saved item, send your own events.

Sending an event

tsx

import { Riveora } from '@riveora/react-native';

Riveora.track('item_saved', { category: 'shoes', price_tier: 'premium', from_search: true });

The event appears in Live events within seconds and in each user’s journey, tagged with the screen that was open when it happened.

Rule	Limit	If you go over it
Event name	Up to 80 characters	Shortened to 80 characters
Property key	Up to 80 characters	The property is dropped
Property value	Text (up to 500 characters), number, true/false or null	Longer text is shortened. Dates are sent as text. Lists, objects and functions are dropped.

An event keeps at most 50 properties.

Automatically removed

The SDK drops these before an event leaves the device, and the Riveora server drops them again before storing it:

Keys that name a secret or contact detail, anywhere in the key: password, token, secret, auth, email, phone, card, cvv, ssn, dob, birth, address, iban.
Keys with one of these words (whole words, in snake_case or camelCase): phone words like tel, mobile_number or user_mobile; secrets like pin, otp, pwd, passcode, cookie, credentials, api_key, verification_code or seed_phrase; and a person’s name like first_name, full_name, username or surname. Keys such as shipping, country_code, promo_code, name or plan_name are kept.
Values that contain an email address or a token (a JWT, “Bearer …”, an API key such as sk_live_…, sk-… or AKIA…), or that are a formatted phone number, a card number or an IBAN.

Still, never put personal data in properties: these rules catch common mistakes, not everything.

Something unclear or missing? Email us and we’ll improve this page.