@c15t/react 3.1.0 → 3.2.0-canary.0

package/docs/integrations/hotjar.md

@@ -10,16 +10,22 @@ icon: hotjar
 group: integrations
 ---
 
-The c15t `hotjar` helper keeps Hotjar off the page until `measurement` has
-consent. Until then, c15t does not define `window._hjSettings` or `window.hj`.
-The helper sends no consent signal to Hotjar. If the visitor withdraws consent,
-c15t removes the loader script element. By default, c15t also reloads the page.
-The reload stops Hotjar.
+Hotjar records what visitors do on your pages, so it should load only when
+consent allows analytics. The c15t `hotjar` helper waits until the
+`measurement` category is allowed before it adds the Hotjar loader. Until then,
+c15t doesn't define `window._hjSettings` or `window.hj`, and it loads nothing
+from Hotjar. Under an opt-in policy, that wait lasts until the visitor allows
+analytics.
+
+Withdrawal needs more care. c15t sends Hotjar no consent signal, so it can't
+tell a running recording to stop. By default it reloads the page instead, and
+the reload ends the recording.
 
 ## Configure Hotjar
 
-Copy the site ID from your Hotjar tracking code, where it is the `hjid` value.
-Remove the original tracking code.
+Find your site ID in the Hotjar tracking code. It's the `hjid` value. Then
+delete the tracking code from your app. c15t doesn't control that snippet, so
+if it stays, Hotjar loads and records even after the visitor rejects analytics.
 
 | Package manager | Command                          |
 | :-------------- | :------------------------------- |
@@ -165,7 +171,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -184,7 +190,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();
@@ -240,30 +246,38 @@ A kernel you create yourself needs a loader from
 
 ## Options
 
-| Option      | Default                                                       | Behavior                                                                                                                                                                     |
-| ----------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `siteId`    | Required                                                      | Site ID as a number or string. Set as `window._hjSettings.hjid` and used in the default loader URL. Missing, empty and `0` values log an error and the script does not load. |
-| `version`   | `6`                                                           | Script version, set as `window._hjSettings.hjsv` and the `sv` query parameter of the default loader URL.                                                                     |
-| `scriptUrl` | `https://static.hotjar.com/c/hotjar-<siteId>.js?sv=<version>` | Loader URL override.                                                                                                                                                         |
+| Option      | Default                                                       | Behavior                                                                                                                                                                      |
+| ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `siteId`    | Required                                                      | Site ID as a number or string. Set as `window._hjSettings.hjid` and used in the default loader URL. If it's missing, empty or `0`, c15t logs an error and never loads Hotjar. |
+| `version`   | `6`                                                           | Script version, set as `window._hjSettings.hjsv` and the `sv` query parameter of the default loader URL.                                                                      |
+| `scriptUrl` | `https://static.hotjar.com/c/hotjar-<siteId>.js?sv=<version>` | Loader URL override.                                                                                                                                                          |
 
 ## Loading and revocation
 
-`hotjar` uses the `measurement` category. When measurement becomes allowed,
-the helper sets `window._hjSettings` and a queue-backed `window.hj` stub, each
-only when the global is undefined, then loads the Hotjar loader.
+`hotjar` uses the `measurement` category. When `measurement` is allowed, the
+helper sets `window._hjSettings` and a `window.hj` stub that queues calls, then
+loads the Hotjar script. If your page already defines either global, the helper
+leaves it alone.
 
-On revocation the helper removes the loader script element and calls no Hotjar
-API. A recording in progress continues until the page unloads, so c15t's
-default reload on revocation is what ends it.
+When the visitor withdraws, the helper removes the script element. Hotjar is
+already running by then, so removing the element doesn't stop it. The default
+page reload does. If you set `reloadOnConsentRevoked: false`, Hotjar keeps
+recording until the visitor leaves the page.
 
 ## Verify Hotjar
 
