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