Updating User Data — Overview

Pulsate is privacy-first by default: until you explicitly send personal data, users are tracked anonymously. Everything Pulsate knows about a user beyond device behavior is data your app chooses to send.

What you can send

PageWhatWhy
Personal DataName, email, phone, gender, agePersonalized campaigns ("Hi John…"), contact channels
Custom AttributesAny typed key/value (string, int, float, boolean, date) + countersSegmentation filters in the CMS
Custom EventsNamed user actionsEvent-triggered campaigns, journey analytics
PrivacySubscribe / unsubscribeGlobal campaign opt-out per user

When data is sent

Most user-data calls are cached locally and synced to Pulsate when the app enters the background (calls are merged and deduplicated). Two exceptions:

  • setPrivacy syncs in real time.
  • forceAttributeSync() triggers an almost-immediate sync of everything pending (debounced, so multiple calls merge into one request).

Always send user data after a session is active — the onSuccess callback of startPulsateSessionForAlias is the natural place.