Topics
Overview
You might have your product analytics data already in tools like Heap, Amplitude, Mixpanel or similar and you integrated with such tool directly - via SDK, code snippets, etc. (not via Segment). And might also built around those tools to qualify/label events you find important and identify users/grouping them in cohorts.
Amazing! Most of these tools have Webhooks functionality to trigger on a particular events and this how you can bring data to journy - again via API/SDK or Segment.
What’s Amplitude?
Amplitude is a powerful product analytics platform that enables you to build better products by tracking and understanding user behavior.
Use Amplitude to track user data and gain insights into user engagement, retention, and revenue. Amplitude keeps your data trustworthy and secure, ensuring that you have access to accurate and reliable information. Amplitude offers powerful analytics tools that help answer questions about what happened, why it happened, and which actions to take next. With Amplitude, you can seamlessly share your work across teams, facilitating collaboration and driving growth.
What’s Amplitude Webhooks?
Amplitude Webhook streaming integration enables you to forward your Amplitude events and users to custom webhooks. This is a light-weight way to set a stream of event and user data out of Amplitude, to a URL of your choosing to enable any of your use cases.
The use case with streaming events from Amplitude to Webhook involves leveraging Amplitude's flexibility to forward event and user data to custom URLs of your choosing (e.g. journy.io Tracking API). This integration allows you to ingest customer event data from Amplitude and route it to preferred destination platforms, enabling various customizable use cases tailored to your specific business needs.
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
For URL use
Make sure you add the following headers
Header | Value |
|---|---|
Content-Type | application/json |
.. and construct JSON according to the Specs above.
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
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.
Troubleshooting
Common mistakes are the following:
Make sure URL is correct one & matching event type - Identify, Group and Track
Make sure <Content-Type, application/json>Header is specified
For now (Jan’25) Heap only supports POST. If there’re options make sure it’s POST request
Make sure journy.io key is correct one
Make sure your parameters/properties definition (escaping, markdown, etc.) are not making the result JSON invalid. Try without them!
Tip: Still have questions or need hands-on advice?
