Skip to content

CYBEXO Web CMP Engine Setup

Last updated: November 3, 2026

This installation uses the shared Web CMP runtime, which supports IAB TCF 2.4. TCF behavior depends on the published property configuration; verify the actual installation and connected tags.

Use this guide for direct website installations. Copy the complete snippet from your property’s Integration page after publishing its settings. Use the exact App ID shown in your dashboard, such as CYB-YOUR_APP_ID; do not substitute another property’s ID. Existing IDs remain valid unless your account has completed an explicit migration.

Put the complete block first in <head> on every page, before Google tag initialization, other measurement scripts and TCF consumers. Keep this script synchronous: do not add async or defer. The managed loader initializes Direct consent defaults and the TCF API before later scripts run; it then loads the published configuration.

The default installation enables Consent Mode:

<script id="cybexo-cmp" data-settings-id="CYB-YOUR_APP_ID"
data-api-url="https://api.cybexo.io"
data-assets-url="https://cmp.cybexo.com"
src="https://cmp.cybexo.com/loader.js?data-installation-platform=direct"></script>

Google tag configuration may follow this block in advanced mode. The four initial defaults are denied while configuration loads. Validated regional policy and saved or new visitor choices produce later updates. An intentionally hidden regional banner can grant the configured Google state; a blocked or invalid dependency cannot be treated as that scenario. The 500 ms wait is a bounded Google delay, not a substitute for early defaults.

If the loader itself is blocked, it cannot initialize consent. Do not treat that as a denied default or allow optional tags on that assumption. Use a separately implemented consent-aware blocker when tags must remain blocked during delivery failure. A configuration or vendor-list failure after startup must not grant consent. Configure your Content Security Policy to allow the required asset, configuration and applicable vendor-list requests. Do not add broad wildcard permissions. Apply the same nonce to all relevant script elements when your policy requires it.

Do not combine this direct installation with a second CMP or the GTM template on the same page. GTM uses its native consent APIs and its own setup instructions; do not paste this block into a Custom HTML tag.

Replace the whole old Direct installation, including its inline defaults and separate TCF bootstrap, with the newly copied short snippet. Keep your exact App ID and selected consent mode. The data-installation-platform=direct query identifies this installation path; it is not an engine version. Keep the complete supplied URL. CYBEXO manages the common loader and it revalidates on subsequent page loads.

A browser may still hold an older loader with its previously supplied cache lifetime. Publishing a new runtime or purging an edge cache does not remove that browser copy. Using the supplied Direct URL creates a separate cache entry without clearing the visitor’s saved choices. Publish the changed snippet on every relevant page, then verify ordinary navigation in a returning browser as well as a fresh session. Existing open pages keep their already running code until navigation or reload; browser back/forward restoration can restore that earlier document.

Keep the complete URL supplied by an official integration. For WordPress, Drupal, Shopify or GTM, follow that integration’s update instructions; replacing it with a second direct snippet can create conflicting consent owners. Custom self-hosted or explicitly pinned artifacts need their own tested update process.

Advanced: leave Consent Mode enabled, install the complete on snippet above, and allow consent-aware Google tags to load after this script. Verify defaults, updates and actual tag behavior in Tag Assistant.

Basic tag blocking: keep Consent Mode enabled and configure the publisher’s tag manager or integration to prevent Google tags from loading before the required affirmative choice. For one direct GA4 destination, use the complete Basic/full-off publisher example with Web CMP 1.5.30 or later. Verify no initial Google request before a grant, immediate withdrawal handling, and no Google load on the following denied page. Distinguish an already loaded tag’s transition behavior from a fresh denied page. This blocking behavior is a separate part of the publisher installation; the CMP’s Consent Mode setting alone does not block third-party scripts.

Full Consent Mode off: turn Consent Mode off in the dashboard, publish that setting, and replace the existing installation with the newly generated off snippet. Remove the old inline Google bootstrap and any separately installed gtag_enable_tcf_support = true override. The direct off snippet retains the TCF stub and consent UI, but does not queue Google defaults or updates, and disables the CMP’s advertiser-consent-mode inference flag. If Google tags remain in use, a separately implemented consent-aware blocker is required; verify it before making the page public.

<script id="cybexo-cmp" data-settings-id="CYB-YOUR_APP_ID"
data-consent-mode="off"
data-api-url="https://api.cybexo.io"
data-assets-url="https://cmp.cybexo.com"
src="https://cmp.cybexo.com/loader.js?data-installation-platform=direct"></script>

Changing a dashboard setting cannot undo inline defaults already executed by an older snippet. To return to advanced mode, publish Consent Mode on, replace the full installation with the on snippet, and remove only the intentional Google-tag blocking rules after verifying consent behavior. Preserve unrelated security and consent controls.

These direct-script off instructions do not replace the GTM template’s ownership configuration. See Google Consent Mode validation and Google’s basic and advanced definitions.

Keep a visible privacy choices link or button on each page. The built-in floating control uses the same preferences entry point. A publisher control can call:

if (typeof window.openCMPSettings === 'function') {
window.openCMPSettings();
}

The entry point opens only when configuration and applicable TCF delivery are ready. A function’s existence alone is not a readiness check. Opening preferences is not consent. Repeated opening preserves an unsaved draft; closing with X cancels that draft. Choices change only through an explicit completed action.

Use a fresh browser session and Tag Assistant. Check:

  1. Correct App ID and approved domain; current loader, configuration and vendor list load successfully.
  2. In advanced mode, all four denied defaults precede Google initialization; acceptance and mixed choices produce the expected updates.
  3. From accepted, rejected and mixed saved choices, reopen preferences, change a draft and close without saving. The saved choice and effective Google state must remain unchanged. Select the latest consent event in Tag Assistant, then return to the page summary to refresh its displayed state.
  4. Turn only Analytics off, then reload. Analytics remains denied even when the TCF advertising-purpose string is unchanged.
  5. Reject All and reload; optional consent stays denied and the privacy control still opens.
  6. Block each required dependency in a controlled test and verify no fabricated consent grant, then remove the block and verify recovery.
  7. Separately test your configured no-banner regional case. A primary worldwide-TCF demonstration is a different configuration.
  8. In basic/full-off installations, verify the publisher’s actual network blocking and withdrawal behavior, not just the CMP switch.

For an observable command log, this handles both arrays and the standard gtag arguments objects:

(window.dataLayer || [])
.map(entry => Array.isArray(entry) ? entry :
Object.prototype.toString.call(entry) === '[object Arguments]' ? Array.from(entry) : null)
.filter(entry => entry && entry[0] === 'consent');

Queued commands are not proof of effective Google consent or collection. Use Tag Assistant for that distinction. For late signals, first verify whether the Google tag uses Google tag gateway. See TCF API validation and Web consent receipts for the related checks.