In-App Messaging in Android Apps that use SDK Version 10

The processes for implementing and customizing in-app messaging have been updated in version 10 of the SDK. To upgrade your app to version 10 of the SDK, first update the initialization code. Then, use these code examples to update the in-app messaging code in your app.

Implement IAM on Android

Use this code example to implement in-app messaging during SDK initialization.

1SFMCSdk.configure(applicationContext as Application, SFMCSdkModuleConfig.build {
2  engagementModuleConfig = MarketingCloudConfig.builder().apply {
3    // Other configuration options
4    // Tell the SDK how to handle button clicks in an In-App Message
5    setUrlHandler(UrlHandler { context, url, _ ->
6      PendingIntent.getActivity(
7        context,
8        Random().nextInt(),
9        Intent(Intent.ACTION_VIEW, url.toUri()),
10        PendingIntent.FLAG_UPDATE_CURRENT
11      )
12    })
13  }.build(applicationContext)
14}) {
15  // TODO handle initialization status
16}

Optional Methods

Use this code example to set the in-app message listener.

1MarketingCloudSdk.requestSdk { engagementSdk ->
2
3  engagementSdk.inAppMessageManager.setInAppMessageListener(object :
4    InAppMessageManager.EventListener {
5
6    override fun shouldShowMessage(message: InAppMessage): Boolean {
7
8      return if (shouldShowMessage /* Your Custom logic confirming to show in-app message */) {
9        true
10      } else {
11        // Store message id for later
12        val blockedMessageId = message.id
13        false
14      }
15    }
16
17    override fun didShowMessage(message: InAppMessage) = Unit
18    override fun didCloseMessage(message: InAppMessage) = Unit
19  })
20}

Prevent or Delay Message Display

Use this code example to prevent or delay the display of an in-app message.

1MarketingCloudSdk.requestSdk { engagementSdk ->
2  engagementSdk.inAppMessageManager.showMessage(blockedMessageId)
3}

Customize Display

Use this code example to customize the font used in an in-app message.

1MarketingCloudSdk.requestSdk { engagementSdk ->
2  engagementSdk.inAppMessageManager.setTypeface(appFontFace)
3}

Set Status Bar Color

Use this code example to set the status bar color of an in-app message.

1MarketingCloudSdk.requestSdk { engagementSdk ->
2  engagementSdk.inAppMessageManager.setStatusBarColor(
3    ContextCompat.getColor(this as Context, R.color.colorPrimary)
4  )
5}