Skip to main content
MoEngage Kit の統合を開始する前に、mParticle iOS SDK を統合してください。詳細については、開発者向けドキュメントおよび Kit 統合のドキュメントを参照してください。mParticle iOS SDK がすでにアプリケーションに統合されている場合は、この手順をスキップしてください。

MoEngage Kit の統合

SDK のインストール

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

  1. プロジェクトの設定 -> Package Dependencies -> Add Package に移動します。
  2. URL https://github.com/moengage/mparticle-apple-integration-moengage.git を入力し、ブランチとして master または必要なバージョンを選択してパッケージをインストールします。
  3. Add Package をクリックします。
  4. アプリのターゲットに mParticle-MoEngage プロダクトを選択します。

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

以下のように、アプリの Podfile に Kit の依存関係を追加します。

MoEngage SDK の設定

  1. アプリの Info.plist で MoEngageAppDelegateProxyEnabled を false /NO に設定して、MoEngageSDK のメソッドスウィズリングを無効にします。
  2. 設定ページの Dashboard —> Settings —> Account —> General から Workspace ID(以前の App ID)を取得し、mParticle Kit を初期化する前に、AppDelegate の didFinishLaunchingWithOptions コールバック __ で MoEngage SDK を設定します。

インストールとアップデートの区別:

アプリがすでに App Store で公開されている状態で MoEngage を統合する場合があるため、アプリのアップデートが実際の UPDATE なのか INSTALL なのかを把握する必要があります。これらを区別するには、以下のいずれかのメソッドを使用します。
詳細については、次のリンクを参照してください。

プッシュ通知の処理

mParticle SDK を使用した設定

mParticle SDK には、プッシュトークンの登録を処理し、mParticle SDK でプッシュ通知を受信する方法が用意されています。設定オプションについては、プッシュ統合のドキュメントを参照してください。

MoEngage SDK またはアプリケーションを使用した設定

MoEngage SDK で設定する場合、または独自に処理する場合は、MoEngage のプッシュ統合のドキュメント)を確認してください。 MoEngage iOS SDK で提供される機能の詳細については、次のリンクを参照してください。

mParticle SDK の使用方法

詳細な使用方法については、開発者向けドキュメントを参照してください。

ユーザー管理

ユーザー ID は、mParticle の IDSync フレームワークと MoEngage のユーザープロファイルの組み合わせによって管理されます。 アプリケーションでユーザーの状態を管理するには、mParticle の開発者向け統合ドキュメントの IDSync ドキュメントを確認してください。 デフォルトでは、この連携により、次の主要な mParticle 識別子が追加のコードなしで MoEngage のユーザー属性に自動的にマッピングされます。
  • customerId
  • email
  • mobileNumber

追加の識別子のマッピング

その他の識別子(ソーシャルメディア ID、内部エイリアスなど)を同期するには、setMappingForIdentity(), メソッドを使用して明示的にマッピングする必要があります。これにより、mParticle の setIdentity API 呼び出しによって識別子が追加または更新されたときに、その変更が対応する MoEngage のユーザー属性に反映されます。

呼び出すタイミング

この設定は、アプリの起動シーケンスの特定の時点で実行する必要があります。
  1. MoEngage SDK を初期化した後。
  2. mParticle の setIdentity API を初めて呼び出す前。
このロジックを配置するのに最適な場所は、UIApplicationDelegate の didFinishLaunchingWithOptions コールバックです。

イベントトラッキング

mParticle SDK からカスタムイベントとコマースイベントを追跡するには、logEvent を使用します。mParticle SDK は、関連するプロファイルとともにイベントを MoEngage Kit に送信します(mParticle ダッシュボードで設定されている場合)。

ユーザー属性のトラッキング

mParticle SDK には、ユーザー属性を設定するための setUserAttributeList が用意されています。mParticle の標準属性とカスタム属性のどちらを設定しても、両方とも MoEngage Kit に渡され、MoEngage SDK で適切にマッピングされます。

サンプル実装

サンプル実装については、こちらの GitHub リポジトリを参照してください。