# 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.

# 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: "",
    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/18/2020, 7:52:05 PM