api-referenceGET
GET
https://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. TransmettezwebsiteId ou domain 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
| Paramètre | 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 réponse
| Paramètre | Taper | Description |
|---|---|---|
identity | object | Localisation géographique, type d'appareil, navigateur, système d'exploitation et dimensions du viewport de la dernière page vue |
source | string | null | Source de trafic originale qui a amené ce visiteur (domaine référent 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, dernière URL, objectifs atteints et liste des pages visitées |
revenue | object | Résumé des revenus : totalRevenue, indicateur isCustomer, timeToFirstConversion (secondes, ou null) |
profile | object | null | Données utilisateur identifiées (userId, name, email) si identify a été appelé. Null pour les visiteurs anonymes |
activityTimeline | array | Liste chronologique fusionnée de toutes les pages vues, objectifs atteints et paiements pour ce visiteur |
Exemple de requête (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
}
]
}
}