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