Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Use Amplitude as a data source for Chartcastr. Connect your project with an API Key + Secret Key and Chartcastr will pull active user metrics, top events, funnel conversion, cohort retention, custom event overlays, and UTM-broken-down traffic to generate charts delivered automatically to Slack or email. Chartcastr connects with read-only access via Amplitude’s Dashboard REST API — no SDK changes, no data export required.

​
Setup

1

Find your Amplitude API Key + Secret Key

In Amplitude, open Settings → Organization Settings → API and Secret Keys. The API Keys tab lists each project’s key — copy the key value for the project you want to chart.
Amplitude Organization Settings showing the API and Secret Keys page with the API Keys tab selected and a list of project API keys
Switch to the Secret Keys tab and click Show to reveal the matching secret for the same project.
Amplitude API and Secret Keys page with the Secret Keys tab selected, showing a Show button to reveal the project's secret key
Anyone with the Secret Key can query your project’s data. Chartcastr stores it encrypted at rest with AES-256-GCM, but treat the key as a credential and rotate it through Amplitude if it ever leaks.
2

Connect in Chartcastr

In Chartcastr, go to New Connection and select Amplitude as a source. Pick US or EU region, paste the API Key + Secret Key, and click Test & Connect.
Region: Use US for amplitude.com or EU for analytics.eu.amplitude.com. The region drives which API host we hit and is locked once connected — disconnect and reconnect to switch regions.
3

Confirm your pageview event

After connecting, Chartcastr auto-detects your pageview event by looking for common names ([Amplitude] Page Viewed, Page Viewed, pageview, etc.) in your top events. You can override it with any event from your project — pick Pick a different event in the connect modal.
4

Select a metric

Choose a chart type. Funnel metrics ask you to pick an ordered 2–5 event sequence; the Custom Events Overlay asks you to pick up to 5 events; the UTM Traffic and UTM Conversion charts ask you to pick a UTM dimension (utm_source, utm_medium, utm_campaign, utm_content, utm_term) and 1–5 specific values to overlay as separate lines.
5

Create a connection

Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.

​
Available Metrics

Chartcastr supports 15 pre-built Amplitude metrics across seven categories.

Active Users

DAU, WAU, MAU, new users, and a combined DAU/WAU/MAU chart for engagement tracking.

Events

Total events, unique event users, and a stacked Top Events chart.

Pageviews

Total pageviews and unique pageview users using your auto-detected pageview event.

Funnels

Overall conversion rate and per-step user counts for an inline 2–5 event funnel.

Retention

Average weekly cohort retention curve based on returning user activity.

Custom Events Overlay

Pick up to 5 events and overlay them as lines on a single chart.

UTM Traffic & Conversion

Pick a UTM dimension and 1–5 specific values; we render each value as its own line on a single chart so you can compare Google vs Reddit vs Twitter (or any campaigns) at a glance.

View all available charts

See the full list of Amplitude metrics with chart types and descriptions.

​
UTM Breakdowns

Amplitude’s JS SDK automatically captures utm_source, utm_medium, utm_campaign, utm_content, and utm_term as event properties on every event. The UTM Traffic and UTM Conversion charts let you pick one of those dimensions and overlay up to 5 specific values as separate lines.
  • UTM Traffic — counts pageview events per UTM value (e.g. pageviews from utm_source=google vs utm_source=reddit).
  • UTM Conversion — counts a chosen conversion event (e.g. Sign Up) per UTM value, so you can compare conversion volume across campaigns.
Pick a value list with care: with 5 lines on one chart the hard cap is what keeps it readable in a Slack post. We pull the top-50 most-frequent values per dimension so you can find rare campaigns via the search box.

​
Authentication

Chartcastr uses HTTP Basic auth with your Amplitude API Key + Secret Key. The secret is encrypted at rest with AES-256-GCM. We never store project-token-style credentials — only the API key pair, which is scoped to a single Amplitude project and is read-only at the Dashboard REST API level.

​
Rate Limits

Amplitude’s Dashboard REST API is capped at 360 requests/hour per project with a maximum of 6 concurrent queries. Chartcastr’s pulse cadence (daily/weekly) keeps you well below the cap. If you hit the limit you’ll see a clear “rate limit hit” error in the chart preview — wait an hour and try again.

​
Next Steps

Slack destination

Deliver Amplitude charts to your Slack channels with AI summaries in the thread.

Email destination

Send pulse charts to a distribution list on the cadence that fits your team.