Custom Insight (Webhook) Documentation

Plugging your own data into a Dasheroo dashboard is simple with our Custom Insight Webhook. All we need is URL with a JSON formatted response to retrieve it from.

Here's how to get started.

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
    }
  }
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request