Skip to main content

How to set up Amplitude

Authentication

Amplitude requires API credentials:
  1. Log in to your Amplitude account
  2. Navigate to SettingsProjects → Select your project
  3. Find your credentials:
    • Region: US or EU (based on your data location)
    • API Key: Your project API key
    • Secret Key: Your project secret key
  4. Enter all credentials in Cargo when connecting

Amplitude data models

Fetch events

Pull product analytics events from Amplitude into Cargo. Configuration:
  • Start date: Begin fetching events from this date
Features:
  • Incremental sync (only new events since last sync)
  • Minimum 12-hour sync interval
  • Unifies as contact events
Data includes:
  • Event name
  • User ID
  • Event properties
  • Timestamp
  • Session data

Event data structure

Amplitude events typically include:
FieldDescription
event_typeName of the event
user_idUser identifier
event_timeWhen the event occurred
event_propertiesCustom event data
user_propertiesUser attributes
platformDevice platform
countryUser’s country
cityUser’s city

Best practices

  • Define key activation events in Amplitude
  • Use consistent user IDs that map to your CRM
  • Set meaningful sync intervals based on your use case
  • Combine Amplitude data with enrichment for complete profiles
  • Build lead scoring models using product engagement signals

Use cases

  • Lead qualification: Score leads based on product usage
  • Sales enablement: Surface product usage data to sales
  • Customer success: Monitor account health
  • Marketing: Trigger campaigns based on behavior