Key concepts

The terms you'll meet across the Bubbl dashboard, and what each one means today.

The dashboard sidebar with the workspace switcher, search and the Campaigns, Locations, Notifications, Reports, Company and Configuration groups

Building blocks#

Term	What it means
Campaign	Brings locations, notifications and timing together. Nothing reaches a phone unless a running campaign sends it.
Geo campaign	Fires notifications when a phone enters or leaves its locations or location groups. It reaches all devices or chosen segments.
Push campaign	Sends notifications at set times on one day, wherever people are. It goes to all devices or to chosen segments.
Location	A named geofence: a Polygon you draw, or a Circle with a radius of 50 to 1,000 m. Reusable across campaigns.
Location group	A named set of locations. A campaign that targets a group activates at every location in it.
Notification	Reusable content you attach to campaigns: a Message (headline, body, optional media and call to action) or a Survey (up to five questions).
Template	In Reports, a saved notification, counted once however many campaigns it's attached to. Campaign notifications counts each attachment.
Activation	When an attached notification fires: On enter or On exit for a geo campaign, a send time for a push campaign.
Segment	A tag your app sets on a device through the SDK. You can target geo and push campaigns at segments and switch a segment's targeting off.

Campaign statuses#

Status	Meaning
Scheduled	Set up and waiting for its start time.
Active	Running now.
Paused	Stopped by someone on your team until they resume it.
Ended	Its end time has passed. Its results stay available.

Workspaces and setup#

Term	What it means
Sandbox	Your test workspace. Only approved test devices receive anything, so nothing reaches real users.
Production	Your live workspace. It opens on a paid plan and serves every phone running your app with its live key.
SDK API key	The key your app starts Bubbl with, under Configuration › Developers. `pk_test_` keys belong to the Sandbox and `pk_live_` keys to Production.
Test device	A phone approved to receive the Sandbox, under Configuration › Test Devices.
Firebase	Google's push service. Bubbl sends Android pushes with your Firebase service account.
Apple Push (APNs)	Apple's push service. Bubbl sends iOS pushes straight to Apple with each app's `.p8` auth key.
Delivery rules	Company-wide limits on how often people hear from you: frequency cap, quiet hours and re-trigger cooldown.

Results#

Term	What it means
Sent	Notifications Bubbl sent to devices.
Delivered	Notifications that reached the device.
Opened	Delivered notifications someone tapped.
Engagement	How many of your registered devices a campaign reached, as a percentage: devices reached ÷ total registered devices × 100.

Team roles#

Role	Can do
Owner	Everything, including billing changes, cancelling, transferring ownership and deleting the company.
Admin	Everything except the owner-only actions.
Developer	Configuration and test devices. Builds in the Sandbox; can only view content in Production.
Marketer	Campaigns, locations, notifications, segments and reports. No company, team, billing or configuration pages.

Search from anywherePress ⌘K (Ctrl K on Windows) or / to search campaigns, locations, location groups, notifications, devices and dashboard pages in the current workspace.

Was this page helpful?