Heap
Send Encatch survey events to Heap - where to find the details in Heap and how to set up the connection
Overview
The Heap connector sends survey events to a Heap environment as server-side events, with the user's identity and, if you choose, their traits as user properties.
| What it gets | Survey events as server-side events |
| 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:
- A Heap environment — the one that should get the events
- Its App ID — the environment's ID (Step 1)
- Its data residency — United States, or Europe if your account uses Heap's EU data residency
Step 1: Get your App ID in Heap
- In Heap, open Account → Manage → Projects.
- Find the environment that should get the survey events and copy its ID. This is the App ID.
- Check which region your Heap account is on. Choose Europe only if the account uses Heap's EU data residency.
Pick the right region. Heap answers success for events sent to the wrong region and then drops them, so Test connection still passes. Always check that the test event appears in Heap's Live data feed.
Step 2: Add the connection in Encatch
- In Encatch, open Data sync → Survey events and click Add connection.
- Choose Heap.
- Enter a Name you'll recognise in the list and in Logs.
- Fill in the Heap settings:
| Field | What to enter |
|---|---|
| Data residency | United States (default) or Europe. |
| App ID | The environment's ID. |
- Press Test connection. Encatch shows what Heap 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 Heap. 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 Heap
Test connection sends one event named encatch_test_event. In Heap, open Data → Live data feed and check that the test event appears within a few seconds. Heap's Users view lists only users with sessions, so to see survey events by user, build a chart on the event and group it by Identity.
Good to know
- Profile update. With Update the user's profile on, the user's Encatch traits are set as Heap user properties.
- Anonymous respondents arrive without an identity, under the device ID.
- Rate limit. Heap limits each person (30 requests per 30 seconds), not the connection as a whole.
Troubleshooting
| What you see | What it means | What to do |
|---|---|---|
| Delivered, but nothing in the Live data feed | The data residency is wrong | Switch Data residency, save and test again |
| Events arrive, users don't show in Users | Heap lists only users with sessions there | Use a chart grouped by Identity |
Was this page helpful?
