Upgrade guide

What changed in Acme Analytics

Pick the version you're on and the one you're moving to. Everything you need to change is listed first.

Releases
7
Breaking
3
Deprecations
3

3 breaking changes

  1. v2.0.0

    acme.track() no longer accepts a callback

    @acme/analytics SDK

    Replace acme.track(name, props, cb) with await acme.track(name, props). Wrap calls in try/catch if you relied on the callback error argument.

  2. v2.0.0

    Page-number pagination removed from GET /v1/events

    REST API

    Use the next_cursor value from each response as ?cursor= on the next request. The page and per_page parameters now return 400.

  3. v2.0.0

    Funnel step ids are now strings

    REST API, webhooks

    Store funnel step ids as strings; numeric ids are no longer returned.

3 deprecations

  • v1.5.0acme.track(event, props, callback)→ use await acme.track(event, props)· removed in 2.0.0Callbacks are replaced by promises.
  • v1.6.0GET /v1/events?page=N→ use GET /v1/events?cursor=…· removed in 2.0.0Page-number pagination is slow on large projects.
  • v1.8.0ACME_API_KEY environment variable→ use ACME_PROJECT_TOKEN· removed in 3.0.0

Releases in this range

  1. v2.0.0NewFunnels 2.0 with drop-off insights
  2. v1.8.0ImprovedDashboards load 3× faster
  3. v1.7.1FixedCSV exports now respect your timezone
  4. v1.7.0NewSlack alerts for anomaly detection
  5. v1.6.0ImprovedA redesigned event explorer
  6. v1.5.1FixedFixed duplicate sessions on Safari 18
  7. v1.5.0NewTeam spaces & granular permissions