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

package/docs/vi/cli/index.md

@@ -125,7 +125,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 
 ### Xác thực
 
-- **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/login.md)** - Xác thực với Intlayer CMS và nhận thông tin xác thực truy cập
+- **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md)** - Xác thực với Intlayer CMS và nhận thông tin xác thực truy cập
 
 ### Các lệnh cốt lõi
 

package/docs/vi/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Cấu hình (Configuration)
 description: Tìm hiểu cách cấu hình Intlayer cho ứng dụng của bạn. Hiểu các cài đặt và tùy chọn khác nhau có sẵn để tùy chỉnh Intlayer theo nhu cầu của bạn.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Thêm cấu hình `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,
   },
 
+  /**
+   * Cấu hình phân tích (analytics).
+   */
+  analytics: {
+    /**
+     * Có bật thu thập dữ liệu phân tích hay không (lượt xem trang, hiển thị nội dung, sự kiện A/B).
+     * Yêu cầu phải thiết lập `editor.clientId` để phục vụ việc quy kết (attribution).
+     * Mặc định: false
+     */
+    enabled: true,
+
+    /**
+     * Số mili giây giữa các lần gửi hàng loạt tự động đến backend.
+     * Mặc định: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Tỷ lệ phiên được ghi lại, từ 0 (không có) đến 1 (tất cả).
+     * Mặc định: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Cài đặt cho các bản dịch và thế hệ (generation) bằng AI.
    */
@@ -668,6 +695,20 @@ Xác định cài đặt cho visual editor, bao gồm cổng máy chủ và tr
 
 ---
 
+### Cấu hình Phân tích (Analytics)
+
+Xác định các cài đặt liên quan đến phân tích của Intlayer: thu thập dữ liệu về nội dung thực sự được hiển thị cho người dùng (lượt xem trang, hiển thị nội dung) và hỗ trợ thử nghiệm A/B trên nội dung.
+
+Tính năng phân tích hoàn toàn là tùy chọn tham gia (opt-in): không có gì được thu thập trừ khi `analytics.enabled` được đặt rõ ràng thành `true` **và** một khóa dự án (`editor.clientId`) được cấu hình để quy kết. Khi bị vô hiệu hóa (mặc định), toàn bộ tích hợp phân tích sẽ bị loại bỏ khỏi gói ứng dụng của bạn (dead-code elimination).
+
+| Trường          | Mô tả                                                                            | Kiểu      | Mặc định | Ví dụ   | Ghi chú                                                                                                                                    |
+| --------------- | -------------------------------------------------------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `enabled`       | Bật thu thập dữ liệu phân tích (lượt xem trang, hiển thị nội dung, sự kiện A/B). | `boolean` | `false`  | `true`  | Yêu cầu phải thiết lập `editor.clientId` để phục vụ việc quy kết; nếu không, phân tích vẫn bị vô hiệu hóa ngay cả khi `enabled` là `true`. |
+| `flushInterval` | Số mili giây giữa các lần gửi hàng loạt tự động đến backend.                     | `number`  | `20000`  | `10000` |                                                                                                                                            |
+| `sampleRate`    | Tỷ lệ phiên được ghi lại, từ `0` (không có) đến `1` (tất cả).                    | `number`  | `1`      | `0.5`   | Việc lấy mẫu là xác định theo từng phiên, vì vậy một phiên được ghi lại sẽ báo cáo tất cả các sự kiện của nó (không có phễu một phần).     |
+
+---
+
 ### Cấu hình Routing (Routing)
 
 Cài đặt kiểm soát hành vi routing, bao gồm cấu trúc URL, lưu trữ locale và quản lý middleware.

package/docs/vi/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-07-08
 title: Intlayer CMS | Đưa nội dung của bạn ra ngoài vào Intlayer CMS
 description: Đưa nội dung của bạn ra ngoài vào Intlayer CMS để ủy quyền quản lý nội dung cho nhóm của bạn.
 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: "Chuyển phần 'Đồng bộ trực tiếp' sang trang riêng (live-sync.md), chỉ giữ lại phần giới thiệu ngắn gọn và liên kết ở đây"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Thêm tài liệu đồng bộ trực tiếp"
@@ -245,144 +248,7 @@ Sau đó, bạn sẽ có thể xem và quản lý từ điển của mình trong
 
 Live Sync cho phép ứng dụng của bạn phản ánh các thay đổi nội dung CMS trong thời gian chạy. Không cần xây dựng lại hoặc triển khai lại. Khi được bật, các cập nhật sẽ được truyền đến máy chủ Live Sync để làm mới các từ điển mà ứng dụng của bạn đang đọc.
 
-Bật Live Sync bằng cách cập nhật cấu hình Intlayer của bạn:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... các thiết lập cấu hình khác
-  editor: {
-    /**
-     * Bật tính năng tải lại nóng (hot reloading) cấu hình locale khi phát hiện thay đổi.
-     * Ví dụ, khi một từ điển được thêm hoặc cập nhật, ứng dụng sẽ cập nhật
-     * nội dung hiển thị trên trang.
-     *
-     * Vì tải lại nóng yêu cầu kết nối liên tục với máy chủ,
-     * tính năng này chỉ có sẵn cho khách hàng của gói `enterprise`.
-     *
-     * Mặc định: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Điều khiển cách các từ điển được nhập khẩu:
-     *
-     * - "live": Các từ điển được lấy động bằng cách sử dụng Live Sync API.
-     *   Thay thế useIntlayer bằng useDictionaryDynamic.
-     *
-     * Lưu ý: Chế độ live sử dụng Live Sync API để lấy từ điển. Nếu cuộc gọi API
-     * thất bại, các từ điển sẽ được nhập khẩu động.
-     * Lưu ý: Chỉ các từ điển có nội dung từ xa và cờ "live" mới sử dụng chế độ live.
-     * Các từ điển khác sử dụng chế độ động để tối ưu hiệu năng.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Khởi động server Live Sync để bao bọc ứng dụng của bạn:
-
-Ví dụ sử dụng server độc lập:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... các script khác
-    "live:start": "npx intlayer live",
-  },
-}
-```
-
-Bạn cũng có thể sử dụng server ứng dụng của mình song song bằng cách sử dụng đối số `--process`.
-
-Ví dụ sử dụng Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... các script khác
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Ví dụ sử dụng Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... các script khác
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Server Live Sync bao bọc ứng dụng của bạn và tự động áp dụng nội dung cập nhật khi nó đến.
-
-Để nhận thông báo thay đổi từ CMS, server Live Sync duy trì một kết nối SSE đến backend. Khi nội dung thay đổi trong CMS, backend chuyển tiếp bản cập nhật đến server Live Sync, server này sẽ ghi các từ điển mới. Ứng dụng của bạn sẽ phản ánh bản cập nhật trong lần điều hướng tiếp theo hoặc khi tải lại trình duyệt, không cần phải xây dựng lại.
-
-Sơ đồ luồng (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
-
-![Sơ đồ luồng Live Sync CMS/Backend/Live Sync Server/Application Server/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-Cách hoạt động:
-
-![Sơ đồ logic Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-### Quy trình phát triển (cục bộ)
-
-- Trong quá trình phát triển, tất cả các từ điển từ xa được lấy khi ứng dụng khởi động, giúp bạn có thể kiểm tra các cập nhật nhanh chóng.
-- Để thử nghiệm Live Sync cục bộ với Next.js, hãy bao bọc server phát triển của bạn:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... các script khác
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Dành cho Vite
-  },
-}
-```
-
-Bật tối ưu hóa để Intlayer áp dụng các biến đổi nhập khẩu Live trong quá trình phát triển:
-
-```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,
-  },
-};
-
-export default config;
-```
-
-Cấu hình này bao bọc server phát triển của bạn với server Live Sync, lấy các từ điển từ xa khi khởi động, và truyền các cập nhật từ CMS qua SSE. Tải lại trang để xem các thay đổi.
-
-Ghi chú và hạn chế:
-
-- Thêm nguồn gốc live sync vào chính sách bảo mật trang web của bạn (CSP). Đảm bảo URL live sync được phép trong `connect-src` (và `frame-ancestors` nếu có liên quan).
-- Live Sync không hoạt động với đầu ra tĩnh. Đối với Next.js, trang phải là động để nhận các cập nhật tại thời gian chạy (ví dụ: sử dụng `generateStaticParams`, `generateMetadata`, `getServerSideProps`, hoặc `getStaticProps` một cách phù hợp để tránh các hạn chế chỉ tĩnh hoàn toàn).
-- Trong CMS, mỗi từ điển có một cờ `live`. Chỉ những từ điển có `live=true` mới được lấy qua API live sync; những từ điển khác được nhập động và không thay đổi trong thời gian chạy.
-- Cờ `live` được đánh giá cho mỗi từ điển tại thời điểm build. Nếu nội dung từ xa không được đánh dấu `live=true` trong quá trình build, bạn phải build lại để kích hoạt Live Sync cho từ điển đó.
-- Server live sync phải có quyền ghi vào `.intlayer`. Trong các container, đảm bảo quyền ghi vào `/.intlayer`.
+Để xem hướng dẫn thiết lập đầy đủ (kích hoạt, khởi động máy chủ Live Sync, quy trình phát triển cục bộ và các giới hạn), xem [tài liệu Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/live-sync.md).
 
 ## Gỡ lỗi
 

package/docs/vi/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Đồng bộ trực tiếp (Live Sync) | Phản ánh thay đổi nội dung CMS theo thời gian thực
+description: Cho phép ứng dụng của bạn phản ánh các thay đổi nội dung của Intlayer CMS ngay khi chạy, không cần build lại hay triển khai lại.
+keywords:
+  - Đồng bộ trực tiếp
+  - Live Sync
+  - CMS
+  - Trình chỉnh sửa trực quan
+  - Quốc tế hóa
+  - Tài liệu
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Được tách từ tài liệu Intlayer CMS sang trang riêng"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Thêm tài liệu đồng bộ trực tiếp"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Thay thế trường `hotReload` bằng `liveSync`"
+author: aymericzip
+---
+
+# Đồng bộ trực tiếp (Live sync)
+
+Live Sync cho phép ứng dụng của bạn phản ánh các thay đổi nội dung CMS trong thời gian chạy. Không cần xây dựng lại hoặc triển khai lại. Khi được bật, các cập nhật sẽ được truyền đến máy chủ Live Sync để làm mới các từ điển mà ứng dụng của bạn đang đọc.
+
+## Mục lục
+
+<TOC/>
+
+---
+
+## Bật Đồng bộ trực tiếp
+
+Bật Live Sync bằng cách cập nhật cấu hình Intlayer của bạn:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... các thiết lập cấu hình khác
+  editor: {
+    /**
+     * Bật tính năng tải lại nóng (hot reloading) cấu hình locale khi phát hiện thay đổi.
+     * Ví dụ, khi một từ điển được thêm hoặc cập nhật, ứng dụng sẽ cập nhật
+     * nội dung hiển thị trên trang.
+     *
+     * Vì tải lại nóng yêu cầu kết nối liên tục với máy chủ,
+     * tính năng này chỉ có sẵn cho khách hàng của gói `enterprise`.
+     *
+     * Mặc định: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Điều khiển cách các từ điển được nhập khẩu:
+     *
+     * - "live": Các từ điển được lấy động bằng cách sử dụng Live Sync API.
+     *   Thay thế useIntlayer bằng useDictionaryDynamic.
+     *
+     * Lưu ý: Chế độ live sử dụng Live Sync API để lấy từ điển. Nếu cuộc gọi API
+     * thất bại, các từ điển sẽ được nhập khẩu động.
+     * Lưu ý: Chỉ các từ điển có nội dung từ xa và cờ "live" mới sử dụng chế độ live.
+     * Các từ điển khác sử dụng chế độ động để tối ưu hiệu năng.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Khởi động server Live Sync để bao bọc ứng dụng của bạn:
+
+Ví dụ sử dụng server độc lập:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... các script khác
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+Bạn cũng có thể sử dụng server ứng dụng của mình song song bằng cách sử dụng đối số `--process`.
+
+Ví dụ sử dụng Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... các script khác
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Ví dụ sử dụng Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... các script khác
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Server Live Sync bao bọc ứng dụng của bạn và tự động áp dụng nội dung cập nhật khi nó đến.
+
+Để nhận thông báo thay đổi từ CMS, server Live Sync duy trì một kết nối SSE đến backend. Khi nội dung thay đổi trong CMS, backend chuyển tiếp bản cập nhật đến server Live Sync, server này sẽ ghi các từ điển mới. Ứng dụng của bạn sẽ phản ánh bản cập nhật trong lần điều hướng tiếp theo hoặc khi tải lại trình duyệt, không cần phải xây dựng lại.
+
+Sơ đồ luồng (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
+
+![Sơ đồ luồng Live Sync CMS/Backend/Live Sync Server/Application Server/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+Cách hoạt động:
+
+![Sơ đồ logic Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+## Quy trình phát triển (cục bộ)
+
+- Trong quá trình phát triển, tất cả các từ điển từ xa được lấy khi ứng dụng khởi động, giúp bạn có thể kiểm tra các cập nhật nhanh chóng.
+- Để thử nghiệm Live Sync cục bộ với Next.js, hãy bao bọc server phát triển của bạn:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... các script khác
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Dành cho Vite
+  },
+}
+```
+
+Bật tối ưu hóa để Intlayer áp dụng các biến đổi nhập khẩu Live trong quá trình phát triển:
+
+```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,
+  },
+};
+
+export default config;
+```
+
+Cấu hình này bao bọc server phát triển của bạn với server Live Sync, lấy các từ điển từ xa khi khởi động, và truyền các cập nhật từ CMS qua SSE. Tải lại trang để xem các thay đổi.
+
+## Ghi chú và hạn chế
+
+- Thêm nguồn gốc live sync vào chính sách bảo mật trang web của bạn (CSP). Đảm bảo URL live sync được phép trong `connect-src` (và `frame-ancestors` nếu có liên quan).
+- Live Sync không hoạt động với đầu ra tĩnh. Đối với Next.js, trang phải là động để nhận các cập nhật tại thời gian chạy (ví dụ: sử dụng `generateStaticParams`, `generateMetadata`, `getServerSideProps`, hoặc `getStaticProps` một cách phù hợp để tránh các hạn chế chỉ tĩnh hoàn toàn).
+- Trong CMS, mỗi từ điển có một cờ `live`. Chỉ những từ điển có `live=true` mới được lấy qua API live sync; những từ điển khác được nhập động và không thay đổi trong thời gian chạy.
+- Cờ `live` được đánh giá cho mỗi từ điển tại thời điểm build. Nếu nội dung từ xa không được đánh dấu `live=true` trong quá trình build, bạn phải build lại để kích hoạt Live Sync cho từ điển đó.
+- Server live sync phải có quyền ghi vào `.intlayer`. Trong các container, đảm bảo quyền ghi vào `/.intlayer`.
+
+## Liên kết hữu ích
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md)
+- [Trình chỉnh sửa trực quan Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md)
+- [Tài liệu tham khảo cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)
+- [Hướng dẫn Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/self_hosting.md)