-Filter DevTools Network by `hotjar`. After you allow measurement, the
-`hotjar-<siteId>.js` request loads from `static.hotjar.com`, and
-`window._hjSettings.hjid` holds your site ID. Review a recording of a real
-screen in your app to check that Hotjar masks the fields you expect.
-`window.hj` still exists after revocation, so check measurement permission
-before your own `hj` calls.
+Filter the DevTools Network panel by `hotjar`. After you allow measurement,
+the loader appears and `window._hjSettings.hjid` holds your site ID. If it
+holds a different ID, other code on the page set `_hjSettings` before c15t, and
+the helper left it alone. Find and remove that code. By default
+the loader is `hotjar-<siteId>.js` from `static.hotjar.com`. If you set
+`scriptUrl`, look for that URL instead.
+
+Then watch one recording of a real screen in your app. Hotjar decides what to
+mask, not c15t, so check that it hides the fields you expect.
+
+`window.hj` stays defined after withdrawal. If your own code calls `hj()`,
+check the measurement permission first.
 
 Test in a private window with an opt-in policy. Open DevTools Network, disable
 the cache and filter by the vendor's domain:

package/docs/integrations/intercom.md

@@ -165,7 +165,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -184,7 +184,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/klaviyo.md

@@ -175,7 +175,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -194,7 +194,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/linkedin-insights.md

@@ -166,7 +166,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -185,7 +185,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/logrocket.md

@@ -164,7 +164,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -183,7 +183,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/matomo-analytics.md

@@ -170,7 +170,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -189,7 +189,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/meta-pixel.md

@@ -166,7 +166,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -185,7 +185,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/microsoft-clarity.md

@@ -166,7 +166,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -185,7 +185,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/microsoft-uet.md

@@ -168,7 +168,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -187,7 +187,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/mixpanel-analytics.md

@@ -177,7 +177,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -196,7 +196,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/one-dollar-stats.md

@@ -164,7 +164,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -183,7 +183,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/openai-pixel.md

@@ -169,7 +169,7 @@ pass them as a top-level prop:
 
 ```svelte title="src/App.svelte"
 <script lang="ts">
-  import { ConsentProvider, manifest } from '@c15t/svelte';
+  import { ConsentProvider, manifest } from 'c15t/svelte';
   import { scripts } from './consent-scripts';
 </script>
 
@@ -188,7 +188,7 @@ handle and the layout load from the [SvelteKit quickstart](https://c15t.com/docs
 
 ```svelte title="src/routes/+layout.svelte"
 <script lang="ts">
-  import { ConsentRoot } from '@c15t/svelte';
+  import { ConsentRoot } from 'c15t/svelte';
   import { scripts } from '../consent-scripts';
 
   let { children, data } = $props();

package/docs/integrations/other-ads-and-pixels.md

