@walkeros/web-destination-hotjar 3.4.2 → 4.0.0-next-1777463920154
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -10
- package/dist/dev.d.mts +5 -5
- package/dist/dev.d.ts +5 -5
- package/dist/dev.js +1 -1
- package/dist/dev.js.map +1 -1
- package/dist/dev.mjs +1 -1
- package/dist/dev.mjs.map +1 -1
- package/dist/examples/index.d.mts +5 -5
- package/dist/examples/index.d.ts +5 -5
- package/dist/examples/index.js +30 -25
- package/dist/examples/index.mjs +30 -25
- package/dist/index.browser.js +1 -1
- package/dist/index.es5.js +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1 -1
- package/dist/index.mjs.map +1 -1
- package/dist/walkerOS.json +28 -119
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
[NPM Package](https://www.npmjs.com/package/@walkeros/web-destination-hotjar)
|
|
12
12
|
• [Documentation](https://www.walkeros.io/docs/destinations/web/hotjar)
|
|
13
13
|
|
|
14
|
-
This package forwards walkerOS events to [Hotjar](https://www.hotjar.com/)
|
|
14
|
+
This package forwards walkerOS events to [Hotjar](https://www.hotjar.com/) -
|
|
15
15
|
session recordings, heatmaps, surveys, and on-page feedback. Built on the
|
|
16
16
|
official [`@hotjar/browser`](https://www.npmjs.com/package/@hotjar/browser) SDK.
|
|
17
17
|
|
|
@@ -21,13 +21,13 @@ forwards them as Hotjar events, identities, and SPA route notifications.
|
|
|
21
21
|
|
|
22
22
|
## Features
|
|
23
23
|
|
|
24
|
-
- **Default event forwarding**
|
|
24
|
+
- **Default event forwarding** - every walkerOS event becomes
|
|
25
25
|
`Hotjar.event(name)` with no additional config
|
|
26
|
-
- **Identity**
|
|
26
|
+
- **Identity** - `Hotjar.identify(userId, attributes)` with userId extracted
|
|
27
27
|
from the resolved mapping value; remaining keys become user attributes
|
|
28
|
-
- **SPA state change**
|
|
28
|
+
- **SPA state change** - `Hotjar.stateChange(path)` for accurate heatmaps on
|
|
29
29
|
virtual page views in single-page applications
|
|
30
|
-
- **Snippet injection**
|
|
30
|
+
- **Snippet injection** - `@hotjar/browser` handles script loading, including
|
|
31
31
|
CSP `nonce` and debug mode
|
|
32
32
|
|
|
33
33
|
## Installation
|
|
@@ -77,14 +77,14 @@ await startFlow({
|
|
|
77
77
|
|
|
78
78
|
Standard mapping features also apply:
|
|
79
79
|
|
|
80
|
-
- `name`
|
|
81
|
-
- `
|
|
80
|
+
- `name` - rename the forwarded event (`Hotjar.event(<new name>)`)
|
|
81
|
+
- `silent` - suppress the default `Hotjar.event(...)` call while still running
|
|
82
82
|
`identify` / `stateChange`
|
|
83
|
-
- `ignore`
|
|
83
|
+
- `ignore` - drop the event entirely (no calls produced)
|
|
84
84
|
|
|
85
85
|
## Event Forwarding
|
|
86
86
|
|
|
87
|
-
Hotjar's `event(actionName)` API is name-only
|
|
87
|
+
Hotjar's `event(actionName)` API is name-only - no properties, no payload. The
|
|
88
88
|
destination forwards the walkerOS `event.name` (e.g. `"order complete"`) by
|
|
89
89
|
default. Rename with `mapping.name`:
|
|
90
90
|
|
|
@@ -132,7 +132,7 @@ emit a walkerOS event:
|
|
|
132
132
|
mapping: {
|
|
133
133
|
page: {
|
|
134
134
|
view: {
|
|
135
|
-
|
|
135
|
+
silent: true, // Suppress default Hotjar.event('page view')
|
|
136
136
|
settings: {
|
|
137
137
|
stateChange: 'data.id', // Resolves to the new path
|
|
138
138
|
},
|
package/dist/dev.d.mts
CHANGED
|
@@ -121,7 +121,7 @@ declare const userLoginIdentify: HotjarStepExample;
|
|
|
121
121
|
declare const destinationLevelIdentify: HotjarStepExample;
|
|
122
122
|
/**
|
|
123
123
|
* SPA state change -- stateChange mapping resolves to path string.
|
|
124
|
-
*
|
|
124
|
+
* silent=true suppresses the default Hotjar.event() call.
|
|
125
125
|
*/
|
|
126
126
|
declare const pageViewStateChange: HotjarStepExample;
|
|
127
127
|
/**
|
|
@@ -130,22 +130,22 @@ declare const pageViewStateChange: HotjarStepExample;
|
|
|
130
130
|
*/
|
|
131
131
|
declare const combinedFeatures: HotjarStepExample;
|
|
132
132
|
/**
|
|
133
|
-
* mapping.
|
|
133
|
+
* mapping.silent -- suppresses the default Hotjar.event() call. No other
|
|
134
134
|
* settings active, so the destination produces zero calls.
|
|
135
135
|
*/
|
|
136
|
-
declare const
|
|
136
|
+
declare const pageViewSilent: HotjarStepExample;
|
|
137
137
|
|
|
138
138
|
type step_HotjarStepExample = HotjarStepExample;
|
|
139
139
|
declare const step_combinedFeatures: typeof combinedFeatures;
|
|
140
140
|
declare const step_defaultEventForwarding: typeof defaultEventForwarding;
|
|
141
141
|
declare const step_destinationLevelIdentify: typeof destinationLevelIdentify;
|
|
142
|
-
declare const
|
|
142
|
+
declare const step_pageViewSilent: typeof pageViewSilent;
|
|
143
143
|
declare const step_pageViewStateChange: typeof pageViewStateChange;
|
|
144
144
|
declare const step_renamedEvent: typeof renamedEvent;
|
|
145
145
|
declare const step_userLoginIdentify: typeof userLoginIdentify;
|
|
146
146
|
declare const step_wildcardIgnored: typeof wildcardIgnored;
|
|
147
147
|
declare namespace step {
|
|
148
|
-
export { type step_HotjarStepExample as HotjarStepExample, step_combinedFeatures as combinedFeatures, step_defaultEventForwarding as defaultEventForwarding, step_destinationLevelIdentify as destinationLevelIdentify,
|
|
148
|
+
export { type step_HotjarStepExample as HotjarStepExample, step_combinedFeatures as combinedFeatures, step_defaultEventForwarding as defaultEventForwarding, step_destinationLevelIdentify as destinationLevelIdentify, step_pageViewSilent as pageViewSilent, step_pageViewStateChange as pageViewStateChange, step_renamedEvent as renamedEvent, step_userLoginIdentify as userLoginIdentify, step_wildcardIgnored as wildcardIgnored };
|
|
149
149
|
}
|
|
150
150
|
|
|
151
151
|
declare const index_env: typeof env;
|
package/dist/dev.d.ts
CHANGED
|
@@ -121,7 +121,7 @@ declare const userLoginIdentify: HotjarStepExample;
|
|
|
121
121
|
declare const destinationLevelIdentify: HotjarStepExample;
|
|
122
122
|
/**
|
|
123
123
|
* SPA state change -- stateChange mapping resolves to path string.
|
|
124
|
-
*
|
|
124
|
+
* silent=true suppresses the default Hotjar.event() call.
|
|
125
125
|
*/
|
|
126
126
|
declare const pageViewStateChange: HotjarStepExample;
|
|
127
127
|
/**
|
|
@@ -130,22 +130,22 @@ declare const pageViewStateChange: HotjarStepExample;
|
|
|
130
130
|
*/
|
|
131
131
|
declare const combinedFeatures: HotjarStepExample;
|
|
132
132
|
/**
|
|
133
|
-
* mapping.
|
|
133
|
+
* mapping.silent -- suppresses the default Hotjar.event() call. No other
|
|
134
134
|
* settings active, so the destination produces zero calls.
|
|
135
135
|
*/
|
|
136
|
-
declare const
|
|
136
|
+
declare const pageViewSilent: HotjarStepExample;
|
|
137
137
|
|
|
138
138
|
type step_HotjarStepExample = HotjarStepExample;
|
|
139
139
|
declare const step_combinedFeatures: typeof combinedFeatures;
|
|
140
140
|
declare const step_defaultEventForwarding: typeof defaultEventForwarding;
|
|
141
141
|
declare const step_destinationLevelIdentify: typeof destinationLevelIdentify;
|
|
142
|
-
declare const
|
|
142
|
+
declare const step_pageViewSilent: typeof pageViewSilent;
|
|
143
143
|
declare const step_pageViewStateChange: typeof pageViewStateChange;
|
|
144
144
|
declare const step_renamedEvent: typeof renamedEvent;
|
|
145
145
|
declare const step_userLoginIdentify: typeof userLoginIdentify;
|
|
146
146
|
declare const step_wildcardIgnored: typeof wildcardIgnored;
|
|
147
147
|
declare namespace step {
|
|
148
|
-
export { type step_HotjarStepExample as HotjarStepExample, step_combinedFeatures as combinedFeatures, step_defaultEventForwarding as defaultEventForwarding, step_destinationLevelIdentify as destinationLevelIdentify,
|
|
148
|
+
export { type step_HotjarStepExample as HotjarStepExample, step_combinedFeatures as combinedFeatures, step_defaultEventForwarding as defaultEventForwarding, step_destinationLevelIdentify as destinationLevelIdentify, step_pageViewSilent as pageViewSilent, step_pageViewStateChange as pageViewStateChange, step_renamedEvent as renamedEvent, step_userLoginIdentify as userLoginIdentify, step_wildcardIgnored as wildcardIgnored };
|
|
149
149
|
}
|
|
150
150
|
|
|
151
151
|
declare const index_env: typeof env;
|