指標とレポート
メトリクスとレポートは、プラットフォームの使用状況を追跡、分析、理解できるNTT CPaaSプラットフォーム機能です。CPaaS X では、レポートのスコープはapplicationIdとentityIdに設定されるため、プラットフォーム全体の集計のみを表示するのではなく、アプリケーションごとまたは顧客エンティティごとにメトリックを表示できます。
スコープ レポートの仕組み [#how-scoped-reporting-works]
CPaaS X は、applicationId と entityId によってメトリックのスコープを設定します。次の 2 つのレベルでクエリできます。
アプリケーションレベルのレポート
合計メッセージ量、配信率、成功率など、アプリケーション内のすべてのエンティティにわたる集計メトリック。
エンティティ レベルのレポート
正確な使用状況、配信率、パフォーマンスを示す顧客ごとの指標。各エンティティのデータは、他のエンティティから完全に分離されています。
スコープメトリクスが重要な理由 [#why-scoped-metrics-matter]
スコープ メトリックは、マルチテナント プラットフォームに 3 つの重要な機能を提供します。
- 顧客ごとの使用状況の追跡: 各顧客が送信したメッセージの数、チャネル、配信率を正確に把握します。エンティティごとにパフォーマンスの問題を特定します。
- 顧客のセルフサービスの可視性: 他のエンティティのデータを公開することなく、顧客が自分の使用状況データにアクセスできるようにします。各顧客には、独自のメトリックとクォータのみが表示されます。
- パフォーマンス傾向分析: エンティティごとの配信率、メッセージ量、使用パターンを経時的に追跡します。異常を検出し、顧客とのコミュニケーションパフォーマンスを最適化します。
メトリックを表示する場所 [#where-to-view-metrics]
CPaaS X の指標とレポートには、次の 3 つの方法でアクセスできます。
NTT CPaaS Web インターフェイスの [Analyze] セクションを使用すると、コードを記述せずにメトリックを表示できます。Analyze は、CPaaS X のお客様向けに applicationId と entityId によるフィルタリングをサポートしているため、エンティティごとにメトリックを分離できます。
- 配信率、失敗したメッセージ、エンゲージメントデータ(クリック数、閲覧率)を含むクロスチャネルダッシュボード。
- 顧客ごとのコスト分析のためのアプリケーションおよびエンティティディメンションを含む財務レポート。
- 定期的な自動レポート(日次、週次、月次)とエクスポートと共有。
最適な用途: 技術者以外のユーザー、クイックチェック、財務報告。
Analyzeを参照してください。
applicationId、entityId、および timeframe でフィルター処理されたプログラムによるクエリ。APPLICATION_IDとENTITY_IDをグループ化ディメンションとして使用して、テナント全体のトラフィックデータを集計します。
- 大規模なデータセットの非同期クエリ処理。
- すべてのチャネル (SMS、Eメール、WhatsApp、RCS など) にわたる集計されたトラフィック データ。
- 国、ネットワーク、送信者、ステータス コード、カスタム ディメンションごとに柔軟に集計できます。
最適な用途: カスタム ダッシュボード、自動レポート、プログラマティック コスト アトリビューション。
Metrics APIを参照してください。
通信フロー全体のイベントによってトリガーされるリアルタイムの Webhook 通知。サブスクリプションは、フィルターを使用して applicationId と entityId によってスコープが設定されるため、各エンティティは専用の Webhook エンドポイントを介して独自のイベントのみを受信します。
- SMS、MMS、Eメール、WhatsApp、RCS、Viber、Voiceなどを含む20+チャンネルをサポートします。
- イベントタイプには、配信、クリック、表示、受信メッセージ、ID 変更、テンプレート更新が含まれます。
- エンティティ、アプリケーション、ユーザー、またはリソースでフィルタします。サブスクリプションは、すべてのフィルター条件が一致する場合にのみトリガーされます。
- Web インターフェイス (開発者ツール > サブスクリプション管理) またはサブスクリプション APIを使用してサブスクリプションを管理します。
最適な用途: ライブ監視、即時アラート、顧客向けイベント ストリーム、および受信メッセージ処理。
Webhook サブスクリプション (/cpaas-x/イベント サブスクリプション) を参照してください。
アプリケーションとエンティティ
コアコンセプトとデータの分離。
Webhook サブスクリプション
エンティティごとのリアルタイム配信通知。
CPaaS X セットアップを保護する
アクセス制御の API キーのスコープを設定します。