@intlayer/docs 9.0.0-canary.15 → 9.0.0-canary.16

package/docs/it/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Nuovo Intlayer v9 - Cosa c'è di nuovo?
 description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections e Variants.
 keywords:
@@ -205,6 +205,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: tracciamento dell'esposizione dei contenuti e test A/B
+
+Un nuovo pacchetto opzionale, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), ti mostra quali contenuti vengono effettivamente visualizzati dai tuoi visitatori — chiudendo il cerchio con **Collections & Variants** permettendoti di eseguire test A/B sui contenuti e misurare le conversioni per variante.
+
+- **Tracciamento a livello di provider**: `IntlayerProvider` (React / Next.js / React Native) registra automaticamente eventi `page_view` al caricamento, al cambio di rotta e al cambio di lingua.
+- **Tracciamento a livello di nodo**: ogni risoluzione di `useIntlayer` segnala un evento `content_exposure` — quale chiave del dizionario, percorso della chiave, lingua e, quando applicabile, quale **variante** A/B è stata mostrata. Le esposizioni ripetute dello stesso nodo all'interno di una finestra di invio vengono unite in un unico evento.
+- **Assegnazione A/B deterministica**: `getVariant(experimentKey, variants)` assegna una variante a ogni sessione **senza andata e ritorno al server**, quindi nessuno sfarfallio prima del primo rendering.
+- **`useConversion()`**: attribuisce un obiettivo (registrazione, clic, acquisto…) alla variante a cui la sessione è stata esposta.
+- **Costo zero se non installato**: stesso schema tree-shakeable di `@intlayer/editor` — `import()` dinamico avvolto in `try/catch`, più una variabile d'ambiente a tempo di compilazione (`INTLAYER_ANALYTICS_ENABLED`) che elimina completamente l'integrazione dal bundle per le app che non la attivano.
+- **Nessun nuovo schema di configurazione**: riutilizza `editor.backendURL` (endpoint di invio / self-hosting) ed `editor.clientId` (chiave del progetto, che funge anche da interruttore di attivazione).
+- **Rispettoso della privacy**: hashing anonimo della sessione (SHA-256, nessun id grezzo memorizzato), nessuna memorizzazione dell'IP, geolocalizzazione approssimativa limitata al paese, richieste inviate in batch circa ogni 20 secondi.
+- **Dashboard**: una nuova pagina **Analytics** (visibile nella barra laterale una volta selezionato un progetto) mostra utenti attivi, utenti di oggi, utenti degli ultimi 7/30/90 giorni, un grafico dell'evoluzione dei visitatori e la suddivisione per lingua e posizione.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Disponibile già oggi per React, Next.js e React Native (tramite `react-intlayer`); altri binding per framework (Vue, Svelte, Angular, …) sono pianificati, seguendo lo stesso schema di rilascio di `@intlayer/editor`. Consulta la [documentazione di Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) per la guida completa.
+
+---
+
 ## Vite Plugin: Compiler e Proxy in Bundle
 
 Il plugin Vite `intlayer()` ora raggruppa il **compiler** e il **proxy di locale-routing** direttamente, quindi la maggior parte dei progetti ha bisogno solo di un singolo plugin in `vite.config.ts`:
