Targeting Users#

bzzz supports three targeting modes: all subscribers, individual users, and segments.

All subscribers#

The simplest option. Every device subscribed to your org gets the notification.

{ "target": "all" }

External IDs#

When a user subscribes to your org in the bzzz app, they can optionally be tagged with an externalId that you define. This is typically the user ID from your own system.

{ "target": { "external_id": "usr_123" } }

This sends the notification only to devices where the subscription has that external ID.

External IDs are set by the iOS app during subscription. You control what ID to pass based on your app's context.

Segments#

Segments are named groups of external IDs. Create them in the dashboard or via the API, then target them by ID.

{ "target": { "segment": "premium-users" } }

Creating segments#

Upload a CSV or paste a comma-separated list of external IDs in Dashboard > Segments > New segment.

When to use segments vs external IDs#

• Single user (e.g. "your order shipped"): use external_id
• Group of users (e.g. "new feature for premium users"): use segment
• Everyone (e.g. "scheduled maintenance"): use "all"