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

package/docs/ko/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: "Self-Hosting 섹션 추가: Docker Compose 부트스트랩, 서비스 인벤토리, SDK 구성, 선택적 기능 및 업그레이드 참고 사항"
@@ -403,146 +406,7 @@ await pushDictionaries([{ key: "home", content: { title: "Home" } }]);
 
 라이브 동기화는 앱이 런타임에 CMS 콘텐츠 변경 사항을 반영할 수 있게 합니다. 재빌드나 재배포가 필요 없습니다. 활성화되면 업데이트가 라이브 동기화 서버로 스트리밍되어 애플리케이션이 읽는 사전을 갱신합니다.
 
-> Live Sync는 지속적인 서버 연결이 필요하며 엔터프라이즈 플랜에서만 사용할 수 있습니다.
-
-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 서버로 전달하고, Live Sync 서버는 새로운 사전을 기록합니다. 애플리케이션은 다음 탐색 또는 브라우저 새로고침 시 업데이트를 반영하며, 재빌드가 필요하지 않습니다.
-
-플로우 차트 (CMS/백엔드 -> Live Sync 서버 -> 애플리케이션 서버 -> 프론트엔드):
-
-![Live Sync Flow CMS/Backend/Live Sync Server/Application Server/Frontend Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-작동 방식:
-
-![Live Sync Logic Schema](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 import 변환을 적용하도록 최적화를 활성화하세요:
-
-```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, // 기본값: process.env.NODE_ENV === 'production'
-  },
-};
-
-export default config;
-```
-
-이 설정은 개발 서버를 Live Sync 서버와 래핑하고, 시작 시 원격 사전을 가져오며, CMS에서 SSE를 통해 업데이트를 스트리밍합니다. 변경 사항을 보려면 페이지를 새로 고치세요.
-
-참고 사항 및 제약 조건:
-
-- 라이브 싱크 출처를 사이트 보안 정책(CSP)에 추가하세요. 라이브 싱크 URL이 `connect-src`(및 관련이 있다면 `frame-ancestors`)에 허용되어 있는지 확인하세요.
-- 라이브 싱크는 정적 출력과 함께 작동하지 않습니다. 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/ko/live-sync.md)를 참조하세요.
 
 ## 자체 호스팅
 

package/docs/ko/live-sync.md

@@ -0,0 +1,187 @@
+---
+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/>
+
+---
+
+## 라이브 동기화 활성화
+
+> Live Sync는 지속적인 서버 연결이 필요하며 엔터프라이즈 플랜에서만 사용할 수 있습니다.
+
+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 서버로 전달하고, Live Sync 서버는 새로운 사전을 기록합니다. 애플리케이션은 다음 탐색 또는 브라우저 새로고침 시 업데이트를 반영하며, 재빌드가 필요하지 않습니다.
+
+플로우 차트 (CMS/백엔드 -> Live Sync 서버 -> 애플리케이션 서버 -> 프론트엔드):
+
+![Live Sync Flow CMS/Backend/Live Sync Server/Application Server/Frontend Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+작동 방식:
+
+![Live Sync Logic Schema](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 import 변환을 적용하도록 최적화를 활성화하세요:
+
+```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, // 기본값: process.env.NODE_ENV === 'production'
+  },
+};
+
+export default config;
+```
+
+이 설정은 개발 서버를 Live Sync 서버와 래핑하고, 시작 시 원격 사전을 가져오며, CMS에서 SSE를 통해 업데이트를 스트리밍합니다. 변경 사항을 보려면 페이지를 새로 고치세요.
+
+## 참고 사항 및 제약 조건
+
+- 라이브 싱크 출처를 사이트 보안 정책(CSP)에 추가하세요. 라이브 싱크 URL이 `connect-src`(및 관련이 있다면 `frame-ancestors`)에 허용되어 있는지 확인하세요.
+- 라이브 싱크는 정적 출력과 함께 작동하지 않습니다. 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/ko/intlayer_CMS.md)
+- [Intlayer 비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)
+- [구성 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)
+- [자체 호스팅 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md)

package/docs/ko/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 라이브러리를 위한 드롭인 호환성 패키지와 컬렉션(Collections), 베리언트(Variants) 지원을 소개합니다.
 keywords:
@@ -202,6 +202,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 **변형**이 표시되었는지. 플러시 창 내에서 동일 노드에 대한 반복 노출은 하나의 이벤트로 병합됩니다.
+- **결정론적 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`에서 단일 플러그인만 필요합니다:
@@ -323,5 +366,6 @@ v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는
 
 - [호환 어댑터 패키지 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)
 - [동적 딕셔너리 - 컬렉션 및 베리언트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/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/ko/configuration.md)
 - [CMS SDK - @intlayer/api를 통한 프로그래밍 방식 접근](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)

package/docs/nl/cli/index.md

@@ -125,7 +125,7 @@ Om te zien hoe u beschikbare talen of andere parameters configureert, raadpleegt
 
 ### Authenticatie
 
-- **[Inloggen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/login.md)** - Authenticeren bij het Intlayer CMS en inloggegevens verkrijgen
+- **[Inloggen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/cli/login.md)** - Authenticeren bij het Intlayer CMS en inloggegevens verkrijgen
 
 ### Kerncommando's
 

package/docs/nl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Configuratie (Configuration)
 description: Leer hoe u Intlayer configureert voor uw applicatie. Begrijp de verschillende instellingen en opties die beschikbaar zijn om Intlayer aan uw behoeften aan te passen.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` configuratie toegevoegd"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Optie `format` toegevoegd aan de woordenboekconfiguratie"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Analytics-configuratie.
+   */
+  analytics: {
+    /**
+     * Of het verzamelen van analytics is ingeschakeld (paginaweergaven, content-exposities, A/B-events).
+     * Vereist dat `editor.clientId` is ingesteld voor attributie.
+     * Standaard: false
+     */
+    enabled: true,
+
+    /**
+     * Milliseconden tussen automatische gebundelde verzendingen naar de backend.
+     * Standaard: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Fractie van sessies om te registreren, van 0 (geen) tot 1 (alle).
+     * Standaard: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Instellingen voor vertalingen en genereren met behulp van AI.
    */
@@ -665,6 +695,20 @@ Definieert de instellingen voor de ingebouwde visuele editor, inclusief de serve
 
 ---
 
+### Analytics-configuratie (Analytics)
+
+Definieert instellingen voor Intlayer analytics: het verzamelen van welke content daadwerkelijk aan gebruikers wordt getoond (paginaweergaven, content-exposities) en het mogelijk maken van A/B-testen op content.
+
+Analytics is strikt opt-in: er wordt niets verzameld tenzij `analytics.enabled` expliciet is ingesteld op `true` **en** een projectsleutel (`editor.clientId`) is geconfigureerd voor attributie. Wanneer uitgeschakeld (standaard) wordt de volledige analytics-integratie uit uw applicatiebundel verwijderd (dead-code elimination).
+
+| Veld            | Beschrijving                                                                                | Type      | Standaard | Voorbeeld | Opmerking                                                                                                                               |
+| --------------- | ------------------------------------------------------------------------------------------- | --------- | --------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Schakelt het verzamelen van analytics in (paginaweergaven, content-exposities, A/B-events). | `boolean` | `false`   | `true`    | Vereist dat `editor.clientId` is ingesteld voor attributie; anders blijft analytics uitgeschakeld, zelfs als `enabled` op `true` staat. |
+| `flushInterval` | Milliseconden tussen automatische gebundelde verzendingen naar de backend.                  | `number`  | `20000`   | `10000`   |                                                                                                                                         |
+| `sampleRate`    | Fractie van sessies om te registreren, van `0` (geen) tot `1` (alle).                       | `number`  | `1`       | `0.5`     | Sampling is deterministisch per sessie, zodat een geregistreerde sessie al zijn events rapporteert (geen gedeeltelijke funnels).        |
+
+---
+
 ### Routingconfiguratie (Routing)
 
 Instellingen die het gedrag van routing regelen, inclusief URL-structuur, opslag van locales en beheer van middleware.

package/docs/pl/cli/index.md

@@ -125,7 +125,7 @@ Aby dowiedzieć się, jak skonfigurować dostępne języki lub inne parametry, z
 
 ### Uwierzytelnianie
 
-- **[Zaloguj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/login.md)** - Uwierzytelnij się w Intlayer CMS i uzyskaj dane dostępu
+- **[Zaloguj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/login.md)** - Uwierzytelnij się w Intlayer CMS i uzyskaj dane dostępu
 
 ### Polecenia Podstawowe
 

package/docs/pl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Dodano konfigurację `analytics`"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Dodano opcję `format` do konfiguracji słownika"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Konfiguracja analityki (analytics).
+   */
+  analytics: {
+    /**
+     * Czy zbieranie danych analitycznych jest włączone (odsłony strony, ekspozycje treści, zdarzenia A/B).
+     * Wymaga ustawienia `editor.clientId` na potrzeby atrybucji.
+     * Domyślnie: false
+     */
+    enabled: true,
+
+    /**
+     * Milisekundy między automatycznymi zbiorczymi wysyłkami do backendu.
+     * Domyślnie: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Ułamek sesji do rejestrowania, od 0 (brak) do 1 (wszystkie).
+     * Domyślnie: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Ustawienia tłumaczenia i generowania opartego na AI.
    */
@@ -665,6 +695,20 @@ Definiuje ustawienia edytora wizualnego, w tym port serwera i status aktywacji.
 
 ---
 
+### Konfiguracja analityki (Analytics)
+
+Definiuje ustawienia związane z analityką Intlayer: zbieranie informacji o tym, jakie treści są faktycznie wyświetlane użytkownikom (odsłony strony, ekspozycje treści) oraz obsługę testów A/B treści.
+
+Analityka jest ściśle opt-in: nic nie jest zbierane, dopóki `analytics.enabled` nie zostanie jawnie ustawione na `true` **i** nie skonfigurowano klucza projektu (`editor.clientId`) na potrzeby atrybucji. Gdy jest wyłączona (domyślnie), cała integracja analityczna jest usuwana z pakietu aplikacji (dead-code elimination).
+
+| Pole            | Opis                                                                                      | Typ       | Domyślnie | Przykład | Uwaga                                                                                                                                             |
+| --------------- | ----------------------------------------------------------------------------------------- | --------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Włącza zbieranie danych analitycznych (odsłony strony, ekspozycje treści, zdarzenia A/B). | `boolean` | `false`   | `true`   | Wymaga ustawienia `editor.clientId` na potrzeby atrybucji; w przeciwnym razie analityka pozostaje wyłączona, nawet jeśli `enabled` wynosi `true`. |
+| `flushInterval` | Milisekundy między automatycznymi zbiorczymi wysyłkami do backendu.                       | `number`  | `20000`   | `10000`  |                                                                                                                                                   |
+| `sampleRate`    | Ułamek sesji do rejestrowania, od `0` (brak) do `1` (wszystkie).                          | `number`  | `1`       | `0.5`    | Próbkowanie jest deterministyczne dla sesji, więc zarejestrowana sesja raportuje wszystkie swoje zdarzenia (bez częściowych lejków).              |
+
+---
+
 ### Konfiguracja routingu (Routing)
 
 Ustawienia kontrolujące zachowanie routingu, w tym strukturę URL, przechowywanie locale i obsługę middleware.