@@ -353,6 +396,7 @@ Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking cha
 
 - [Guida ai Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md)
 - [Dizionari Dinamici - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
+- [Analytics - Tracciamento dell'esposizione dei contenuti e test A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Riferimento alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
 - [SDK CMS - Accesso programmatico con @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
 - [Guida al Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md)

package/docs/ja/cli/index.md

@@ -125,7 +125,7 @@ Intlayerは、複数の設定ファイル形式をサポートしています：
 
 ### 認証
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/login.md)** - Intlayer CMSで認証し、アクセス資格情報を取得します。
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/login.md)** - Intlayer CMSで認証し、アクセス資格情報を取得します。
 
 ### コアコマンド
 

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` 設定を追加"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * アナリティクス（analytics）設定。
+   */
+  analytics: {
+    /**
+     * アナリティクス収集を有効にするかどうか（ページビュー、コンテンツの露出、A/Bイベント）。
+     * 帰属（attribution）のために `editor.clientId` の設定が必要です。
+     * デフォルト: false
+     */
+    enabled: true,
+
+    /**
+     * バックエンドへの自動バッチ送信間のミリ秒数。
+     * デフォルト: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * 記録するセッションの割合。0（なし）から1（すべて）まで。
+     * デフォルト: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * AI による翻訳と生成の設定。
    */
@@ -668,6 +695,20 @@ export default config;
 
 ---
 
+### アナリティクス設定 (Analytics)
+
+Intlayerアナリティクスに関する設定を定義します。ユーザーに実際に表示されたコンテンツ（ページビュー、コンテンツの露出）を収集し、コンテンツのA/Bテストを可能にします。
+
+アナリティクスは厳密にオプトイン方式です。`analytics.enabled` が明示的に `true` に設定され、**かつ** 帰属のためのプロジェクトキー（`editor.clientId`）が設定されない限り、何も収集されません。無効の場合（デフォルト）、アナリティクスの統合全体がアプリケーションのバンドルから削除されます（デッドコード除去）。
+
+| フィールド      | 説明                                                                              | 型        | デフォルト | 例      | 備考                                                                                                                                       |
+| --------------- | --------------------------------------------------------------------------------- | --------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `enabled`       | アナリティクス収集を有効にします（ページビュー、コンテンツの露出、A/Bイベント）。 | `boolean` | `false`    | `true`  | 帰属のために `editor.clientId` の設定が必要です。設定されていない場合、`enabled` が `true` でもアナリティクスは無効のままです。            |
+| `flushInterval` | バックエンドへの自動バッチ送信間のミリ秒数。                                      | `number`  | `20000`    | `10000` |                                                                                                                                            |
+| `sampleRate`    | 記録するセッションの割合。`0`（なし）から`1`（すべて）まで。                      | `number`  | `1`        | `0.5`   | サンプリングはセッションごとに決定的であるため、記録されたセッションはそのすべてのイベントを報告します（部分的なファネルにはなりません）。 |
+
+---
+
 ### ルーティング設定 (Routing)
 
 URL 構造、ロケール保存、ミドルウェア管理など、ルーティングの動作を制御する設定。

package/docs/ja/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-29
+updatedAt: 2026-07-08
 title: Intlayer CMS | コンテンツをIntlayer CMSに外部化する
 description: コンテンツ管理をチームに委任するために、コンテンツをIntlayer CMSに外部化します。
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "「ライブ同期」セクションを専用ページ（live-sync.md）に移動し、ここには簡単な紹介とリンクのみを残した"
   - version: 9.0.0
     date: 2026-06-30
     changes: "「セルフホスティング」セクションを追加: Docker Composeブートストラップ、サービスインベントリ、SDK設定、オプション機能、アップグレードノート"
@@ -403,144 +406,7 @@ await pushDictionaries([{ key: "home", content: { title: "Home" } }]);
 
 ライブ同期は、アプリが実行時に CMS のコンテンツ変更を反映できるようにします。再ビルドや再デプロイは不要です。有効にすると、更新がライブ同期サーバーにストリームされ、アプリケーションが読み込む辞書が更新されます。
 
-Intlayerの設定を更新してLive Syncを有効にします：
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... その他の設定
-  editor: {
-    /**
-     * 変更が検出されたときにロケール設定のホットリロードを有効にします。
-     * 例えば、辞書が追加または更新された場合、アプリケーションは
-     * ページに表示されるコンテンツを更新します。
-     *
-     * ホットリロードは継続的なサーバー接続を必要とするため、
-     * `enterprise`プランのクライアントのみ利用可能です。
-     *
-     * デフォルト: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * 辞書のインポート方法を制御します：
-     *
-     * - "fetch"：辞書はLive Sync APIを使用して動的に取得されます。
-     *   useIntlayerの代わりにuseDictionaryDynamicを使用します。
-     *
-     * 注意：ライブモードはLive Sync APIを使用して辞書を取得します。API呼び出しが
-     * 失敗した場合、辞書は動的にインポートされます。
-     * 注意：リモートコンテンツかつ"live"フラグが付いた辞書のみがライブモードを使用します。
-     * その他はパフォーマンスのために動的モードを使用します。
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-アプリケーションをラップするために Live Sync サーバーを起動します：
-
-スタンドアロンサーバーを使用した例：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... その他のスクリプト
-    "live:start": "npx intlayer live",
-  },
-}
-```
-
-`--process` 引数を使用して、アプリケーションサーバーと並行して使用することもできます。
-
-Next.js を使用した例：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... その他のスクリプト
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Vite を使用した例：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... その他のスクリプト
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Live Sync サーバーはあなたのアプリケーションをラップし、更新されたコンテンツが到着すると自動的に適用します。
-
-CMSからの変更通知を受け取るために、Live SyncサーバーはバックエンドとのSSE接続を維持します。CMSのコンテンツが変更されると、バックエンドは更新情報をLive Syncサーバーに転送し、新しい辞書を書き込みます。アプリケーションは次のナビゲーションまたはブラウザのリロード時に更新を反映し、再ビルドは不要です。
-
-フローチャート（CMS/バックエンド -> Live Syncサーバー -> アプリケーションサーバー -> フロントエンド）:
-
-![Live Sync フロー CMS/バックエンド/Live Syncサーバー/アプリケーションサーバー/フロントエンド スキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-動作の仕組み:
-
-![Live Sync ロジックスキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-### 開発ワークフロー（ローカル）
-
-- 開発中は、アプリケーション起動時にすべてのリモート辞書が取得されるため、更新をすばやくテストできます。
-- Next.jsでローカルにLive Syncをテストするには、開発サーバーをラップします：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... 他のスクリプト
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Vite用
-  },
-}
-```
-
-開発中にIntlayerがLiveインポート変換を適用するように最適化を有効にします：
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true, // default: process.env.NODE_ENV === 'production'
-  },
-};
-
-export default config;
-```
-
-この設定により、開発サーバーがLive Syncサーバーでラップされ、起動時にリモート辞書を取得し、CMSからの更新をSSE経由でストリーミングします。変更を確認するにはページをリロードしてください。
-
-注意事項と制約：
-
-- Live Sync のオリジンをサイトのセキュリティポリシー（CSP）に追加してください。Live Sync の URL が `connect-src`（および該当する場合は `frame-ancestors`）で許可されていることを確認してください。
-- Live Sync は静的出力では動作しません。Next.js の場合、ページはランタイムで更新を受け取るために動的である必要があります（例：完全な静的のみの制約を避けるために、`generateStaticParams`、`generateMetadata`、`getServerSideProps`、または `getStaticProps` を適切に使用してください）。
-- CMSでは、各辞書に`live`フラグがあります。`live=true`の辞書のみがライブ同期APIを通じて取得され、それ以外は動的にインポートされ、実行時には変更されません。
-- `live`フラグはビルド時に各辞書ごとに評価されます。ビルド時にリモートコンテンツが`live=true`に設定されていなかった場合、その辞書のライブ同期を有効にするには再ビルドが必要です。
-- ライブ同期サーバーは`.intlayer`に書き込み可能でなければなりません。コンテナ環境では`/.intlayer`への書き込み権限を確保してください。
+設定方法、Live Sync サーバーの起動、ローカル開発ワークフロー、制約事項などの完全なガイドは、[Live Sync ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/live-sync.md)を参照してください。
 
 ## セルフホスティング
 

package/docs/ja/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: ライブ同期 | CMSコンテンツの変更をリアルタイムに反映
+description: リビルドや再デプロイなしで、Intlayer CMS のコンテンツ変更をアプリにリアルタイムで反映させます。
+keywords:
+  - ライブ同期
+  - Live Sync
+  - CMS
+  - ビジュアルエディタ
+  - 国際化
+  - ドキュメント
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Intlayer CMS ドキュメントから独立したページに移動"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "ライブ同期のドキュメントを追加"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "`hotReload` フィールドを `liveSync` に置き換え"
+author: aymericzip
+---
+
+# ライブ同期
+
+ライブ同期は、アプリが実行時に CMS のコンテンツ変更を反映できるようにします。再ビルドや再デプロイは不要です。有効にすると、更新がライブ同期サーバーにストリームされ、アプリケーションが読み込む辞書が更新されます。
+
+## 目次
+
+<TOC/>
+
+---
+
+## ライブ同期を有効にする
+
+Intlayerの設定を更新してLive Syncを有効にします：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... その他の設定
+  editor: {
+    /**
+     * 変更が検出されたときにロケール設定のホットリロードを有効にします。
+     * 例えば、辞書が追加または更新された場合、アプリケーションは
+     * ページに表示されるコンテンツを更新します。
+     *
+     * ホットリロードは継続的なサーバー接続を必要とするため、
+     * `enterprise`プランのクライアントのみ利用可能です。
+     *
+     * デフォルト: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * 辞書のインポート方法を制御します：
+     *
+     * - "fetch"：辞書はLive Sync APIを使用して動的に取得されます。
+     *   useIntlayerの代わりにuseDictionaryDynamicを使用します。
+     *
+     * 注意：ライブモードはLive Sync APIを使用して辞書を取得します。API呼び出しが
+     * 失敗した場合、辞書は動的にインポートされます。
+     * 注意：リモートコンテンツかつ"live"フラグが付いた辞書のみがライブモードを使用します。
+     * その他はパフォーマンスのために動的モードを使用します。
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+アプリケーションをラップするために Live Sync サーバーを起動します：
+
+スタンドアロンサーバーを使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+`--process` 引数を使用して、アプリケーションサーバーと並行して使用することもできます。
+
+Next.js を使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Vite を使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Live Sync サーバーはあなたのアプリケーションをラップし、更新されたコンテンツが到着すると自動的に適用します。
+
+CMSからの変更通知を受け取るために、Live SyncサーバーはバックエンドとのSSE接続を維持します。CMSのコンテンツが変更されると、バックエンドは更新情報をLive Syncサーバーに転送し、新しい辞書を書き込みます。アプリケーションは次のナビゲーションまたはブラウザのリロード時に更新を反映し、再ビルドは不要です。
+
+フローチャート（CMS/バックエンド -> Live Syncサーバー -> アプリケーションサーバー -> フロントエンド）:
+
+![Live Sync フロー CMS/バックエンド/Live Syncサーバー/アプリケーションサーバー/フロントエンド スキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+動作の仕組み:
+
+![Live Sync ロジックスキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+## 開発ワークフロー（ローカル）
+
+- 開発中は、アプリケーション起動時にすべてのリモート辞書が取得されるため、更新をすばやくテストできます。
+- Next.jsでローカルにLive Syncをテストするには、開発サーバーをラップします：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... 他のスクリプト
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Vite用
+  },
+}
+```
+
+開発中にIntlayerがLiveインポート変換を適用するように最適化を有効にします：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true, // default: process.env.NODE_ENV === 'production'
+  },
+};
+
+export default config;
+```
+
+この設定により、開発サーバーがLive Syncサーバーでラップされ、起動時にリモート辞書を取得し、CMSからの更新をSSE経由でストリーミングします。変更を確認するにはページをリロードしてください。
+
+## 注意事項と制約
+
+- Live Sync のオリジンをサイトのセキュリティポリシー（CSP）に追加してください。Live Sync の URL が `connect-src`（および該当する場合は `frame-ancestors`）で許可されていることを確認してください。
+- Live Sync は静的出力では動作しません。Next.js の場合、ページはランタイムで更新を受け取るために動的である必要があります（例：完全な静的のみの制約を避けるために、`generateStaticParams`、`generateMetadata`、`getServerSideProps`、または `getStaticProps` を適切に使用してください）。
+- CMSでは、各辞書に`live`フラグがあります。`live=true`の辞書のみがライブ同期APIを通じて取得され、それ以外は動的にインポートされ、実行時には変更されません。
+- `live`フラグはビルド時に各辞書ごとに評価されます。ビルド時にリモートコンテンツが`live=true`に設定されていなかった場合、その辞書のライブ同期を有効にするには再ビルドが必要です。
+- ライブ同期サーバーは`.intlayer`に書き込み可能でなければなりません。コンテナ環境では`/.intlayer`への書き込み権限を確保してください。
+
+## 役立つリンク
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)
+- [Intlayer ビジュアルエディタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [セルフホスティングガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)

package/docs/ja/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-29
+updatedAt: 2026-07-08
 title: Intlayer v9の新機能
 description: Intlayer v9の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアントのサポートを導入します。
 keywords:
@@ -203,6 +203,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: コンテンツ露出の計測と A/B テスト
+
+新しいオプションパッケージ [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) は、実際にどのコンテンツが訪問者に表示されているかを教えてくれます。そして **Collections & Variants** の輪を完成させ、コンテンツの A/B テストとバリアントごとのコンバージョン計測を可能にします。
+
+- **プロバイダーレベルの計測**: `IntlayerProvider`（React / Next.js / React Native）は、初回読み込み、ルート変更、ロケール変更時に自動で `page_view` イベントを記録します。
+- **ノードレベルの計測**: `useIntlayer` が解決されるたびに `content_exposure` イベントが送信されます — どの辞書キー、キーパス、ロケール、そして（該当する場合は）どの A/B **バリアント** が表示されたか。フラッシュ間隔内の同一ノードへの重複露出は 1 件に集約されます。
+- **決定論的な A/B 割り当て**: `getVariant(experimentKey, variants)` はサーバーへの往復なしでセッションにバリアントを割り当てるため、初回描画前のちらつきがありません。
+- **`useConversion()`**: セッションが見たバリアントに対して、ゴール（登録、クリック、購入など）を紐づけます。
+- **未インストール時のコストはゼロ**: `@intlayer/editor` と同じ tree-shakeable パターンを採用 — `try/catch` でラップした動的 `import()` に加え、ビルド時の環境変数（`INTLAYER_ANALYTICS_ENABLED`）により、利用しないアプリでは統合全体がデッドコード除去されます。
+- **新しい設定スキーマなし**: 既存の `editor.backendURL`（送信先エンドポイント / セルフホスティング）と `editor.clientId`（プロジェクトキー、兼有効化スイッチ）を再利用します。
+- **プライバシーへの配慮**: セッションの匿名ハッシュ化（SHA-256、生の ID は保存しない）、IP は保存せず、国単位の大まかな位置情報のみ、リクエストはおよそ 20 秒ごとにバッチ送信されます。
+- **ダッシュボード**: 新しい **Analytics** ページ（プロジェクト選択後にサイドバーへ表示）で、アクティブユーザー数、本日のユーザー数、過去 7/30/90 日のユーザー数、訪問者推移グラフ、ロケール別・地域別の内訳を確認できます。
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+現在 React、Next.js、React Native（`react-intlayer` 経由）で利用可能です。他のフレームワークバインディング（Vue、Svelte、Angular など）は、`@intlayer/editor` と同じ展開パターンに沿って計画されています。完全なガイドは [Analytics ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) を参照してください。
+
+---
+
 ## Vite Plugin: バンドルされたコンパイラとプロキシ
 
 `intlayer()` Vite プラグインは、**コンパイラ**と**ロケールルーティングプロキシ**を直接バンドルするようになったため、ほとんどのプロジェクトは `vite.config.ts` に単一のプラグインのみが必要です：
@@ -324,5 +367,6 @@ v8からアップグレードする場合、v9には破壊的変更は含まれ
 
 - [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
 - [動的辞書 - コレクション、バリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [Analytics（分析） - コンテンツ露出の計測とA/Bテスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
 - [CMS SDK - @intlayer/api によるプログラムからのアクセス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)

package/docs/ko/cli/index.md

@@ -125,7 +125,7 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
 
 ### 인증
 
-- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/login.md)** - Intlayer CMS에 인증하고 액세스 자격 증명을 가져옵니다.
+- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/login.md)** - Intlayer CMS에 인증하고 액세스 자격 증명을 가져옵니다.
 
 ### 핵심 명령어
 

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: 구성 (Configuration)
 description: 애플리케이션에 Intlayer를 구성하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤설정하는 데 사용할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` 구성 추가"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * 애널리틱스(analytics) 구성.
+   */
+  analytics: {
+    /**
+     * 애널리틱스 수집 활성화 여부(페이지 뷰, 콘텐츠 노출, A/B 이벤트).
+     * 귀속(attribution)을 위해 `editor.clientId`가 설정되어 있어야 합니다.
+     * 기본값: false
+     */
+    enabled: true,
+
+    /**
+     * 백엔드로 자동 일괄 전송하는 간격(밀리초).
+     * 기본값: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * 기록할 세션의 비율, 0(없음)에서 1(전체) 사이.
+     * 기본값: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * AI 기반 번역 및 생성 설정.
    */
@@ -668,6 +695,20 @@ export default config;
 
 ---
 
+### 애널리틱스 구성 (Analytics)
+
+Intlayer 애널리틱스와 관련된 설정을 정의합니다: 사용자에게 실제로 표시되는 콘텐츠(페이지 뷰, 콘텐츠 노출)를 수집하고 콘텐츠에 대한 A/B 테스트를 지원합니다.
+
+애널리틱스는 철저히 옵트인(opt-in) 방식입니다: `analytics.enabled`가 명시적으로 `true`로 설정되고 **그리고** 귀속을 위한 프로젝트 키(`editor.clientId`)가 구성되지 않는 한 아무것도 수집되지 않습니다. 비활성화된 경우(기본값), 전체 애널리틱스 통합은 애플리케이션 번들에서 데드 코드 제거(dead-code elimination)됩니다.
+
+| 필드            | 설명                                                                | 타입      | 기본값  | 예시    | 참고                                                                                                                                  |
+| --------------- | ------------------------------------------------------------------- | --------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | 애널리틱스 수집을 활성화합니다(페이지 뷰, 콘텐츠 노출, A/B 이벤트). | `boolean` | `false` | `true`  | 귀속을 위해 `editor.clientId`가 설정되어 있어야 합니다. 설정되지 않으면 `enabled`가 `true`여도 애널리틱스는 비활성 상태로 유지됩니다. |
+| `flushInterval` | 백엔드로 자동 일괄 전송하는 간격(밀리초).                           | `number`  | `20000` | `10000` |                                                                                                                                       |
+| `sampleRate`    | 기록할 세션의 비율, `0`(없음)에서 `1`(전체) 사이.                   | `number`  | `1`     | `0.5`   | 샘플링은 세션별로 결정적이므로, 기록된 세션은 자신의 모든 이벤트를 보고합니다(부분 퍼널 없음).                                        |
+
+---
+
 ### 라우팅 구성 (Routing)
 
 URL 구조, 로케일 저장 및 미들웨어 처리를 포함하여 라우팅 동작을 제어하기 위한 설정입니다.