概要
MoEngage Assist Chrome 拡張機能は、開発者やマーケターが MoEngage Web SDK の統合と実装を監視し、トラブルシューティングできるように設計された専用のデバッグツールです。この拡張機能をインストールすると、ブラウザから直接 Web SDK の統合を検証およびデバッグできます。 この拡張機能を使用すると、次のことができます。- Service Worker の登録を確認する。
- プッシュトークンの生成を確認する。
- イベントのトラッキングをリアルタイムで検査する。
- 実装上の問題をトラブルシューティングおよびデバッグする。
- キャンペーンと関連機能にアクセスする。
インストール手順
- Chrome ウェブストアに移動します。
- MoEngage Assist を検索します。
- Add to Chrome を選択して拡張機能をインストールします。
- すばやくアクセスできるよう、拡張機能をブラウザのツールバーにピン留めします。
アクティブな Web ページに MoEngage Web SDK がインストールされていない場合、拡張機能には「SDK not found」の状態が表示されます。Web SDK の統合の詳細については、Web SDK の統合を参照してください。
拡張機能のタブ
Web SDK が正常に統合されると、拡張機能は以下の 4 つのタブに運用データを表示します。Issues
Issues タブには、早急な対応が必要な重大な統合エラーや設定エラーが表示されます。 表示されるエラーを並べ替えるには、Filter by issue category ドロップダウンメニューを使用します。カテゴリは次のとおりです。- Setup: 基本的な設定エラーを表示します (例: HTTP モードでの Web Push の失敗、Service Worker ファイルの欠落、ポリフィルが必要なサポート対象外の Promise など)。
- Track: データ収集の異常を特定します (例: 属性値として空のオブジェクトを渡している、属性文字列が欠落している、通知タイトルが空白であるなど)。
- Info: キャンペーン配信のエラーを示します (例: 受信されていない、または削除されたカード ID をトラッキングしようとしているなど)。
Setup Info
MoEngage ワークスペースの基本的な設定と環境の詳細を、ブラウザから直接検証できます。Setup Info タブには、Web SDK の実装の包括的な概要が、以下のセクションに分けて表示されます。
- 基本情報
- Service Worker
- Web Push オプトインの設定
ワークスペースの主要なメタデータと設定ステータスを表示します。これには以下が含まれます。
- Data center: データがホストされているリージョン。
- App ID: ワークスペースの一意の識別子。
- Multi ID enabled: Multi-ID トラッキング機能が有効かどうかを示します。
- SPA mode enabled: シングルページアプリケーションのトラッキングが有効かどうかを示します。
- Shopify: MoEngage が Shopify の Web サイトに統合されているかどうかを示します。
- Billing type: 有効なサブスクリプションモデル (Subscriber based billing) を示します。
- Is sub domain shared?: 設定が共有サブドメインをサポートしているかどうかを示します。
- Settings last fetched: 直近の SDK 設定の同期の相対的なタイムスタンプを表示します (例: Just now)。
Track
Track タブでは、リアルタイムのデータ収集ペイロードを監視し、アクティブなセッションのイベントストリームを検証します。このタブは次の 2 つのサブタブに分かれています。- Event
- User
- Event
- User
現在のページでトラッキングされているライブの行動イベントとシステムイベントを監視します。
- 検索とフィルター: 専用の検索バーを使用して、特定のイベント名や属性でライブストリームをすばやくフィルタリングできます。
- ステータスインジケーター: 正常に取得されたイベントペイロードには、イベント名の横に緑色の Tracked バッジが表示されます。
- ペイロードの検証: トラッキングされたイベントを選択すると、そのペイロードが展開され、基になるキーと値のペアを検査できます。特定のイベントタイプ (On-site Messaging のインタラクションやページビューなど) に応じて、以下のような詳細なパラメーターを検証できます。
- キャンペーンのメタデータ: campaign_id、campaign_name、cid などの識別子。
- 実行プロパティ: Variation ID、Locale Name、Locale ID、ターゲットとなる Campaign Tags などの設定の詳細。
- ユーザーコンテキスト: Logged In Status、First Visit、アクティブな URL など、イベント発生時に評価されたセッション固有のブール値と文字列。
Campaign
Campaign タブでは、現在のユーザーセッションを対象とするアクティブなキャンペーンをデバッグおよび検査できます。キャンペーンはチャネルタイプ別に分類されています。- OSM (On-Site Messaging)
- Web Personalization
- Cards
- ステータス、テンプレートタイプ (例: POP_UP)、有効期限、更新日時。
- 優先度と動作の設定 (例: blocking、scrollable、sticky)。
- キャンペーンの完全なペイロード。詳細な分析のために、クリップボードに直接コピーできます。
- Campaign details パネル内の View in Dashboard リンクを選択すると、MoEngage ワークスペース内で特定のキャンペーンの設定を直接開くことができます。
- Web SDK の実装に特定のモジュールや機能が統合されていない場合、MoEngage Assist はトラブルシューティングに役立つ説明的なエラー状態を表示します。たとえば、OSM モジュールが欠落している場合、拡張機能には次のように表示されます: “OSM not integrated. To start seeing campaigns, please integrate the OSM module on your website.”
- Campaign status: 現在の適格性と配信メトリクスをトラッキングします。
- ページの適格性 (Page eligibility) と表示ステータス (Display status) を検証します。
- 現在の読み込みにおけるページビューのインプレッション合計と、累計インプレッションを表示します。
- Campaign properties: キャンペーンのセットアップで定義された主要な構造の設定とレンダリングの動作を示します。
- メタデータ: テンプレートタイプ (例: POP_UP)、有効期限、更新日時、優先度が含まれます。
- レンダリングルール: Max show count、Auto dismiss after、Delay between same campaign、Blocking、Scrollable、Sticky フラグなど、具体的な UI/UX の制約の詳細を示します。
- Trigger actions: キャンペーンを実行するために必要な具体的な行動条件の詳細を示します。
- 評価されたプライマリイベント (例: MOE_PAGE_EXIT) を特定し、そのトリガーステータスを確認します。
- ルールの説明と、設定されたトリガーの遅延 (例: Immediately) を表示します。
- Frequency capping: キャンペーン疲れを防ぐために設定された、グローバルおよびページレベルの制限を表示します。
- ルール: すべてのキャンペーンの最大表示回数 (例: Max 3 Per day) と、特定のページ読み込みに関する制約を示します。
- デバイスのフリークエンシーデータ: このセクションを展開すると、設定されたルールに対する特定のデバイスの実行回数を確認できます。直近 1 時間 (LH) と当日 (Date) の消費量の内訳が表示されます。
