> ## Documentation Index
> Fetch the complete documentation index at: https://help.superhawk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude

> Connect Amplitude to bring product usage and feature adoption into Superhawk.

Amplitude gives Superhawk the product-usage side of the picture: which features an account uses, how often, and whether that is going up or down.

## Connecting

<Steps>
  <Step title="Get your Amplitude keys">
    In Amplitude, go to **Settings → Projects** and copy the **API Key** and the **Secret Key** for the project you want to connect.
  </Step>

  <Step title="Open Integrations in Superhawk">
    Go to **Integrations** and find Amplitude under **Product & Analytics**.
  </Step>

  <Step title="Enter the keys and choose your region">
    Paste both keys, then select your Amplitude region:

    * **US** for `amplitude.com`
    * **EU** for `analytics.eu.amplitude.com`
  </Step>

  <Step title="Wait for the first sync">
    Historical events are pulled in first, which takes longer than subsequent syncs.
  </Step>
</Steps>

<Warning>
  **Get the region right.** Choosing the wrong one produces an authentication failure rather than wrong data, so it fails loudly -- but it is the most common reason a correct set of keys is rejected. Check which Amplitude URL your team actually logs in at.
</Warning>

## Mapping events to features

Raw Amplitude events are not useful on their own. Superhawk maps them onto the feature catalog you define, so usage reads in your product's own vocabulary rather than as event names.

Set this up in [Features & Modules](/customer-success/modules). Without it, usage data arrives but cannot be read as adoption.

## What it feeds

* **[Feature usage](/accounts/feature-usage)** -- what each account uses, and what they do not
* **[Metrics](/customer-success/metrics)** -- usage-based metrics per account
* **[Account health](/customer-success/account-health)** -- usage trend as a health factor
* **[Signals](/signals/overview)** -- adoption gaps, usage collapse, and expansion indicators
* **[User breakdown](/accounts/user-breakdown)** -- who at the account is active

## Related

* [PostHog](/integrations/analytics/posthog) -- the alternative product analytics source
* [BigQuery](/integrations/warehouse/bigquery) -- for metrics computed from your own tables
* [Features & Modules](/customer-success/modules)