package/docs/vi/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-29
+updatedAt: 2026-07-08
 title: Intlayer v9 Mới - Có gì mới?
 description: Khám phá các tính năng mới trong Intlayer v9. Giới thiệu các package tương thích drop-in cho các thư viện i18n phổ biến và hỗ trợ Collections và Variants.
 keywords:
@@ -203,6 +203,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: theo dõi mức độ hiển thị nội dung & thử nghiệm A/B
+
+Một gói tùy chọn mới, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), cho bạn biết nội dung nào thực sự được hiển thị cho khách truy cập — và khép lại vòng lặp với **Collections & Variants** bằng cách cho phép bạn thử nghiệm A/B nội dung và đo lường chuyển đổi theo từng biến thể.
+
+- **Theo dõi ở cấp provider**: `IntlayerProvider` (React / Next.js / React Native) tự động ghi lại sự kiện `page_view` khi tải trang, khi chuyển route và khi đổi locale.
+- **Theo dõi ở cấp node**: mỗi lần `useIntlayer` được phân giải sẽ báo cáo một sự kiện `content_exposure` — khóa dictionary nào, key path nào, locale nào, và (nếu có) **biến thể** A/B nào đã được hiển thị. Các lần hiển thị lặp lại của cùng một node trong một cửa sổ flush sẽ được gộp lại thành một sự kiện.
+- **Phân bổ A/B tất định**: `getVariant(experimentKey, variants)` gán một biến thể cho mỗi phiên **mà không cần gọi ngược lại máy chủ**, vì vậy không có hiện tượng nhấp nháy trước lần render đầu tiên.
+- **`useConversion()`**: gán một mục tiêu (đăng ký, nhấp chuột, mua hàng…) cho biến thể mà phiên đã tiếp xúc.
+- **Không tốn chi phí nếu không cài đặt**: cùng mô hình tree-shakeable như `@intlayer/editor` — `import()` động được bọc trong `try/catch`, cộng với một biến môi trường tại thời điểm build (`INTLAYER_ANALYTICS_ENABLED`) giúp loại bỏ hoàn toàn tích hợp này khỏi bundle đối với các ứng dụng không sử dụng.
+- **Không có schema cấu hình mới**: tái sử dụng `editor.backendURL` (endpoint gửi dữ liệu / self-hosting) và `editor.clientId` (khóa dự án, đồng thời là công tắc bật/tắt).
+- **Tôn trọng quyền riêng tư**: băm ẩn danh phiên (SHA-256, không lưu id gốc), không lưu trữ IP, chỉ định vị địa lý thô ở cấp quốc gia, các yêu cầu được gửi theo lô khoảng mỗi 20 giây.
+- **Bảng điều khiển**: một trang **Analytics** mới (hiển thị trong thanh bên sau khi chọn dự án) hiển thị người dùng đang hoạt động, người dùng hôm nay, người dùng trong 7/30/90 ngày qua, biểu đồ biến động khách truy cập, và phân tích theo Locale so với Vị trí.
+
+```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
+```
+
+Đã khả dụng ngay hôm nay cho React, Next.js và React Native (thông qua `react-intlayer`); các liên kết framework khác (Vue, Svelte, Angular, …) đang được lên kế hoạch, theo cùng một mô hình triển khai như `@intlayer/editor`. Xem [tài liệu Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) để biết hướng dẫn đầy đủ.
+
+---
+
 ## Vite Plugin: Bundled Compiler & Proxy
 
 Plugin Vite `intlayer()` hiện đóng gói **compiler** và **locale-routing proxy** trực tiếp, vì vậy hầu hết các dự án chỉ cần một plugin duy nhất trong `vite.config.ts`:
