組み込みアナリティクス

1）定義と値

Embedded Analyticsは、レポート、ダッシュボード、メトリクス、推奨事項、インタラクティブなリサーチツールがエンドユーザーの主要な製品/ビジネスプロセスに深く統合されるアプローチです。目標は「グラフを表示する」ことではなく、CRM、キャッシュデスク、ロイヤルティプラットフォーム、決済キャビネット、管理者、クライアントアプリケーション内のアクションのコンテキストで意思決定をスピードアップすることです。

• より高速で優れたソリューション：コンテキストスイッチが少なくなります。
• LTVの成長と保持：ユーザーは洞察と制御のために戻ります。
• 製品差別化：分析は価値提案の一部になります。
• インターフェースにおけるアナリティクス/BIチームのセルフサービスの削減

2）標準的な使用例

運用ダッシュボード：コンバージョン、財務フロー、リスク、SLAのKPI。
組み込みの推奨事項：次のベストアクション、アップセル/クロスセル、アラート。
セグメント別スライス/テナント：ブランド、地域、パートナー、商人。
セルフサービス分析：フィルタ、ドリルダウン、保存されたビュー。
エクスポート/メーリング：CSV/XLSX、 PDFスナップショット、サブスクリプション、Webhookアラート。

3）ターゲットオーディエンスと役割

オペレータ/マネージャ：監視、応答、計画。
アナリスト/プロダクトマネージャ：高速A/Bインサイト、仮説、QoE。
ファイナンス/コンプライアンス：GGRコントロール、レポート、詐欺パターン。
Partners/B2B顧客：透明性、セルフサービスおよび信頼。

4）アーキテクチャ： 概要

1.データソース：OLTP、イベント（ストリーム）、サードパーティのAPI。

2.収集とクリーニング：CDC/ETL/ELT、スキーマ、重複排除、SLAダウンロード。

3.ストレージ/ストアフロント：Data Lake+DWH （star/snowflake）、 OLAP/HTAP。

4.セマンティックレイヤー：ビジネスメトリック、ユニフォーム定義、ACL。

5.レンダリング/レンダリングサービス：グラフ/ダッシュボードエンジン。

6.埋め込み：iframe/JS-SDK/Component API、モバイルSDK。

7.セキュリティとアイデンティティのフェデレーション：SSO/JWT/SCIM、 RLS/CLS。

8.エクスプロイテーション：キャッシュ、モニタリング、コンテンツバージョニング、オブザビリティ。

重要な原理：大量処理なしで変更を管理するために、（メトリクスを考慮すると）ビジュアライゼーションからセマンティクスを分離します。

5）データモデルと意味論

単一のKPI用語集：定義、ソース、数式、所有者。
寝具：ステージング→キュレーション→マート；原料は店の窓から分けられます。
安定したキーおよびSCD：店のための正確な歴史（SCD2）を保って下さい。
Row-/Column-Level Security （RLS/CLS）：テナント/ロール/リージョンによるフィルタリング。
データテスト：鮮度、完全性、独自性、異常のバリデータ。

6）埋め込み： 統合オプション

IFrame埋め込み：すばやく開始；重要：安全なトークン、サンドボックス。
JS-SDK/Component-embedding：反応コンポーネント、製品との双方向通信（フィルタ、イベント）。
Headless/Graph API：印刷、エクスポート、一括レポート用サーバー。
モバイルSDK：ネイティブスクリーン、オフラインキャッシュ、プッシュトリガー。

header: { alg: "RS256", typ: "JWT" }
payload: { sub: "<user_id>", tenant_id: "<tenant>", roles: ["manager"], exp: <ts> }

トークンはプロバイダの秘密鍵で署名され、レンダーサービスによってチェックされます。'tenant_id/roles'に基づいて、RLS/CLSとアクセスパターンが適用されます。

7）セキュリティとアクセス

SSO： SAML/OIDC、役割/グループのSCIMプロビジョニング。
RLS/CLS：行/列の詳細ポリシー。
PHI/PII/PCI：マスキング、トークン化、仮名化。
監査証跡：誰が何を見たのか、どのフィルタが適用されたのか、エクスポートされたかどうか。
制限と保護：レート制限、要求署名、アンチスクレイピング。

8）複数のテナントおよび分離

論理分離：キー+RLSの'tenant_id'；クイックスタート。
物理的な分離：大規模なクライアント/リージョン用の専用データベース/スキーマ。
コンテンツテンプレート：パラメーターを通じて「1つのダッシュボード-何千ものテナント」。
クォータ/SLO：エクスポート制限、リフレッシュレート、SLAレンダリング。

9）パーソナライゼーションとコンテキスト

コンテキストフィルタ：役割、地理、チャンネル、ユーザーセグメント。
保存されたビューと選択されたダッシュボード。
推奨事項/ヒント：「次に見るもの」、「今日の異常」。
Nudges：マイクロコピーライティング、KPIハイライト、アクションチェックリスト。

10）性能およびスケール

