Skip to main content
analytics-ios 上に構築されたこの SDK は、今後アップデートが提供されません。analytics-swift 上に構築された MoEngage-Segment-Swift SDK の使用を推奨します。詳細については、MoEngage-Segment-Swift のドキュメントを参照してください。

SDK のインストール

MoEngage は、Cocoapods または Swift Package Manager を使用して Twilio Segment 経由で統合できます。

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

  • pod init コマンドで pod を初期化します。これにより、プロジェクトの podfile が作成されます。
  • 以下のように pod ‘Segment-MoEngage’ を追加して podfile を更新します。
  • pod を更新します。- pod update

Swift Package Manager を使用したインストール

Segment-MoEngage は、SDK バージョン 7.1.0 以降で SPM に対応しています。統合するには、次の GitHub URL を使用し、ブランチを master に、またはバージョンを 7.1.0 以上に設定します。https://github.com/moengage/MoEngage-Segment-iOS.git

Twilio Segment SDK のセットアップ

App Delegate に移動し、Twilio Segment SDK をセットアップします。
AppDelegate の application:didFinishLaunchingWithOptions メソッドで、MoEngage SDK のデータセンター/リージョンを別途設定してください。詳細については、ドキュメントを参照してください。
Twilio Segment SDK のセットアップ時に、[config use:[SEGMoEngageIntegrationFactory instance]] の追加を忘れないでください。これを行わないと、データは MoEngage に送信されません。

MoEngage のセットアップ

MoEngage をセットアップするには、次の手順を実行します。
  1. MoEngage Dashboard > Settings > General に移動します。
  2. Workspace ID をコピーします。
  3. Twilio Segment ダッシュボードに移動し、Integrations に進んで MoEngage を選択します。
  4. MoEngage Integration を有効にします。
  5. MoEngage Settings に移動し、ステップ 1 で取得した MoEngage Workspace ID を入力します。
  6. 変更を保存します。
64351a3-Screen_Shot_2018-09-20_at_11.25.31.png これらの新しい設定がすべての既存ユーザーに反映されるまで、最大 1 時間かかります。新規ユーザーには即座に反映されます。Twilio Segment-MoEngage Integration はバンドル統合であり、クライアント側の統合が必要です。

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

ユーザー属性とは、メールアドレス、ユーザー名、携帯電話番号、性別など、ユーザー固有の特性です。identify を使用すると、ユーザーとそのアクションを紐付け、ユーザーの特性を記録できます。これには、一意の User ID と、ユーザーについて把握している任意の traits が含まれます。
詳細については、こちらのリンクを参照してください。

イベントのトラッキング

イベントトラッキングは、アプリ内のユーザー行動をトラッキングするために使用します。track を使用すると、ユーザーが実行したアクションを記録できます。すべてのアクションは「イベント」をトリガーし、イベントには関連する属性を含めることもできます。
データのトラッキングに必要な作業は以上です。詳細については、こちらのリンクを参照してください。

ユーザーのリセット

reset メソッドは、現在のユーザーに関する SDK の内部ストアをクリアします。これは、ユーザーが時間の経過とともに異なる ID でログイン/ログアウトできるアプリで役立ちます。
詳細については、こちらのリンクを参照してください。

プッシュ通知

プッシュ通知は、ユーザーのエンゲージメントを維持し、アプリに関する情報を届けるための優れた方法です。アプリにプッシュ通知を実装する際には、次のオプションがあります。

MoEngage によるプッシュ実装

Twilio Segment SDK は現在、iOS10 から Apple によって導入された UserNotifications フレームワークをサポートしていないため、こちらがより推奨される実装方法です。MoEngage SDK を使用してモバイルアプリにプッシュ通知を実装するには、次のリンクを参照してください: プッシュ通知
Twilio Segment による SDK の初期化に遅延があるため、AppDelegate Swizzling は Twilio Segment Integration では確実に動作しません。そのため、プッシュ関連のすべてのコールバックで MoEngage SDK のメソッドを必ず呼び出してください。

Twilio Segment によるプッシュ実装

この方法では、通知のクリックによってアプリが起動された場合に、MoEngage SDK が通知を処理できないことが確認されています。これは、この特定のシナリオで Twilio Segment SDK が MoEngage SDK にペイロードを提供しないためです。そのため、プッシュ関連のコールバックで MoEngage SDK のメソッドを直接呼び出す最初の方法を使用することを強く推奨します。
  1. こちらのリンクの手順に従って、Twilio Segment SDK を使用してプッシュを登録します。
  2. アプリケーションの application:didReceiveRemoteNotification: メソッドに次のコードを追加します。
  1. アプリに application:didReceiveRemoteNotification:fetchCompletionHandler: を統合している場合は、そのメソッドに次のコードを追加します。
  1. handleActionWithIdentifier:forRemoteNotification: を実装している場合は、そのメソッドに次のコードを追加します。

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

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

InApp Native

アプリ内メッセージングは、ユーザーのセグメントに送信できるカスタムビューで、カスタムメッセージの表示、新しいオファーの提供、特定のページへの誘導などに使用できます。アプリ内メッセージングの詳細とアプリケーションへの実装方法については、次のリンクを参照してください: InApp NATIV
Twilio Segment for iOS の使用方法の詳細については、Twilio Segment が提供する開発者ドキュメントを参照してください。