# Sonderfälle (https://webmetic.de/docs/installation/sonderfaelle)

Jeder Abschnitt behandelt einen Fall und steht für sich. Die Grundinstallation finden Sie unter [Installation](https://webmetic.de/docs/installation).

## Bevor Sie beginnen [#bevor-sie-beginnen]

- **Konto**: Sie brauchen ein Webmetic-Konto und Ihren Tracking-Code unter [**Menü** > **Trackingcode**](https://app.webmetic.de/?menu=tracking_code).
- **Rechte**: Jeder Benutzer Ihres Kontos kann Websites hinzufügen, auch ohne Admin-Rechte.
- **Zugang**: Je nach Fall brauchen Sie Zugang zum HTML Ihrer Website, zum Tag-Manager, zu den Plugins Ihres CMS oder zu den Server-Headern.
- **Plan**: Wie viele Domains Sie hinzufügen können, hängt von Ihrem Plan ab. Keine Einstellung auf dieser Seite kostet Credits.

## Single-Page-Apps erfassen [#single-page-apps-erfassen]

Webmetic erkennt Seitenwechsel in Single-Page-Apps selbst, sodass Ihre App keinen zusätzlichen Code braucht. Jeder neue Pfad und jeder neue Query-String zählt als Seitenaufruf, auch ein geänderter Filterparameter.

1. **Link anklicken**: Die Adresse ändert sich, ohne dass die Seite neu lädt.
2. **Wechsel erkennen**: Webmetic vergleicht die Adresse ohne den Teil nach `#` mit der letzten.
3. **Seite abschließen**: Webmetic sendet Scrolltiefe und aktive Zeit der vorigen Seite.
4. **Seitenaufruf senden**: Webmetic meldet die neue Seite mit ihrem aktuellen Titel.

Drei Punkte entscheiden, ob die Daten stimmen:

- **Hash-Routen**: Adressen wie `/#/preise` erzeugen keine Seitenaufrufe, und Webmetic erfasst dann nur die erste Seite des Besuchs. Webmetic bietet dafür keine Einstellung.
- **Seitentitel**: Webmetic liest den Titel kurz nach dem Wechsel der Adresse. Setzen Sie ihn deshalb zusammen mit der Route, sonst trägt der Seitenaufruf den Titel der vorigen Seite.
- **Einmal einbinden**: Binden Sie den Tracking-Code einmal in die HTML-Grundseite oder das Root-Layout ein. Der Tracking-Code aus dem Dashboard startet auch bei doppeltem Laden nur einmal. Die Kurzform aus dem Abschnitt zur Content Security Policy zählt dagegen doppelt.

Im Google Tag Manager brauchen Sie keinen eigenen Trigger für Seitenwechsel.

## Subdomains erfassen [#subdomains-erfassen]

Webmetic sammelt alle Subdomains unter der Hauptdomain. Besuche auf `www.ihre-website.de`, `shop.ihre-website.de` und `ihre-website.de` stehen in derselben Unternehmensliste.

1. **Subdomains senden**: Der Tracking-Code läuft auf `www.`, `shop.` und `karriere.ihre-website.de`.
2. **Hauptdomain zuordnen**: Webmetic speichert alle Besuche unter `ihre-website.de`.
3. **Eine Liste**: Alle Unternehmen stehen in der Liste der Hauptdomain.
4. **Ansicht filtern**: Auf Wunsch zeigen Sie nur die Besuche einer Subdomain.

Eine Subdomain braucht keinen eigenen Eintrag und kann auch keinen erhalten. Wenn Sie unter **Websites** eine Subdomain eingeben, fügt Webmetic die Hauptdomain hinzu oder zeigt die Meldung **Diese Website ist bereits hinzugefügt.**

Wenn ein Besuch am selben Tag zwischen Ihren Subdomains wechselt, bleibt es ein Besuch ohne neue Herkunft. Der Verlauf des Besuchs zeigt den Klick als **Subdomain-Klick**.

So sehen Sie sich nur eine Subdomain an:

1. Öffnen Sie die Unternehmensliste Ihrer Domain.
2. Klicken Sie oben links auf den Namen Ihrer Website. Eingerückt darunter stehen die Subdomains mit genügend Besuchen.
3. Wählen Sie eine Subdomain aus. Die Liste zeigt nur Besuche, die diese Subdomain berührt haben.

Segmente, Tags und Einstellungen gehören weiter zur Hauptdomain. Über die Zeile der Hauptdomain kehren Sie zur ganzen Liste zurück.

## Mehrere Domains hinzufügen [#mehrere-domains-hinzufügen]

Der Tracking-Code enthält nur Ihre Account-ID und keine Domain, deshalb nutzen Sie denselben Code auf allen Domains. Im Dashboard erscheint eine Domain aber erst, nachdem Sie diese hinzugefügt haben.

1. Öffnen Sie [**Menü** > **Websites**](https://app.webmetic.de/?menu=websites). Die **Website-Verwaltung** öffnet sich.
2. Geben Sie unter **Neue Website hinzufügen** nur die Domain ein, zum Beispiel `ihre-website-wien.at`.
3. Klicken Sie auf **Hinzufügen**. Die Domain steht zuerst auf **Nicht integriert**.
4. Binden Sie den Tracking-Code auf der neuen Domain ein.
5. Klicken Sie auf **Status aktualisieren**. Sobald Daten mit Ihrer Account-ID ankommen, zeigt Webmetic den Status **Aktiv**.

![Die Website-Verwaltung mit mehreren Domains und ihrem Status](https://webmetic.de/docs/media/de/light/websites-status.webp)

Webmetic zeigt den Status für jede Domain einzeln, und jede Domain hat eine eigene Unternehmensliste. Sie wechseln über die Website-Auswahl oben links. Webmetic verbindet Besuche über mehrere Domains nicht: Auf der zweiten Domain erscheint die erste als Herkunft.

Wenn die Grenze Ihres Plans erreicht ist, zeigt Webmetic statt des Formulars die Schaltfläche **Auf Growth upgraden**.

## Caching- und Optimierungs-Plugins einstellen [#caching--und-optimierungs-plugins-einstellen]

Ein Seiten-Cache stört nicht, denn der Tracking-Code ist für alle Besuche gleich. Probleme entstehen durch Funktionen, die JavaScript verzögern, zusammenfassen oder verändern:

- **Nicht verzögern**: Webmetic sendet den ersten Seitenaufruf erst, wenn der Code läuft. Wenn er erst bei der ersten Interaktion lädt, fehlen alle Besuche ohne Klick oder Scrollen.
- **Ausnahme eintragen**: Nehmen Sie `t.webmetic.de/iav.js` vom Minifizieren, Zusammenfassen, Verschieben und Verzögern aus, und lassen Sie den Tracking-Code aus dem Dashboard unverändert.
- **Nicht selbst hosten**: Eine Kopie von `iav.js` auf Ihrem Server erhält keine Updates, und die Session-Aufzeichnung funktioniert nicht. Mit der Kurzform fehlt zusätzlich die Account-ID, und die Domain steht dann auf **Fehlerhaft**.

Das [WordPress-Plugin](https://webmetic.de/docs/installation/wordpress) trägt die Ausnahme selbst in WP Rocket, LiteSpeed Cache, Perfmatters, SG Optimizer, FlyingPress, Autoptimize und W3 Total Cache ein. In Cloudflare Rocket Loader, Jetpack Boost, WP-Optimize, Hummingbird, Breeze und NitroPack tragen Sie die Ausnahme selbst ein.

## Content Security Policy anpassen [#content-security-policy-anpassen]

Wenn Ihre Website eine Content Security Policy (CSP) sendet, ergänzen Sie diese Einträge:

```text
script-src https://t.webmetic.de;
connect-src https://t.webmetic.de;
img-src https://t.webmetic.de;
```

- **script-src**: Hier laden `iav.js` und bei aktiver Session-Aufzeichnung das Skript für die Aufzeichnung. Der Tracking-Code aus dem Dashboard ist ein Inline-Skript. Wenn Ihre CSP kein `'unsafe-inline'` erlaubt, braucht er eine Nonce oder einen Hash.
- **connect-src**: Darüber sendet Webmetic Seitenaufrufe, Ereignisse und Aufzeichnungen.
- **img-src**: Webmetic nutzt diesen Weg nur, wenn die anderen Wege scheitern.

Der Tracking-Code ruft keine weiteren Adressen auf. Sie brauchen also weder `worker-src` noch `blob:`. Das WordPress-Plugin gibt dem Inline-Skript die ID `webmetic-bootstrap`, damit Sie gezielt eine Nonce setzen können. Wenn Sie den Google Tag Manager nutzen, gelten zusätzlich dessen eigene Anforderungen.

<Accordions>
<Accordion title="Kurzform ohne Inline-Skript">

Die Kurzform lädt `iav.js` direkt, ohne Inline-Skript, und braucht deshalb keine Nonce.

```html
<script src="https://t.webmetic.de/iav.js?id=IHRE_ACCOUNT_ID" async></script>
```

Für die Session-Aufzeichnung hängen Sie `&sr=true` an die Adresse an. Die **Tiefenprüfung** zeigt dann trotzdem den Hinweis **Session-Aufzeichnung inaktiv**, weil sie die Aufzeichnung nur im Tracking-Code aus dem Dashboard erkennt. Weil die Kurzform bei doppeltem Laden zweimal startet, binden Sie diese nur einmal ein. Wir empfehlen weiterhin den Tracking-Code aus dem Dashboard.

</Accordion>
</Accordions>

## Tracking-Code an eine Einwilligung binden [#tracking-code-an-eine-einwilligung-binden]

Webmetic verarbeitet die Daten pseudonymisiert. Das Skript setzt keine eigenen Cookies, liest aber, falls vorhanden, die Kennung eines Google-Analytics-Cookies aus.

Ob der Tracking-Code vor oder erst nach einer Einwilligung lädt, entscheiden Sie als verantwortliche Stelle.

Der Tracking-Code hat keine Schnittstelle für Einwilligungen und keinen Befehl zum Starten oder Beenden. Sie steuern die Einwilligung deshalb über das Laden:

- **Consent-Tool**: Ihr Tool blockiert den Tracking-Code, bis die Einwilligung vorliegt.
- **Google Tag Manager**: Sie lösen das Webmetic-Tag erst nach der Einwilligung aus, zum Beispiel mit einem passenden Trigger. Die Webmetic-Vorlage hat keine eigenen Consent-Einstellungen.

Wenn jemand mitten im Besuch zustimmt, beginnt die Erfassung auf der aktuellen Seite. Ein Widerruf wirkt ab dem nächsten vollständigen Laden der Seite, in einer Single-Page-App also erst nach einem Neuladen.

Die **Tiefenprüfung** unter [**Menü** > **Trackingcode**](https://app.webmetic.de/?menu=tracking_code) zeigt, ob der Code vor oder erst nach der Zustimmung lädt. Wenn der Code erst danach lädt, zeigt die Tiefenprüfung den Hinweis **Code lädt nur nach Zustimmung**. Webmetic erfasst dann keine Besuche vor der Einwilligung.

Die Prüfung testet nur die Startseite der ersten Website Ihres Kontos.

Ihre Besucher können unter [webmetic.de/opt-out](https://webmetic.de/opt-out) mit der Schaltfläche **Opt-Out aktivieren** widersprechen. Der Widerspruch gilt für dieses Gerät und diese Internetverbindung auf allen Websites mit Webmetic.

## Staging und Testumgebungen ausschließen [#staging-und-testumgebungen-ausschließen]

Eine Staging-Subdomain wie `staging.ihre-website.de` gehört zur Hauptdomain, und ihre Testbesuche erscheinen deshalb in der Liste Ihrer Live-Website. Um Tests herauszuhalten, binden Sie den Tracking-Code auf Staging nicht ein. Alternativ nutzen Sie eine eigene Domain, die Sie nicht unter **Websites** hinzufügen.

Erfassen Sie nur Ihre eigene Domain, keine Plattform-Adressen wie `*.myshopify.com`, `*.vercel.app` oder `*.netlify.app`. Sonst zählt Webmetic die Daten nicht zu Ihrer Domain.

`localhost`, IP-Adressen und `file://` erscheinen nie im Dashboard. Testen Sie deshalb auf der veröffentlichten Website, mit **Schnellprüfung** oder **Tiefenprüfung**.

## Iframes und AMP-Seiten berücksichtigen [#iframes-und-amp-seiten-berücksichtigen]

Der Tracking-Code erfasst immer die Seite, in der er läuft. In einem Iframe zählt Webmetic also Seitenaufrufe der Domain des Iframes, nicht der umgebenden Seite.

Webmetic sieht keine Formulare in fremden Iframes, zum Beispiel aus eingebetteten Formular-Tools, weil der Browser das verhindert. Videos von YouTube und Vimeo sind die Ausnahme.

Webmetic bietet keine eigene Einbindung für AMP-Seiten.

## Automatische Ereignisse nutzen [#automatische-ereignisse-nutzen]

Ohne zusätzlichen Code erfasst Webmetic diese Ereignisse:

- **Formulare**: Start, Absenden und Abbruch, außer bei Suchformularen mit `role="search"`
- **Downloads**: Links auf Dateien, erkannt an der Dateiendung oder am Attribut `download`
- **Klicks**: auf E-Mail- und Telefon-Links, auf andere Websites und zwischen Ihren Subdomains
- **Suche**: Suchformulare und Parameter wie `q` oder `suche` in der Adresse
- **Videos und Audio**: YouTube nur mit `enablejsapi=1` in der Adresse des Iframes, auch über `youtube-nocookie.com`; Vimeo ohne Zusatz; eigene Videos außer stumm automatisch startenden; Audio
- **Verhalten**: Scrolltiefe, aktive Zeit und Drucken

Die Zeitachse zeigt E-Mail- und Telefon-Klicks sowie Audio derzeit nicht. [Erfasste Ereignisse](https://webmetic.de/docs/visitor-intelligence/erfasste-ereignisse) beschreibt, welche Ereignisse ein Besuch zeigt.

Sie können keine eigenen Ereignisse oder Seitenaufrufe per Code senden, denn der Tracking-Code hat dafür keine Schnittstelle.

## Nächste Schritte [#nächste-schritte]

- [Installation prüfen](https://webmetic.de/docs/installation/pruefen): Mit Schnellprüfung und Tiefenprüfung sehen, ob Daten ankommen.
- [Tracking-Code im HTML](https://webmetic.de/docs/installation/alle-plattformen): Den Tracking-Code direkt in den Quelltext Ihrer Website einbinden.
- [Erkennungsrate und Datenqualität](https://webmetic.de/docs/erkennungsrate-und-datenqualitaet): Warum nicht jeder Besuch erkannt wird und wie Sie falsche Daten melden.
