API-Referenz

Echtzeit-Karte

Name: Flowsery
Author: Flowsery

Echtzeit-Besucherdaten mit Geo-Standorten abrufen

GEThttps://analytics.flowsery.com/realtime/map

Aktive Besucher (letzte 10 Minuten), aktuelle Ereignisse und aktuelle Zahlungen fuer die Echtzeit-Kartenansicht abrufen.

API-Schluessel (Bearer-Token)

Antwortstruktur

visitors[] -- Details zu aktiven Besuchern einschliesslich Standortkoordinaten, Systeminformationen, aktueller URL, Referrer, Sitzungsdaten, Kundenstatus, Profildaten und Conversion-Wahrscheinlichkeitsbewertungen.

conversionMetrics -- Basis-Conversion-Rate und Durchschnittswert fuer die Bewertung.

recentEvents[] -- Aktuelle Seitenaufrufe und Zielabschluesse innerhalb des Zeitfensters.

recentPayments[] -- Aktuelle Zahlungsereignisse innerhalb des Zeitfensters.

Hinweise

Das Zeitfenster umfasst die letzten 10 Minuten fuer aktive Besucher, aktuelle Ereignisse und aktuelle Zahlungen. <code>conversionLikelihood</code> und <code>conversionMetrics</code> sind nur vorhanden, wenn genuegend Conversion-Modellierungsdaten vorliegen. <code>hasConversionPredictions</code> ist false, wenn noch keine Conversion-Metriken verfuegbar sind.

Beispielanfrage (curl)

curl --request GET \
  --url https://analytics.flowsery.com/api/v1/realtime/map \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": {
    "count": 2,
    "visitors": [
      {
        "visitorId": "b971cbbf-7ce2-4925-902b-8f95a5fb3449",
        "location": {
          "city": "Denver",
          "region": "US-CO",
          "countryCode": "US"
        },
        "system": {
          "browser": { "name": "Chrome" },
          "os": { "name": "Mac OS" },
          "device": { "type": "desktop" }
        },
        "currentUrl": "/pricing",
        "referrer": null,
        "sessionStartTime": "2026-02-06T05:27:20.000Z",
        "visitCount": 1,
        "params": {
          "ref": null,
          "source": null,
          "via": null,
          "utm_source": null,
          "utm_medium": null,
          "utm_campaign": null,
          "utm_content": null,
          "utm_term": null
        },
        "latitude": 39.7391,
        "longitude": -104.9866,
        "isCustomer": false,
        "customerName": null,
        "customerEmail": null,
        "profileData": {
          "displayName": null,
          "userId": null,
          "hasProfile": false,
          "isRandomName": true
        },
        "conversionLikelihood": {
          "score": 65,
          "confidence": 0.763,
          "isBaseline": false,
          "dimensionMatches": ["device", "os", "browser", "country", "referrer"],
          "raw": {
            "conversionRate": 0.0056,
            "averageValue": 246.98,
            "expectedValue": 1.37
          }
        }
      }
    ],
    "conversionMetrics": {
      "baselineConversionRate": 0.0044,
      "baselineAverageValue": 243.63
    },
    "hasConversionPredictions": true,
    "recentEvents": [
      {
        "_id": "69857bb827ddefd472fb2b09",
        "type": "pageview",
        "visitorId": "b971cbbf-7ce2-4925-902b-8f95a5fb3449",
        "timestamp": "2026-02-06T05:27:20.000Z",
        "path": "/pricing",
        "countryCode": "US",
        "extraData": {},
        "referrer": null,
        "customerName": null,
        "amount": null,
        "displayName": null
      }
    ],
    "recentPayments": [
      {
        "_id": "69857bb827ddefd472fb2b12",
        "type": "payment_received",
        "timestamp": "2026-02-06T05:26:10.000Z",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "amount": 49,
        "currency": "USD",
        "renewal": false,
        "displayName": null,
        "isNew": false,
        "visible": true
      }
    ]
  }
}