Amplitude integration
UserGist sends core events through Amplitude HTTP V2. Choose Default / US or EU to match the Amplitude project's data residency.
Connect
- Copy the project's API key from Amplitude project settings.
- Open UserGist → App settings → Integrations → Amplitude.
- Select the same data region, choose event categories, then connect.
- Find UserGist Integration Connected in Amplitude's live event stream or User Look-Up using the synthetic device ID shown by UserGist.
Identity mapping
| UserGist | Amplitude |
|---|---|
anonymousId | device_id |
externalId | user_id |
| Event UUID | insert_id |
Anonymous IDs represent an installation, so they belong in device_id—never user_id. Once UserGist.identify() succeeds, later events include the same device ID and the stable external account ID. UserGist User Identified creates the anonymous-to-known link.
Align with an existing Amplitude SDK
Use the same IDs in both SDKs:
const anonymousId = await waitForUserGistAnonymousId()
amplitude.setDeviceId(anonymousId)
const result = await UserGist.identifyAsync(account.id, properties, subjectToken)
if (result === 'synced') amplitude.setUserId(account.id)On logout, await UserGist.reset(), reset Amplitude, then set Amplitude's device ID to the newly generated UserGist anonymous ID. Direct app analytics may use names such as Checkout Completed; UserGist-forwarded events always start with UserGist.