ヘッドアップ通知

概要

通知チャネルの設定ヘッドアップ通知は、Android の通知チャネルを通じてのみサポートされます。通知チャネルの作成については、公式ドキュメントを参照してください。この設定が必要な通知チャネルは API レベル 26 まで利用できなかったため、API レベル 26 未満の Android デバイスでは設定が適用されません。ヘッドアップ通知の場合、通知チャネルの重要度は IMPORTANCE_HIGH である必要があり、同じチャネル ID を MoEngage ダッシュボードで設定する必要があります。

設定

MoEngage Android バージョン 13.06.00 では、NotificationConfig に新しいフラグ isDirectPostingForHeadsUpEnabled が追加されました。ヘッドアップ通知を使用している場合は、SDK の初期化時に isDirectPostingForHeadsUpEnabled フラグを true として渡すことを強くお勧めします。デフォルトでは false です。

使用可能なすべてのオプションの API リファレンスの詳細については、NotificationConfig を参照してください。

configureNotificationMetaData() を使用して、設定を SDK に渡します。

val moEngage = MoEngage.Builder(
        application = this,
        appId = "YOUR_WORKSPACE_ID",
        dataCenter = DataCenter.DATA_CENTER_X
    )
    .configureNotificationMetaData(
        NotificationConfig(
            smallIcon = R.drawable.small_icon,
            largeIcon = R.drawable.large_icon,
            isDirectPostingForHeadsUpEnabled = true
        )
    )
    .build()
MoEngage.initialiseDefaultInstance(moEngage)

MoEngage moEngage = new MoEngage.Builder(this, "YOUR_WORKSPACE_ID", DataCenter.DATA_CENTER_X)
    .configureNotificationMetaData(new NotificationConfig(R.drawable.small_icon, R.drawable.large_icon, R.color.notiColor, false, true))
    .build();
MoEngage.initialiseDefaultInstance(moEngage);

ヘッドアップ通知の動作

isDirectPostingForHeadsUpEnabled が true の場合、高優先度のチャネルであれば、SDK は直接投稿メカニズムを使用してリッチコンテンツを直接投稿します。そのため、操作されない場合、フローティングのヘッドアップ通知ビューは 5〜8 秒間表示されます。API レベル 26 より前の Android バージョンでは、このフラグはデフォルトで無視され、デフォルトで再投稿メカニズムが使用されます。

一方、isDirectPostingForHeadsUpEnabled が false の場合は、既存の再投稿メカニズムが使用されます。このメカニズムでは、まずテキストが投稿され、メディアアセットのダウンロードが完了するとリッチコンテンツが投稿されます。これは、通知の受信時に少なくとも一部のコンテンツをすぐにユーザーに表示し、良好なインプレッション率を維持するためです。この場合、再投稿によりヘッドアップウィンドウは数秒以内に閉じられます。

​概要

​設定

​ヘッドアップ通知の動作

​ヘッドアップ以外の通知の動作

概要

設定

ヘッドアップ通知の動作

ヘッドアップ以外の通知の動作