Tracking Events in a Conversation

Events

You may wish to track certain events in conversations, such as:

JSON Format

The JSON that you can send to track an event is:

For each event type, you can pass additional properties:
customEvent

revenueEvent

pageLaunchEvent

shareEvent

referralEvent

Tracking Custom Events

Post to the endpoint

https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>

Make sure to set the ‘Content-Type’ header to ‘application/json’

The data to POST should pass the following data:

{
  "name": "trackMeEvent",
  "type": "customEvent",
  "userId": "967295313370594",
  "extraInfo": {
    "start": 1500504070512,
    "difference": 374,
    "end": 1500504070886
  }
}

Sample cURL

curl -X POST -H "Content-Type: application/json"
     -d '{"name":"trackMeEvent","type":"customEvent","userId":"967295313370594","extraInfo":{"start":1500504070512,"difference":374,"end":1500504070886}}'
     'https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>'

Tracking Revenue Events

Post to the endpoint

https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>

Make sure to set the ‘Content-Type’ header to ‘application/json’

The data to POST should pass the following data:

{
  "name": "boughtSandwich",
  "type": "revenueEvent",
  "userId": "967295313370594",
  "amount": 17.45,
  "metadata": {
    "productName": "Ham Sandwich",
    "sku": "abc123123"
  }
}

Sample cURL

curl -X POST -H "Content-Type: application/json"
     -d '{"name":"boughtSandwich","type":"revenueEvent","userId":"967295313370594","amount":17.45,"metadata":{"productName":"Ham Sandwich","sku":"abc123123"}}'
     'https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>'

Tracking Page Launch Events

Post to the endpoint

https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>

Make sure to set the ‘Content-Type’ header to ‘application/json’

The data to POST should pass the following data:

{
  "name": "Launched Detail Page",
  "type": "pageLaunchEvent",
  "userId": "967295313370594",
  "extraInfo": {
    "url": "https://www.dashbot.io/"
  }
}

Sample cURL

curl -X POST -H "Content-Type: application/json"
     -d '{"name":"Launched Detail Page","type":"pageLaunchEvent","userId":"967295313370594","extraInfo":{"url":"https://www.dashbot.io/"}}'
     'https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>'

Tracking Share Events

Post to the endpoint

https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>

Make sure to set the ‘Content-Type’ header to ‘application/json’

The data to POST should pass the following data:

{
  "name": "sharedLink",
  "type": "shareEvent",
  "userId": "967295313370594",
  "sharedMessage": {
    "text": "come check out this bot"
  }
}

Sample cURL

curl -X POST -H "Content-Type: application/json"
     -d '{"name":"sharedLink","type":"shareEvent","userId":"967295313370594","sharedMessage":{"text":"come check out this bot"}}'
     'https://tracker.dashbot.io/track?platform=sms&v=11.1.0-rest&type=event&apiKey=<strong>API_KEY_HERE</strong>'