...
How to forward Amplitude events to journy?
Label your events
First you need to label some of the key events you want pass to journy.
Go to Data>Explore raw events and Raw events table underneath.
...
Scroll through to find out the event you need and click Label event.
...
You can see a complete list of your labeled events at Labeled events page.
...
Create hooks
Go to Integrations>Directory and type Webhook
...
If it’s not turned on you might need to reach out to Heap Sales team to enable.
Click New WebHook
...
Create destination webhook
Go to Data>Destinations and click Add Destination
...
Search webhook and click Webhook in Messaging Destinations section
...
Put hook name and click Create Sync
...
Define hook configuration
Suggestion is to keep Webhook disabled till you configure it fully and test connection.
Amplitude webhook is a POST request. Exactly what we need for journy.io. If in future versions of Amplitude there will be an option to choose Method please specify POST.
...
For URL use
Make sure you add the following headersAs you can see from screenshoot the required headers are also defined automatically.
Header | Value |
|---|---|
Content-Type | application/json |
.. and construct JSON Click Send Events.
...
You need to customize the payload according to the Specs above.
While defining the payload you will most probably would need a mix of predefined constants and dynamic variables. To access Amplitude event and user data use
| Code Block | ||
|---|---|---|
| ||
"someKey" : "${input.user_someUserProperty}" |
and
| Code Block | ||
|---|---|---|
| ||
"anotherKey" : "${input.event_anotherEventProperty}" |
Check a complete list of available properties in Amplitude Documentation.
To get Journy.io WriteKey go to Connections and either use existing SDK connection or create a new one.
...
Test it out
Go to you App or website. Do the actions that will cause your Heap labeled events to happen.
Go to Heap and check they were recorded
...
| Info |
|---|
As of now (Jan’25) there’s no AuditLog for Webhooks in Heap so you won't be able to confirm the webhook was sent. You can check whether it was received in journy.io |
Go to your Connections in journy.io and find your SDK Connection. Click Logs and if already there Refresh.
...
Suggestion is to Test Connection before enabling the hook.
...
and verify the message is received in jounry.io plus you see the expected impact of the message on your journy.io data set.
...
Once this is becoming as usual we suggest to check Delivery and Debugger sections of the hook in Amplitude and respective Connection Log in journy.io. This is especially valuable during troubleshooting of specific use cases and changes.
Troubleshooting
Common mistakes are the following:
Make sure URL is correct one & matching event type - Identify, Group and Track
Make sure By default the request header should be <Content-Type, application/json>Header is specifiedFor now (Jan’25) Heap only supports POSTjson>. Please check.
By default Amplitude is sending POST request. If there’re options make sure it’s POST request.
Make sure journy.io key WriteKey is correct one
Make sure your parameters/properties definition (escaping, markdown, etc.) are not making the result JSON invalid. Try without them!
...