Via Amplitude Webhooks
- Yuri Lapin
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?
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
As you can see from screenshoot the required headers are also defined automatically.
Header | Value |
|---|---|
Content-Type | application/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
"someKey" : "${input.user_someUserProperty}" and
"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
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
By default the request header should be <Content-Type, application/json>. Please check.
By default Amplitude is sending POST request. If there’re options make sure it’s POST.
Make sure journy.io WriteKey is correct one
Make sure your parameters/properties definition (escaping, markdown, etc.) are not making the result JSON invalid. Try without them!