
Android 依存関係のインストール
InApp で画像と GIF を表示するための要件
InApp バージョン 7.0.0 以降、SDK がアプリ内メッセージで画像や GIF を表示するには Glide が必要です。build.gradle ファイルに以下の依存関係を追加する必要があります。iOS では追加の依存関係のインストールは不要です。
InApp の表示
MoEngage は、メタ API 呼び出しによって対象となるアプリ内キャンペーンのリストを更新します。アクティブなセッション中は、アプリがバックグラウンドからフォアグラウンドに戻ったとき(最大で 15 分に 1 回)にリストが更新され、新しいセッションが開始されたとき、またはアプリが強制終了されて再起動されたときには即座に更新されます。
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 はサポートされていません。
複数のセルフハンドル InApp の統計のトラッキング
onCampaignsAvailable() コールバックメソッドは SelfHandledCampaignsData を返します。これには SelfHandledCampaignData オブジェクトのリストが含まれます。各 SelfHandledCampaignData オブジェクトの統計は、以下の API を使用して個別にトラッキングする必要があります。コンテキストに応じた複数のセルフハンドル InApp の取得
コンテキストに応じた複数のセルフハンドル InApp を取得するには、*getSelfHandledInApps()* を呼び出す前に、setCurrentContext() を使用して InApp のコンテキストを設定します。これにより、コンテキストありおよびコンテキストなしの InApp のリストが(キャンペーン作成時に設定されたキャンペーン優先度の順に)返されます。セルフハンドル InApp の統計のトラッキング
アプリ内メッセージの表示、クリック、閉じる操作はアプリケーションが制御するため、これらが発生するたびにアプリケーションは MoEngage SDK に通知する必要があります。SDK に通知するには、次のメソッドを呼び出します。セルフハンドル InApp のコールバックでアプリケーションに提供されたデータオブジェクトを、以下の API のパラメーターとして渡す必要があります。InApp コールバック
InApp の表示、InApp のクリック、InApp の閉じる操作、およびセルフハンドル InApp の利用可能イベントに対するコールバックを提供しています。以下のように登録できます。コンテキスト InApp
特定の画面で InApp キャンペーンを制限するだけでなく、アプリケーション内のユーザーのコンテキストに基づいて InApp を制限することもできます。アプリケーション内のユーザーのコンテキストを設定するには、以下のように setCurrentContext() API を使用します。コンテキストの設定
showInApp() を呼び出す前に、ウィジェットの initState() メソッド内で以下のメソッドを呼び出してコンテキストを設定します。コンテキストのリセット
ユーザーがそのコンテキストから離れたら、resetCurrentContext() API を使用して既存のコンテキストをリセット/クリアします。InApp ペイロード
InApp データは以下の形式で受信されます。画面の向きの変更への対応
これは Android プラットフォームのみが対象です。
4.1.0 以降、InApp は縦向き(ポートレート)と横向き(ランドスケープ)の両方のモードでサポートされています。SDK が InApp の表示を処理できるように、デバイスの向きが変更されたときに SDK に通知する必要があります。 これには 2 つの方法があります。
- アプリの Android ネイティブ部分に API 呼び出しを追加する
- MoEngage プラグインの
onOrientationChanged()を呼び出す