docs: update tracker script document

Author: moonrailgun

website/docs/website/track-script.md

@@ -22,6 +22,8 @@ you can get this script code from your **Tianji** website list
 
 This is a very common method in website analysis. You can use it quickly get it by using **Tianji**.
 
+### Basic Usage
+
 After you inject script code into your website, you just need add a `data-tianji-event` in dom attribute.
 
 for example:
@@ -32,6 +34,90 @@ for example:
 
 Now, when user click this button, your dashboard will receive new event
 
+### Attach Event Data
+
+You can attach additional data to your events by using `data-tianji-event-{key}` attributes. Any attribute matching this pattern will be collected and sent with the event.
+
+```html
+<button 
+  data-tianji-event="purchase" 
+  data-tianji-event-product="Premium Plan"
+  data-tianji-event-price="99"
+  data-tianji-event-currency="USD">
+  Buy Now
+</button>
+```
+
+This will send an event named `purchase` with the following data:
+```json
+{
+  "product": "Premium Plan",
+  "price": "99",
+  "currency": "USD"
+}
+```
+
+### Track Link Clicks
+
+When using `data-tianji-event` on anchor (`<a>`) tags, **Tianji** handles them specially to ensure the event is tracked before navigation:
+
+```html
+<a href="/pricing" data-tianji-event="view-pricing">Check Pricing</a>
+```
+
+For internal links (not opening in new tab), the tracker will:
+1. Prevent the default navigation
+2. Send the tracking event
+3. Navigate to the target URL after tracking completes
+
+For external links or links with `target="_blank"`, the event is tracked without blocking the navigation.
+
+### JavaScript API
+
+After the tracker script is loaded, you can also track events programmatically using the `window.tianji` object.
+
+#### Track Custom Events
+
+```javascript
+// Simple event tracking
+window.tianji.track('button-clicked');
+
+// Event with custom data
+window.tianji.track('purchase', {
+  product: 'Premium Plan',
+  price: 99,
+  currency: 'USD'
+});
+
+// Track with custom payload object
+window.tianji.track({
+  website: 'your-website-id',
+  name: 'custom-event',
+  data: { key: 'value' }
+});
+
+// Track using a function (receives current page info)
+window.tianji.track((payload) => ({
+  ...payload,
+  name: 'dynamic-event',
+  data: { timestamp: Date.now() }
+}));
+```
+
+#### Identify Users
+
+You can attach user information to tracking sessions:
+
+```javascript
+window.tianji.identify({
+  userId: 'user-123',
+  email: '[email protected]',
+  plan: 'premium'
+});
+```
+
+This information will be associated with subsequent events from this user.
+
 
 ## Modify default script name
 

website/i18n/de/docusaurus-plugin-content-docs/current/install/manual.md

@@ -1,23 +1,23 @@
 ---
 sidebar_position: 1
-_i18n_hash: 94d2e9b28e14ee0258d96bc450acf5f6
+_i18n_hash: bd680ba831a70a5f00ce7db124d136dc
 ---
 # Installation ohne Docker
 
-Die Verwendung von Docker zur Installation von `Tianji` ist der beste Weg, da Sie sich keine Gedanken über Umgebungsprobleme machen müssen.
+Die Installation von `Tianji` mit Docker ist der beste Weg, da Sie sich nicht um Umweltprobleme kümmern müssen.
 
