Page View

Ein Seitenaufruf ist eine Seite Ihrer Website, die ein Besuch geladen hat. Ein Beispiel: Jemand von Bergquell Mineralbrunnen gelangt über LinkedIn auf Ihre Preisseite und öffnet danach zwei weitere Seiten. Die Session hat dann drei Seitenaufrufe.

Seitenaufrufe haben keine eigene ID und stehen in der Liste user_data ihrer Session, in der Reihenfolge der Aufzeichnung.

ZählregelnCopy Anchor Link

Der Tracking-Code meldet einen Seitenaufruf bei jedem Laden einer Seite. Dabei gilt:

• Neu laden: Wenn jemand dieselbe URL noch einmal lädt, entsteht kein neuer Seitenaufruf.
• Zurück zu einer Seite: Webmetic fasst nur direkt aufeinanderfolgende gleiche URLs zusammen. Die Folge A, B, A ergibt drei Seitenaufrufe.
• Single-Page-Apps: Jeder URL-Wechsel über die History-API des Browsers zählt als Seitenaufruf. Wenn sich nur der Teil nach # ändert, zählt das nicht als Seitenaufruf.

MesswerteCopy Anchor Link

• timestamp: Der Zeitpunkt, zu dem der Webmetic-Server den Seitenaufruf empfangen hat, nicht die Uhr des Browsers. Die API gibt ihn in UTC ohne Suffix aus, Webhooks mit Z. Mehr dazu unter Zeiträume und Zeitzonen.
• scroll_depth: Die tiefste Marke, die der Besuch auf der Seite überschritten hat: 0, 25, 50, 75 oder 90. Webmetic kennt keine feineren Stufen und keinen Wert 100. Jeder Seitenaufruf beginnt bei 0.
• time_spent: Die Sekunden bis zum nächsten Seitenaufruf derselben Session. Auf der letzten Seite zählt Webmetic bis zur letzten Interaktion, zum Beispiel einem Download. Wenn es keine Interaktion gab, übernimmt Webmetic die aktive Zeit aus engagement_time. Wenn auch engagement_time fehlt, setzt Webmetic einen geschätzten Wert von wenigen Sekunden ein. Scrollen zählt nicht als Interaktion.
• engagement_time: Die aktive Zeit in Sekunden, gemessen im Browser. Aktiv heißt: Der Tab ist sichtbar, und in den letzten 60 Sekunden gab es Aktivität per Maus, Tastatur, Scrollen oder Touch. Der Browser sendet den Wert, wenn jemand die Seite verlässt, den Tab wechselt oder in einer Single-Page-App zur nächsten Ansicht wechselt.
• document_location und document_title: Webmetic speichert URL und Titel vollständig und kürzt nichts. Die URL enthält Query-String und #-Teil.

Empfohlen: Nutzen Sie engagement_time als Dauer einer Seite, weil der Wert die aktive Zeit misst. Das Dashboard nutzt ihn ebenfalls und greift nur dann auf time_spent zurück, wenn er fehlt.

FelderCopy Anchor Link

EreignisseCopy Anchor Link

Die Liste events enthält die Interaktionen, die Webmetic auf der Seite erkannt hat. Jedes Ereignis hat type und target, dazu detail und meta, die auch null sein oder fehlen können.

Als Suchbegriff in der URL gelten die Parameter q, s, search, query, keyword, term und suche.

Die API liefert keine Formulareingaben, mit einer Ausnahme: Bei site_search steht der Suchbegriff vollständig in target. Bei contact_click fehlen E-Mail-Adresse und Telefonnummer.

Der Tracking-Code erkennt YouTube-Videos nur, wenn die Einbettung enablejsapi=1 enthält. Stumm automatisch startende HTML5-Videos zählen nicht.

Sie können keine eigenen Ereignisse senden. user_events_count zählt dagegen auch Interaktionen ohne eigenen Typ, zum Beispiel Audio. Der Wert kann deshalb größer sein als die Zahl der Einträge in events.

