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

package/docs/cs/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Konfigurace (Configuration)
 description: Naučte se, jak nakonfigurovat Intlayer pro vaši aplikaci. Porozumějte různým nastavením a možnostem dostupným pro přizpůsobení Intlayer vašim potřebám.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Přidána konfigurace `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: "Přidání možnosti `format` do konfigurace slovníku"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Konfigurace analytiky (analytics).
+   */
+  analytics: {
+    /**
+     * Zda je povoleno shromažďování analytiky (zobrazení stránek, expozice obsahu, A/B události).
+     * Vyžaduje nastavení `editor.clientId` pro atribuci.
+     * Výchozí: false
+     */
+    enabled: true,
+
+    /**
+     * Milisekundy mezi automatickým dávkovým odesíláním na backend.
+     * Výchozí: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Podíl relací k zaznamenání, od 0 (žádná) do 1 (všechny).
+     * Výchozí: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Nastavení překladů a generování pomocí AI.
    */
@@ -665,6 +695,20 @@ Definuje nastavení pro vestavěný vizuální editor, včetně portu serveru a
 
 ---
 
+### Konfigurace analytiky (Analytics)
+
+Definuje nastavení související s analytikou Intlayer: shromažďování informací o tom, jaký obsah je uživatelům skutečně zobrazován (zobrazení stránek, expozice obsahu), a podporu A/B testování obsahu.
+
+Analytika je striktně opt-in: nic se neshromažďuje, pokud není `analytics.enabled` explicitně nastaveno na `true` **a** není nakonfigurován projektový klíč (`editor.clientId`) pro atribuci. Je-li vypnuta (výchozí stav), celá integrace analytiky je odstraněna z balíčku vaší aplikace (dead-code elimination).
+
+| Pole            | Popis                                                                              | Typ       | Výchozí | Příklad | Poznámka                                                                                                                         |
+| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Povolí shromažďování analytiky (zobrazení stránek, expozice obsahu, A/B události). | `boolean` | `false` | `true`  | Vyžaduje nastavení `editor.clientId` pro atribuci; jinak analytika zůstává vypnutá, i když je `enabled` nastaveno na `true`.     |
+| `flushInterval` | Milisekundy mezi automatickým dávkovým odesíláním na backend.                      | `number`  | `20000` | `10000` |                                                                                                                                  |
+| `sampleRate`    | Podíl relací k zaznamenání, od `0` (žádná) do `1` (všechny).                       | `number`  | `1`     | `0.5`   | Vzorkování je deterministické pro každou relaci, takže zaznamenaná relace hlásí všechny své události (žádné částečné trychtýře). |
+
+---
+
 ### Konfigurace routování (Routing)
 
 Nastavení ovládající chování routování, včetně struktury URL, ukládání lokalit a správy middleware.

package/docs/de/cli/index.md

@@ -125,7 +125,7 @@ Um zu erfahren, wie Sie verfügbare Sprachen oder andere Parameter konfigurieren
 
 ### Authentifizierung
 
-- **[Anmelden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/login.md)** - Bei Intlayer CMS authentifizieren und Zugangsdaten erhalten
+- **[Anmelden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/login.md)** - Bei Intlayer CMS authentifizieren und Zugangsdaten erhalten
 
 ### Kernbefehle
 

package/docs/de/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Konfiguration (Configuration)
 description: Erfahren Sie, wie Sie Intlayer für Ihre Anwendung konfigurieren. Verstehen Sie die verschiedenen Einstellungen und Optionen, um Intlayer an Ihre Bedürfnisse anzupassen.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` Konfiguration hinzugefügt"
   - 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-Konfiguration.
