Custom Insight (Webhook) Documentation

Data URLs

The URL you provide while creating a custom insight is called the data URL. It must be a valid http or https URL.

Example Data URL

https://www.yourcompany.com/path/to/data.json

Data URL with Basic Authentication

https://username:password@www.yourcompany.com/path/to/data.json

Data Strategies & Value Types

A data strategy tells Dasheroo how to treat a statistic over time. There are two strategies we support:

• continuous (default) - a rolling total (example: the size of a mailing list)
• interval - resets to zero at the beginning of each day (example: new Facebook Fans)

If you don't provide a strategy, Dasheroo will assume it's continuous.

A Value type tells Dasheroo what type of metric to expect. There are three value types support:

• integer
• percentage
• float

Setting a Data Strategy & Value Types

  {    "my_statistic_1": {      "type": "integer",      "strategy": "continuous",      "value": 1,      "label": "My Statistic 1",      "order": 0    },    "my_statistic_2": {      "type": "float",      "strategy": "interval",      "value": 0.5,      "label": "My Statistic 2",      "order": 1,    }  }

Response Formats

The response format must correspond with the custom insight report type you selected.

Single Statistic with Histogram

  {    "my_statistic": {      "type": "integer",      "value": 1,      "label": "My Statistic"      }  }

Multiple Statistics with Histogram

  {    "my_statistic_1": {      "type": "integer",      "value": 1,      "label": "My Statistic 1",      "order": 0    },    "my_statistic_2": {      "type": "percentage",      "value": 0.5,      "label": "My Statistic 2",      "order": 1    },    "my_statistic_3": {      "type": "percentage",      "value": 0.25,      "label": "My Statistic 3",      "order": 2    }  }