How to Set Up Your Branded App and Enable Push Notifications for Your Ambassadors on a Mobile Device

Push notifications are a powerful way to keep your ambassadors engaged with important updates and announcements. As an admin, you can customize a Progressive Web App (PWA) which is similar to an app, to reflect your brand identity and enable notifications seamlessly. This guide will walk you through configuring your app icon, app name, and enabling push notifications.

Steps to Configure Your App Branding and Notifications

1. Access the Branding Section in Settings Page: Log in to your admin dashboard and navigate to the Branding Settings page
2. Set Your App Name
   • Enter the name you want to display for your app.
   • This name will appear beneath the app icon on the ambassadors’ home screens.
   • Keep it concise and reflective of your brand

3. Customize Your App Icon
   • Upload your brand’s app icon, which will be displayed on ambassadors' home screens when they install the app.
   • Recommended specifications:
     • Format: PNG or JPG.
     • Dimensions: 512 x 512 pixels for optimal clarity.
   • Make sure the icon aligns with your branding for instant recognition.
4. Enable Push Notifications
   • Locate the 'Enable App Notifications Prompts for Users' checkbox at the bottom of the Branding Settings page.
   • Check this box to activate the ability to send push notifications to your ambassadors.
   • Notifications are enabled only for ambassadors who have bookmarked or installed the app on their devices.
5. Save and Apply Changes
   • Click Update to apply your branding and notification preferences.

NOTE: Once ambassadors install the app, the app name and icon cannot be changed unless they uninstall and reinstall the app to apply the updates.

Ambassador Experience

• Customized App on Home Screen:

  Ambassadors who install your app will see the updated app icon and name on their device home screens, giving a cohesive brand experience.

• Seamless Engagement:

  Push notifications will appear as native device alerts, allowing you to send updates, activity details, or rewards approved directly to ambassadors. Notifications will draw ambassadors back to the app, boosting activity and engagement.

• Access Anywhere:

  The app provides ambassadors with the flexibility to access your app on any modern browser without needing to download a native app from the app store.

Notifications Breakdown

Activity Notifications

• Pending Activity Completion:

  Ambassadors receive a notification when an activity is approved but still incomplete. This indicates that one or more tasks within the activity remain unfinished, prompting them to continue their progress.

• Task Rejected:

  A notification is sent when a specific task within an activity is rejected, informing the ambassador to review or revise their submission.

Rewards Notifications

Once the last task in an activity (single-task or multi-task) is approved, the ambassador receives a notification about the approval and rewards earned if any:

• Points Earned:

  Ambassadors are notified of the reward points they’ve earned, with a direct link to the rewards page to view or redeem their points.

• Cash Reward Received:

  Ambassadors are notified of a cash reward earned and redirected to the completed activity details for more context.

• No Reward Associated:

  For activities with no reward, ambassadors are notified about the approval and redirected to the approved activity.

• Reward Token Earned:

  A notification is sent for token-based rewards, with a link to the rewards catalog where they can browse redeemable items.

• Manually Issued Reward:

  Ambassadors receive a notification for single manually issued rewards and are redirected to the relevant rewards page.

• Multiple Manually Issued Rewards:

  A consolidated notification is sent when multiple rewards are manually issued, with a link to the page summarizing all rewards.

Community Interaction Notifications

• New Comment on Post:

  Ambassadors receive a notification when someone comments on their post, encouraging continued engagement.

• Reply to a Comment:

  A notification is sent when someone replies to their comment, driving further interaction within the community.

FAQs and Troubleshooting

1. Why don’t I see the “Allow Notifications” prompt on installation?
   • Ensure that notification permissions are enabled in your browser/device settings.
2. Ambassadors report not receiving notifications—what should I do?
   • Confirm that the app is installed/bookmarked on their devices.
   • Ask ambassadors to enable notifications in their device or browser settings.
3. Can ambassadors receive notifications on all devices?
   • Yes, but push notifications work best on the most recent versions of Chrome and Safari. On iOS, Safari must be updated to version 16.4 or later. For other browsers, ensure they have installed your app using https://brand_name.brandchamp.io/install where brand_name is the name of your brand.