Candu helps you build, iterate, and personalize your in-app content experiences. Measuring the impact of your content is essential.
You can send events captured in Candu back to Heap, enabling you to leverage Heap's analytics capabilities to gain insights into user behavior and further improve your product experience.
Setting up Candu's Heap Integration
Step 1: Get your Heap App ID
Log in to Heap.
Navigate to Account > Manage > Projects.
Locate the project named Main with environment Production.
In the details panel, scroll to the Environments section.
Copy the Production ID - this is your Heap App ID.
Step 2: Setup the integration in Candu
Log in to your Candu account.
Go to the Settings > Integrations page.
Add your Heap App ID and hit 'Save Changes.'
Step 3: Test Your Heap Data Integration
Perform actions in your Candu components (e.g., click a live Candu button) to trigger sample events you've chosen to track.
Check your Heap dashboard to verify that events are being logged correctly. Note that it may take a few minutes for the data to appear.
Events Tracked
For a complete list of Candu's event schema, see Candu SDK event names.
When integrated with Heap, Candu automatically sends the following events:
Content views (
candu.sdk.content)User interactions (
candu.sdk.content.interaction)Form submissions (
candu.sdk.form_submit)Checklist completions (
candu.sdk.tutorial.checklist_group_complete)Tour interactions (
candu.sdk.tour_step_tooltip,candu.sdk.tour_completed)Hotspot engagement (
candu.sdk.hotspot_tooltip,candu.sdk.hotspot_beacon)
Each event includes relevant metadata such as:
Content ID
Segment ID
Document ID
Version ID
Placement ID
Node ID (for component events)
Troubleshooting
If you're not seeing events in Heap:
Verify your App ID is correct and matches your Production environment ID
Ensure the integration is saved correctly in Candu
Check that your content is published and live
Confirm that your Heap implementation is working by testing other events