Session und UnternehmenCopy Anchor Link

Ein Seitenaufruf trägt keine company_id. Über die session_id finden Sie in /session seine Session und deren company_id.

Webmetic liest UTM-Werte und Klick-IDs aus der URL des ersten Seitenaufrufs und legt sie an der Session ab.

BeispielCopy Anchor Link

Das Beispiel zeigt den ersten Seitenaufruf der Session aus /session_user_data. In /company-sessions fehlt session_id, weil der Seitenaufruf dort in seiner Session steht.

{
  "session_id": "01M4WQFX6YM2X5V8T4N6R1C0DZ",
  "timestamp": "2026-10-14T08:12:05.214000",
  "document_location": "https://ihre-website.de/preise?utm_source=linkedin&utm_medium=social&utm_campaign=messe-2026",
  "document_title": "Preise",
  "scroll_depth": 75,
  "referrer": "https://www.linkedin.com/",
  "time_spent": 95.0,
  "engagement_time": 70,
  "user_events_count": 2,
  "events": [
    {
      "type": "download",
      "target": "preisliste.pdf",
      "detail": "https://ihre-website.de/media/preisliste.pdf",
      "meta": { "fileType": "pdf" }
    },
    {
      "type": "form_start",
      "target": "angebotsanfrage",
      "detail": null,
      "meta": { "fieldCount": 6 }
    }
  ]
}

SonderfälleCopy Anchor Link

• Fehlend oder null: In /session_user_data und /company-sessions fehlt ein Feld, zu dem Webmetic nichts gespeichert hat. In den Feeds und in Webhooks ist jedes Feld vorhanden, ohne Wert als null.
• Leere Texte: document_title, referrer sowie detail und meta eines Ereignisses können "" oder null sein oder fehlen. Behandeln Sie alle drei Fälle gleich.
• Kurze Seiten: Wenn eine Seite weniger als 50 Pixel höher ist als das Fenster, bleibt scroll_depth bei 0. Der Besuch hat die Seite trotzdem ganz gesehen.
• Ohne aktive Zeit: engagement_time fehlt, wenn der Browser den Wert nicht mehr senden konnte, zum Beispiel nach dem Schließen.
• Referrer in Single-Page-Apps: Jeder Seitenaufruf trägt den Referrer des ersten Ladens, nicht die vorige Seite.
• Zeitraum: from_date und to_date filtern nach dem Beginn der Session. /session_user_data liefert deshalb alle Seitenaufrufe einer solchen Session, auch spätere.
• Reihenfolge: Die Reihenfolge der Einträge in /session_user_data ist nicht festgelegt. Sortieren Sie selbst nach timestamp. Mehr dazu unter Paginierung.
• Free-Plan: Bei einem verborgenen Unternehmen enthält ein Eintrag in /session_user_data nur session_id, timestamp und blurred: true. In /company-sessions fehlt dann user_data, und in den Feeds ist die Liste leer. Mehr dazu unter Pläne.
• Opt-out: Die API liefert keine Seitenaufrufe nach einem Opt-out.

Verwendet vonCopy Anchor Link

• Endpunkte: GET /session_user_data liefert einen Eintrag pro Seitenaufruf, und total in pagination zählt dort Seitenaufrufe. GET /company-sessions liefert die Seitenaufrufe in result[].sessions[].user_data[].
• Besuchsarten: GET /intensive-visits, GET /returning-visits und GET /new-visits liefern die Seitenaufrufe ebenfalls in result[].sessions[].user_data[]. Mehr dazu unter Besuchsarten.
• Webhooks: Alle vier Ereignisse tragen die Seitenaufrufe in data.visit.user_data. Wenn der Body zu groß wird, lässt Webmetic zuerst die ältesten Seitenaufrufe weg und setzt data.truncated auf true. Mehr dazu unter Webhooks.
• KI-Assistent: Auch der KI-Assistent ruft Seitenaufrufe ab. Das Tool get_company_activity zeigt die Seitenaufrufe eines Besuchs als Text.