WebmeticDocs

Besuchsarten

Besuchsarten sind die drei Regeln, nach denen Webmetic Unternehmen als intensiv, wiederkehrend oder neu einordnet.

Eine Besuchsart beschreibt, wie ein Unternehmen Ihre Website besucht hat: intensiv, wiederkehrend oder neu. Ein Beispiel: Jemand von einem Getränkehersteller liest zwei Minuten lang Ihre Preisseite, und Webmetic führt das Unternehmen als intensiv.

Wenn das Unternehmen zum ersten Mal auf Ihrer Website war, ist es zugleich neu. Webmetic berechnet die drei Arten für Sie, und die API liefert sie als Feeds und als Webhook-Ereignisse.

Regeln

BesuchsartFeedWebhook-Ereignis
Intensiv/intensive-visits: Unternehmen mit mindestens einem Besuch von mindestens 30 Sekunden im Zeitraumcompany.intensive_visit: jeder Besuch von mindestens 30 Sekunden, einmal pro Besuch
Wiederkehrend/returning-visits: Unternehmen mit zwei oder mehr Besuchen im Zeitraumcompany.returned: jeder Besuch nach dem ersten, einmal pro Besuch
Neu/new-visits: Unternehmen, deren erster Besuch im Zeitraum liegtcompany.identified: der erste Besuch, einmal pro Unternehmen und Website

Ein Besuch ist eine Session. Webmetic wertet nur die Besuche aus, die Ihr Konto auf dieser Website erfasst hat.

Besuche, die Webmetic keinem Unternehmen zuordnet, haben keine Besuchsart.

Die drei Arten sind unabhängig voneinander. Ein Besuch kann zwei Ereignisse auslösen, zum Beispiel company.identified und company.intensive_visit.

Intensiv

Ein Besuch ist intensiv, wenn er insgesamt 30 Sekunden oder länger dauert. Webmetic liest dafür session_duration, und genau 30 Sekunden zählen mit.

Die Zahl der Seiten und die Scrolltiefe spielen keine Rolle. Auch session_time zählt nicht, denn das ist die durchschnittliche Zeit pro Seitenaufruf.

Das Ereignis company.intensive_visit kann später eintreffen als die anderen Ereignisse desselben Besuchs. Webmetic prüft den Besuch weiter, nachdem er im Dashboard erscheint, und meldet ihn, sobald er 30 Sekunden erreicht.

Wiederkehrend

Für wiederkehrende Unternehmen gelten mit Absicht zwei Regeln:

  • Feed: /returning-visits zählt nur Besuche im Zeitraum und lässt Besuche vor from_date weg.
  • Webhook: company.returned meldet jeden Besuch eines Unternehmens, das Ihre Website schon einmal besucht hat, unabhängig davon, wann.

Ein Beispiel: Ein Unternehmen hat Ihre Website im letzten Jahr zehnmal besucht und diese Woche einmal. In /returning-visits?from_date=-7 days fehlt es, aber der Webhook meldet den Besuch als company.returned.

Neu

Neu ist ein Unternehmen bei seinem ersten Besuch, den Ihr Konto auf dieser Website erfasst hat. Besuche, die andere Webmetic-Konten erfasst haben, zählen nicht.

Der Feed /new-visits liefert ein Unternehmen, wenn dieser erste Besuch im Zeitraum liegt. Wenn er vor from_date lag, fehlt das Unternehmen, auch wenn es Ihre Website seitdem oft besucht hat.

Für denselben Besuch schließen sich company.identified und company.returned aus.

Ein neuer Webhook meldet nur Besuche ab seiner Einrichtung. Er meldet Unternehmen, die Ihre Website schon vorher besucht haben, als company.returned. Sie fragen frühere neue Unternehmen mit /new-visits ab.

Zeitraum und Antwort

Die drei Feeds nehmen domain, from_date und to_date an. Wenn Sie keinen Zeitraum angeben, gelten die letzten 30 Tage bis jetzt.

  • Zeitraum: Er beginnt mit from_date und endet direkt vor to_date. Ein Datum ohne Uhrzeit schließt als to_date den ganzen Tag ein. Mehr dazu unter Zeiträume und Zeitzonen.
  • Keine Seiten: Die Antwort enthält alle Zeilen auf einmal in result. Weil die Feeds weder page noch page_size kennen, wählen Sie für große Ergebnisse einen kürzeren Zeitraum.
  • Reihenfolge: Die Feeds liefern die Zeilen in keiner festen Reihenfolge.
  • Eine Zeile pro Unternehmen: Jedes Unternehmen steht höchstens einmal in einem Feed, kann aber in mehreren Feeds stehen.
  • Alle Felder: Jede Zeile hat dieselben Felder, und nur bei verborgenen Unternehmen kommt blurred dazu. Was Webmetic nicht kennt, ist null, bei directors und nace_codes eine leere Liste.
  • Schlüssel: Sie brauchen den Visitor-Intelligence-Schlüssel. Wenn domain nicht zu Ihrem Konto gehört, antwortet die API mit API_KEY_NOT_AUTHORIZED, wie unter Fehler beschrieben.
  • Limits: Es gilt eine Anfrage pro Sekunde je Endpunkt, wie unter Anfragelimits beschrieben. Die Feeds und die Webhooks kosten keine Credits.

