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

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

Maven 3 mainTemplate.gradle ファイルに次の依存関係を追加します。
$sdkVersion を適切な SDK バージョンに置き換えてください。

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

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

In-App の表示

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

Nudge の表示

画面上の指定した位置に Nudge タイプの In-App メッセージを表示するには、MoEInAppHelper.ShowNudge() を使用します。
NudgePosition 列挙型は、Nudge が表示される位置を定義します。

Self-Handled InApp

Self-Handled In-App は、SDK がアプリケーションに配信するメッセージで、アプリケーションは SDK から配信されたペイロードを使用して UI を構築します。

単一の Self-Handled InApp

単一の Self-Handled In-App メッセージをリクエストするには、以下の API を呼び出します。
ペイロードはコールバックを介して返されます。以下に示すようにコールバックを登録します。

複数の Self-Handled InApp

イベントトリガー型の複数の Self-Handled In-App はサポートされていません。
複数の Self-Handled キャンペーンを取得するには、MoEngageClient.GetSelfHandledInApps() を使用します。SDK は、キャンペーン作成時に設定されたキャンペーンの優先度順に、最大 5 件のキャンペーンを返します。
キャンペーンのリストはコールバックを介して返されます。以下に示すようにコールバックを登録します。

統計のトラッキング

リスト内の各キャンペーンの統計は、個別にトラッキングする必要があります。個々の InAppSelfHandledCampaignData オブジェクトを、以下の API のパラメーターとして渡します。

InApp コールバック

SDK は、In-App が表示、閉じられた、またはクリックされた(ウィジェットにナビゲーションアクションまたはカスタムアクションが関連付けられている場合のみ)ときに、クライアントアプリケーションにコールバックを提供します。
上記のケースで通知を受け取るには、以下のコールバックを使用します。

InApp の表示

InApp のクリック

InApp のカスタムアクション

InApp の終了

InApp ペイロード

画面の向きの変更の処理

これは Android プラットフォームのみが対象です
Unity Plugin バージョン 2.2.0 以降、In-App は縦向きと横向きの両方のモードでサポートされています。
SDK が In-App の表示を処理できるように、デバイスの向きが変更されたときに SDK に通知する必要があります。
これには 2 つの方法があります。
  1. アプリの Android ネイティブ部分に API 呼び出しを追加する
  2. MoEngage プラグインの onOrientationChanged() を呼び出す
  3. アプリの Android ネイティブ部分に API 呼び出しを追加する
UnityPlayerActivity クラスで onConfigurationChanged() API コールバックを受け取ったときに、SDK に通知します。
カスタムの UnityPlayerActivity を作成したくない場合は、Android 版 MoEngage SDK に同梱されている MoEUnityPlayerActivity を利用できます。このアクティビティは、デバイスの設定変更を内部で処理します。
このアクティビティをアプリのエントリーポイントとして追加する必要があります。そのためには、AndroidManifest.xml 内の現在のエントリーポイントを以下のコードに置き換えます。

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

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