Empower your product teams with richer data from your warehouse to perform deeper analysis and better understand user behavior
Supported syncing
| Type | Description | Supported Sync Modes |
|---|---|---|
| Objects | Sync records to objects such as users or organizations in Amplitude | Upsert |
| Events | Sync records as events to Amplitude. This is often in the form of a track call | Insert |
For more information about sync modes, refer to the sync modes docs.
Connect to Amplitude
Go to the Destinations overview page and click the Add destination button. Select Amplitude and click Continue. You can then authenticate Hightouch to Amplitude by entering these fields into Hightouch:
- API Key: You can find your API key by following these instructions in Amplitude's docs.
- Region: This is either a Standard server or EU residency server.
Once you've entered these fields, click Continue. Give your destination a descriptive name and Finish the destination connection setup.
Sync configuration
Once you've set up your Amplitude destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Amplitude destination you want to sync to.
Objects
Hightouch can sync data to either User and Group objects. A dropdown is available to select between Users and Groups when configuring an Amplitude sync.
This integration only supports the Upsert mode. In this mode, Hightouch inserts new users or groups into Amplitude and keeps all user attributes up-to-date.
Record matching
Hightouch matches rows from your model to Amplitude users by Amplitude User ID or Amplitude Device ID. Select the model column that contains these values if you are syncing user objects. See Amplitude's docs for more on identifying users.
Hightouch matches rows from your model to Amplitude groups by Group Value. Select the model column that contains these values if you are syncing groups.
Field mapping
You can sync columns from your source to Amplitude's default and custom fields. User properties only apply on the next event after the property has been changed, and don't apply retrospectively. For more information, check out Amplitude's FAQ.
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options for Amplitude objects:
| Behavior | Description |
|---|---|
| Do nothing | Keep the customer or group record in Amplitude with all its synced fields |
| Clear | Remove all the mapped fields, but keep the record in Amplitude |
Events
Hightouch supports sending events of a given name, for example, Signed Up. Enter this name and choose the model column containing the either user ID or device ID. You can also select the model column containing the event timestamp. If the timesamp field is empty, Hightouch uses the time the event arrives at the server.
Hightouch accepts a normal date time format for the timestamp, and automatically converts it to the format required by Amplitude.
Field mapping
Hightouch allows you to pass data to the default properties and the custom event properties of an Amplitude event.
Tips and troubleshooting
Common errors
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.