
Android 依存関係のインストール
InApp で画像と GIF を表示するための要件
InApp バージョン 7.0.0 以降、SDK はアプリ内メッセージで画像や GIF を表示するために Glide を必要とします。android/app/build.gradle ファイルに以下の依存関係を追加する必要があります。
アプリ内メッセージの表示
MoEngage は、meta API 呼び出しを通じて、対象となるアプリ内キャンペーンのリストを更新します。アクティブなセッション中は、アプリがバックグラウンドからフォアグラウンドに戻ったとき(最大 15 分に 1 回)にリストが更新されます。また、新しいセッションが開始されたとき、またはアプリが強制終了されて再起動されたときには、即座に更新されます。
showInApp() を呼び出します。
ナッジの表示
react-native-moengage バージョン 9**.0.0** 以降、MoEngage InApp SDK は非侵入型のナッジの表示をサポートしています。 ナッジ InApp キャンペーンを表示するには、showNudge() を呼び出します。
InApp/ナッジのリダイレクトのデフォルト動作
InApp またはナッジがクリックされると、MoEngage SDK はリッチランディングナビゲーションのみのリダイレクトを処理します。 画面名およびディープリンクのリダイレクトについては、アプリのコードでユーザーを適切な画面またはディープリンクにリダイレクトする必要があります。画面名とディープリンクのリダイレクトを処理するには、InApp クリックのコールバックメソッドを実装する必要があります。MoEngage SDK は、InApp のペイロードをこのコールバックコードに渡すだけです。実装手順は、統合の InApp コールバックのセクションに記載されています。セルフハンドル InApp
セルフハンドル InApp は、SDK が配信するものの、表示はアプリ側で処理する必要があるメッセージです。単一のセルフハンドル InApp
セルフハンドル InApp を取得するには、以下のメソッドを呼び出します。複数のセルフハンドル InApp
- この機能は、プラグインのバージョン 11.1.0 以降でサポートされています。
複数のセルフハンドル InApp の統計のトラッキング
getSelfHandledInApps() メソッドは MoESelfHandledCampaignsData を返します。これには MoESelfHandledCampaignData オブジェクトのリストが含まれています。各 MoESelfHandledCampaignData オブジェクトの統計は、以下の API を使用して個別にトラッキングする必要があります。コンテキストに応じた複数のセルフハンドル InApp の取得
コンテキストに応じた複数のセルフハンドル InApp を取得するには、*getSelfHandledInApps()* を呼び出す前に setCurrentContext() を使用して InApp のコンテキストを設定します。これにより、コンテキストありおよびコンテキストなしの InApp のリストが(キャンペーン作成時に設定されたキャンペーンの優先度順に)返されます。統計のトラッキング
セルフハンドル InApp の表示、クリック、閉じる操作はアプリケーションによって制御されるため、InApp が 表示、クリック、または 閉じられた ときには、SDK に通知する必要があります。以下は、SDK に通知するために呼び出す必要があるメソッドです。セルフハンドル InApp のコールバックでアプリケーションに提供される MoESelfHandledCampaignData オブジェクトのインスタンスであるキャンペーンオブジェクトを、以下の API のパラメーターとして渡す必要があります。InApp コールバック
InApp キャンペーンが表示、閉じる、またはクリックされるたびにコールバックが提供されます。以下のように登録できます。コンテキスト InApp
特定の画面/アクティビティで InApp キャンペーンを制限するだけでなく、アプリケーション内のユーザーのコンテキストに基づいて InApp を制限することもできます。アプリケーション内でユーザーのコンテキストを設定するには、以下のように setCurrentContext() API を使用します。コンテキストの設定
showInApp() を呼び出す前に、以下のメソッドを呼び出してコンテキストを設定します。コンテキストのリセット
ユーザーがそのコンテキストから離れる際は、resetCurrentContext() API を使用して既存のコンテキストをリセット/クリアします。ペイロード構造
画面の向きの変更への対応
これは Android プラットフォームのみが対象です
7.3.0 以降、アプリ内メッセージは縦向きモードと横向きモードの両方でサポートされています。SDK がアプリ内メッセージの表示を処理できるよう、デバイスの向きが変わったときに SDK に通知する必要があります。
アプリの Android ネイティブ部分に API 呼び出しを追加する
アプリの Activity クラスでonConfigurationChanged() API コールバックを受け取ったときに、SDK に通知します。