@@ -0,0 +1,94 @@
+---
+title: Other ads and pixels
+description: Consent-gated helpers for ad platforms and conversion pixels that
+  don't need a full guide.
+icon: radar
+group: integrations
+---
+
+Each helper below loads its vendor only after the visitor allows the listed consent category. For setup, see [Integrations overview](./overview.md).
+
+## AdRoll
+
+AdRoll retargets site visitors with ads and measures conversions. The helper sends the first `pageView` for you. Waits for `marketing` consent.
+
+```ts title="src/consent-scripts.ts"
+import { adrollPixel } from '@c15t/integrations/adroll';
+
+export const scripts = [
+	adrollPixel({ advertiserId: 'ADVERTISER_ID', pixelId: 'PIXEL_ID' }),
+];
+```
+
+| Option         | Type     | Required | Description                                                                   |
+| -------------- | -------- | -------- | ----------------------------------------------------------------------------- |
+| `advertiserId` | `string` | Yes      | Advertiser ID from Analytics > Insights > Website > View Pixel.               |
+| `pixelId`      | `string` | Yes      | Pixel ID from the same snippet.                                               |
+| `scriptUrl`    | `string` | No       | Loader URL. Defaults to `https://s.adroll.com/j/<advertiserId>/roundtrip.js`. |
+
+**When consent is withdrawn:** AdRoll has no API to stop it, so the helper leaves it on the page. Keep c15t's default `reloadOnConsentRevoked` so the page reload removes it.
+
+* In AdRoll, set Settings > Data Collection > Visitor Consent to **Use your existing Consent Banner**. Otherwise AdRoll can load its own banner.
+
+## LiveIntent
+
+LiveIntent's LiveConnect tag identifies visitors for people-based ad targeting and measurement. Waits for `marketing` consent.
+
+```ts title="src/consent-scripts.ts"
+import { liveIntentTag } from '@c15t/integrations/liveintent';
+
+export const scripts = [liveIntentTag({ tagId: 'YOUR_TAG_ID' })];
+```
+
+| Option      | Type                | Required | Description                                                                                                                                       |
+| ----------- | ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `tagId`     | `string`            | Yes      | Tag filename from your LiveConnect base tag, without `.min.js`.                                                                                   |
+| `events`    | `LiveIntentEvent[]` | No       | Event objects queued once on the first grant, such as `{ event: 'conversion', name: 'purchase' }`. Use the fields from your account's event tags. |
+| `scriptUrl` | `string`            | No       | Loader URL. Defaults to `https://b-code.liadm.com/<tagId>.min.js`.                                                                                |
+
+**When consent is withdrawn:** LiveConnect has no API to stop it, so the helper leaves it on the page. Keep c15t's default `reloadOnConsentRevoked` so the page reload removes it.
+
+* Don't test with the public `a-00xx` tag from LiveIntent's examples. It's live production code, not a sandbox.
+* Where GDPR applies, LiveIntent also reads the TCF string. LiveIntent's guide lists purposes 1 to 4, but the served bundle asks for more. Confirm your account's requirements with LiveIntent.
+
+## The Trade Desk
+
+The Trade Desk Universal Pixel records conversions and builds ad audiences. Waits for `marketing` consent.
+
+```ts title="src/consent-scripts.ts"
+import { theTradeDeskPixel } from '@c15t/integrations/the-trade-desk';
+
+export const scripts = [
+	theTradeDeskPixel({ advertiserId: 'ADVERTISER_ID', pixelIds: ['PIXEL_ID'] }),
+];
+```
+
+| Option                 | Type                                     | Required | Description                                                                                             |
+| ---------------------- | ---------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------- |
+| `advertiserId`         | `string`                                 | Yes      | Advertiser ID from your Universal Pixel snippet.                                                        |
+| `pixelIds`             | `string[]`                               | Yes      | One or more Universal Pixel IDs. A blank entry skips the helper.                                        |
+| `enableCookieSyncing`  | `boolean`                                | No       | Set `false` to turn off cookie syncing. Unset uses the vendor default.                                  |
+| `dataProcessingOption` | `{ policies: string[]; region: string }` | No       | Limited data use setting, such as `{ policies: ['LDU'], region: 'US-CO' }`. It doesn't replace consent. |
+| `scriptUrl`            | `string`                                 | No       | Loader URL. Defaults to `https://js.adsrvr.org/up_loader.3.0.0.js`.                                     |
+
+**When consent is withdrawn:** The Trade Desk has no API to stop its SDK, so the helper leaves it on the page. Keep c15t's default `reloadOnConsentRevoked` so the page reload removes it.
+
+* Walmart DSP accounts use a different loader. Set `scriptUrl` to `https://azjs.adsrvr.org/thetradedesk-ads/up_loader.3.0.0.js`.
+* `enableCookieSyncing: false` doesn't stop all cookies. The Trade Desk still sets its `TDID` cookie on `adsrvr.org`.
+
+## Vector
+
+Vector identifies the people and companies visiting your site and builds advertising audiences from their activity. Waits for `marketing` consent.
+
+```ts title="src/consent-scripts.ts"
+import { vector } from '@c15t/integrations/vector';
+
+export const scripts = [vector({ pixelId: 'YOUR_PIXEL_ID' })];
+```
+
+| Option      | Type     | Required | Description                                                   |
+| ----------- | -------- | -------- | ------------------------------------------------------------- |
+| `pixelId`   | `string` | Yes      | Pixel ID from **Settings > Pixel** in Vector.                 |
+| `scriptUrl` | `string` | No       | Custom SDK URL. Defaults to `https://cdn.vector.co/pixel.js`. |
+
+**When consent is withdrawn:** Vector has no stop API, so c15t reloads the page to stop it. Keep `reloadOnConsentRevoked` on.