-Wenn Ihr Server jedoch kein Docker unterstützt, können Sie versuchen, es manuell zu installieren.
+Falls Ihr Server jedoch keine Docker-Unterstützung bietet, können Sie es manuell installieren.
 
 ## Anforderungen
 
 Sie benötigen:
 
 - [Node.js](https://nodejs.org/en/download/) 18.12+ / 20.4+
-- [pnpm](https://pnpm.io/) 9.x (9.7.1 besser)
+- [pnpm](https://pnpm.io/) 9.x (9.7.1 wird empfohlen)
 - [Git](https://git-scm.com/downloads)
-- [PostgreSQL](https://www.postgresql.org/)
+- [Postgresql](https://www.postgresql.org/)
 - [pm2](https://pm2.keymetrics.io/) - Um Tianji im Hintergrund auszuführen
-- [Apprise](https://github.com/caronc/apprise) - optional, falls Sie Benachrichtigungen benötigen
+- [apprise](https://github.com/caronc/apprise) - optional, falls Sie Benachrichtigungen benötigen
 
 ## Code klonen und bauen
 
@@ -31,38 +31,38 @@ pnpm build
 
 ## Umgebungsdatei vorbereiten
 
-Erstellen Sie eine `.env` Datei in `src/server`
+Erstellen Sie eine `.env` Datei im Verzeichnis `src/server`
 
 ```ini
 DATABASE_URL="postgresql://user:[email protected]:5432/tianji?schema=public"
-JWT_SECRET="ersetzen-sie-mich-durch-einen-beliebigen-string"
+JWT_SECRET="ersetzen-sie-mich-durch-einen-zufälligen-string"
 ```
 
-Stellen Sie sicher, dass Ihre Datenbank-URL korrekt ist, und vergessen Sie nicht, die Datenbank vorher zu erstellen.
+Stellen Sie sicher, dass Ihre Datenbank-URL korrekt ist und denken Sie daran, die Datenbank zuvor zu erstellen.
 
-Weitere Umgebungen finden Sie in diesem Dokument [environment](./environment.md)
+Weitere Umgebungen finden Sie in diesem Dokument [environment](./environment.md).
 
-> Wenn Sie können, ist es besser sicherzustellen, dass Ihr Encoding en_US.utf8 ist, zum Beispiel: `createdb -E UTF8 -l en_US.utf8 tianji`
+> Wenn möglich, stellen Sie sicher, dass Ihre Zeichencodierung auf en_US.utf8 eingestellt ist, zum Beispiel: `createdb -E UTF8 -l en_US.utf8 tianji`
 
 ## Server ausführen
 
 ```bash
 npm install pm2 -g && pm2 install pm2-logrotate
 
-# DB-Migration initialisieren
+# Datenbankmigration initialisieren
 cd src/server
 pnpm db:migrate:apply
 
 # Server starten
 pm2 start ./dist/src/server/main.js --name tianji
 ```
 
-Standardmäßig läuft `Tianji` auf `http://localhost:12345`.
+Standardmäßig wird `Tianji` unter `http://localhost:12345` ausgeführt.
 
 ## Code auf neue Version aktualisieren
 
 ```bash
-# Neuen Release/Tags auschecken
+# Neue Versions-/Tags übernehmen
 cd tianji
 git fetch --tags
 git checkout -q <version>
@@ -73,7 +73,7 @@ pnpm install
 # Projekt bauen
 pnpm build
 
-# DB-Migrationen durchführen
+# Datenbankmigrationen durchführen
 cd src/server
 pnpm db:migrate:apply
 
@@ -85,22 +85,22 @@ pm2 restart tianji
 
 ## Installation von `isolated-vm` fehlgeschlagen
 
-Wenn Sie Python 3.12 verwenden, wird ein Fehler wie folgt angezeigt:
+Wenn Sie Python 3.12 verwenden, wird möglicherweise folgender Fehler angezeigt:
 
 ```
 ModuleNotFoundError: No module named 'distutils'
 ```
 
-Das liegt daran, dass Python 3.12 `distutils` aus dem eingebauten Modul entfernt hat. Jetzt haben wir eine gute Lösung dafür.
+Dies liegt daran, dass Python 3.12 `distutils` als integriertes Modul entfernt hat. Es gibt jedoch eine gute Lösung dafür.
 
-Sie können Ihre Python-Version von 3.12 auf 3.9 ändern, um das Problem zu lösen.
+Sie können Ihre Python-Version von 3.12 auf 3.9 ändern, um das Problem zu beheben.
 
-### Wie man es mit einem von Brew verwalteten Python löst
+### Wie man es mit Brew-verwaltetem Python löst
 
 ```bash
 brew install [email protected]
 rm /opt/homebrew/bin/python3
 ln -sf /opt/homebrew/bin/python3 /opt/homebrew/bin/python3.9
 ```
 
-Dann können Sie die Version mit `python3 --version` überprüfen.
+Anschließend können Sie die Version mit `python3 --version` überprüfen.

website/i18n/de/docusaurus-plugin-content-docs/current/website/track-script.md

@@ -1,64 +1,150 @@
 ---
 sidebar_position: 1
-_i18n_hash: bcb6522b66b64594f82548e296f77934
+_i18n_hash: ef9fc0eb6072a8f037b70ff2b56e12ae
 ---
 # Tracker-Skript
 
 ## Installation
 
-Um Website-Ereignisse zu verfolgen, musst du nur ein einfaches Skript (< 2 KB) in deine Website einbinden.
+Um Website-Ereignisse zu verfolgen, müssen Sie nur ein einfaches Skript (< 2 KB) in Ihre Website einfügen.
 
 Das Skript sieht wie folgt aus:
 
 ```html
-<script async defer src="https://<your-self-hosted-domain>/tracker.js" data-website-id="xxxxxxxxxxxxx"></script>
+<script async defer src="https://<Ihre-eigene-Domain>/tracker.js" data-website-id="xxxxxxxxxxxxx"></script>
 ```
 
-Du kannst diesen Skriptcode aus deiner **Tianji**-Websiteliste abrufen.
+Sie können diesen Skript-Code aus Ihrer **Tianji**-Websiteliste erhalten.
 
-## Ereignisbericht
+## Ereignis melden
 
-**Tianji** bietet eine einfache Möglichkeit, Benutzerklickereignisse zu melden. Es hilft dir, zu verfolgen, welche Aktionen Benutzer mögen und häufig verwenden.
+**Tianji** bietet eine einfache Möglichkeit, Benutzer-Klickereignisse zu melden. Es ist einfach, nachzuvollziehen, welche Aktionen der Benutzer mag und häufig verwendet.
 
-Dies ist eine sehr häufige Methode in der Website-Analyse. Du kannst sie schnell mit **Tianji** nutzen.
+Dies ist eine sehr gängige Methode in der Website-Analyse. Sie können es schnell nutzen, indem Sie **Tianji** verwenden.
 
-Nachdem du den Skriptcode in deine Website eingebunden hast, musst du nur ein `data-tianji-event` in das DOM-Attribut einfügen.
+### Grundlegende Nutzung
+
+Nachdem Sie den Skript-Code in Ihre Website eingefügt haben, müssen Sie nur ein `data-tianji-event` im DOM-Attribut hinzufügen.
 
 Zum Beispiel:
 
 ```html
-<button data-tianji-event="submit-login-form">Login</button>
+<button data-tianji-event="submit-login-form">Anmelden</button>
 ```
 
-Jetzt, wenn ein Benutzer auf diese Schaltfläche klickt, erhält dein Dashboard ein neues Ereignis.
+Wenn ein Benutzer nun auf diese Schaltfläche klickt, erhält Ihr Dashboard ein neues Ereignis.
 
-## Standard-Skriptnamen ändern
+### Ereignisdaten anhängen
 
-> Diese Funktion ist ab v1.7.4 verfügbar.
+Sie können zusätzliche Daten an Ihre Ereignisse anhängen, indem Sie `data-tianji-event-{key}`-Attribute verwenden. Jedes Attribut, das diesem Muster entspricht, wird gesammelt und mit dem Ereignis gesendet.
 
-Du kannst die Umgebungsvariable `CUSTOM_TRACKER_SCRIPT_NAME` beim Starten verwenden.
+```html
+<button 
+  data-tianji-event="purchase" 
+  data-tianji-event-product="Premium Plan"
+  data-tianji-event-price="99"
+  data-tianji-event-currency="USD">
+  Jetzt kaufen
+</button>
+```
 
-Zum Beispiel:
+Dies sendet ein Ereignis namens `purchase` mit den folgenden Daten:
+```json
+{
+  "product": "Premium Plan",
+  "price": "99",
+  "currency": "USD"
+}
+```
+
+### Link-Klicks verfolgen
+
+Bei der Verwendung von `data-tianji-event` auf Anker (`<a>`) -Tags behandelt **Tianji** diese speziell, um sicherzustellen, dass das Ereignis vor der Navigation verfolgt wird:
+
+```html
+<a href="/pricing" data-tianji-event="view-pricing">Preise anzeigen</a>
+```
+
+Für interne Links (nicht in einem neuen Tab geöffnet) wird der Tracker:
+1. Die Standardnavigation verhindern
+2. Das Verfolgungsereignis senden
+3. Nach Abschluss der Verfolgung zur Ziel-URL navigieren
+
+Für externe Links oder Links mit `target="_blank"` wird das Ereignis verfolgt, ohne die Navigation zu blockieren.
+
+### JavaScript-API
+
+Nachdem das Tracker-Skript geladen ist, können Sie auch Ereignisse programmatisch unter Verwendung des `window.tianji`-Objekts verfolgen.
+
+#### Benutzerdefinierte Ereignisse verfolgen
+
+```javascript
+// Einfaches Ereignisverfolgen
+window.tianji.track('button-clicked');
+
+// Ereignis mit benutzerdefinierten Daten
+window.tianji.track('purchase', {
+  product: 'Premium Plan',
+  price: 99,
+  currency: 'USD'
+});
+
+// Verfolgen mit benutzerdefiniertem Payload-Objekt
+window.tianji.track({
+  website: 'Ihre-Website-ID',
+  name: 'benutzerdefiniertes-ereignis',
+  data: { key: 'value' }
+});
+
+// Verfolgen mithilfe einer Funktion (erhält aktuelle Seiteninformationen)
+window.tianji.track((payload) => ({
+  ...payload,
+  name: 'dynamisches-ereignis',
+  data: { timestamp: Date.now() }
+}));
+```
+
+#### Benutzer identifizieren
+
+Sie können Benutzerdaten an Session-Tracking anhängen:
+
+```javascript
+window.tianji.identify({
+  userId: 'user-123',
+  email: '[email protected]',
+  plan: 'premium'
+});
+```
+
+Diese Informationen werden mit nachfolgenden Ereignissen dieses Benutzers verbunden.
+
+## Standardmäßigen Skriptnamen ändern
+
+> Diese Funktion ist verfügbar ab v1.7.4+
+
+Sie können die Umgebung `CUSTOM_TRACKER_SCRIPT_NAME` verwenden, wenn Sie damit starten
+
+zum Beispiel:
 ```
 CUSTOM_TRACKER_SCRIPT_NAME="my-tracker.js"
 ```
 
-Dann kannst du auf dein Tracker-Skript über `"https://<your-self-hosted-domain>/my-tracker.js"` zugreifen.
+dann können Sie Ihr Tracker-Skript mit `"https://<Ihre-eigene-Domain>/my-tracker.js"` besuchen.
 
-Dies hilft dir, einige Werbeblocker zu umgehen.
+Dies soll Ihnen helfen, einige Werbeblocker zu umgehen.
 
-Du benötigst nicht die `.js`-Endung. Es kann ein beliebiger Pfad sein, du kannst sogar `CUSTOM_TRACKER_SCRIPT_NAME="this/is/very/long/path"` verwenden.
+Sie benötigen nicht das `.js`-Suffix. Es kann jeder beliebige Pfad sein, den Sie wählen, sogar `CUSTOM_TRACKER_SCRIPT_NAME="this/is/very/long/path"`.
 
 ## Nur bestimmte Domains verfolgen
 
-Im Allgemeinen meldet der Tracker alle Ereignisse, unabhängig davon, wo deine Website läuft. Manchmal müssen wir jedoch Ereignisse wie `localhost` ignorieren.
+Im Allgemeinen wird der Tracker alle Ereignisse melden, wo immer Ihre Seite läuft. Aber manchmal müssen wir Ereignisse wie `localhost` ignorieren.
 
-Tianji bietet ein Attribut für das Tracker-Skript, um dies zu tun.
+Tianji bietet ein Attribut des Tracker-Skripts, um dies zu tun.
 
-Du kannst `data-domains` in dein Skript einfügen. Der Wert sollte deine Stammdomains sein, die verfolgt werden sollen. Verwende `,` um mehrere Domains zu trennen.
+Sie können `data-domains` in Ihr Skript hinzufügen. Der Wert sollte Ihre Root-Domains zum Verfolgen sein. Verwenden Sie `,` um mehrere Domains zu trennen.
 
 ```html
-<script async defer src="https://<your-self-hosted-domain>/tracker.js" data-website-id="xxxxxxxxxxxxx" data-domains="website.com,www.website.com"></script>
+<script async defer src="https://<Ihre-eigene-Domain>/tracker.js" data-website-id="xxxxxxxxxxxxx" data-domains="website.com,www.website.com"></script>
 ```
 
-Dann kannst du nur die Ereignisse von diesen Domains sehen.
+Dann können Sie nur die Ereignisse von diesen Domains sehen.