キャッシュ：マルチレイヤー（クエリキャッシュ、実体化ビュー、静的グラフのCDN）。
証明：スケジュールユニット、ロールアップ、キューブ/集計テーブル。
HTAP/OLAP： Post OLTPと分析負荷は列DBMSを使用します。
ストリーミング：Kafka/Kinesis+インクリメンタルアップサートによるほぼリアルタイムメトリクス。
フロントエンドの最適化：テーブル仮想化、遅延負荷、デバンクフィルタ。

11）可用性とUX

ゼロ・クリック・インサイト：エンティティ・テーブル/カードに直接ヒントを表示します。
ドリルダウン/ドリルスルー：KPIからプライマリイベントへの旅。
KPIの説明：「メトリックがどのように考慮されるか」、ソース、更新時間。
アクセシビリティ（a11y）：コントラスト、キーボードナビゲーション、ARIAラベル。
モビリティ：アダプティブカード、KPIタイル、クイックフィルター。

12）コンテンツ管理（コンテンツプラットフォーム）

ダッシュボードとソースのバージョン、ドラフト/出版物。
カナリア分析リリース、新しいグラフのための機能フラグ。
数式とセマンティクス（承認ワークフロー）の変更を制御します。
カタログ/メトリック、タグ、所有者で検索します。

13）エンベデッドアナリティクスの収益化

関税：基本的なKPI-無料、高度なレポート-Pro/Enterprise。
有料アドオン：エクスポート、APIアクセス、ホワイトラベル、制限の増加。
B2Bチャネル：パートナー/商人のためのアクセス-追加サービスとして。
Embedded Value： Analyticsをコア製品アプレットの鍵にします。

14）コンプライアンスと規制

GDPR/CPA/ローカル規制：法的根拠、データの最小化。
アクセス/削除する権利：DSARプロセスと「忘れられる権利」。
ストレージと保持：データの種類と地域によるタイミングポリシー。
データのローカライズ：ストレージ領域、国境を越えた転送。

15）成功指標（サンプルセット）

アクティベーション：アクティブアナリティクスユーザー（WAU/MAU）の割合。
エンゲージメント：セッションごとのウィジェット・インタラクションの平均数。
洞察速度：イベントから利用可能なKPIまでの時間。
ビジネス効果：コンバージョン/リテンションの向上、詐欺/チャージレートの削減。
信頼性：アップタイムレンダリングサービス、p95レイテンシ、エクスポートエラーの共有。

16）プロセススタック（オプション）

ボルト：BigQuery/Snowflake/Redshift/ClickHouse/DuckDB。
オーケストレーション：Airflow/Argo/DBT/Prefect。
ストリーミング：Kafka/Kinesis/PubSub。
セマンティクス：dbt metrics/LookML/Headless BI。
可視化：独自のReactコンポーネント、商用/OSS BIエンジン、大量のWebGLチャート。
Auth/SSO： Keycloak/Auth0/Azure AD、 OIDC/SAML、 JWT。
観測可能性：Prometheus/Grafana/OpenTelemetry、ログ集計。

17）運営・サポート

SLO/アラート： p95レンダリング<X sec、ウィンドウの鮮度<Y分。
Runbooks：データの劣化、数式の回帰、「赤」ダッシュボードの排除。
容量計画：時間/週、輸出限界による負荷予測。
インシデントポリシー：通信、一時的なプラグ、死後。

18） Antipatterns

「グラフのためのグラフ」：ユーザーアクションとの接続がないこと。
Spaghettiメトリクス：異なる画面で同じKPIの異なる数式。
欠落しているRLS/CLS：テナント間のデータ漏洩。
OLTPでの重いライブリクエスト：生産的なトランザクションの劣化。
iframeのみへの依存：取り返しのつかない制限されたUXと制御。

19）実装ロードマップ（フェーズ別）

1.発見：ソリューションマップ、JTBD、 KPI最小リスト、リスク。
2.MVP： 3-5重要なダッシュボード、SSO、基本的なRLS、キャッシュ/請求書。
3.スケール：セマンティックレイヤー、カタログ、バージョン、ヘッドレスAPI、エクスポート。
4.サポートと成長：ターゲットのヒント、アラート、A/Bイテレーション、収益化。

20）プレリリースのチェックリスト

• ステージングでテストされたSSOと役割。
• RLS/CLSポリシーは、すべての店舗およびエクスポートをカバーします。
• 統一KPI数式とデータ用語集を公開しました。
• p95レイテンシとデータの鮮度はSLOに対応しています。
• ログ/トレイル/監査証跡が利用可能で、アラートが接続されています。
• UXパターン（ドリルダウン、保存されたフィルタ、KPI説明）をチェックしました。
• 法的要件と保持ポリシーが合意されています。

ボトムライン：埋め込まれた分析は別の「BIスクリーン」ではなく、データをアクションにする製品の有機的な部分です。成功は、セマンティクスの質、安全なマルチテナンシー、レンダリングのスピード、持続可能な搾取、およびアナリティクスがユーザーの意思決定をどのくらい変えるかによって決まります。