package/docs/integrations/other-analytics.md

@@ -0,0 +1,108 @@
+---
+title: Other analytics tools
+description: Consent-gated helpers for analytics tools that don't need a full guide.
+icon: chart-line
+group: integrations
+---
+
+Each helper below loads its vendor only after the visitor allows the listed consent category. For setup, see [Integrations overview](./overview.md).
+
+## Lucky Orange
+
+Lucky Orange records sessions and builds heatmaps. Waits for `measurement` consent by default.
+
+```ts title="src/lucky-orange.ts"
+import { luckyOrange } from '@c15t/integrations/lucky-orange';
+
+export const scripts = [luckyOrange({ siteId: 'YOUR_SITE_ID' })];
+```
+
+| Option      | Type              | Required | Description                                                                                            |
+| ----------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------ |
+| `siteId`    | `string`          | Yes      | Site ID from Lucky Orange.                                                                             |
+| `category`  | Consent condition | No       | Category or condition that must be allowed. Defaults to `'measurement'`.                               |
+| `scriptUrl` | `string`          | No       | Custom or proxied loader URL. Defaults to `https://tools.luckyorange.com/core/lo.js?site-id=<siteId>`. |
+
+**When consent is withdrawn:** the helper calls `LO.privacy.setConsentStatus(false)`. Recording code already on the page can't be unloaded, so keep c15t's default page reload.
+
+* Turn on **Require Consent** in the Lucky Orange dashboard. The helper grants consent through Lucky Orange's privacy API after the visitor allows it.
+* The helper doesn't call `optOut()`, because that writes an opt-out cookie that lasts two years and gets in the way if the visitor grants consent again.
+* A proxy `scriptUrl` must keep `lo.js` in its path. Lucky Orange finds the site ID by looking for that file name.
+
+## Pendo
+
+Pendo records product usage and shows in-app guides. Waits for `measurement` consent by default.
+
+```ts title="src/pendo.ts"
+import { pendo } from '@c15t/integrations/pendo';
+
+export const scripts = [pendo({ apiKey: 'YOUR_API_KEY' })];
+```
+
+| Option              | Type                      | Required | Description                                                                                     |
+| ------------------- | ------------------------- | -------- | ----------------------------------------------------------------------------------------------- |
+| `apiKey`            | `string`                  | Yes      | Web agent API key from Pendo.                                                                   |
+| `visitor`           | `Record<string, unknown>` | No       | Visitor metadata passed to `pendo.initialize()`.                                                |
+| `account`           | `Record<string, unknown>` | No       | Account metadata passed to `pendo.initialize()`.                                                |
+| `initializeOptions` | `Record<string, unknown>` | No       | Other `initialize()` options, such as `disableCookies` or `excludeAllText`.                     |
+| `category`          | Consent condition         | No       | Category or condition that must be allowed. Defaults to `'measurement'`.                        |
+| `scriptUrl`         | `string`                  | No       | Custom or proxied agent URL. Defaults to `https://cdn.pendo.io/agent/static/<apiKey>/pendo.js`. |
+
+**When consent is withdrawn:** the helper calls `pendo.stopSendingEvents()`. If consent comes back on the same page, it calls `startSendingEvents()` and keeps the same visitor identity. c15t still reloads the page by default; keep the reload if the next page must run without Pendo.
+
+* The helper never calls `clearSession()`, because that starts a new anonymous visitor. If a visitor signs out while consent is granted, call `pendo.clearSession()` yourself before you identify the next visitor.
+* Stopping events doesn't delete Pendo's cookies or local storage, and guides already on the page stay there.
+
+## RB2B
+
+RB2B identifies the companies and US visitors behind site traffic for sales outreach. Waits for `marketing` consent.
+
+```ts title="src/consent-scripts.ts"
+import { rb2b } from '@c15t/integrations/rb2b';
+
+export const scripts = [rb2b({ accountKey: 'YOUR_RB2B_KEY' })];
+```
+
+| Option       | Type     | Required | Description                                                                                                                   |
+| ------------ | -------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `accountKey` | `string` | Yes      | Account key from the `reb2b.load` call on RB2B's Script Setup page.                                                           |
+| `scriptUrl`  | `string` | No       | Loader URL from your dashboard snippet. Defaults to `https://ddwl4m2hdecbv.cloudfront.net/b/<accountKey>/<accountKey>.js.gz`. |
+
+**When consent is withdrawn:** RB2B has no stop API, so c15t reloads the page to stop it. Keep `reloadOnConsentRevoked` on.
+
+* Authorize your domain first: in RB2B, open **Script**, choose **Add a Domain** and save it. RB2B's script doesn't run on domains you haven't added.
+* `scriptUrl` must stay on RB2B's CloudFront or S3 hosts, under `/b/<accountKey>/`. RB2B checks the script's own URL, so a proxy fails, and the helper logs an error and skips loading for other URLs.
+* RB2B runs once per page load, not on client-side route changes. To count a new page view, use full-page navigation, such as a plain `<a href>`.
+
+## Statable
+
+Statable is cookieless web analytics. Waits for `measurement` consent.
+
+```ts title="src/consent-scripts.ts"
+import { statableAnalytics } from '@c15t/integrations/statable-analytics';
+
+export const scripts = [statableAnalytics({ siteId: '12345' })];
+```
+
+| Option        | Type                 | Required | Description                                                                                                                |
+| ------------- | -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `siteId`      | `string` or `number` | Yes      | Numeric site ID from **Site settings > Tracking Code** in Statable.                                                        |
+| `scriptUrl`   | `string`             | No       | Loader URL for your own CDN. Each `{siteId}` is replaced with the ID. Defaults to `https://statable.com/js/{siteId}/s.js`. |
+| `trackingApi` | `string`             | No       | Full ingestion endpoint. Defaults to the loader origin plus `/api/event`.                                                  |
+
+**When consent is withdrawn:** Statable has no stop API, so c15t reloads the page to stop the tracker. Keep `reloadOnConsentRevoked` on.
+
+* The `/js/<siteId>/s.js` loader is only on Statable's paid plans. The Hobby plan uses a widget with a different loader, which this helper doesn't support.
+* If your CDN serves the loader but doesn't serve or proxy `/api/event`, set `trackingApi` to the full ingestion URL:
+
+```ts title="src/consent-scripts.ts"
+import { statableAnalytics } from '@c15t/integrations/statable-analytics';
+
+export const scripts = [
+	statableAnalytics({
+		scriptUrl: 'https://cdn.example.com/js/{siteId}/s.js',
+		siteId: '12345',
+		trackingApi: 'https://analytics.example.com/api/event',
+	}),
+];
+```