@@ -324,5 +367,6 @@ Nếu bạn đang nâng cấp từ v8, lưu ý rằng v9 không bao gồm các b
 
 - [Hướng dẫn về Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/index.md)
 - [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/index.md)
+- [Analytics - Theo dõi mức độ hiển thị nội dung & thử nghiệm A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Tài liệu tham khảo cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)
 - [CMS SDK - Truy cập theo chương trình với @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md)

package/docs/zh/cli/index.md

@@ -125,7 +125,7 @@ Intlayer 接受多种配置文件格式：
 
 ### 身份验证
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/login.md)** - 在 Intlayer CMS 中进行身份验证并获取访问凭据
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/login.md)** - 在 Intlayer CMS 中进行身份验证并获取访问凭据
 
 ### 核心命令
 

package/docs/zh/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: 配置
 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 事件）。
+     * 需要设置 `editor.clientId` 以进行归因。
+     * 默认值：false
+     */
+    enabled: true,
+
+    /**
+     * 自动批量发送到后端之间的毫秒数。
+     * 默认值：20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * 要记录的会话比例，从 0（不记录）到 1（全部记录）。
+     * 默认值：1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * 使用 AI 进行翻译和生成的设置。
    */
@@ -671,6 +698,20 @@ export default config;
 
 ---
 
+### 分析配置 (Analytics)
+
+定义与 Intlayer 分析相关的设置：收集实际展示给用户的内容（页面浏览量、内容曝光），并支持内容的 A/B 测试。
+
+分析功能严格采用选择加入（opt-in）模式：除非将 `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 结构、区域设置存储和中间件管理。