Skip to main content
アプリ内メッセージ(In-App Messaging)は、ユーザーのセグメントに送信して、カスタムメッセージを表示したり、新しいオファーを提示したり、特定のページへ誘導したりできるカスタムビューです。これらは MoEngage アカウントから作成できます。 In App NATIV1

Android 依存関係のインストール

InApp で画像と GIF を表示するための要件

InApp バージョン 7.0.0 以降、SDK がアプリ内メッセージで画像や GIF を表示するには Glide が必要です。build.gradle ファイルに以下の依存関係を追加する必要があります。
iOS では追加の依存関係のインストールは不要です。

InApp の表示

MoEngage は、メタ API 呼び出しによって対象となるアプリ内キャンペーンのリストを更新します。アクティブなセッション中は、アプリがバックグラウンドからフォアグラウンドに戻ったとき(最大で 15 分に 1 回)にリストが更新され、新しいセッションが開始されたとき、またはアプリが強制終了されて再起動されたときには即座に更新されます。
画面上に InApp キャンペーンを表示するには、以下の API を呼び出します。リッチランディングナビゲーションでない限り、ユーザーが InApp をクリックしたときのリダイレクトはアプリ側で処理する必要があります。

Nudge の表示

moengage_flutter バージョン 7.0.0 以降、MoEngage InApp SDK は非侵入型の Nudge の表示をサポートしています。この API は Android と iOS でのみサポートされています。リッチランディングナビゲーションでない限り、ユーザーが InApp をクリックしたときのリダイレクトはアプリ側で処理する必要があります。 Nudge InApp キャンペーンを表示するには、showNudge() を呼び出します。

InApp/Nudge のリダイレクトのデフォルト動作

InApp または Nudge がクリックされた場合、MoEngage SDK が処理するのは リッチランディングナビゲーション のリダイレクトのみです。 画面名およびディープリンクへのリダイレクトについては、アプリのコードでユーザーを適切な画面またはディープリンクにリダイレクトする必要があります。画面名およびディープリンクのリダイレクトを処理するには、InApp クリックのコールバックメソッドを実装する必要があります。MoEngage SDK は、InApp のペイロードをこのコールバックコードに渡すだけです。実装手順は、統合ガイドの InApp コールバックのセクションに記載されています。

セルフハンドル InApp

セルフハンドル InApp は、SDK によってアプリケーションに配信されるメッセージであり、アプリケーションは SDK から配信されたペイロードを使用して UI を構築します。セルフハンドル InApp を取得するには、以下の API を使用します。
セルフハンドルキャンペーンを取得するには、以下のようにコールバックを登録します。

複数のセルフハンドル InApp

  • この機能には、moengage_flutter バージョン 9.0.0 以上が必要です。
  • イベントトリガー型の複数のセルフハンドル InApp はサポートされていません。
getSelfHandledInApps() を使用して、複数のセルフハンドルキャンペーンを取得します。MoEngage SDK は最大 5 件のキャンペーンを(キャンペーン作成時に設定されたキャンペーン優先度の順に)返します。この関数は、セルフハンドル InApp のデータを Future で返します。
SelfHandledInAppsData 型のデータが返されます。

複数のセルフハンドル InApp の統計のトラッキング

onCampaignsAvailable() コールバックメソッドは SelfHandledCampaignsData を返します。これには SelfHandledCampaignData オブジェクトのリストが含まれます。各 SelfHandledCampaignData オブジェクトの統計は、以下の API を使用して個別にトラッキングする必要があります。

コンテキストに応じた複数のセルフハンドル InApp の取得

コンテキストに応じた複数のセルフハンドル InApp を取得するには、*getSelfHandledInApps()* を呼び出す前に、setCurrentContext() を使用して InApp のコンテキストを設定します。これにより、コンテキストありおよびコンテキストなしの InApp のリストが(キャンペーン作成時に設定されたキャンペーン優先度の順に)返されます。

セルフハンドル InApp の統計のトラッキング

アプリ内メッセージの表示、クリック、閉じる操作はアプリケーションが制御するため、これらが発生するたびにアプリケーションは MoEngage SDK に通知する必要があります。SDK に通知するには、次のメソッドを呼び出します。セルフハンドル InApp のコールバックでアプリケーションに提供されたデータオブジェクトを、以下の API のパラメーターとして渡す必要があります。

InApp コールバック

InApp の表示、InApp のクリック、InApp の閉じる操作、およびセルフハンドル InApp の利用可能イベントに対するコールバックを提供しています。以下のように登録できます。
コールバックは、show メソッドまたはトリガーイベントによって InApp が表示される前に登録する必要があります。これらのコールバックを設定した後に、プラグインの initialise() メソッドを呼び出すようにしてください。詳細については、ドキュメントを参照してください。

コンテキスト InApp

特定の画面で InApp キャンペーンを制限するだけでなく、アプリケーション内のユーザーのコンテキストに基づいて InApp を制限することもできます。アプリケーション内のユーザーのコンテキストを設定するには、以下のように setCurrentContext() API を使用します。

コンテキストの設定

showInApp() を呼び出す前に、ウィジェットの initState() メソッド内で以下のメソッドを呼び出してコンテキストを設定します。

コンテキストのリセット

ユーザーがそのコンテキストから離れたら、resetCurrentContext() API を使用して既存のコンテキストをリセット/クリアします。
コンテキスト InApp の詳細については、トラブルシューティングと FAQ にあるビデオチュートリアルを参照してください。

InApp ペイロード

InApp データは以下の形式で受信されます。

画面の向きの変更への対応

これは Android プラットフォームのみが対象です。
SDK バージョン 4.1.0 以降、InApp は縦向き(ポートレート)と横向き(ランドスケープ)の両方のモードでサポートされています。
SDK が InApp の表示を処理できるように、デバイスの向きが変更されたときに SDK に通知する必要があります。
これには 2 つの方法があります。
  1. アプリの Android ネイティブ部分に API 呼び出しを追加する
  2. MoEngage プラグインの onOrientationChanged() を呼び出す

アプリの Android ネイティブ部分に API 呼び出しを追加する

アプリの Activity クラスで onConfigurationChanged() API コールバックを受信したときに SDK に通知します。

MoEngage プラグインの画面の向き変更 API を呼び出す

画面の向きの変更を SDK に通知するには、以下の API を呼び出します。