Skip to main content
Push notifications are sent to the Loyalife mobile app via Firebase Cloud Messaging (FCM). They appear on the member’s device lock screen or notification shade and can open specific in-app screens on tap. Provider: Firebase Cloud Messaging (FCM)

​
Requirements

For a member to receive push notifications:
  • The Loyalife mobile app must be installed on their device
  • The member must be logged in to the app
  • The member must have granted notification permissions on their device
If any of these conditions are not met, the notification cannot be delivered.

​
Configuration fields

​
Constraints

​
Delivery and success

Loyalife determines delivery outcome based on the FCM response: A failed push cannot be recovered — Loyalife does not retry. The member must reinstall the app and log in to receive future push notifications.
FCM does not confirm whether the member actually saw or tapped the notification — only that the message was accepted for delivery. Success means FCM accepted it, not that it was opened.

​
Previewing and testing

Use Send Test Notification to send a live push to a specific member’s device:
  1. Click Send Test Notification in the template editor
  2. Enter the member’s registered phone number — the system resolves the member
  3. Variables in the body appear as fillable fields in the test modal
  4. Submit — the FCM message is dispatched immediately
The test sends the notification in real time and is not recorded in the member’s delivery log.

​
Delivery analytics

Each template’s detail view shows push delivery metrics over selectable time windows (7 days, 30 days, 3 months, 6 months): A success/fail pie chart is shown alongside the counts.

​
Push notifications in campaigns

Push Notification is available as a delivery channel in the Campaign module alongside Email, SMS, and WhatsApp. Campaigns can target a member segment and deliver a push notification from any active push template. Supported campaign types: Promotional, Occasion Reward, and Reward to Members. To use push in a campaign:
  1. Create a push notification template in Engage → Communications
  2. When creating a campaign, select Push Notification as a delivery channel
  3. Link the push template to the campaign
  4. Campaign performance metrics show Total Sent, Success, and Failed counts for push delivery
Push notifications in campaigns are delivered after the campaign cron executes — not immediately on campaign activation.

​
Troubleshooting

Push notifications not reaching the member’s device.
  • Confirm the member has the Loyalife app installed, is logged in, and has granted notification permissions on their device.
  • Check the delivery log on the member’s profile (Account Info → Communications) for the failure status.
  • A Failed status means the FCM token is no longer valid. This happens when the app is uninstalled or the user logs out. The notification cannot be recovered; the member must reinstall and log in.
FCM is not configured for the program.
  • FCM setup is done during program onboarding. Contact your Loyalife team to verify FCM is configured and the correct Firebase project credentials are linked to your program.