Welcome to Encatch Docs
Data syncBetaConnectorsAnalytics

Amplitude

Send Encatch survey events to Amplitude - where to find the details in Amplitude and how to set up the connection

Overview

The Amplitude connector sends survey events to an Amplitude project as tracked events, so you can chart survey reach and completion next to product usage, and build cohorts from answers.

What it getsSurvey events as tracked events on the user
EventsSurvey shown, started, submitted, partially submitted and dismissed
Anonymous respondentsSupported, with Include anonymous respondents on
User profileUpdated with the user's traits when Update the user's profile is on
StatusAvailable

What You'll Need

Before you start, make sure you have:

  • An Amplitude project — the project that should get the events
  • Its API Key and Secret Key — from the project's General tab (Step 1)
  • Access to project settings in Amplitude — a Manager or Admin role

Step 1: Get your keys in Amplitude

  1. In Amplitude, open Settings (the gear icon) and go to Organization settings → Projects.
  2. Click the project that should get the survey events.
  3. On the General tab, copy the API Key and the Secret Key.
  4. Note your region. If you sign in at app.eu.amplitude.com, the project is in Europe. Otherwise it is in North America.

Step 2: Add the connection in Encatch

  1. In Encatch, open Data sync → Survey events and click Add connection.
  2. Choose Amplitude.
  3. Enter a Name you'll recognise in the list and in Logs.
  4. Fill in the Amplitude settings:
FieldWhat to enter
RegionNorth America (default) or Europe, as noted in Step 1.
API KeyThe project's API Key.
Secret KeyThe project's Secret Key.
  1. Press Test connection. Encatch shows what Amplitude answered.

Encatch keeps the keys encrypted and never shows them again. To change one later, press Replace.


Step 3: Choose what to send

  1. Under Surveys, choose All surveys or Only these surveys.
  2. Under What is sent, tick the events to send. A new connection starts with Survey shown, started, submitted and dismissed ticked. Survey partially submitted is off until you tick it.
  3. Rename an event if you want another name in Amplitude. The defaults are encatch_survey_shown, encatch_survey_started, encatch_survey_submitted, encatch_survey_partial and encatch_survey_dismissed.
  4. To also send responses of people who are not signed in, turn on Include anonymous respondents.
  5. Open Advanced options to choose how users are identified, whether answers are sent and the rate limit.

Every option is explained in Connection settings.


Step 4: Save and start sending

Click Save. Saving does not start sending: press Start sending when you are ready. From then on events go out as they happen, and every delivery is listed in Logs.


Check it in Amplitude

Test connection sends one event named encatch_test_event. In Amplitude, look the event up in a chart or in the user look-up to confirm it arrived. Survey events then appear under the names you chose, for example encatch_survey_submitted.


Good to know

  • User IDs Amplitude refuses. Amplitude does not accept some user IDs (for example null, unknown, 0, -1). For this reason the form offers If the user doesn't have it, use even with User name chosen: a refused user name then goes to the fallback, or the event is skipped.
  • Anonymous respondents arrive as an anonymous Amplitude user, under the device ID.
  • Rate limit. A new connection starts at 3,000 events a minute. Amplitude's Free plan takes 100 requests a second (6,000 a minute); paid plans take far more. It also takes at most 30 events a second for one user.

Troubleshooting

What you seeWhat it meansWhat to do
Key refusedThe API Key or Secret Key is wrong, or belongs to another projectCopy both keys again from the project's General tab and paste them with Replace
Delivered, but nothing in AmplitudeThe region is wrongCheck the address you sign in at and set Region to match
SkippedAmplitude does not accept the user's IDChoose another identifier or a fallback in Advanced options

Was this page helpful?