Récupérer les données du visiteur

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/visitors/{visitorId}

Récupérez les données d'identité, d'activité, de revenus et de profil d'un visiteur spécifique à l'aide de l'ID visiteur interne renvoyé par Flowsery.

Jeton Bearer (jeton workspace ou clé API de site)

Les jetons d'espace de travail nécessitent un sélecteur de site Web

Les jetons de l'API Workspace peuvent accéder à tous les sites Web de l'espace de travail. Transmettez <code>websiteId</code> ou <code>domain</code> pour que Flowsery sache quel site Web interroger ou muter. Les clés API de site Web sont déjà limitées à un seul site Web, le sélecteur peut donc être omis.

Sélecteur de site Web

Parametre	Taper	Description
`websiteId`	`string`	ID de site Web à utiliser avec un jeton API d'espace de travail. Omettre lors de l'authentification avec une clé API de site Web.
`domain`	`string`	Site Web domain à utiliser avec un jeton API d'espace de travail lorsque websiteId n'est pas fourni. Omettre lors de l'authentification avec une clé API de site Web.

Identification du visiteur

Utilisez l'ID visiteur interne des enregistrements Flowsery ou des réponses API. Ne transmettez pas le cookie _fs_vid du navigateur directement comme paramètre de route.

Champs de reponse

Parametre	Taper	Description
`identity`	`object`	Localisation geographique, type d'appareil, navigateur, systeme d'exploitation et dimensions du viewport de la derniere page vue
`source`	`string \| null`	Source de trafic originale qui a amene ce visiteur (domaine referent ou source UTM)
`sourceIconUrl`	`string \| null`	URL du favicon de la source de trafic
`activity`	`object`	Nombre de visites et de pages vues, informations de temps, derniere URL, objectifs atteints et liste des pages visitees
`revenue`	`object`	Resume des revenus : totalRevenue, indicateur isCustomer, timeToFirstConversion (secondes, ou null)
`profile`	`object \| null`	Donnees utilisateur identifiees (userId, name, email) si identify a ete appele. Null pour les visiteurs anonymes
`activityTimeline`	`array`	Liste chronologique fusionnee de toutes les pages vues, objectifs atteints et paiements pour ce visiteur

Exemple de requete (curl)

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/visitors/{visitorId} \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": {
    "visitorId": "a3ab2331-989f-4cfa-91c6-2461c9e3c6bd",
    "identity": {
      "country": "South Korea",
      "countryCode": "KR",
      "region": "KR-44",
      "city": "Seosan City",
      "browser": { "name": "Chrome", "version": "133.0.0.0" },
      "os": { "name": "Mac OS", "version": "10.15.7" },
      "device": { "type": "Desktop" },
      "viewport": { "width": 1728, "height": 998 }
    },
    "source": "youtube.com",
    "sourceIconUrl": "https://icons.duckduckgo.com/ip3/youtube.com.ico",
    "activity": {
      "visitCount": 3,
      "pageViewCount": 8,
      "firstVisitAt": "2025-04-11T03:38:49.154Z",
      "lastVisitAt": "2025-04-11T03:38:49.154Z",
      "currentUrl": "example.com/",
      "visitedPages": [
        { "url": "example.com/", "timestamp": "2025-04-11T03:38:49.154Z" }
      ],
      "completedCustomGoals": [
        { "name": "newsletter_signup", "timestamp": "2025-04-11T03:38:54.253Z" }
      ]
    },
    "revenue": {
      "totalRevenue": 29.99,
      "isCustomer": true,
      "timeToFirstConversion": 3600
    },
    "profile": {
      "userId": "usr_123",
      "name": "John Doe",
      "email": "john@example.com"
    },
    "activityTimeline": [
      {
        "type": "payment",
        "timestamp": "2025-04-11T04:38:49.154Z",
        "url": null,
        "eventName": null,
        "amount": 29.99
      },
      {
        "type": "goal",
        "timestamp": "2025-04-11T03:38:54.253Z",
        "url": null,
        "eventName": "newsletter_signup",
        "amount": null
      },
      {
        "type": "pageview",
        "timestamp": "2025-04-11T03:38:49.154Z",
        "url": "example.com/",
        "eventName": null,
        "amount": null
      }
    ]
  }
}