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

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

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

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

アプリ内メッセージの表示

MoEngage は、meta API 呼び出しを通じて、対象となるアプリ内キャンペーンのリストを更新します。アクティブなセッション中は、アプリがバックグラウンドからフォアグラウンドに戻ったとき(最大 15 分に 1 回)にリストが更新されます。また、新しいセッションが開始されたとき、またはアプリが強制終了されて再起動されたときには、即座に更新されます。
アプリ内で InApp を表示する必要がある箇所で、以下のように 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 のペイロードはコールバックを介して返されます。以下のようにコールバックを登録します。

複数のセルフハンドル InApp

  • この機能は、プラグインのバージョン 11.1.0 以降でサポートされています。
getSelfHandledInApps() を使用して、複数のセルフハンドルキャンペーンを取得します。

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

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

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

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

統計のトラッキング

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

InApp コールバック

コールバックは、show メソッドまたはトリガーイベントのいずれかによって InApp が表示される前に登録する必要があります。また、これらのコールバックを設定した後に、プラグインの initialize() メソッドを呼び出していることを確認してください。詳細については、ドキュメントを参照してください。
InApp キャンペーンが表示、閉じる、またはクリックされるたびにコールバックが提供されます。以下のように登録できます。

コンテキスト InApp

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

コンテキストの設定

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

コンテキストのリセット

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

ペイロード構造

 

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

これは Android プラットフォームのみが対象です
SDK バージョン 7.3.0 以降、アプリ内メッセージは縦向きモードと横向きモードの両方でサポートされています。
SDK がアプリ内メッセージの表示を処理できるよう、デバイスの向きが変わったときに SDK に通知する必要があります。

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

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

ステータスバーの表示

ステータスバーを表示するには、Android SDK の初期化時に次のコードスニペットを使用します。