Aufbau einer Zeile

Jede Zeile ist ein Unternehmen mit den Feldern von Company. In den Feeds fehlen davon organization_type, primary_color, secondary_color, wz2025_codes und die Texte what_they_do_*, how_they_make_money_* und target_audience_*. Dazu kommen diese Felder:

FeldTypBeispielBeschreibung
sessionsarrayDie Besuche, die zur Regel passen, als Session mit den Seitenaufrufen in user_data, nach Zeit sortiert, die älteste zuerst.
timestamp, weburl, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_campaign_id, click_id, click_type, session_duration, session_time, visitor_city, visitor_country, visitor_zip, visitor_country_codewie in der Session"2026-10-14T08:12:05.214000"Kopien aus der frühesten Session in sessions.
sessions_totalinteger1Die Zahl der Sessions in sessions.
pages_totalinteger3Die Zahl der Seitenaufrufe in diesen Sessions.
blurredbooleantrueNur bei verborgenen Unternehmen im Free-Plan, sonst fehlt das Feld.

Welche Besuche in sessions stehen und in sessions_total und pages_total zählen, hängt vom Feed ab:

  • /intensive-visits: nur die intensiven Besuche im Zeitraum.
  • /returning-visits und /new-visits: alle Besuche des Unternehmens im Zeitraum.

Beispiel

Das Beispiel zeigt eine Zeile aus /intensive-visits in gekürzter Form: Es fehlen die meisten Felder mit null und einige Felder der Session.

GET /intensive-visits
{
  "result": [
    {
      "company_id": "41ea486a9c95",
      "company_name": "Bergquell Mineralbrunnen GmbH",
      "city": "Freising",
      "country_code": "DE",
      "company_url": "www.bergquell.example",
      "linkedin": null,
      "employee_count": [201, 500],
      "lead_score": 88.0,
      "fit_score": 92,
      "relevance_score": 80.96,
      "sessions": [
        {
          "timestamp": "2026-10-14T08:12:05.214000",
          "session_id": "01M4WQFX6YM2X5V8T4N6R1C0DZ",
          "weburl": "https://ihre-website.de",
          "utm_source": "linkedin",
          "utm_medium": "social",
          "utm_campaign": "messe-2026",
          "session_duration": 309.0,
          "session_time": 103.0,
          "visitor_city": "Freising",
          "visitor_country_code": "DE",
          "user_data": [
            {
              "timestamp": "2026-10-14T08:12:05.214000",
              "document_location": "https://ihre-website.de/preise",
              "time_spent": 95.0
            },
            {
              "timestamp": "2026-10-14T08:13:40.214000",
              "document_location": "https://ihre-website.de/abfuellanlagen",
              "time_spent": 150.0
            },
            {
              "timestamp": "2026-10-14T08:16:10.214000",
              "document_location": "https://ihre-website.de/kontakt",
              "time_spent": 64.0
            }
          ]
        }
      ],
      "timestamp": "2026-10-14T08:12:05.214000",
      "weburl": "https://ihre-website.de",
      "utm_source": "linkedin",
      "utm_medium": "social",
      "utm_campaign": "messe-2026",
      "utm_term": null,
      "session_duration": 309.0,
      "session_time": 103.0,
      "visitor_city": "Freising",
      "visitor_country_code": "DE",
      "sessions_total": 1,
      "pages_total": 3
    }
  ]
}

Sonderfälle

  • Free-Plan: Unternehmen, die Sie im Free-Plan nicht sehen, stehen trotzdem in den Feeds. Ihre Zeile behält company_id, hat blurred: true und einen Platzhalter in company_name. Alle anderen Felder sind null, auch sessions_total und pages_total. In den Sessions haben nur session_id und timestamp einen Wert. Alle übrigen Session-Felder sind null, und user_data ist leer.
  • Webhooks im Free-Plan: Webhooks melden nur die Unternehmen, die Sie im Free-Plan sehen. Verborgene Unternehmen lösen kein Ereignis aus. Mehr dazu unter Pläne.

Verwendet von

  • Feeds: /intensive-visits, /returning-visits und /new-visits.
  • Webhooks: Die Webhook-Ereignisse heißen company.intensive_visit, company.returned und company.identified. Mehr dazu unter Webhooks. Ein Ereignis enthält ein Unternehmen und einen einzelnen Besuch, keine Zeile wie im Feed. Unter Menü > Integrationen > Webhooks heißen sie Interessiertes Unternehmen, Wiederkehrendes Unternehmen und Neues Unternehmen.
  • Dashboard: Die Benachrichtigungen Interessierte Unternehmen, Wiederkehrende Unternehmen und Neue Unternehmen nutzen die Regeln der Feeds.
  • KI-Assistent: Auch der KI-Assistent ruft die Besuchsarten ab, mit dem Tool get_visit_highlights.

Auf dieser Seite

RegelnIntensivWiederkehrendNeuZeitraum und AntwortAufbau einer ZeileBeispielSonderfälleVerwendet von