Supported Data Sources For Hosted Embeds

The jQuery.EpochChart.js library itself can use data from any source, as long as it's properly formatted.

However, if you want this app to build a hosted embed for you, you'll need to supply data from one of two sources:

  1. Analytics data from:
    • Keen.io
    • Other services available by request.
  2. A JSON endpoint, serving raw data in the expected format.

Using your Analytics Data in a Hosted Embed:

From Keen.io:
  1. Paste the Series or Saved Query url from your Keen.io account that returns the data you'd like to use.
  2. Be sure to include your read_key so we can authenticate.
From other services:

Ideally, we'd pull data from other analytics services, such as Google Analytics or Mixpanel. Since I don't use these services in my own apps, I have yet to implement them.

If you'd like to be able to pull from a 3rd party analytics service besides one already supported, tweet me a request at @jfeldstein

Hosting your own JSON endpoint:

Data for your hosted embed needs to be served up from your endpoint in the following format. Dates should be Unix timestamps.

[
  [date, value],
  [date, value],
  ...
]

For example: (live example)

[
  [1382827634000,132],
  [1382914034000,112],
  [1383000434000,130],
  [1383086834000,165],
  [1383173234000,140],
  [1383259634000,148],
  [1383346034000,134]
]

Supported Event/Marker Sources for Hosted Embeds

The jQuery.EpochChart.js library itself doesn't care where you store the data for your markers, only that they're properly formatted when passed in.

However, if you want this app to provide a hosted embed, markers will need to be supplied from one of two sources:

  1. Link your embed to an ical calendar export, such as that from a Google Calendar.
  2. Link your embed to an endpoint serving a properly formatted JSON response.

Managing Events Data from a Google Calendar

Linking your embed to a Google Calendar's ical export lets you add or change the events shown on your chart by simply updating the calendar.

  1. Create a new google calendar.
  2. Find it's private iCal export URL by clicking the green Icalbutton button at the bottom of the settings page.
  3. Use the iCal url as the Marker Url for your new hosted embed.
  4. Add markers to your chart by updating your calendar.

Hosting your own JSON endpoint of event/marker data

To host your own events data, serve it up in the following format. Dates are Unix timestamps.

[
  [date, event_description],
  [date, event_description],
  ...
]

For example: (live example)

[
  [1382914034000, "Implemented new onboarding funnel"],
  [1383000434000, "Hired new sales guy"]
]