GET /visit/visitor
This endpoint returns the activity feed for a given user. It can be used to retrieve visits data collected by Kameleoon such as experiments and personalizations being triggered for the user or targeted segments.
Query Parameters
- siteCode string required
Id of the Kameleoon project
- currentVisit boolean
Set to true if you would like to get data for the current visit. Note: it is strongly recommended to provide the parameter "visitorCode" in that case. In the contrary, the last known visitor code associated to the provided mapping value is used to retrieve the current visit of the visitor. See descriptions of the parameters "visitorCode" and "mappingValue"
- maxNumberPreviousVisits int32 required
The maximum number of previous visits to return. Note: cross-device visitor history reconciliation of previous visits is performed if the parameter "mappingValue" is provided. In the contrary, the provided visitor code is used to retrieve the previous visits of the visitor
- visitorCode string
Visitor code (Kameleoon unique id for a visitor). Note: it is required if the parameter "mappingValue" is not provided. See descriptions of the parameters "currentVisit" and "maxNumberPreviousVisits"
- mappingValue string
Value of the custom data configured as a mapping identifier (acting as a visitor cross-device id) if applicable. Note: it is required if the parameter "visitorCode" is not provided. See descriptions of the parameters "currentVisit" and "maxNumberPreviousVisits"
- all boolean
Set to true if you would like to get all events (conversion, page, experiment, custom data..) for the given user
- staticData boolean
Set to true if you would like to get static data events (browser, browser version, device type, OS) for the given user. Note: it is ignored if the parameter "all" is provided with value true
- page boolean
Set to true if you would like to get page data events (URLs viewed) for the given user. Note: it is ignored if the parameter "all" is provided with value true
- conversion boolean
Set to true if you would like to get conversion events for the given user and for goals you have set up in your Kameleoon account. Note: it is ignored if the parameter "all" is provided with value true
- targetingSegment boolean
Set to true if you would like to get the targeted segments id for a given user. Note: it requires Kameleoon Audiences Explorer add-on or Kameleoon AI-Driven Personalization package. It is ignored if the parameter "all" is provided with value true
- experiment boolean
Set to true if you would like to get the targeted experiments id and variations id for a given user. Note: it is ignored if the parameter "all" is provided with value true
- weather boolean
Set to true if you would like to get weather conditions data (temperature, humidity, pressure...) collected by Kameleoon. Note: it is ignored if the parameter "all" is provided with value true
- customData boolean
Set to true if you would like to get custom data events for a given user. Note: only custom data that are not set as "local" can be retrieved. It is ignored if the parameter "all" is provided with value true
- product boolean
Set to true if you would like to get product events (product eans viewed) for a given user. Note: it is ignored if the parameter "all" is provided with value true
- personalization boolean
Set to true if you would like to get the targeted personalizations id and variations id for a given user. Note: it is ignored if the parameter "all" is provided with value true
- geolocation boolean
Set to true if you would like to get the geolocation data (country, region, city, postalcode, lattitude..) for a given user. Note: it is ignored if the parameter "all" is provided with value true
- prettyPrint boolean
Set to true if you would like a "pretty" printed response
- 200
- 400
- 401
- 403
- 429
- 500
Successful operation, youngest visits are rendered = JSON object {"currentVisit": <value = <visit>>, "previousVisits": <value = JSON array of <visit>>}, with <visit> = JSON object ("currentVisit" optional key)
Malformed request syntax
Failed authentication (missing token when required, bad token - malformed, expired, invalid signature)
Forbidden user-agent or access denied to restricted resource
Rate limited
Unexpected internal error