Dokumentation

Bevor Sie beginnen

• Ein Privatrak-Projekt für Ihre Website. Wie Sie eines anlegen, zeigt Erste Schritte.
• Nuxt 3 oder neuer.
• Ihr Website-Schlüssel, also der Schlüssel vom Typ Ihre Website. Sie kopieren ihn unter Einstellungen › API-Schlüssel. Er kann nur Daten senden. Sie können ihn also gefahrlos in Ihre App schreiben.

Analytics in Ihre Nuxt-App einbauen

1. Installieren Sie das Modul:

   npm install @privatrak/nuxt

2. Tragen Sie es in nuxt.config.ts unter modules ein. Legen Sie Ihren Website-Schlüssel und apiHost unter tracker ab:

   // nuxt.config.ts
   export default defineNuxtConfig({
     modules: ['@privatrak/nuxt'],
     tracker: {
       apiKey: 'your-website-key',
       apiHost: 'https://api.privatrak.com',
     },
   });

3. Starten Sie Ihre App und öffnen Sie eine Seite.

Die Seitenaufrufe kommen an, ebenso jeder Routenwechsel, jeder Klick und jedes abgeschickte Formular.

Um den Schlüssel pro Umgebung zu setzen, ohne erneuten Build, nutzen Sie die Umgebungsvariable NUXT_PUBLIC_TRACKER_API_KEY.

Festlegen, was der Tracker erfasst

Der Block tracker nimmt neben apiKey und apiHost die Optionen des Trackers an:

export default defineNuxtConfig({
  modules: ['@privatrak/nuxt'],
  tracker: {
    apiKey: 'your-website-key',
    apiHost: 'https://api.privatrak.com',
    autocapture: false,
    excludedUrls: ['/admin/*'],
    traits: ['beta'],
  },
});

Optionen, die Sie weglassen, folgen den Einstellungen Ihres Projekts unter Einstellungen › Tracker. Alle Optionen stehen in der Tracker-Referenz.

Aktionen im Code benennen

Fügen Sie einem Button oder Link data-track hinzu. Privatrak zeigt ihn dann als Feature, also als Namen für etwas, das Besucher auf Ihrer Website tun, hier signup-cta:

<template>
  <button data-track="signup-cta" data-track-plan="pro">Sign up</button>
</template>

Um ein Event aus dem Code zu senden, nutzen Sie useTracker(). Nuxt importiert es für Sie. track() sendet ein Event, und mit setTraits() geben Sie dem Besuch eine Liste von Traits, etwa einen Tarif:

<script setup lang="ts">
const { track, setTraits } = useTracker();

function onCheckout(): void {
  track('checkout-completed', { plan: 'pro' });
}

setTraits(['paid', 'admin']);
</script>

Beide tun beim Rendern auf dem Server nichts. Sie können sie also auch in Code aufrufen, der dort läuft. Weitere Beispiele finden Sie unter Im Code benennen.

KI-Dienste und Crawler melden

KI-Dienste wie ChatGPT und Claude lesen Ihre Seiten, ohne JavaScript auszuführen, deshalb sieht der Tracker sie nie. Das Modul meldet ihre Anfragen von Ihrem Nuxt-Server aus, und die Seite KI-Dienste zeigt, wie oft jeder Dienst Ihre Seiten gelesen hat. Es ist eingeschaltet, sobald Ihr Website-Schlüssel gesetzt ist, Sie müssen also nichts weiter einrichten. Es verzögert keine Antwort und lässt keine fehlschlagen.

Das Modul meldet Anfragen von Crawlern für Seiten, robots.txt, Sitemaps und llms.txt. Dateien unter /_nuxt/, Bilder und Ihre /api/-Routen werden nicht gemeldet.

Es funktioniert mit jedem Nitro-Preset, das einen Server hat: Node, Vercel, Vercel Edge, Netlify, Cloudflare Pages und Workers, Bun und Deno. Eine Website, die mit nuxi generate gebaut wurde, hat keinen Server, deshalb gibt es nichts zu melden.

Tragen Sie bei Netlify in nuxt.config.ts einen Wert für compatibilityDate ein, damit eine Funktion nicht endet, bevor eine Meldung gesendet ist.

Zum Ausschalten setzen Sie serverRequests: false im Block tracker:

export default defineNuxtConfig({
  modules: ['@privatrak/nuxt'],
  tracker: {
    apiKey: 'your-website-key',
    apiHost: 'https://api.privatrak.com',
    serverRequests: false,
  },
});

Sie können auch NUXT_TRACKER_SERVER_REQUESTS=false in der Umgebung des Servers setzen.

Melden Sie Server-Anfragen schon auf anderem Weg, zum Beispiel mit einem Cloudflare Worker, nutzen Sie nur einen davon, sonst wird jede Anfrage doppelt gezählt. Server-Anfragen melden erklärt, wie.

Was Privatrak in Nuxt erfasst

Im Browser erfasst Privatrak Seitenaufrufe, Klicks, abgeschickte Formulare und die Events, die Sie mit track() senden. Was Besucher in ein Formular eintippen, liest es nie. Es setzt keine Cookies, deshalb brauchen Sie keinen Cookie-Banner. Wie Besucher gezählt werden, erklärt Datenschutz.

Von Ihrem Server erhält Privatrak nur Anfragen bekannter Crawler. Zu jeder Anfrage sind das der User-Agent des Crawlers, die Seitenadresse und die Uhrzeit. Nichts über Ihre Besucher verlässt Ihren Server. Die Einzelheiten stehen unter Was Ihren Server verlässt.

Prüfen, ob es funktioniert

Seitenaufrufe prüfen

1. Öffnen Sie in Ihrem Browser eine Seite Ihrer Website.
2. Öffnen Sie in Privatrak Events und klicken Sie auf Events aktualisieren.

Ihr Seitenaufruf steht in der obersten Zeile, mit dem Typ Seitenaufruf. Kommt nichts an, öffnen Sie die Konsole Ihres Browsers. Der Tracker schreibt dort, was schiefgegangen ist, und unter Wenn nichts gesendet wird steht, was Sie tun können.

Anfragen von Crawlern prüfen

1. Rufen Sie eine Seite Ihrer Live-Website so auf, wie es ein KI-Dienst täte. Ersetzen Sie die Adresse durch Ihre eigene:

   curl -A "ChatGPT-User/1.0" https://example.com/

2. Öffnen Sie in Privatrak KI-Dienste und wechseln Sie zum Tab Alle Crawler.

ChatGPT-User (OpenAI) erscheint unter KI-Antworten mit 1 Anfrage. Diese Testanfrage zählt wie eine echte. Erscheint nichts, prüfen Sie, ob Ihr Website-Schlüssel gesetzt ist, ob die Domain Ihrer Website unter den erlaubten Domains steht, ob Ihre Website auf einem Server läuft und ob kein Cache die Anfrage beantwortet hat.