Customizing In-App Notifications

To make in-app notifications more engaging, you might want to implement your own user experience so that your in-app messaging can blend into the look and feel of your UI. To do so, override the following callback methods, and return false, which ensures that Mobile’s interface isn’t displayed. At this point you can trigger your own in-app notification interface using the Message object.

iOS (Objective-C)

//On iOS, using Objective-C

- (BOOL)shouldPresentInAppNotificationForMessage:(STMMessage *)message {  
  // Do something with the message
  
  // Register an impression *if* you are displaying the notification yourself.
  [[STMMessageStream new] registerImpressionWithType:STMImpressionTypeInAppNotificationView forMessage:message];
  return NO;  
}

//Be sure to assign your delegate to STMMessageStream
[[STMMessageStream new] setDelegate:self]

iOS (Swift)

//On iOS, using Swift

func shouldPresentInAppNotificationForMessage(message: STMMessage) -> Bool {
  return false
}

//Be sure to assign your delegate to STMMessageStream
STMMessageStream().setDelegate(self)

Android (Java)

//On Android, using Java

new MessageStream().setOnInAppNotificationDisplayListener(new 
  MessageStream.OnInAppNotificationDisplayListener() {
    @Override
    public boolean shouldPresentInAppNotification(Message message) {
      return false;
    }
});

Android (Kotlin)

//On Android, using Kotlin

MessageStream().setOnInAppNotificationDisplayListener(object : MessageStream.OnInAppNotificationDisplayListener {
  override fun shouldPresentInAppNotification(message: Message?): Boolean {
    return false
  }
})

Not available in Unity and React Native Due to limitations of current plugin architecture in Unity and React Native, it is not currently possible to override the stock experience for in-app notifications. Rest assured, you can still deliver these notifications, but you won’t be able to customize their UX. We hope to bring customization to these platforms in the near future.

Registering an Impression Event

In order to support impression analytics in your custom in-app notification, you will need to ensure you register an impression event when it is shown.

iOS (Objective-C)

//On iOS, using Objective-C
 
[[STMMessageStream new] registerImpressionWithType:STMImpressionTypeInAppNotificationView forMessage:message];

iOS (Swift)

//On iOS, using Swift
   STMMessageStream().registerImpressionWithType(STMImpressionType.InAppNotificationView, forMessage: message)

Android (Java)

//On Android, using Java

new MessageStream().registerMessageImpression(ImpressionType.IMPRESSION_TYPE_IN_APP_VIEW, message);

Android (Kotlin)

//On Android, using Kotlin

MessageStream().registerMessageImpression(ImpressionType.IMPRESSION_TYPE_IN_APP_VIEW, message)