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 gets | Survey events as tracked events on the user |
| Events | Survey shown, started, submitted, partially submitted and dismissed |
| Anonymous respondents | Supported, with Include anonymous respondents on |
| User profile | Updated with the user's traits when Update the user's profile is on |
| Status | Available |
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
- In Amplitude, open Settings (the gear icon) and go to Organization settings → Projects.
- Click the project that should get the survey events.
- On the General tab, copy the API Key and the Secret Key.
- 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
- In Encatch, open Data sync → Survey events and click Add connection.
- Choose Amplitude.
- Enter a Name you'll recognise in the list and in Logs.
- Fill in the Amplitude settings:
| Field | What to enter |
|---|---|
| Region | North America (default) or Europe, as noted in Step 1. |
| API Key | The project's API Key. |
| Secret Key | The project's Secret Key. |
- 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
- Under Surveys, choose All surveys or Only these surveys.
- 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.
- Rename an event if you want another name in Amplitude. The defaults are
encatch_survey_shown,encatch_survey_started,encatch_survey_submitted,encatch_survey_partialandencatch_survey_dismissed. - To also send responses of people who are not signed in, turn on Include anonymous respondents.
- 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 see | What it means | What to do |
|---|---|---|
| Key refused | The API Key or Secret Key is wrong, or belongs to another project | Copy both keys again from the project's General tab and paste them with Replace |
| Delivered, but nothing in Amplitude | The region is wrong | Check the address you sign in at and set Region to match |
| Skipped | Amplitude does not accept the user's ID | Choose another identifier or a fallback in Advanced options |
Was this page helpful?
