Via the Amplitude destination, Hightouch can create and sync users.
To find the setup keys, navigate to Settings -> Projects -> [Your Project] -> General. We only need the API key; secret key authentication is not required.
In this mode, new users will be inserted into Amplitude and all user attributes will be kept up-to-date within Amplitude.
This mode is good for the following scenarios:
You want to push objects into Amplitude and want to keep the data up-to-date
Upsert has three configuration parameters:
Name | Details |
Hightouch Column Containing Amplitude User ID | The name of the Amplitude column (id, created_at, first_name) that acts as distinct ID in Amplitude. |
Hightouch to Amplitude Default Field Mappings | A list of common user attributes that will be pushed to new users in Amplitude. |
Hightouch to Amplitude Custom Field Mappings | A list of custom user attributes that will be pushed to new users in Amplitude. |
In addition, Hightouch will also append the query ID (found in the url bar) to the ht_query
list property in Amplitude i.e. if the user is part of the queries with IDs 2 and 7, Amplitude will have ht_query: [2,7]
.
User properties only apply on the next event after the property has been changed, and does not apply retrospectively. For more information, check out Amplitude's FAQ.