Skip to main content

Nudges

Nudges are proactive suggestions generated based on user state. They help re-engage users and surface timely insights.

How Nudges Work

  1. Adapter defines templates — What nudges are possible in your domain
  2. Engine checks triggers — Based on state (inactivity, momentum drop, patterns)
  3. Nudges are generated — Stored with status pending
  4. Your app delivers them — Email, push notification, in-app banner
  5. User acts or dismisses — Status updated to acted or dismissed

Defining Nudge Templates

In your adapter:

Using the Nudge Engine

Retrieving Pending Nudges

Nudge Lifecycle

Status Flow

Updating Status

Via HTTP API:

Trigger Types

The baseline engine checks for:

Customizing Triggers

Override the engine for custom trigger logic:

Best Practices

Limit nudge frequency. Users will mute or ignore if you nudge too often.
High-priority nudges should be rare and important. Most should be 3-6.
Each nudge should have a clear action the user can take.
If a user dismisses a nudge type repeatedly, consider reducing frequency.
Monitor acted vs dismissed rates to improve nudge templates.