+   */
+  analytics: {
+    /**
+     * Ob die Analytics-Erfassung aktiviert ist (Seitenaufrufe, Content-Expositionen, A/B-Ereignisse).
+     * Erfordert, dass `editor.clientId` für die Zuordnung gesetzt ist.
+     * Standard: false
+     */
+    enabled: true,
+
+    /**
+     * Millisekunden zwischen automatischen gebündelten Übertragungen an das Backend.
+     * Standard: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Anteil der zu erfassenden Sitzungen, von 0 (keine) bis 1 (alle).
+     * Standard: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * KI-gestützte Übersetzungs- und Generierungseinstellungen.
    */
@@ -671,6 +698,20 @@ Definiert Einstellungen für den integrierten Editor, einschließlich Server-Por
 
 ---
 
+### Analytics-Konfiguration (Analytics Configuration)
+
+Definiert Einstellungen für Intlayer Analytics: die Erfassung, welche Inhalte Nutzern tatsächlich angezeigt werden (Seitenaufrufe, Content-Expositionen), und die Unterstützung von A/B-Tests für Inhalte.
+
+Analytics ist streng Opt-in: Es wird nichts erfasst, es sei denn, `analytics.enabled` ist explizit auf `true` gesetzt **und** ein Projektschlüssel (`editor.clientId`) ist für die Zuordnung konfiguriert. Wenn deaktiviert (Standard), wird die gesamte Analytics-Integration aus Ihrem Anwendungs-Bundle per Dead-Code-Elimination entfernt.
+
+| Feld            | Beschreibung                                                                             | Typ       | Standard | Beispiel | Hinweis                                                                                                                                            |
+| --------------- | ---------------------------------------------------------------------------------------- | --------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Aktiviert die Analytics-Erfassung (Seitenaufrufe, Content-Expositionen, A/B-Ereignisse). | `boolean` | `false`  | `true`   | Erfordert, dass `editor.clientId` für die Zuordnung gesetzt ist; andernfalls bleibt Analytics deaktiviert, selbst wenn `enabled` auf `true` steht. |
+| `flushInterval` | Millisekunden zwischen automatischen gebündelten Übertragungen an das Backend.           | `number`  | `20000`  | `10000`  |                                                                                                                                                    |
+| `sampleRate`    | Anteil der zu erfassenden Sitzungen, von `0` (keine) bis `1` (alle).                     | `number`  | `1`      | `0.5`    | Das Sampling ist pro Sitzung deterministisch, sodass eine erfasste Sitzung alle ihre Ereignisse meldet (keine unvollständigen Funnels).            |
+
+---
+
 ### Routing-Konfiguration
 
 Einstellungen, die das Routing-Verhalten steuern, einschließlich URL-Struktur, Sprachspeicherung und Middleware-Handhabung.

package/docs/de/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Intlayer CMS | Externalisieren Sie Ihre Inhalte in das Intlayer CMS
 description: Externalisieren Sie Ihre Inhalte in das Intlayer CMS, um die Verwaltung Ihrer Inhalte an Ihr Team zu delegieren.
 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: "Abschnitt „Live-Synchronisation“ auf eine eigene Seite (live-sync.md) verschoben; hier nur eine kurze Einführung mit Link belassen"
   - version: 9.0.0
     date: 2026-06-30
     changes: "Self-Hosting-Abschnitt hinzugefügt: Docker Compose Bootstrap, Service-Inventar, SDK-Konfiguration, optionale Funktionen und Upgrade-Hinweise"
@@ -248,140 +251,7 @@ Anschließend können Sie Ihr Wörterbuch im [Intlayer CMS](https://app.intlayer
 
 Live Sync ermöglicht es Ihrer App, CMS-Inhaltsänderungen zur Laufzeit widerzuspiegeln. Kein Neuaufbau oder erneutes Bereitstellen erforderlich. Wenn aktiviert, werden Updates an einen Live-Sync-Server gestreamt, der die Wörterbücher aktualisiert, die Ihre Anwendung liest.
 
-> Live Sync erfordert eine kontinuierliche Serververbindung und ist im Enterprise-Plan verfügbar.
-
-Aktivieren Sie Live Sync, indem Sie Ihre Intlayer-Konfiguration aktualisieren:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... andere Konfigurationseinstellungen
-  editor: {
-    /**
-     * Aktiviert das Hot-Reloading der Lokalisierungskonfigurationen, wenn Änderungen erkannt werden.
-     * Zum Beispiel, wenn ein Wörterbuch hinzugefügt oder aktualisiert wird, aktualisiert die Anwendung
-     * den auf der Seite angezeigten Inhalt.
-     *
-     * Da Hot-Reloading eine kontinuierliche Verbindung zum Server erfordert, ist es
-     * nur für Kunden des `enterprise`-Plans verfügbar.
-     *
-     * Standard: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Steuert, wie Wörterbücher importiert werden:
-     *
-     * - "live": Wörterbücher werden dynamisch über die Live Sync API abgerufen.
-     *   Ersetzt useIntlayer durch useDictionaryDynamic.
-     *
-     * Hinweis: Der Live-Modus verwendet die Live Sync API, um Wörterbücher abzurufen. Wenn der API-Aufruf
-     * fehlschlägt, werden die Wörterbücher dynamisch importiert.
-     * Hinweis: Nur Wörterbücher mit entfernten Inhalten und dem "live"-Flag verwenden den Live-Modus.
-     * Andere verwenden den dynamischen Modus für bessere Leistung.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Starten Sie den Live Sync Server, um Ihre Anwendung einzubinden:
-
-Beispiel mit Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... andere Skripte
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Beispiel mit Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... andere Skripte
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Der Live Sync Server umschließt Ihre Anwendung und wendet automatisch aktualisierte Inhalte an, sobald diese eintreffen.
-
-Um Änderungsbenachrichtigungen vom CMS zu erhalten, hält der Live-Sync-Server eine SSE-Verbindung zum Backend aufrecht. Wenn sich Inhalte im CMS ändern, leitet das Backend die Aktualisierung an den Live-Sync-Server weiter, der die neuen Wörterbücher schreibt. Ihre Anwendung spiegelt die Aktualisierung bei der nächsten Navigation oder beim Neuladen des Browsers wider – ein Neubau ist nicht erforderlich.
-
-Flussdiagramm (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
-
-![Live Sync Logik Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-So funktioniert es:
-
-![Live Sync Ablauf CMS/Backend/Live Sync Server/Application Server/Frontend Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-### Entwicklungs-Workflow (lokal)
-
-- In der Entwicklung werden alle entfernten Wörterbücher beim Start der Anwendung abgerufen, sodass Sie Updates schnell testen können.
-- Um Live Sync lokal mit Next.js zu testen, umschließen Sie Ihren Dev-Server:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... andere Skripte
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Für Vite
-  },
-}
-```
-
-Aktivieren Sie die Optimierung, damit Intlayer während der Entwicklung die Live-Import-Transformationen anwendet:
-
-```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;
-```
-
-Diese Konfiguration umschließt Ihren Dev-Server mit dem Live Sync Server, lädt entfernte Wörterbücher beim Start und streamt Updates vom CMS über SSE. Aktualisieren Sie die Seite, um Änderungen zu sehen.
-
-Hinweise und Einschränkungen:
-
-- Fügen Sie die Live Sync-Quelle zu Ihrer Site-Sicherheitsrichtlinie (CSP) hinzu. Stellen Sie sicher, dass die Live Sync-URL in `connect-src` (und `frame-ancestors`, falls relevant) erlaubt ist.
-- Live Sync funktioniert nicht mit statischem Output. Für Next.js muss die Seite dynamisch sein, um zur Laufzeit Updates zu erhalten (z. B. verwenden Sie `generateStaticParams`, `generateMetadata`, `getServerSideProps` oder `getStaticProps` entsprechend, um vollständige statische Einschränkungen zu vermeiden).
-
-Diese Einrichtung bindet Ihren Entwicklungsserver mit dem Live-Sync-Server, lädt beim Start entfernte Wörterbücher und streamt Aktualisierungen vom CMS über SSE. Aktualisieren Sie die Seite, um Änderungen zu sehen.
-
-Hinweise und Einschränkungen:
-
-- Fügen Sie die Live-Sync-Quelle zu Ihrer Sicherheitsrichtlinie der Website (CSP) hinzu. Stellen Sie sicher, dass die Live-Sync-URL in `connect-src` (und `frame-ancestors`, falls relevant) erlaubt ist.
-- Live Sync funktioniert nicht mit statischer Ausgabe. Für Next.js muss die Seite dynamisch sein, um zur Laufzeit Updates zu erhalten (z. B. verwenden Sie `generateStaticParams`, `generateMetadata`, `getServerSideProps` oder `getStaticProps` entsprechend, um vollständige statische Einschränkungen zu vermeiden).
-- Im CMS hat jedes Wörterbuch ein `live`-Flag. Nur Wörterbücher mit `live=true` werden über die Live-Sync-API abgerufen; andere werden dynamisch importiert und bleiben zur Laufzeit unverändert.
-- Das `live`-Flag wird für jedes Wörterbuch zur Build-Zeit ausgewertet. Wenn der entfernte Inhalt während des Builds nicht mit `live=true` gekennzeichnet war, müssen Sie neu bauen, um Live Sync für dieses Wörterbuch zu aktivieren.
-- Der Live-Sync-Server muss in der Lage sein, in `.intlayer` zu schreiben. In Containern stellen Sie sicher, dass Schreibzugriff auf `/.intlayer` besteht.
+Die vollständige Anleitung (Aktivierung, Start des Live-Sync-Servers, lokaler Entwicklungsworkflow und Einschränkungen) finden Sie in der [Live-Sync-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/live-sync.md).
 
 ## Self-Hosting
 

package/docs/de/live-sync.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Live-Synchronisation | CMS-Inhaltsänderungen zur Laufzeit übernehmen
+description: Lassen Sie Ihre Anwendung CMS-Inhaltsänderungen zur Laufzeit widerspiegeln — ohne Neuerstellung oder erneutes Deployment.
+keywords:
+  - Live-Synchronisation
+  - Live Sync
+  - CMS
+  - Visueller Editor
+  - Internationalisierung
+  - Dokumentation
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Aus der Intlayer-CMS-Dokumentation in eine eigene Seite verschoben"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Live-Sync-Dokumentation hinzugefügt"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Ersetzte das Feld `hotReload` durch `liveSync`"
+author: aymericzip
+---
+
+# Live-Synchronisation
+
+Live Sync ermöglicht es Ihrer App, CMS-Inhaltsänderungen zur Laufzeit widerzuspiegeln. Kein Neuaufbau oder erneutes Bereitstellen erforderlich. Wenn aktiviert, werden Updates an einen Live-Sync-Server gestreamt, der die Wörterbücher aktualisiert, die Ihre Anwendung liest.
+
+## Inhaltsverzeichnis
+
+<TOC/>
+
+---
+
+## Live-Synchronisation aktivieren
+
+> Live Sync erfordert eine kontinuierliche Serververbindung und ist im Enterprise-Plan verfügbar.
+
+Aktivieren Sie Live Sync, indem Sie Ihre Intlayer-Konfiguration aktualisieren:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... andere Konfigurationseinstellungen
+  editor: {
+    /**
+     * Aktiviert das Hot-Reloading der Lokalisierungskonfigurationen, wenn Änderungen erkannt werden.
+     * Zum Beispiel, wenn ein Wörterbuch hinzugefügt oder aktualisiert wird, aktualisiert die Anwendung
+     * den auf der Seite angezeigten Inhalt.
+     *
+     * Da Hot-Reloading eine kontinuierliche Verbindung zum Server erfordert, ist es
+     * nur für Kunden des `enterprise`-Plans verfügbar.
+     *
+     * Standard: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Steuert, wie Wörterbücher importiert werden:
+     *
+     * - "live": Wörterbücher werden dynamisch über die Live Sync API abgerufen.
+     *   Ersetzt useIntlayer durch useDictionaryDynamic.
+     *
+     * Hinweis: Der Live-Modus verwendet die Live Sync API, um Wörterbücher abzurufen. Wenn der API-Aufruf
+     * fehlschlägt, werden die Wörterbücher dynamisch importiert.
+     * Hinweis: Nur Wörterbücher mit entfernten Inhalten und dem "live"-Flag verwenden den Live-Modus.
+     * Andere verwenden den dynamischen Modus für bessere Leistung.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Starten Sie den Live Sync Server, um Ihre Anwendung einzubinden:
+
+Beispiel mit Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... andere Skripte
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Beispiel mit Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... andere Skripte
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Der Live Sync Server umschließt Ihre Anwendung und wendet automatisch aktualisierte Inhalte an, sobald diese eintreffen.
+
+Um Änderungsbenachrichtigungen vom CMS zu erhalten, hält der Live-Sync-Server eine SSE-Verbindung zum Backend aufrecht. Wenn sich Inhalte im CMS ändern, leitet das Backend die Aktualisierung an den Live-Sync-Server weiter, der die neuen Wörterbücher schreibt. Ihre Anwendung spiegelt die Aktualisierung bei der nächsten Navigation oder beim Neuladen des Browsers wider – ein Neubau ist nicht erforderlich.
+
+Flussdiagramm (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
+
+![Live Sync Logik Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+So funktioniert es:
+
+![Live Sync Ablauf CMS/Backend/Live Sync Server/Application Server/Frontend Schema](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+## Entwicklungs-Workflow (lokal)
+
+- In der Entwicklung werden alle entfernten Wörterbücher beim Start der Anwendung abgerufen, sodass Sie Updates schnell testen können.
+- Um Live Sync lokal mit Next.js zu testen, umschließen Sie Ihren Dev-Server:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... andere Skripte
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Für Vite
+  },
+}
+```
+
+Aktivieren Sie die Optimierung, damit Intlayer während der Entwicklung die Live-Import-Transformationen anwendet:
+
+```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;
+```
+
+Diese Konfiguration umschließt Ihren Dev-Server mit dem Live Sync Server, lädt entfernte Wörterbücher beim Start und streamt Updates vom CMS über SSE. Aktualisieren Sie die Seite, um Änderungen zu sehen.
+
+## Hinweise und Einschränkungen
+
+- Fügen Sie die Live-Sync-Quelle zu Ihrer Sicherheitsrichtlinie der Website (CSP) hinzu. Stellen Sie sicher, dass die Live-Sync-URL in `connect-src` (und `frame-ancestors`, falls relevant) erlaubt ist.
+- Live Sync funktioniert nicht mit statischer Ausgabe. Für Next.js muss die Seite dynamisch sein, um zur Laufzeit Updates zu erhalten (z. B. verwenden Sie `generateStaticParams`, `generateMetadata`, `getServerSideProps` oder `getStaticProps` entsprechend, um vollständige statische Einschränkungen zu vermeiden).
+- Im CMS hat jedes Wörterbuch ein `live`-Flag. Nur Wörterbücher mit `live=true` werden über die Live-Sync-API abgerufen; andere werden dynamisch importiert und bleiben zur Laufzeit unverändert.
+- Das `live`-Flag wird für jedes Wörterbuch zur Build-Zeit ausgewertet. Wenn der entfernte Inhalt während des Builds nicht mit `live=true` gekennzeichnet war, müssen Sie neu bauen, um Live Sync für dieses Wörterbuch zu aktivieren.
+- Der Live-Sync-Server muss in der Lage sein, in `.intlayer` zu schreiben. In Containern stellen Sie sicher, dass Schreibzugriff auf `/.intlayer` besteht.
+
+## Nützliche Links
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md)
+- [Intlayer Visueller Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md)
+- [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
+- [Self-Hosting-Leitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/self_hosting.md)

package/docs/de/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Neues Intlayer v9 – Was ist neu?
 description: Entdecken Sie die Neuerungen in Intlayer v9. Einführung von Drop-in-Kompatibilitätspaketen für beliebte i18n-Bibliotheken und Unterstützung für Collections und Variants.
 keywords:
@@ -205,6 +205,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: Content-Exposure-Tracking & A/B-Tests
+
+Ein neues optionales Paket, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), zeigt Ihnen, welche Inhalte Ihren Besuchern tatsächlich angezeigt werden — und schließt damit den Kreis zu **Collections & Variants**, indem es Ihnen ermöglicht, Inhalte per A/B-Test zu testen und Conversions pro Variante zu messen.
+
+- **Tracking auf Provider-Ebene**: `IntlayerProvider` (React / Next.js / React Native) erfasst automatisch `page_view`-Ereignisse beim Laden, bei Routenwechseln und bei Sprachwechseln.
+- **Tracking auf Knotenebene**: Jede Auflösung von `useIntlayer` meldet ein `content_exposure`-Ereignis — welcher Dictionary-Schlüssel, Key-Path, welche Sprache und (falls zutreffend) welche A/B-**Variante** angezeigt wurde. Wiederholte Anzeigen desselben Knotens innerhalb eines Flush-Fensters werden zu einem Ereignis zusammengefasst.
+- **Deterministische A/B-Zuweisung**: `getVariant(experimentKey, variants)` weist jeder Sitzung eine Variante zu — **ohne Server-Roundtrip**, sodass kein Flackern vor dem ersten Rendering auftritt.
+- **`useConversion()`**: ordnet ein Ziel (Registrierung, Klick, Kauf …) der Variante zu, der die Sitzung ausgesetzt war.
+- **Keine Kosten, wenn nicht installiert**: gleiches tree-shakeable Muster wie bei `@intlayer/editor` — dynamischer, in `try/catch` gekapselter `import()`, plus eine Build-Zeit-Umgebungsvariable (`INTLAYER_ANALYTICS_ENABLED`), die die gesamte Integration für Apps, die sie nicht nutzen, per Dead-Code-Elimination entfernt.
+- **Kein neues Konfigurationsschema**: verwendet weiterhin `editor.backendURL` (Ingestion-Endpunkt / Self-Hosting) und `editor.clientId` (Projektschlüssel, zugleich Aktivierungsschalter).
+- **Datenschutzfreundlich**: anonymes Session-Hashing (SHA-256, keine Rohkennungen gespeichert), keine IP-Speicherung, nur grobe länderbasierte Geolokalisierung, gebündelte Anfragen etwa alle 20 Sekunden.
+- **Dashboard**: Eine neue **Analytics**-Seite (in der Seitenleiste sichtbar, sobald ein Projekt ausgewählt ist) zeigt aktive Nutzer, Nutzer heute, Nutzer der letzten 7/30/90 Tage, einen Besucherentwicklungsgraphen sowie Aufschlüsselungen nach Sprache und Standort.
+
+```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
+```
+
+Bereits heute verfügbar für React, Next.js und React Native (über `react-intlayer`); weitere Framework-Anbindungen (Vue, Svelte, Angular, …) sind geplant und folgen demselben Rollout-Muster wie `@intlayer/editor`. Die vollständige Anleitung finden Sie in der [Analytics-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md).
+
+---
+
 ## Vite Plugin: Bundled Compiler & Proxy
 
 Das `intlayer()` Vite Plugin bündelt nun den **Compiler** und den **Locale-Routing Proxy** direkt, sodass die meisten Projekte nur ein einzelnes Plugin in `vite.config.ts` benötigen:
@@ -353,6 +396,7 @@ Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält.
 
 - [Leitfaden für Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compat/index.md)
 - [Dynamische Dictionaries – Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)
+- [Analytics - Content-Exposure-Tracking & A/B-Tests](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
 - [CMS SDK – Programmatischer Zugriff mit @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md)
 - [Self-Hosting-Leitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/self_hosting.md)