@c15t/react 3.2.0-canary.0 → 3.2.1

package/docs/integrations/oracle-eloqua.md

@@ -0,0 +1,301 @@
+---
+title: Oracle Eloqua
+description: Load Oracle Eloqua after mapped category and vendor consent,
+  configure its tracking settings, and verify loading and withdrawal with c15t.
+seoTitle: Oracle Eloqua cookie consent with c15t
+seoDescription: Gate Oracle Eloqua on category and vendor consent with c15t.
+  Configure the loader, understand withdrawal limits, and verify vendor requests
+  and storage.
+icon: chart-line
+group: integrations
+---
+
+`eloquaTracking` waits for its mapped category and vendor consent before creating vendor globals or downloading Oracle Eloqua. The default category is `marketing`.
+
+## Configure Oracle Eloqua
+
+Copy your site ID from Eloqua and remove the original asynchronous tracking snippet. Configure a first-party tracking hostname in Eloqua before setting `firstPartyCookieDomain`.
+
+| Package manager | Command                          |
+| :-------------- | :------------------------------- |
+| npm             | `npm install @c15t/integrations` |
+| pnpm            | `pnpm add @c15t/integrations`    |
+| yarn            | `yarn add @c15t/integrations`    |
+| bun             | `bun add @c15t/integrations`     |
+
+```ts title="src/consent-scripts.ts"
+import { eloquaTracking } from '@c15t/integrations/oracle-eloqua';
+
+export const scripts = [eloquaTracking({ siteId: 'YOUR_SITE_ID' })];
+```
+
+## Register the scripts
+
+Complete your [framework quickstart](https://c15t.com/docs/frameworks) first. Keep its Inth
+endpoint, policy, styles and consent UI. Remove the vendor's original script,
+SDK initializer or tag-manager entry, so the vendor loads only through c15t.
+
+The vendor pages put the helper in `src/consent-scripts.ts`. If your framework
+quickstart already has a `scripts` array, such as the one in `c15t.config.ts`
+in the Next.js guide, add the helper to that array instead of creating a
+second file.
+The `scripts` export is a configuration, not an initializer. Add it to the c15t provider you already have, at the registration
+point for your framework below. These are edits to that provider, not a second
+provider.
+
+**Next.js**
+
+Add the configuration to `scripts` in `c15t.config.ts`, next to
+`next.config.ts`:
+
+```ts title="c15t.config.ts"
+import { defineConsentConfig } from 'c15t/next';
+import { scripts } from './src/consent-scripts';
+
+export default defineConsentConfig({ scripts });
+```
+
+Keep the rest of your config, such as `mode` and `routePrefix`, in the
+same call. `ConsentRoot` reads the config in the browser, so the layout
+keeps passing only `state`. App Router, Pages Router and static export all
+read the same file. See
+[Next.js scripts and embeds](https://c15t.com/docs/frameworks/next/scripts).
+
+**TanStack Start**
+
+Import the configuration into your root route and pass it to the existing
+`ConsentRoot` as a top-level prop. Keep the loader from the
+[TanStack Start quickstart](https://c15t.com/docs/frameworks/tanstack-start/quickstart):
+
+```tsx title="src/routes/__root.tsx"
+import { scripts } from '../consent-scripts';
+
+<ConsentRoot state={consent} scripts={scripts}>
+```
+
+Import vendor helpers in the root route module, not in a server function.
+A server function's return value must be serializable, and script
+configurations carry callbacks. See
+[TanStack Start scripts](https://c15t.com/docs/frameworks/tanstack-start/scripts).
+
+**React**
+
+Add the configuration to the existing `ConsentProvider` options, next to
+`mode`:
+
+```tsx title="src/consent.tsx"
+import { scripts } from './consent-scripts';
+
+<ConsentProvider options={{ mode, scripts }}>
+```
+
+`mode` is the `manifest()` value from the
+[React quickstart](../frameworks/react/quickstart.md). Keep the banner,
+dialog and preferences link inside the provider. See
+[React scripts and embeds](../frameworks/react/scripts.md).
+
+**Nuxt**
+
+Register the scripts under the `c15t` key in `app/app.config.ts`. Adjust the
+relative import to where you created `consent-scripts.ts`:
+
+```ts title="app/app.config.ts"
+import { scripts } from '../src/consent-scripts';
+
+export default defineAppConfig({
+  c15t: { scripts },
+});
+```
+
+The Nuxt module merges this over its options in `nuxt.config.ts` and starts
+one script loader in the browser after hydration, once it has applied the
+visitor's stored choice and privacy signals. Keep `scripts` out of
+`nuxt.config.ts`, which reaches the browser as JSON and drops the vendor
+callbacks. Write the vendor IDs into `consent-scripts.ts`. See
+[Nuxt scripts and embeds](https://c15t.com/docs/frameworks/nuxt/scripts).
+
+**Vue**
+
+Pass the scripts to the existing `c15tVue` plugin call in `src/main.ts`:
+
+```ts title="src/main.ts"
+import { c15tVue, manifest } from 'c15t/vue/vue-plugin';
+import { scripts } from './consent-scripts';
+
+app.use(c15tVue, {
+  mode: manifest(),
+  scripts,
+});
+```
+
+Keep your existing `mode` and other options. The plugin starts one
+script loader when the app mounts, after it has applied the visitor's stored
+choice. Do not also call `createScriptLoader` from a component. See
+[Vue scripts and embeds](https://c15t.com/docs/frameworks/vue/scripts).
+
+**Astro**
+
+Add the scripts to the client entrypoint from the
+[Astro quickstart](https://c15t.com/docs/frameworks/astro/quickstart), `src/c15t.client.ts`,
+which the integration finds on its own. Keep `astro.config.mjs` as it is.
+If the module already exports scripts, combine the two arrays.
+
+```ts title="src/c15t.client.ts"
+import type { C15tClientOptionsExtension } from 'c15t/astro';
+import { scripts } from './consent-scripts';
+
+export default { scripts } satisfies C15tClientOptionsExtension;
+```
+
+Vendor helpers contain callbacks, and the integration options in
+`astro.config.mjs` are serialized into the page, so do not put helpers in
+the integration's `scripts` option. The integration passes the client
+entrypoint to the one runtime every page shares, including across
+`ClientRouter` navigation.
+
+**Svelte**
+
+Import the scripts in the component that owns your existing provider and
+pass them as a top-level prop:
+
+```svelte title="src/App.svelte"
+<script lang="ts">
+  import { ConsentProvider, manifest } from 'c15t/svelte';
+  import { scripts } from './consent-scripts';
+</script>
+
+<ConsentProvider mode={manifest()} {scripts}>
+  <!-- Keep your application, consent UI and preferences link here. -->
+</ConsentProvider>
+```
+
+Retain the styles and consent UI from the [Svelte quickstart](https://c15t.com/docs/frameworks/svelte/quickstart).
+The provider owns the loader and disposes it on unmount.
+
+**SvelteKit**
+
+Add the scripts to the existing `ConsentRoot` in the root layout. Keep the
+handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs/frameworks/sveltekit/quickstart).
+
+```svelte title="src/routes/+layout.svelte"
+<script lang="ts">
+  import { ConsentRoot } from 'c15t/svelte';
+  import { scripts } from '../consent-scripts';
+
+  let { children, data } = $props();
+</script>
+
+<ConsentRoot state={data.consent} {scripts}>
+  {@render children()}
+  <!-- Keep your consent UI and preferences link here. -->
+</ConsentRoot>
+```
+
+Import vendor helpers in the layout component, not in `+layout.server.ts`:
+a server load cannot send functions to the browser. Prerendered, static and
+SPA-mode pages use the same `scripts` prop. If you pass an externally owned
+`runtime` to the provider, register scripts when creating that runtime instead.
+
+**HTML**
+
+The helpers in `@c15t/integrations` are ES modules that need a bundler. On a
+page that loads the c15t script tag, paste the vendor's own snippet instead
+and keep it inert until its category is allowed:
+
+```html
+<script type="text/plain" data-c15t-category="measurement">
+  // The vendor's snippet, unchanged
+</script>
+```
+
+Use the category this guide names for the vendor. c15t runs the snippet
+once that category is allowed, and reloads the page when the visitor
+withdraws it. Helper options on this page, such as `loadMode`, do not apply
+to a pasted snippet. See [HTML scripts](https://c15t.com/docs/frameworks/html/scripts).
+
+**JavaScript**
+
+Pass the scripts to `init()` from `@c15t/browser`, next to your mode:
+
+```ts
+import { init, manifest } from '@c15t/browser';
+import { scripts } from './consent-scripts';
+
+const consent = init({
+  mode: manifest(),
+  scripts,
+});
+```
+
+Keep the mode from your quickstart. With
+`createConsentRuntime` from `c15t/runtime`, pass `scripts` to it instead.
+A kernel you create yourself needs a loader from
+`c15t/modules/script-loader`. Attach one loader per kernel. See
+[JavaScript scripts](https://c15t.com/docs/frameworks/javascript/scripts).
+
+## Options
+
+| Option                   | Default                                | Behavior                                                    |
+| ------------------------ | -------------------------------------- | ----------------------------------------------------------- |
+| `siteId`                 | Required                               | Eloqua site ID.                                             |
+| `firstPartyCookieDomain` | Unset                                  | First-party tracking hostname configured in Eloqua.         |
+| `category`               | `marketing`                            | Consent condition for the whole loader.                     |
+| `scriptUrl`              | `https://img.en25.com/i/elqCfg.min.js` | Custom or proxied loader URL. Blank values use the default. |
+
+Missing or blank required values log an error and never load.
+
+Custom loaders must synchronously append one matching consent response script when `elqOptIn` or `elqOptOut` runs. Preserve `pps=41` for opt-in, `pps=42` for opt-out, and the installed account's `siteid` query parameter. The response itself can complete asynchronously. A deferred or unmatched custom response leaves consent indeterminate. The helper reports the problem and blocks tracking and further consent commands until reload.
+
+A custom dispatcher that throws also blocks tracking and further consent commands until reload, even if it appended a matching response before throwing.
+
+## Loading and revocation
+
+After consent, the helper creates `_elqQ`, sets the site ID and optional first-party cookie domain, and downloads the SDK. After loading, it queues `elqOptIn` and waits for its response script before `elqTrackPageView`. The page view uses the full current page URL, including its path, query and fragment, when the response completes.
+
+The helper sends one consent request at a time. If consent changes while a response is pending, it waits for completion and then sends the latest choice. Withdrawal or disposal during opt-in sends `elqOptOut` after that response finishes and suppresses the page view only when the current owners no longer collectively permit tracking. Disposing one provider preserves the active lifecycle when at least one registered provider remains and every remaining provider still allows tracking. Regrant waits for any pending opt-out before opting in again. Failed responses do not trigger immediate retries or page views. A later consent update or remount can retry a failed request, including an opt-out that failed after disposal. Regrant and category changes preserve Eloqua's installed dispatcher while another provider retains its loader. If a surviving provider needs a new loader, the helper creates a fresh setup queue before loading another SDK. Each SDK execution receives its initial site and first-party settings, which the helper binds to its physical tag before loading. The helper keeps the resulting dispatcher with that tag. A detached download can still execute, so later provider adoption uses the tag's captured dispatcher.
+
+Calling `eloquaTracking` again with equivalent options preserves the active consent lifecycle, including pending response handling across disposal and remount. Consent responses for the same site stay serialized when a provider is replaced, even if its category or loader URL changes. When providers share that configuration, every registered provider must allow the category and vendor before tracking starts. A denied provider that has never loaded still participates in this decision. SDK setup waits while a registered provider denies consent. Compatible providers can use different consent categories or loader URLs and still coordinate consent. Regranting either provider sends one page view after opt-in completes, provided every current owner allows tracking.
+
+A provider can adopt an already-loaded compatible tag while another provider denies consent. Once the denying provider is removed or grants consent, the adopter can keep tracking after the original provider is disposed.
+
+Use one site ID and first-party cookie domain per page. Hostname case and surrounding whitespace are normalized. An absent domain differs from a configured domain. Providers with a different site ID or domain conflict with the installed configuration. The helper reports the conflict, blocks the adopter's commands, and blocks tracking through the installed account while that provider remains registered, even if it starts denied. Withdrawal still targets the installed account and waits for its pending response. Removing the conflicting provider releases its blocker. Changing the installed site or domain requires reload, including after its script tag is removed.
+
+If the stock SDK fails to append a consent response, the helper reports the dispatch failure without confirming the request. It sends no page view for a failed opt-in. A later explicit script reconciliation can retry that request; there is no automatic retry loop. A failed opt-out can leave Eloqua's previous opt-in cookie in place. The helper does not delete that cookie or claim withdrawal succeeded.
+
+Keep `reloadOnConsentRevoked` enabled. Eloqua's opt-in and opt-out commands make asynchronous requests; opt-out does not disable every SDK request method or cancel requests already in flight. The helper orders its own consent requests and waits for the first-party opt-in response so a regrant page view does not run while the opt-in cookie still reads `0`. A request that never completes can hold up a later choice until reload. The loader stays in the DOM for same-page regrant because Eloqua replaces its array queue with a dispatcher. Reload gives the next page a fresh tracking lifecycle. Removing a script tag cannot unload the SDK.
+
+Eloqua can set `ELOQUA`, `ELQSTATUS`, `ELQOPTOUT` and first-party `OPTIN` cookies. Oracle documents 13-month tracking cookie lifetimes. Reload does not erase every vendor cookie.
+
+## Verify Oracle Eloqua
+
+Use a clean browser profile for the initial-state checks.
+
+Before consent and after unrelated consent, check for no `elqCfg.min.js`, `_elqQ`, Eloqua cookies or browser storage. Grant the mapped category, which defaults to `marketing`, and allow Oracle Eloqua as a vendor. Confirm the real dispatcher replaces the array, then revoke and inspect the opt-out request. Regrant with your configured account and verify page tracking after the asynchronous opt-in completes.
+
+Sources: [basic tracking](https://docs.oracle.com/en/cloud/saas/marketing/eloqua-user/Help/EloquaAsynchronousTrackingScripts/Tasks/BasicPageTracking.htm), [first-party tracking](https://docs.oracle.com/en/cloud/saas/marketing/eloqua-user/Help/EloquaAsynchronousTrackingScripts/Tasks/BasicPageTrackingFirst.htm), and [opt-in and opt-out commands](https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAA/Help/EloquaAsynchronousTrackingScripts/Tasks/OptingInAndOut.htm).
+
+Test in a private window with an opt-in policy. Open DevTools Network, disable
+the cache and filter by the vendor's domain:
+
+1. Load the page. No request goes to the vendor before you choose.
+2. Click Reject, then reload. There is still no vendor request.
+3. Open Privacy settings and allow the helper's category. The vendor script
+   loads without a page reload.
+4. Turn the category off again and save. c15t reloads the page, and the new
+   page makes no vendor request.
+
+c15t reloads on revocation because removing a script element does not stop
+code that already ran. The vendor's listeners, timers and queued events stay
+alive until the page unloads. If you set `reloadOnConsentRevoked: false`, stop
+the vendor yourself. Register a callback-only script whose `onConsentChange`
+calls the vendor's opt-out API, as shown in
+[custom integrations](./building-integrations.md), and check the
+permission before each of your own event calls. The reload does not delete
+cookies the vendor already set; see
+[clear on revocation for your framework](./overview.md#vendor-switches-and-cookie-cleanup).
+
+The helper lists its vendor by name in the preference dialog, so a visitor can
+turn it off inside an allowed category. See
+[vendor consent for your framework](./overview.md#vendor-switches-and-cookie-cleanup). The
+[consent verification guide](../guides/verify-consent.md) covers navigation,
+expiry and hosting checks.

package/docs/integrations/overview.md

@@ -1,8 +1,7 @@
 ---
 title: Integrations
-description: Find all c15t integrations for analytics, tag managers,
-  advertising, experimentation and personalization, email and SMS, chat and
-  embedded content.
+description: Find c15t integrations for analytics, replay, monitoring,
+  experimentation, personalization, ads, data, chat and embeds.
 seoTitle: Cookie consent integrations for analytics and ads | c15t
 seoDescription: Connect analytics, ad pixels, chat widgets and embeds to your
   cookie banner. c15t has helpers for Google Tag Manager, Meta Pixel, PostHog,
@@ -27,121 +26,135 @@ then follow the vendor guide.
 `@c15t/integrations` is a separate package. Keep importing c15t itself from `c15t`,
 for example `c15t/react` or `c15t/next`.
 
-The Loading behavior column shows when each helper requests the vendor. Most
+The integrations are grouped by what each tool does. The Category column names
+the consent category each helper uses. The Loading behavior column shows when each helper requests the vendor. Most
 wait for the category to be allowed. A few load on every page and pass the
 permission to the vendor's own consent API, so the browser contacts the vendor
 before a choice.
 
-## Embeds
-
-| Integration                     | v3 implementation                             | Loading behavior                                          |
-| ------------------------------- | --------------------------------------------- | --------------------------------------------------------- |
-| [Google Maps](./google-maps.md) | Framework-specific consent-gated map iframe   | Iframe mounts only while the chosen permission is allowed |
-| [YouTube](./youtube.md)         | Framework-specific consent-gated video iframe | Iframe mounts only while the chosen permission is allowed |
-
-Both guides include all nine framework examples. React and Svelte use `ConsentGate`;
-Vue conditionally renders the iframe, and Astro and JavaScript use the existing
-kernel to control its DOM lifecycle. Embeds do not require `@c15t/integrations`.
-
-## Tag managers
-
-| Integration                                   | Helper             | Category                                             | Loading behavior                                                                                     |
-| --------------------------------------------- | ------------------ | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| [Cloudflare Zaraz](./cloudflare-zaraz.md)     | `cloudflareZaraz`  | `necessary`                                          | Always runs; syncs purposes, Zaraz runs the tools                                                    |
-| [Google Tag Manager](./google-tag-manager.md) | `googleTagManager` | `necessary`; `measurement` or `marketing` when gated | Always loads and signals Google consent by default; `loadMode: 'after-consent'` waits for permission |
-
-## Analytics
-
-| Integration                                               | Helper                   | Category                                        | Loading behavior                                                                                     |
-| --------------------------------------------------------- | ------------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| [Lucky Orange](./other-analytics.md#lucky-orange)         | `luckyOrange`            | `measurement`                                   | Waits for effective permission                                                                       |
-| [Google Tag](./google-tag.md)                             | `gtag`                   | `measurement` or `marketing`                    | Always loads and signals Google consent by default; `loadMode: 'after-consent'` waits for permission |
-| [Pendo](./other-analytics.md#pendo)                       | `pendo`                  | `measurement`                                   | Waits for effective permission; stops and resumes event sending                                      |
-| [Ahrefs Analytics](./ahrefs-analytics.md)                 | `ahrefsAnalytics`        | `measurement`                                   | Waits for effective permission                                                                       |
-| [Adobe Analytics](./adobe-analytics.md)                   | `adobeAnalytics`         | `measurement`                                   | Waits for effective permission                                                                       |
-| [Amplitude](./amplitude.md)                               | `amplitude`              | `measurement`                                   | Waits for effective permission; opts the SDK out on revocation                                       |
-| [Cloudflare Web Analytics](./cloudflare-web-analytics.md) | `cloudflareWebAnalytics` | `measurement`                                   | Waits for effective permission                                                                       |
-| [RB2B](./other-analytics.md#rb2b)                         | `rb2b`                   | `marketing`                                     | Waits for effective permission                                                                       |
-| [Clay](./clay.md)                                         | `clay`                   | `marketing`                                     | Waits for effective permission                                                                       |
-| [Clearbit](./clearbit.md)                                 | `clearbit`               | `marketing`                                     | Waits for effective permission                                                                       |
-| [Microsoft Clarity](./microsoft-clarity.md)               | `clarity`                | `measurement`                                   | Gated initially; keeps the SDK and signals storage consent                                           |
-| [Databuddy](./databuddy.md)                               | `databuddy`              | `measurement`                                   | Always loads; switches the SDK's disabled flag                                                       |
-| [Fathom Analytics](./fathom-analytics.md)                 | `fathomAnalytics`        | `measurement`                                   | Waits for effective permission                                                                       |
-| [Heap](./heap.md)                                         | `heap`                   | `measurement`                                   | Waits for effective permission                                                                       |
-| [Matomo Analytics](./matomo-analytics.md)                 | `matomoAnalytics`        | `measurement`                                   | Gated by default; optional consent mode                                                              |
-| [Mixpanel](./mixpanel-analytics.md)                       | `mixpanelAnalytics`      | `measurement`                                   | Always loads; calls opt-in and opt-out APIs                                                          |
-| [OneDollarStats](./one-dollar-stats.md)                   | `oneDollarStats`         | `measurement`                                   | Waits for effective permission                                                                       |
-| [Hotjar](./hotjar.md)                                     | `hotjar`                 | `measurement`                                   | Waits for effective permission                                                                       |
-| [Hightouch](./hightouch.md)                               | `hightouch`              | `measurement`                                   | Waits for effective permission                                                                       |
-| [LogRocket](./logrocket.md)                               | `logRocket`              | `measurement`                                   | Waits for effective permission                                                                       |
-| [Plausible Analytics](./plausible-analytics.md)           | `plausibleAnalytics`     | `measurement`                                   | Waits for effective permission                                                                       |
-| [PostHog](./posthog.md)                                   | `posthog`                | `measurement`                                   | Configurable; defaults to always loading and calling opt-in and opt-out APIs                         |
-| [Promptwatch](./promptwatch.md)                           | `promptwatch`            | `measurement`                                   | Waits for effective permission                                                                       |
-| [Pirsch](./pirsch.md)                                     | `pirsch`                 | `measurement`                                   | Waits for effective permission                                                                       |
-| [RudderStack](./rudderstack.md)                           | `rudderstack`            | `measurement`                                   | Gated by default; optional destination consent mode                                                  |
-| [Segment](./segment.md)                                   | `segment`                | `measurement`                                   | Waits for effective permission                                                                       |
-| [Sentry](./sentry.md)                                     | `sentry`                 | `necessary`; Replay and user data `measurement` | Configurable; defaults to always loading and loads Replay after permission                           |
-| [Rybbit Analytics](./rybbit-analytics.md)                 | `rybbitAnalytics`        | `measurement`                                   | Waits for effective permission                                                                       |
-| [Statable](./other-analytics.md#statable)                 | `statableAnalytics`      | `measurement`                                   | Waits for effective permission                                                                       |
-| [Umami Analytics](./umami-analytics.md)                   | `umamiAnalytics`         | `measurement`                                   | Waits for effective permission                                                                       |
-| [Vercel Analytics](./vercel-analytics.md)                 | `vercelAnalytics`        | `measurement`                                   | Waits for effective permission                                                                       |
-| [Vercel Speed Insights](./vercel-speed-insights.md)       | `vercelSpeedInsights`    | `measurement`                                   | Waits for effective permission; drops reports after revocation                                       |
+## Web analytics
+
+| Integration                                               | Helper                   | Category                     | Loading behavior                                                                                     |
+| --------------------------------------------------------- | ------------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------- |
+| [Plausible Analytics](./plausible-analytics.md)           | `plausibleAnalytics`     | `measurement`                | Waits for effective permission                                                                       |
+| [Fathom Analytics](./fathom-analytics.md)                 | `fathomAnalytics`        | `measurement`                | Waits for effective permission                                                                       |
+| [Umami Analytics](./umami-analytics.md)                   | `umamiAnalytics`         | `measurement`                | Waits for effective permission                                                                       |
+| [Vercel Analytics](./vercel-analytics.md)                 | `vercelAnalytics`        | `measurement`                | Waits for effective permission                                                                       |
+| [Google Tag](./google-tag.md)                             | `gtag`                   | `measurement` or `marketing` | Always loads and signals Google consent by default; `loadMode: 'after-consent'` waits for permission |
+| [Cloudflare Web Analytics](./cloudflare-web-analytics.md) | `cloudflareWebAnalytics` | `measurement`                | Waits for effective permission                                                                       |
+| [Matomo Analytics](./matomo-analytics.md)                 | `matomoAnalytics`        | `measurement`                | Gated by default; optional consent mode                                                              |
+| [Adobe Analytics](./adobe-analytics.md)                   | `adobeAnalytics`         | `measurement`                | Waits for effective permission                                                                       |
+| [Ahrefs Analytics](./ahrefs-analytics.md)                 | `ahrefsAnalytics`        | `measurement`                | Waits for effective permission                                                                       |
+| [Databuddy](./databuddy.md)                               | `databuddy`              | `measurement`                | Gated by default; disables the SDK on revocation                                                     |
+| [Pirsch](./pirsch.md)                                     | `pirsch`                 | `measurement`                | Waits for effective permission                                                                       |
+| [Rybbit Analytics](./rybbit-analytics.md)                 | `rybbitAnalytics`        | `measurement`                | Waits for effective permission                                                                       |
+| [OneDollarStats](./one-dollar-stats.md)                   | `oneDollarStats`         | `measurement`                | Waits for effective permission                                                                       |
+| [Promptwatch](./promptwatch.md)                           | `promptwatch`            | `measurement`                | Waits for effective permission                                                                       |
+| [Statable](./statable-analytics.md)                       | `statableAnalytics`      | `measurement`                | Waits for effective permission                                                                       |
+
+## Product analytics
+
+| Integration                         | Helper              | Category      | Loading behavior                                                             |
+| ----------------------------------- | ------------------- | ------------- | ---------------------------------------------------------------------------- |
+| [PostHog](./posthog.md)             | `posthog`           | `measurement` | Configurable; defaults to always loading and calling opt-in and opt-out APIs |
+| [Mixpanel](./mixpanel-analytics.md) | `mixpanelAnalytics` | `measurement` | Always loads; calls opt-in and opt-out APIs                                  |
+| [Amplitude](./amplitude.md)         | `amplitude`         | `measurement` | Waits for effective permission; opts the SDK out on revocation               |
+| [Heap](./heap.md)                   | `heap`              | `measurement` | Waits for effective permission                                               |
+| [Gainsight PX](./gainsight-px.md)   | `gainsightPx`       | `measurement` | Waits for effective permission                                               |
+| [Pendo](./pendo.md)                 | `pendo`             | `measurement` | Waits for effective permission; stops and resumes event sending              |
+
+## Replay and monitoring
+
+| Integration                                         | Helper                | Category                                        | Loading behavior                                                           |
+| --------------------------------------------------- | --------------------- | ----------------------------------------------- | -------------------------------------------------------------------------- |
+| [Microsoft Clarity](./microsoft-clarity.md)         | `clarity`             | `measurement`                                   | Gated initially; keeps the SDK and signals storage consent                 |
+| [Hotjar](./hotjar.md)                               | `hotjar`              | `measurement`                                   | Waits for effective permission                                             |
+| [LogRocket](./logrocket.md)                         | `logRocket`           | `measurement`                                   | Waits for effective permission                                             |
+| [Sentry](./sentry.md)                               | `sentry`              | `necessary`; Replay and user data `measurement` | Configurable; defaults to always loading and loads Replay after permission |
+| [Vercel Speed Insights](./vercel-speed-insights.md) | `vercelSpeedInsights` | `measurement`                                   | Waits for effective permission; drops reports after revocation             |
+| [FullStory](./fullstory.md)                         | `fullStory`           | `measurement`                                   | Waits for effective permission                                             |
+| [Lucky Orange](./lucky-orange.md)                   | `luckyOrange`         | `measurement`                                   | Waits for effective permission                                             |
 
 ## Experimentation and personalization
 
-| Integration                                                                            | Helper          | Category     | Loading behavior               |
-| -------------------------------------------------------------------------------------- | --------------- | ------------ | ------------------------------ |
-| [Adobe Target](./other-experience.md#adobe-target)                                     | `adobeTarget`   | `experience` | Waits for effective permission |
-| [Appcues](./other-experience.md#appcues)                                               | `appcues`       | `experience` | Waits for effective permission |
-| [Dynamic Yield](./other-experience.md#dynamic-yield)                                   | `dynamicYield`  | `experience` | Waits for effective permission |
-| [Optimizely Web Experimentation](./other-experience.md#optimizely-web-experimentation) | `optimizelyWeb` | `experience` | Waits for effective permission |
-| [Wisepops](./other-experience.md#wisepops)                                             | `wisepops`      | `marketing`  | Waits for effective permission |
-
-## Chat and support
-
-| Integration                                                        | Helper          | Category        | Loading behavior               |
-| ------------------------------------------------------------------ | --------------- | --------------- | ------------------------------ |
-| [Ada](./other-chat-and-support.md#ada)                             | `ada`           | `functionality` | Waits for effective permission |
-| [Crisp](./crisp.md)                                                | `crisp`         | `functionality` | Waits for effective permission |
-| [Front Chat](./front-chat.md)                                      | `frontChat`     | `functionality` | Waits for effective permission |
-| [Gorgias Chat](./other-chat-and-support.md#gorgias-chat)           | `gorgiasChat`   | `functionality` | Waits for effective permission |
-| [Intercom](./intercom.md)                                          | `intercom`      | `functionality` | Waits for effective permission |
-| [Zendesk Messaging](./other-chat-and-support.md#zendesk-messaging) | `zendeskWidget` | `functionality` | Waits for effective permission |
-
-## Email and SMS
-
-| Integration                                                                             | Helper            | Category                      | Loading behavior                                           |
-| --------------------------------------------------------------------------------------- | ----------------- | ----------------------------- | ---------------------------------------------------------- |
-| [Attentive](./other-email-and-sms.md#attentive)                                         | `attentiveTag`    | `marketing`                   | Waits for effective permission                             |
-| [Customer.io](./other-email-and-sms.md#customerio)                                      | `customerIo`      | `marketing`                   | Waits for effective permission                             |
-| [Insider](./other-email-and-sms.md#insider-one)                                         | `insiderTag`      | `marketing`                   | Waits for effective permission                             |
-| [Klaviyo](./klaviyo.md)                                                                 | `klaviyo`         | `marketing` and `measurement` | Waits for both; optional forms-only mode needs `marketing` |
-| [Marketo Munchkin](./other-email-and-sms.md#marketo-munchkin)                           | `marketoMunchkin` | `marketing`                   | Waits for effective permission                             |
-| [Salesforce Account Engagement](./other-email-and-sms.md#salesforce-account-engagement) | `pardotTracking`  | `marketing`                   | Waits for effective permission                             |
-
-## Ads and pixels
-
-| Integration                                                | Helper              | Category    | Loading behavior                                                 |
-| ---------------------------------------------------------- | ------------------- | ----------- | ---------------------------------------------------------------- |
-| [The Trade Desk](./other-ads-and-pixels.md#the-trade-desk) | `theTradeDeskPixel` | `marketing` | Waits for effective permission                                   |
-| [LiveIntent](./other-ads-and-pixels.md#liveintent)         | `liveIntentTag`     | `marketing` | Waits for effective permission                                   |
-| [AdRoll](./other-ads-and-pixels.md#adroll)                 | `adrollPixel`       | `marketing` | Waits for effective permission                                   |
-| [Vector](./other-ads-and-pixels.md#vector)                 | `vector`            | `marketing` | Waits for effective permission                                   |
-| [Meta Pixel](./meta-pixel.md)                              | `metaPixel`         | `marketing` | Gated initially; keeps the SDK and signals consent               |
-| [OpenAI Pixel](./openai-pixel.md)                          | `openaiPixel`       | `marketing` | Gated initially; keeps the SDK and signals consent               |
-| [Pinterest Tag](./pinterest-tag.md)                        | `pinterestTag`      | `marketing` | Gated initially; keeps the tag and signals consent               |
-| [Reddit Pixel](./reddit-pixel.md)                          | `redditPixel`       | `marketing` | Gated initially; keeps the pixel and toggles first-party cookies |
-| [TikTok Pixel](./tiktok-pixel.md)                          | `tiktokPixel`       | `marketing` | Gated initially; keeps the SDK and signals consent               |
-| [LinkedIn Insight Tag](./linkedin-insights.md)             | `linkedinInsights`  | `marketing` | Waits for effective permission                                   |
-| [Microsoft UET](./microsoft-uet.md)                        | `microsoftUet`      | `marketing` | Always loads; signals ad storage consent                         |
-| [Snapchat Pixel](./snapchat-pixel.md)                      | `snapchatPixel`     | `marketing` | Waits for effective permission                                   |
-| [X Pixel](./x-pixel.md)                                    | `xPixel`            | `marketing` | Waits for effective permission                                   |
-
-## Commerce
-
-| Integration             | Helper                         | Category                                    | Loading behavior                                                   |
-| ----------------------- | ------------------------------ | ------------------------------------------- | ------------------------------------------------------------------ |
-| [Shopify](./shopify.md) | `createShopifyCustomerPrivacy` | `measurement`, `marketing`, `functionality` | Loads nothing; sends each choice to Shopify's Customer Privacy API |
+| Integration                                       | Helper          | Category     | Loading behavior               |
+| ------------------------------------------------- | --------------- | ------------ | ------------------------------ |
+| [Adobe Target](./adobe-target.md)                 | `adobeTarget`   | `experience` | Waits for effective permission |
+| [Appcues](./appcues.md)                           | `appcues`       | `experience` | Waits for effective permission |
+| [Dynamic Yield](./dynamic-yield.md)               | `dynamicYield`  | `experience` | Waits for effective permission |
+| [Optimizely Web Experimentation](./optimizely.md) | `optimizelyWeb` | `experience` | Waits for effective permission |
+| [Wisepops](./wisepops.md)                         | `wisepops`      | `marketing`  | Waits for effective permission |
+
+## Ads and growth
+
+| Integration                                             | Helper                                    | Category                                                      | Loading behavior                                                                                                                                                  |
+| ------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Meta Pixel](./meta-pixel.md)                           | `metaPixel`                               | `marketing`                                                   | Gated initially; keeps the SDK and signals consent                                                                                                                |
+| [TikTok Pixel](./tiktok-pixel.md)                       | `tiktokPixel`                             | `marketing`                                                   | Gated initially; keeps the SDK and signals consent                                                                                                                |
+| [Klaviyo](./klaviyo.md)                                 | `klaviyo`                                 | `marketing` and `measurement`                                 | Waits for both; optional forms-only mode needs `marketing`                                                                                                        |
+| [Clearbit](./clearbit.md)                               | `clearbit`                                | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [LinkedIn Insight Tag](./linkedin-insights.md)          | `linkedinInsights`                        | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Microsoft UET](./microsoft-uet.md)                     | `microsoftUet`                            | `marketing`                                                   | Always loads; signals ad storage consent                                                                                                                          |
+| [Pinterest Tag](./pinterest-tag.md)                     | `pinterestTag`                            | `marketing`                                                   | Gated initially; keeps the tag and signals consent                                                                                                                |
+| [Reddit Pixel](./reddit-pixel.md)                       | `redditPixel`                             | `marketing`                                                   | Gated initially; keeps the pixel and toggles first-party cookies                                                                                                  |
+| [Snapchat Pixel](./snapchat-pixel.md)                   | `snapchatPixel`                           | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [X Pixel](./x-pixel.md)                                 | `xPixel`                                  | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [OpenAI Pixel](./openai-pixel.md)                       | `openaiPixel`                             | `marketing`                                                   | Gated initially; keeps the SDK and signals consent                                                                                                                |
+| [ActiveCampaign](./activecampaign.md)                   | `activeCampaignTracking`                  | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Attentive](./attentive.md)                             | `attentiveTag`                            | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Customer.io](./customer-io.md)                         | `customerIo`                              | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Insider](./insider.md)                                 | `insiderTag`                              | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Marketo Munchkin](./marketo.md)                        | `marketoMunchkin`                         | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Salesforce Account Engagement](./salesforce-pardot.md) | `pardotTracking`                          | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Oracle Eloqua](./oracle-eloqua.md)                     | `eloquaTracking`                          | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [HubSpot](./hubspot.md)                                 | `hubspot`                                 | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [RB2B](./rb2b.md)                                       | `rb2b`                                    | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Clay](./clay.md)                                       | `clay`                                    | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Default](./default-com.md)                             | `defaultComPixel` or `defaultComFormsSdk` | Pixel: `measurement`; SDK: `functionality`; both configurable | Pixel waits for permission by default; opt-in `loadMode: 'always'` loads before consent. Standalone SDK always waits for permission. Use one helper per document. |
+| [Amazon Ads](./amazon-ads.md)                           | `amazonAdsTag`                            | `marketing`                                                   | Gated initially; keeps the tag and signals consent when ACS is enabled                                                                                            |
+| [AdRoll](./adroll.md)                                   | `adrollPixel`                             | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [LiveIntent](./liveintent.md)                           | `liveIntentTag`                           | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [The Trade Desk](./the-trade-desk.md)                   | `theTradeDeskPixel`                       | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+| [Vector](./vector.md)                                   | `vector`                                  | `marketing`                                                   | Waits for effective permission                                                                                                                                    |
+
+## Data and tags
+
+| Integration                                   | Helper                         | Category                                             | Loading behavior                                                                                     |
+| --------------------------------------------- | ------------------------------ | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| [Segment](./segment.md)                       | `segment`                      | `measurement`                                        | Waits for effective permission                                                                       |
+| [RudderStack](./rudderstack.md)               | `rudderstack`                  | `measurement`                                        | Gated by default; optional destination consent mode                                                  |
+| [Hightouch](./hightouch.md)                   | `hightouch`                    | `measurement`                                        | Waits for effective permission                                                                       |
+| [Google Tag Manager](./google-tag-manager.md) | `googleTagManager`             | `necessary`; `measurement` or `marketing` when gated | Always loads and signals Google consent by default; `loadMode: 'after-consent'` waits for permission |
+| [Cloudflare Zaraz](./cloudflare-zaraz.md)     | `cloudflareZaraz`              | `necessary`                                          | Always runs; syncs purposes, Zaraz runs the tools                                                    |
+| [Shopify](./shopify.md)                       | `createShopifyCustomerPrivacy` | `measurement`, `marketing`, `functionality`          | Loads nothing; sends each choice to Shopify's Customer Privacy API                                   |
+
+## Chat and embeds
+
+| Integration                       | Helper                     | Category           | Loading behavior                                          |
+| --------------------------------- | -------------------------- | ------------------ | --------------------------------------------------------- |
+| [Intercom](./intercom.md)         | `intercom`                 | `functionality`    | Waits for effective permission                            |
+| [Crisp](./crisp.md)               | `crisp`                    | `functionality`    | Waits for effective permission                            |
+| [Front Chat](./front-chat.md)     | `frontChat`                | `functionality`    | Waits for effective permission                            |
+| [YouTube](./youtube.md)           | None, consent-gated iframe | Chosen by your app | Iframe mounts only while the chosen permission is allowed |
+| [Google Maps](./google-maps.md)   | None, consent-gated iframe | Chosen by your app | Iframe mounts only while the chosen permission is allowed |
+| [Ada](./ada.md)                   | `ada`                      | `functionality`    | Waits for effective permission                            |
+| [Gorgias Chat](./gorgias.md)      | `gorgiasChat`              | `functionality`    | Waits for effective permission                            |
+| [Zendesk Messaging](./zendesk.md) | `zendeskWidget`            | `functionality`    | Waits for effective permission                            |
+
+The YouTube and Google Maps guides include examples for every supported framework.
+Embeds do not require `@c15t/integrations`.
+
+## Read the integration catalog
+
+For programmatic discovery, import `builtInScriptIntegrations` and
+`BUILT_IN_INTEGRATION_KINDS` from `@c15t/integrations/registry`. Each built-in
+entry has an `integrationKind`, typed as `IntegrationKind`, for the groups
+above. `BUILT_IN_INTEGRATION_KINDS` supplies their labels and display order.
+
+The existing `integrationCategory`, `IntegrationCategory` and
+`BUILT_IN_INTEGRATION_CATEGORIES` keep their v3 values, so existing category
+filters still work. `consentCategory` identifies the default consent category
+or condition for each helper.
 
 ## Load each vendor once