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

package/docs/tr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Yeni Intlayer v9 - Yenilikler Neler?
 description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar ve Varyantlar desteği sunuluyor.
 keywords:
@@ -205,6 +205,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: içerik gösterim takibi ve A/B testi
+
+Yeni bir isteğe bağlı paket olan [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), ziyaretçilerinize gerçekte hangi içeriğin gösterildiğini bildirir — ve içerik üzerinde A/B testi yapmanıza ve varyant başına dönüşümleri ölçmenize olanak tanıyarak **Collections & Variants** döngüsünü tamamlar.
+
+- **Provider düzeyinde takip**: `IntlayerProvider` (React / Next.js / React Native) yükleme, rota değişikliği ve dil değişikliğinde otomatik olarak `page_view` olayları kaydeder.
+- **Node düzeyinde takip**: her `useIntlayer` çözümlemesi bir `content_exposure` olayı bildirir — hangi sözlük anahtarı, anahtar yolu, dil ve (varsa) hangi A/B **varyantı** gösterildiği. Bir flush penceresi içinde aynı düğümün tekrarlanan gösterimleri tek bir olayda birleştirilir.
+- **Deterministik A/B ataması**: `getVariant(experimentKey, variants)`, **sunucuya gidiş-dönüş olmadan** her oturuma bir varyant atar, bu nedenle ilk render öncesinde titreme olmaz.
+- **`useConversion()`**: bir hedefi (kayıt, tıklama, satın alma…) oturumun maruz kaldığı varyanta atfeder.
+- **Kurulu değilse sıfır maliyet**: `@intlayer/editor` ile aynı tree-shakeable desen — `try/catch` içine sarılmış dinamik `import()`, artı bunu etkinleştirmeyen uygulamalar için tüm entegrasyonu ölü kod olarak kaldıran bir derleme zamanı ortam değişkeni (`INTLAYER_ANALYTICS_ENABLED`).
+- **Yeni bir yapılandırma şeması yok**: mevcut `editor.backendURL` (gönderim uç noktası / kendi sunucunuzda barındırma) ve `editor.clientId` (proje anahtarı, aynı zamanda etkinleştirme anahtarı) yeniden kullanılır.
+- **Gizliliğe saygılı**: anonim oturum hashleme (SHA-256, ham kimlikler saklanmaz), IP saklanmaz, yalnızca kaba ülke düzeyinde konum, istekler yaklaşık her 20 saniyede bir toplu olarak gönderilir.
+- **Kontrol paneli**: bir proje seçildikten sonra kenar çubuğunda görünen yeni bir **Analytics** sayfası; aktif kullanıcıları, bugünkü kullanıcıları, son 7/30/90 gündeki kullanıcıları, bir ziyaretçi gelişim grafiğini ve Yerel Ayar/Konum dağılımlarını gösterir.
+
+```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
+```
+
+Bugün React, Next.js ve React Native (`react-intlayer` üzerinden) için kullanılabilir; diğer framework bağlamaları (Vue, Svelte, Angular, …) `@intlayer/editor` ile aynı yayılma desenini izleyerek planlanmaktadır. Tam kılavuz için [Analytics belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) bakın.
+
+---
+
 ## Vite Plugin: Bundled Compiler & Proxy
 
 `intlayer()` Vite eklentisi artık **compiler** ve **locale-routing proxy**'i doğrudan içeriyor, bu nedenle çoğu proje `vite.config.ts` içinde yalnızca tek bir eklentiye ihtiyaç duyuyor:
