@codebards/ik-embeddable-form 1.0.6 → 1.0.8

package/README.md

@@ -398,7 +398,34 @@ No other files need to change. The platform supports **25+ variants** this way.
 
 ### GTM
 
-Events are pushed to `window.dataLayer` automatically. Configure your GTM triggers on:
+The embed can **load its own GTM container** (per architecture doc) so form conversions work on Lovable / Framer / plain HTML without host-page GTM.
+
+| Setting | Default | Purpose |
+|---------|---------|---------|
+| `VITE_GTM_ID` | `GTM-P335R9N` (staging/prod) | Container injected when form opens |
+| `loadGtm` in `IKForm.open()` | `true` | Set `false` on WordPress if the theme already loads the same container |
+| `gtmContainerId` in `IKForm.open()` | build-time ID | Optional override (e.g. dedicated embed container) |
+
+```ts
+// Self-contained LP (embed loads GTM)
+IKForm.open({ eventName: '...', webinarType: 'REGULAR', site: 'organic', variant: 'default' });
+
+// WordPress page that already has GTM-P335R9N in the theme
+IKForm.open({ ..., loadGtm: false });
+```
+
+**dataLayer events** (WordPress parity + embed lifecycle):
+
+| When | Event |
+|------|--------|
+| Contact step success | `new_webinar_registration_form_submitted` |
+| Slot proceed | `wordpress_form_submitted` (`formName: "Webinar Slot Selection"`) |
+| Profile step | `pa_new_webinar_registration_form_submitted` (conversion — Meta / Google Ads / LinkedIn) |
+| Form open / step view | `form_open`, `form_step_view`, … |
+
+GTM fires **marketing pixels**. **Clickstream** (`ve2lt1a8il/qa` → BigQuery) is separate — see above.
+
+Events are pushed to `window.dataLayer`. Configure GTM triggers on:
 
 - `form_open` — fired when modal opens
 - `form_close` — fired when modal closes