package/docs/integrations/other-chat-and-support.md

@@ -0,0 +1,112 @@
+---
+title: Other chat and support tools
+description: Consent-gated helpers for chat and support tools that don't need a full guide.
+icon: messages-square
+group: integrations
+---
+
+Each helper below loads its vendor only after the visitor allows the listed consent category. For setup, see [Integrations overview](./overview.md).
+
+## Ada
+
+Ada Messaging adds an Ada AI Agent chat widget to your site. Waits for
+`functionality` consent.
+
+```ts title="src/consent-scripts.ts"
+import { ada } from '@c15t/integrations/ada';
+
+export const scripts = [ada({ handle: 'YOUR_ADA_HANDLE' })];
+```
+
+| Option    | Type     | Required | Description                                                                                        |
+| --------- | -------- | -------- | -------------------------------------------------------------------------------------------------- |
+| `handle`  | `string` | Yes      | Your AI Agent's public handle, from your Ada team. A blank handle logs an error and nothing loads. |
+| `cluster` | `string` | No       | Regional cluster, such as `eu`, `us2` or `maple`. Set it only when Ada gives you one.              |
+| `domain`  | `string` | No       | Ada base-domain override. Set it only when Ada gives you one.                                      |
+
+The helper imports Ada's Messaging Web SDK from
+`https://messaging-assets.ada.support/sdk.js` and keeps its interface private,
+so `window.adaEmbed` stays unset. Remove any other Ada snippet or `embed2.js`
+tag. Ada allows only one Messaging interface per page.
+
+**When consent is withdrawn:** the helper calls Ada's `stop()`, which removes
+the widget's frames. c15t then reloads the page to end any SDK work still
+running.
+
+* Use one Ada configuration per page.
+* Ada has no consent API. The helper can only start and stop the widget.
+* `stop()` doesn't erase stored conversations, tokens or cookies. The visitor's
+  conversation can still be there after a reload.
+* An SDK import that has already started can't be cancelled. The helper skips
+  starting the widget when it finishes, but the SDK can still write its own
+  storage. Keep `reloadOnConsentRevoked` enabled.
+
+## Gorgias Chat
+
+Gorgias Chat adds the Gorgias support chat widget to your store or site. Waits
+for `functionality` consent.
+
+```ts title="src/consent-scripts.ts"
+import { gorgiasChat } from '@c15t/integrations/gorgias';
+
+export const scripts = [gorgiasChat({ appKey: 'YOUR_GORGIAS_APP_KEY' })];
+```
+
+| Option    | Type       | Required | Description                                                                                         |
+| --------- | ---------- | -------- | --------------------------------------------------------------------------------------------------- |
+| `appKey`  | `string`   | Yes      | Public app key from your Gorgias installation snippet. A blank key logs an error and nothing loads. |
+| `version` | `2` or `3` | No       | Installation snippet version. Defaults to `3`.                                                      |
+
+Remove any other Gorgias snippet or store app installation, or Gorgias can load
+before consent. Without `measurement` consent, the helper calls
+`GorgiasChat.disableSegment()` when the widget is ready.
+
+**When consent is withdrawn:** c15t removes the loader and calls
+`disableSegment()` if the widget is ready. Gorgias has no shutdown API, so keep
+`reloadOnConsentRevoked` enabled. The page reload stops the widget.
+
+* Segment stays off for the rest of the page after `disableSegment()`, even if
+  the visitor then grants `measurement`. Gorgias has no call to turn it back on.
+  A reload with `measurement` allowed turns it back on.
+* The v3 snippet has the key at the end of
+  `https://config.gorgias.chat/bundle-loader/YOUR_APP_KEY`. A v2 snippet uses
+  `applicationId` instead. Pass that value as `appKey` with `version: 2`.
+* A placeholder or deleted key still returns HTTP 200, with only a warning
+  that the installation is incorrect. Check that the widget appears to confirm
+  the key works.
+
+## Zendesk Messaging
+
+Zendesk Messaging adds the Zendesk support chat widget to your site. It doesn't
+cover Web Widget Classic. Waits for `functionality` consent.
+
+```ts title="src/consent-scripts.ts"
+import { zendeskWidget } from '@c15t/integrations/zendesk';
+
+export const scripts = [zendeskWidget({ key: 'YOUR_ZENDESK_WIDGET_KEY' })];
+```
+
+| Option     | Type              | Required | Description                                                                                                                                                         |
+| ---------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `key`      | `string`          | Yes      | Widget key from **Admin Center > Channels > Messaging and social > Messaging**, on the widget's **Installation** page. A blank key logs an error and nothing loads. |
+| `category` | Consent condition | No       | Consent needed to load the widget. Defaults to `functionality`.                                                                                                     |
+
+The helper passes consent to Zendesk's
+[cookie setting](https://developer.zendesk.com/api-reference/widget-messaging/web/core/#set-cookies)
+before the widget loads, and again on every consent change:
+
+| Consent                           | Zendesk cookie setting |
+| --------------------------------- | ---------------------- |
+| `functionality` and `measurement` | `all`                  |
+| `functionality` only              | `functional`           |
+| `functionality` withdrawn         | `none`                 |
+
+**When consent is withdrawn:** the helper sends `none`. Zendesk hides the
+widget and deletes its local and session storage. c15t then reloads the page to
+stop the widget code that already ran.
+
+* Use one widget key per page. Zendesk has one global `zE` API, so two widgets
+  on the same page control each other.
+* Removing the helper from your configuration doesn't clear the conversation.
+  It sends no `none`. Revoke consent first if you need the widget storage
+  cleared.