@@ -338,6 +381,7 @@ v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking chan
 
 - [Compat Adapter Paketleri Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md)
 - [Dinamik Sözlükler - Koleksiyonlar ve Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
+- [Analytics - İçerik gösterim takibi ve A/B testi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
 - [CMS SDK - @intlayer/api ile programatik erişim](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
 - [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)

package/docs/uk/cli/index.md

@@ -125,7 +125,7 @@ Intlayer приймає кілька форматів файлів конфіг
 
 ### Автентифікація
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
 
 ### Основні команди
 

package/docs/uk/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.
    */
@@ -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, зберігання локалі та керування проміжним ПЗ.

package/docs/uk/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-30
+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» перенесено на окрему сторінку (live-sync.md), тут залишено короткий вступ і посилання"
   - version: 9.0.0
     date: 2026-06-30
     changes: "Додано розділ «Самостійне розгортання»"
@@ -248,144 +251,7 @@ bun x intlayer dictionary push -d my-first-dictionary-key --env production
 
 Live Sync дозволяє вашому застосунку відображати зміни контенту з CMS під час виконання. Немає потреби у перебудові або повторному розгортанні. Коли увімкнено, оновлення передаються на сервер Live Sync, який оновлює словники, які читає ваш застосунок.
 
-Увімкніть Live Sync, оновивши конфігурацію Intlayer:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... other configuration settings
-  editor: {
-    /**
-     * Увімкнення гарячого перезавантаження конфігурацій локалей при виявленні змін.
-     * Наприклад, коли словник додається або оновлюється, застосунок оновлює
-     * вміст, що відображається на сторінці.
-     *
-     * Оскільки гаряче перезавантаження вимагає постійного з'єднання з сервером,
-     * воно доступне лише клієнтам плану `enterprise`.
-     *
-     * За замовчуванням: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Керує способом імпорту словників:
-     *
-     * - "live": словники завантажуються динамічно за допомогою Live Sync API.
-     *   Замінює useIntlayer на useDictionaryDynamic.
-     *
-     * Примітка: режим live використовує Live Sync API для отримання словників. Якщо виклик API
-     * не вдасться, словники імпортуються динамічно.
-     * Примітка: режим live використовується лише для словників з віддаленим контентом і прапорцем "live".
-     * Інші використовують динамічний режим для кращої продуктивності.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Запустіть Live Sync сервер, щоб обгорнути ваш додаток:
-
-Приклад із окремим (standalone) сервером:
-
-```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/Backend -> Live Sync Server -> Application Server -> Frontend):
-
-![Схема потоку Live Sync (CMS/Backend -> Live Sync Server -> Application Server -> Frontend)](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)
-
-### Робочий процес розробки (локально)
-
-- Під час розробки всі віддалені словники завантажуються при запуску застосунку, тож ви можете швидко тестувати оновлення.
-- Щоб протестувати Live Sync локально з Next.js, обгорніть ваш dev-сервер:
-
-```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,
-  },
-};
-
-export default config;
-```
-
-Ця конфігурація обгортає ваш dev-сервер Live Sync-сервером, завантажує віддалені словники при старті та передає оновлення з CMS через SSE. Оновіть сторінку, щоб побачити зміни.
-
-Примітки та обмеження:
-
-- Додайте origin Live Sync до політики безпеки вашого сайту (CSP). Переконайтеся, що URL Live Sync дозволений у `connect-src` (і в `frame-ancestors`, якщо це доречно).
-- Live Sync не працює зі статичним виводом. Для Next.js сторінка має бути динамічною, щоб отримувати оновлення під час виконання (наприклад, використовуйте `generateStaticParams`, `generateMetadata`, `getServerSideProps` або `getStaticProps` відповідно, щоб уникнути повного обмеження лише статикою).
-- У CMS кожний словник має прапорець `live`. Лише словники з `live=true` завантажуються через API live sync; інші імпортуються динамічно і залишаються незмінними під час виконання.
-- Прапорець `live` оцінюється для кожного словника під час збірки. Якщо віддалений контент не мав `live=true` під час збірки, потрібно перебудувати проект, щоб увімкнути Live Sync для цього словника.
-- Сервер live sync має мати можливість записувати в `.intlayer`. У контейнерах переконайтеся, що є права запису до `/.intlayer`.
+Повний посібник з налаштування (увімкнення, запуск сервера Live Sync, локальний робочий процес розробки та обмеження) наведено в [документації Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/live-sync.md).
 
 ## Самостійне розгортання (Self-Hosting)
 

package/docs/uk/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Live Sync | Відображення змін контенту 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: "Додано документацію `liveSync`"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Замінено поле `hotReload` на `liveSync`"
+author: aymericzip
+---
+
+# Live Sync
+
+Live Sync дозволяє вашому застосунку відображати зміни контенту з CMS під час виконання. Немає потреби у перебудові або повторному розгортанні. Коли увімкнено, оновлення передаються на сервер Live Sync, який оновлює словники, які читає ваш застосунок.
+
+## Зміст
+
+<TOC/>
+
+---
+
+## Увімкнення Live Sync
+
+Увімкніть Live Sync, оновивши конфігурацію Intlayer:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... other configuration settings
+  editor: {
+    /**
+     * Увімкнення гарячого перезавантаження конфігурацій локалей при виявленні змін.
+     * Наприклад, коли словник додається або оновлюється, застосунок оновлює
+     * вміст, що відображається на сторінці.
+     *
+     * Оскільки гаряче перезавантаження вимагає постійного з'єднання з сервером,
+     * воно доступне лише клієнтам плану `enterprise`.
+     *
+     * За замовчуванням: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Керує способом імпорту словників:
+     *
+     * - "live": словники завантажуються динамічно за допомогою Live Sync API.
+     *   Замінює useIntlayer на useDictionaryDynamic.
+     *
+     * Примітка: режим live використовує Live Sync API для отримання словників. Якщо виклик API
+     * не вдасться, словники імпортуються динамічно.
+     * Примітка: режим live використовується лише для словників з віддаленим контентом і прапорцем "live".
+     * Інші використовують динамічний режим для кращої продуктивності.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Запустіть Live Sync сервер, щоб обгорнути ваш додаток:
+
+Приклад із окремим (standalone) сервером:
+
+```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/Backend -> Live Sync Server -> Application Server -> Frontend):
+
+![Схема потоку Live Sync (CMS/Backend -> Live Sync Server -> Application Server -> Frontend)](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)
+
+## Робочий процес розробки (локально)
+
+- Під час розробки всі віддалені словники завантажуються при запуску застосунку, тож ви можете швидко тестувати оновлення.
+- Щоб протестувати Live Sync локально з Next.js, обгорніть ваш dev-сервер:
+
+```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,
+  },
+};
+
+export default config;
+```
+
+Ця конфігурація обгортає ваш dev-сервер Live Sync-сервером, завантажує віддалені словники при старті та передає оновлення з CMS через SSE. Оновіть сторінку, щоб побачити зміни.
+
+## Примітки та обмеження
+
+- Додайте origin Live Sync до політики безпеки вашого сайту (CSP). Переконайтеся, що URL Live Sync дозволений у `connect-src` (і в `frame-ancestors`, якщо це доречно).
+- Live Sync не працює зі статичним виводом. Для Next.js сторінка має бути динамічною, щоб отримувати оновлення під час виконання (наприклад, використовуйте `generateStaticParams`, `generateMetadata`, `getServerSideProps` або `getStaticProps` відповідно, щоб уникнути повного обмеження лише статикою).
+- У CMS кожний словник має прапорець `live`. Лише словники з `live=true` завантажуються через API live sync; інші імпортуються динамічно і залишаються незмінними під час виконання.
+- Прапорець `live` оцінюється для кожного словника під час збірки. Якщо віддалений контент не мав `live=true` під час збірки, потрібно перебудувати проект, щоб увімкнути Live Sync для цього словника.
+- Сервер live sync має мати можливість записувати в `.intlayer`. У контейнерах переконайтеся, що є права запису до `/.intlayer`.
+
+## Корисні посилання
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md)
+- [Візуальний редактор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md)
+- [Довідник з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md)
+- [Посібник із самостійного розгортання](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md)

package/docs/uk/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Новий Intlayer v9 - Що нового?
 description: Дізнайтеся, що нового в Intlayer v9. Представляємо сумісні пакети швидкої заміни (drop-in) для популярних бібліотек i18n та підтримку Collections та Variants.
 keywords:
@@ -204,6 +204,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()`**: прив'язує ціль (реєстрація, клік, покупка…) до варіанту, який бачила сесія.
+- **Нульова вартість без встановлення**: той самий tree-shakeable підхід, що й у `@intlayer/editor` — динамічний `import()`, обгорнутий у `try/catch`, плюс змінна середовища часу збірки (`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: Bundled Compiler & Proxy
 
 Плагін Vite `intlayer()` тепер об'єднує **компілятор** та **проксі для маршрутизації локалей** безпосередньо, тому більшості проектів потрібен лише один плагін у `vite.config.ts`:
@@ -350,6 +393,7 @@ Chromium (що використовується для генерації зні
 
 - [Посібник з пакетів адаптерів сумісності (Compat Adapter Packages)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md)
 - [Динамічні словники - Collections та Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/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/uk/configuration.md)
 - [CMS SDK — програмний доступ через @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md)
 - [Посібник із самостійного розгортання](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md)

package/docs/ur/cli/index.md

@@ -125,7 +125,7 @@ Intlayer کئی کنفیگریشن فائل فارمیٹس قبول کرتا ہ
 
 ### توثیق (Authentication)
 
-- **[لاگ ان](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/login.md)** - Intlayer CMS سے توثیق کریں اور رسائی کی اسناد حاصل کریں
+- **[لاگ ان](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/login.md)** - Intlayer CMS سے توثیق کریں اور رسائی کی اسناد حاصل کریں
 
 ### بنیادی کمانڈز
 

package/docs/ur/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: ترتیب (Configuration)
 description: سیکھیں کہ اپنی ایپلیکیشن کے لیے Intlayer کو کیسے ترتیب دینا ہے۔ اپنی ضروریات کے مطابق Intlayer کو اپنی مرضی کے مطابق بنانے کے لیے دستیاب مختلف ترتیبات اور اختیارات کو سمجھیں۔
 keywords:
@@ -16,6 +16,12 @@ 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"
   - version: 8.10.0
     date: 2026-06-17
     changes: "ڈکشنری کی ترتیب میں `format` کا اختیار شامل کیا گیا"
@@ -354,6 +360,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * اینالیٹکس (analytics) کنفیگریشن۔
+   */
+  analytics: {
+    /**
+     * کیا اینالیٹکس ڈیٹا اکٹھا کرنا فعال ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔
+     * ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے۔
+     * ڈیفالٹ: false
+     */
+    enabled: true,
+
+    /**
+     * بیک اینڈ کو خودکار بیچ ارسال کے درمیان ملی سیکنڈز۔
+     * ڈیفالٹ: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * ریکارڈ کیے جانے والے سیشنز کا تناسب، 0 (کوئی نہیں) سے 1 (تمام) تک۔
+     * ڈیفالٹ: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * AI کے ذریعے ترجمہ اور تیاری کی ترتیبات۔
    */
@@ -667,6 +697,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`   | سیمپلنگ فی سیشن یقینی (deterministic) ہے، اس لیے ایک ریکارڈ شدہ سیشن اپنے تمام ایونٹس کی رپورٹ کرتا ہے۔                    |
+
+---
+
 ### راؤٹنگ کنفیگریشن (Routing)
 
 ترتیبات جو راؤٹنگ کے رویے کو کنٹرول کرتی ہیں، بشمول URL کا ڈھانچہ، لوکل اسٹوریج، اور مڈل ویئر ہینڈلنگ۔