Skip to main content
InApp NATIV キャンペーンは、ユーザーがアプリを使用している間にメッセージを表示することでユーザーをターゲットにします。コンテキストに応じた情報を提供するのに非常に効果的で、アプリの目的の画面や、ユーザーがアプリ内で実行した目的のアクションに応じて、クロスセルやアップセルに役立ちます。 In App NATIV1

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

BOM を使用したインストール

BOM を使用した統合が推奨される統合方法です。BOM を使用したインストールのドキュメントを参照してください。BOM を設定したら、以下に示すように app/build.gradle ファイルに依存関係を追加します。
BOM を設定したら、アプリケーションに必要な特定の MoEngage モジュールを含めます。
注: これらの依存関係にバージョン番号は必要ありません。BOM が自動的に管理します。

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

InApp バージョン 7.0.0 以降、SDK で In-App に画像や GIF を表示するには Glide が必要です。build.gradle ファイルに以下の依存関係を追加する必要があります。

InApp の表示

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

ナッジの表示

capacitor-moengage-core バージョン 6**.0.0** 以降、MoEngage InApp SDK は非侵入型のナッジの表示をサポートしています。 ナッジ InApp キャンペーンを表示するには、showNudge() を呼び出します。

InApp/ナッジのリダイレクトのデフォルト動作

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

Self-Handled InApp

単一の Self-Handled InApp

Self-Handled InApp は、SDK によって配信されますが、表示はアプリで処理する必要があるメッセージです。
Self-Handled In-App を取得するには、以下のメソッドを呼び出します。
Self-Handled In-App のペイロードはコールバックを介して返されます。以下に示すようにコールバックを登録します。

複数の Self-Handled InApp

複数の Self-Handled In-App を取得するには、getSelfHandledInApps() メソッドを呼び出します。これは、MoEInAppSelfHandledCampaignsData オブジェクトを含む Promise を返します。
TypeScript

統計のトラッキング

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

InApp コールバック

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

コンテキスト InApp

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

コンテキストの設定

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

コンテキストのリセット

ユーザーがコンテキストから離れたら、resetInAppContext() API を使用して既存のコンテキストをリセット/クリアします。

ペイロード構造

画面の向きの変更の処理

これは Android プラットフォームのみが対象です
SDK が In-App の表示を処理するためには、デバイスの向きが変わったときに MoEngage SDK に通知する必要があります。 これには 2 つの方法があります。
  1. アプリの Android ネイティブ部分に API 呼び出しを追加する
  2. MoEngage プラグインの onOrientationChanged() を呼び出す

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

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

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

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