Session

Ein Beispiel: Jemand von Bergquell Mineralbrunnen gelangt morgens über einen Link auf LinkedIn auf Ihre Website und liest die Preisseite, eine Produktseite und die Kontaktseite. Das ist eine Session mit drei Seitenaufrufen.

Wenn dieselbe Person am Nachmittag weiterliest, beginnt eine zweite Session. Auf den Produktseiten dieser Dokumentation heißt die Session Besuch.

Beginn einer SessionCopy Anchor Link

Webmetic beginnt eine neue Session in diesen Fällen:

• Ein Besucher ruft an diesem Tag zum ersten Mal eine Seite auf.
• Seit seinem letzten Seitenaufruf sind mehr als 30 Minuten vergangen.
• Ein neuer Tag beginnt, gerechnet in UTC. In Deutschland ist das um 1 Uhr im Winter und um 2 Uhr im Sommer.
• Die Adresse der Seite trägt Kampagnenparameter wie utm_source oder eine Klick-ID wie gclid, und Quelle oder Medium sind anders als beim vorigen Seitenaufruf.

Für die Kampagnenregel zählen ein direkter Aufruf und ein Link von Ihrer eigenen Website nicht als Wechsel. Nach 30 Minuten oder an einem neuen Tag beginnt aber auch ein direkter Aufruf eine neue Session.

Signale beim Verlassen einer Seite, etwa zur Scrolltiefe, zählen nicht als Seitenaufruf.

Eine Session gehört zu genau einem Besucher, einer Website und einem Webmetic-Konto. Subdomains wie shop.ihre-website.de zählen zur selben Website wie ihre-website.de. Keine Session reicht über Mitternacht UTC hinaus.

Die API liefert nur Sessions, die Webmetic einem Unternehmen zugeordnet hat. Es fehlen außerdem Besuche nach einem Opt-out und neue Besuche von Unternehmen, die Sie mit der Domain-Blacklist oder den Organisationstypen ausschließen. Frühere Besuche dieser Unternehmen bleiben in der API.

Eine Session behält ihre session_id, wenn später weitere Seitenaufrufe dazukommen. Speichern Sie Sessions deshalb mit der session_id als Schlüssel und überschreiben Sie bestehende Einträge.

FelderCopy Anchor Link

Quelle, Medium, Kampagne und Klick-ID gelten für die ganze Session und stammen aus ihrem ersten Seitenaufruf. Mehr dazu unter Kampagnen und Kanäle.

SeitenaufrufeCopy Anchor Link

Die Seitenaufrufe einer Session stehen in user_data, einer Liste von Objekten. Jedes Objekt beschreibt einen Seitenaufruf mit Adresse, Titel, Zeit und Ereignissen. Alle Felder stehen unter Page View.

Eine Session hat kein Feld für die Zahl ihrer Seitenaufrufe. Zählen Sie dafür die Einträge in user_data.

/session liefert keine Seitenaufrufe. Dafür steht /session_user_data mit einer Zeile pro Seitenaufruf bereit. Jede Zeile trägt die session_id, über die Sie die Zeile der Session zuordnen.

Felder je EndpunktCopy Anchor Link

In Webhook-Zustellungen tragen Zeitangaben ein Z, in API-Antworten nicht. Was die drei Besuchsarten auszeichnet, steht unter Besuchsarten.

BeispielCopy Anchor Link

Der Besuch begann auf https://ihre-website.de/preise?utm_source=linkedin&utm_medium=social&utm_campaign=messe-2026 und hatte drei Seitenaufrufe.

{
  "company_id": "41ea486a9c95",
  "company_name": "Bergquell Mineralbrunnen GmbH",
  "session_id": "01M4WQFX6YM2X5V8T4N6R1C0DZ",
  "client_id": "14e382cf709a614559666137b3d1dfcefa99b1e7ecf93400cc9e2cc4822619d3",
  "timestamp": "2026-10-14T08:12:05.214000",
  "weburl": "https://ihre-website.de",
  "utm_source": "linkedin",
  "utm_medium": "social",
  "utm_campaign": "messe-2026",
  "session_duration": 309.0,
  "session_time": 103.0,
  "session_engagement": 284.0,
  "user_agent_browser": { "family": "Chrome", "version": "130.0.0" },
  "user_agent_os": { "family": "Windows", "version": "11" },
  "user_agent_device": { "family": "Other" },
  "user_agent_category": "desktop",
  "visitor_city": "Freising",
  "visitor_zip": "85354",
  "visitor_country": "Deutschland",
  "visitor_country_code": "DE"
}

Zwischen dem ersten und dem letzten Seitenaufruf lagen 245 Sekunden, und auf der letzten Seite maß der Browser 64 Sekunden. Das ergibt eine Dauer von 309 Sekunden und 103 Sekunden pro Seitenaufruf.

SonderfälleCopy Anchor Link

• Fehlende Werte: In /session und /company-sessions fehlt ein Feld ohne Wert, aber es kann auch null sein. In den Feeds und in Webhooks ist jedes Feld vorhanden, ohne Wert als null.
• Nicht gemessene Zeit: Wenn es auf der letzten Seite keine Interaktion gab und der Browser keine aktive Zeit gesendet hat, kann Webmetic die Zeit dort nicht messen. Dann setzt Webmetic einen geschätzten Wert von wenigen Sekunden ein, in time_spent und in session_duration.
• Reihenfolge: /session und /company-sessions liefern Sessions in keiner festen Reihenfolge. Sortieren Sie selbst nach timestamp oder session_id. In einer Zeile der Feeds stehen die Sessions vom ältesten zum neuesten. Mehr dazu unter Paginierung.
• Zeitraum: from_date und to_date filtern nach dem Beginn der Session, auch in /session_user_data. Mehr dazu unter Zeiträume und Zeitzonen.
• Mehrere Tage: Wegen der täglich neuen client_id können Sie einem Besucher nicht über mehrere Tage folgen. Verbinden Sie Sessions über die company_id.
• Free-Plan: Bei Unternehmen, die Sie im Free-Plan nicht sehen, hat eine Session in /session nur session_id, company_id, timestamp, einen Platzhalter als company_name und blurred: true. Mehr dazu unter Pläne.

Verwendet vonCopy Anchor Link

• Endpunkte: GET /session, GET /session_user_data, GET /company-sessions, GET /intensive-visits, GET /returning-visits und GET /new-visits.
• Webhooks: company.identified, company.returned, company.intensive_visit und segment.entered tragen die Session in data.visit. Mehr dazu unter Webhooks.
• KI-Assistent: Auch der KI-Assistent ruft die Besuche eines Unternehmens ab, mit dem Tool get_company_activity.