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

Privacy

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.

Tip

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

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

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/25/2020, 2:32:33 PM