# Track: improving results by reporting customer behavior

This action allows you to notify Visii of how the end user interacts with Visii recommendations. To see which events will get you access to a personal client Dashboard, check the Events page.


Please be mindful not to send any personally identifiable information, and to review our section on privacy. We provide information to share with your customers to inform them about how we use their data. By sending us your customer information indicates you have their consent, as outlined in our Data Processing Agreement.


To link requests to the Vision API with analytics, we suggest to populate the v field with the same identifiers you send in the track body.

E.g. /explore?v=user_id:7462402,page_type:pdp

# Input


POST /orgs/:organisation/datasets/:dataset/track

Field Type Required Value Description
organisation String yes The organisation name
dataset String yes The dataset name

# Body

Field Type Required Value Description
message String yes The event name, consult the Events page
data Object no Additional event properties, consult the Events page

# Example

  message: "Page Loaded",
  data: {
    anonymous_id: "8c772995-b629-4051-a4e9-b7a30dbe5b32",
    user_id: "7462402",
    user_ip: "123.124.125.xxx",
    page_url: "https://www.my-website.com/products/my-awesome-product",
    page_referrer: "https://www.my-website.com",
    page_user_agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) ...",
    page_type: "pdp",
    timestamp: 1577836800000,
    ab_tests: [
        name: "visii-recommends",
        group: "visii"
        name: "homepage-cta",
        group: "control"

# Request


my-dataset-api-token is a dataset token, not an organisation token

curl -X POST \
     -H "Authorization: token my-dataset-api-token" \
     -H "Accept: application/vnd.visii.v2+json" \
     -d '{"message":"Page Loaded"}' \

# Response

Field Type Value Description
status String The status of the response
HTTP/1.1 200 OK
  "status": "ok"
Last Updated: 2/25/2020, 2:32:33 PM