# 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

Endpoint

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.126",
    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

Note

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"}' \
     "https://api.visii.com/orgs/my-org/datasets/my-dataset/track"

# 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