Skip to main content
MoEngage SDKは、アプリケーション内で動作する軽量でモジュール式のクライアントライブラリです。イベントトラッキング、ユーザー識別、プッシュトークンの登録、アプリ内メッセージのレンダリング、コンテンツカードの配信を処理し、オフラインキューイングを備えたバッチ処理のHTTPSリクエストを通じてMoEngageサーバーにデータを同期します。 SDKはデフォルトで以下を自動収集します: セッションの開始/終了、アプリバージョン、デバイスモデル、OSバージョン、タイムゾーン、ロケール。プッシュが設定されている場合、プッシュトークンは自動的に登録されます。その他のトラッキング(イベント、ユーザー属性)はすべて、API呼び出しによって明示的に行います。

サポートされているプラットフォーム

ネイティブ

Android SDK

KotlinおよびJava。プッシュ(FCM、HMS)、アプリ内メッセージ、カード、プッシュテンプレート、プッシュアンプリフィケーション、通知センター、位置情報トリガー、Android TVをサポート。モジュール式で、必要なものだけを追加できます。

iOS SDK

SwiftおよびObjective-C。プッシュ(APNs)、アプリ内メッセージ、カード、プッシュテンプレート、Live Activities、リアルタイムトリガー、通知センター、Apple TVをサポート。CocoaPodsまたはSPMで利用できます。

Web SDK

フレームワークに依存しないJavaScript SDK。Webプッシュ、オンサイトメッセージング(OSM)、データトラッキング、カード、ライフサイクルコールバックをサポート。React、Angular、Vue、Next.js、および任意のSPAやMPAで動作します。AMPページ、ブラウザー拡張機能、WebView、スマートTVにも対応しています。

クロスプラットフォーム

クロスプラットフォームSDKは、ネイティブのAndroid SDKおよびiOS SDKへの橋渡しとなる統一APIを提供します。フレームワークレベルの統合に加えて、プッシュ通知、アプリ内メッセージのレンダリング、その他のネイティブ機能に関するプラットフォーム固有のセットアップ手順を完了する必要があります。

React Native

React Native CLIプロジェクトをサポート。プッシュ、アプリ内メッセージ、カード、TVに対応。Androidではネイティブのセットアップが必要で、iOSではCocoaPodsを介して自動リンクされます。

Expo

react-native-expo-moengage 設定プラグインによるExpo managed workflowのサポート。プッシュ、アプリ内メッセージ、カードに対応。ネイティブモジュールのリンクにはEAS Buildが必要です。

Flutter

iOS、Android、Web向けのネイティブバインディングを備えたDartプラグイン。プッシュ、アプリ内メッセージ、カード、ジオフェンス、通知センターに対応。Null安全(Dart 2.12+)。

Cordova

Apache Cordovaプラグイン。プッシュ、アプリ内メッセージ、データトラッキングに対応。CocoaPodsのサポートには cordova-ios 4.3+ が必要です。

Capacitor

Capacitorプラグイン(Capacitor 3+)。プッシュ、アプリ内メッセージ、データトラッキング、ジオフェンスに対応。TypeScript API。

Ionic

IonicはネイティブランタイムとしてCordovaまたはCapacitorを使用します。Ionicプロジェクトのネイティブレイヤーに合ったプラグインを選択してください。Ionic専用のSDKはありません。

Unity

iOSおよびAndroid向けのネイティブバインディングを備えたUnityプラグイン。プッシュ、アプリ内メッセージ、データトラッキング、プッシュテンプレート、位置情報トリガーキャンペーンに対応。

特殊プラットフォーム

TVとOTT

Android TV(Android SDK経由)、Apple TV(iOS SDK経由)、スマートTV(Web SDK経由)。プッシュとアプリ内メッセージのサポートはプラットフォームによって異なります。

Eコマースプラットフォーム

Shopify 2.0(アプリ埋め込みブロック)、Magento、WooCommerce。Eコマースイベントを自動トラッキングし、商品カタログを同期します。

プラットフォームの互換性

クイックスタート

プラットフォームを選択し、統合ガイドに従ってください。最初のイベント送信までの目安時間は、ネイティブSDKで 15~30分、クロスプラットフォームで 30~60分(追加のネイティブ設定が必要なため)です。
1

Workspace IDを取得する

MoEngageダッシュボードで、Settings → Account → APIs → Workspace ID に移動します。SDKの初期化にこのIDが必要です。
2

データセンターを設定する

データセンターによって、SDKが通信するAPIエンドポイントが決まります。ダッシュボードURLのホストからデータセンターを確認してください(例:dashboard-01.moengage.com → dc_1)。これはSDKの初期化時に設定する必要があります。
3

SDKをインストールする

上の表にあるプラットフォーム固有のインストールガイドに従ってください。
4

SDKを初期化する

Workspace IDとデータセンターを指定して初期化メソッドを呼び出します。開発中は TEST 環境を、本番環境では LIVE を使用してください。
5

最初のイベントをトラッキングする

イベントトラッキングAPIを呼び出してカスタムイベントを送信します。MoEngageダッシュボードの Analytics → Event Analysis に表示されることを確認してください。

プラットフォーム別の前提条件

統合を開始する前に、以下を準備してください。
  • Android: google-services.json が設定されたFirebaseプロジェクト(FCMプッシュに必要)。Gradle 7.0+、AGP 7.0+、Java 8+。
  • iOS: プッシュ通知のエンタイトルメントが有効なApple Developerアカウント。MoEngageダッシュボードにアップロードされたAPNs認証キー(.p8 ファイル)。
  • Web: HTTPS対応のドメイン(Service Workerを使用するWebプッシュに必要)。
  • クロスプラットフォーム(React Native / Expo / Flutter / Cordova / Capacitor): 上記のネイティブの前提条件すべてに加え、フレームワーク固有のツールチェーン。

プラットフォーム別の機能の利用可否

すべての機能がすべてのプラットフォームで利用できるわけではありません。統合を開始する前に、この表でサポート状況を確認してください。 ¹ Android、iOS、Web、およびUIカードとセルフハンドルカードの両方。 ² セルフハンドルのみ。
一部の機能には追加のモジュール依存関係が必要です。正確な依存関係の要件については、プラットフォーム固有の統合ガイドを確認してください。

一般的な統合タスク

アップグレードと移行

開発者向けリソース

サンプルアプリ

動作するリファレンス実装:Android · iOS · React Native · Flutter · Capacitor

リリースノート

すべてのSDKの変更履歴。GitHubでリリースを購読すると、新しいバージョン、破壊的変更、セキュリティパッチの通知を受け取れます。

トラブルシューティング

リリースチェックリスト

リリース前の検証:Android · iOS
サポートが必要な場合は、カスタマーサクセスマネージャーにお問い合わせください。