Contentsquare Heap (Cloud)

introduction heap (part of contentsquare ) is a digital analytics platform that automatically captures every user interaction — clicks, taps, form submissions, page views — and lets you retroactively define events without re instrumenting your code this destination sends events to heap using the server side http api , making it immune to ad blockers and browser restrictions use this destination alongside the for maximum coverage getting started this is a cloud mode destination you will need app id (environment id) — found in account > manage > projects in the heap dashboard each project (environment) has its own app id connecting to the heap cdp destination before connecting destinations in the chord cdp, please verify with all destination owners that all non chord cdp configured destinations are disabled running external destinations alongside configured chord cdp destinations can result in duplicate events downstream log into the chord data platform navigate to the cdp click the "add" button next to destinations select heap from the destination catalog enter the destination name and app id optionally configure data region — us (default) or eu controls which heap endpoint receives your events send page events — if enabled (default), page events are forwarded to heap as track events named "page view" enable anonymous user profiles — if enabled, events from anonymous users (no userid ) are forwarded disabled by default click "create" to connect events event mapping chord event type heap api endpoint notes track post /api/track event name and properties forwarded as is page post /api/track sent as a "page view" event if send page events is enabled identify post /api/add user properties user traits sent as heap user properties track events track events are forwarded to heap's /api/track endpoint heap field chord source (priority order) notes app id configured app id required identity userid > context traits email > traits email if absent and anonymous profiles disabled, event is skipped event event (event name) properties properties all event properties forwarded timestamp timestamp iso 8601 format page events if send page events is enabled, page events are forwarded as track events named "page view" heap field chord source (priority order) notes app id configured app id required identity userid > context traits email > traits email if absent and anonymous profiles disabled, event is skipped event (hardcoded) "page view" properties properties merged with page context includes url , path , referrer , title from context page timestamp timestamp iso 8601 format if send page events is disabled, page events are silently dropped identify events identify events are sent to heap's /api/add user properties endpoint to associate traits with a user heap field chord source (priority order) notes app id configured app id required identity userid > context traits email > traits email required; event is skipped if identity cannot be resolved properties traits merged with context traits all user traits forwarded note heap's add user properties endpoint requires a resolved identity identify events without a userid or email are always skipped, regardless of the enable anonymous user profiles setting data regions region endpoint us (default) https //heapanalytics com eu https //heapanalytics eu set the data region option to eu if your heap project is configured for eu data residency testing and validation after connecting the destination trigger a test event from your storefront or use the live events tab in the chord cdp in heap, navigate to account > manage > projects and verify events appear in the event stream check the live events diagnostics in the chord cdp for any api errors or credential issues property mappings destination path description properties all event properties forwarded to heap unchanged traits all user traits forwarded to heap as user properties