Setup In-App Messaging

In addition to Push Notifications, Marigold supports In App messaging. These messages are a created separately to notifications, but can have an attached push notification. In App Messages can be displayed in three ways:

In-App Notifications

Marigold's In-app messages are banner notifications that appear inside of your app. In-app notifications allow users to see messages as they browse your app, no matter what they are doing. They also allow you to reach users who have opted to not receive push notifications.

256

In App Notification

In App Notification Display

There are two times Marigold will try to display an In App Notification

  • After launch: If there is an unseen message, this will be presented to the user. Only the latest sent message will be shown.
  • If the user has your app open, and a message arrives with a push attached to it, this will present an In App Notification.

In App Notification and Push flow

In-app messages work with or without push notifications, and vice versa. You can enable multiple scenarios ranging from the most impactful and immediate (push) to the less obtrusive (in-app message with no notification).

Push notification only

  • People receive a push notification, based on having a valid token or having opted into push
  • Tapping on the push notification will open the app, or lead to a deep link (if it has been added as a key key-value payload)

In-app message with push (including silent push)

If the app is closed, and the user has opted in for push notifications:

  • The user will receive the push notification
  • If the user taps on push, the notification will take the user to the full screen message detail or a deep link or lead to a deep link (if it has been added as a key key-value payload)
    If the user doesn't tap on the push when it's received, they will see it as an in-app notification the next time they open the app (or whatever the latest unread message is)

If the app is open (in other words, if it is the active app in foreground):

  • If the user has opted into push notifications, the user will receive the in-app notification. Tapping on the notification leads to the full screen detail page (for Link messages with deep links, it will lead to the deep link).
  • If app is closed, or if the user has not opted into push notifications, the next time the user opens the app, they will receive an in-app notification with the last unread message. Tapping on the notification leads to the full screen detail page (for Link messages with deep links, it will lead to the deep link).
  • In both of the above scenarios, or if the user doesn't tap on the in-app notification, the message will just be in the stream for them to self-navigate to.

In-app only message (with no push attached)

If the user is in the app at time of message send, the message will simply appear in the Message Stream. When the user navigates to the stream, the stream calls to Marigold for latest messages.
If the user doesn't self-navigate to the stream, the next time they open the app, they will see the last unread message as an in-app notification.

Customizing In App Notifications

In-app notifications work out of the box and don't require any extra development. If you would like to create your own notification that suits the look and feel of your app, please read Customizing In App Notifications.

Delay In App Notification Presentation

In App Notifications appear at first launch, but it is possible to delay them to when it suits your apps, perhaps after login or after user onboarding.

Tapping an In App Notification will, by default, take load the Full Screen Message for that that message.

Full Screen Messages

This screen provides a full-screen, detailed view of the message. Full Screen Messages appear when a user taps on a Push Notification (if attached) or an In App Notification.

256

Full Screen Messages

Customizing Full Screen Messages

Full Screen Messages work out of the box and don't require any extra development. If you would like to create your own screen that suits the look and feel of your app, please read Customizing Full Screen Messages

Message Stream

In-App Notifications and Full Screen Messages are a great way to engage users as they are using the app, however once they have been shown to the user, there is no way to see them again.

A Message stream is the answer to this. It allows you to publish a list of messages in your app which is ideal for use cases where you want the user to be able to come back to the content in their own time.

256

Message Stream

There are two ways to put a message stream inside your app. You can use/adapt our examples or build your own.

For more details, refer to our Message Stream Overview or learn how to build a Message Stream.