Integrate NexaGuard CMP with Drupal

The NexaGuard Consent Management Platform (CMP) provides an enterprise-grade solution for GDPR, ePrivacy, and Google Consent Mode v2 compliance in Drupal.
This guide describes the complete installation, configuration, and verification process for the NexaGuard CMP Drupal Module.

Overview

NexaGuard CMP enables Drupal websites to collect, manage, and transmit user consent signals to third-party services like Google Ads, Google Analytics, and other marketing tools.
The module works seamlessly across Drupal 9, 10, and 11, automatically injecting the CMP loader script into your site’s <head> section.

Once installed, the module will:

Display a customizable consent banner across all pages.

Capture and store user consent preferences.

Handle Google Consent Mode v2 default and update events automatically.

Maintain compliance with privacy regulations globally.

Module Details

Property	Value
Module Name	NexaGuard CMP
Package	Privacy
Description	Integrates NexaGuard Consent Management Platform into Drupal for GDPR and Google Consent Mode v2 compliance.
Core compatibility	Drupal 9, 10, 11
License	GPL-2.0-or-later
Maintainer	NexaGuard Inc.
Project URL	https://www.drupal.org/project/nexaguard_cmp

Requirements

Drupal 9 or higher

PHP 8.1 or higher

Administrator privileges to install modules

A valid NexaGuard CMP account and Settings ID

Installation

Option 1 — Install via Composer

Option 2 — Manual Installation

Download the latest release from the Drupal project page:
https://www.drupal.org/project/nexaguard_cmp

Extract the archive to /modules/custom/nexaguard_cmp or /modules/contrib/nexaguard_cmp.

Enable the module:

Extend → NexaGuard CMP → Enable

Clear caches (drush cr or via the admin interface).

Configuration

Navigate to Configuration → System → NexaGuard CMP.

Enter your Settings ID (from your NexaGuard dashboard).

Configure additional options:

✅ Auto-inject CMP Script.

✅ Enable Google Consent Mode v2.

✅ Inject only for anonymous users.

✅ Exclude admin pages from injection.

Click Save Configuration.

Script Injection Behavior

After configuration, the module automatically injects the CMP loader script into the <head> of all public pages:

The module ensures this script is loaded only once and integrates seamlessly with Drupal caching systems.
If Google Consent Mode is enabled, it automatically executes gtag('consent', 'default') and gtag('consent', 'update') events based on user consent.

Verification

Option 1 — Browser Developer Tools

Open your site and inspect using Developer Tools (F12).

In the Network tab, filter for “loader.js” or “consent”.

Confirm that loader.js is loaded from https://cmp.nexaguard.com and consent events are triggered.

Option 2 — Google Tag Assistant

Install Google Tag Assistant.

Record your session and reload the page.

Verify “Consent Mode active” and gtag('consent', 'update') events after user action.

Option 3 — NexaGuard Debug Mode

Add ?nxg_debug=1 to your site URL.
Example: https://example.com/?nxg_debug=1
The debug overlay will show banner status, consent categories, and Consent Mode values.

Advanced Options

Feature	Description
Anonymous Users Only	Displays the banner only to logged-out visitors.
Exclude Admin Routes	Prevents CMP injection on `/admin/*` pages.
Debug Mode	Adds CMP overlay for consent diagnostics.
Custom Asset URLs	Allows custom CMP endpoints for testing or staging environments.

Troubleshooting

Issue	Cause	Solution
CMP banner not visible	Missing or invalid Settings ID	Verify the ID in NexaGuard CMP configuration
CMP script duplicated	Cached theme injection	Clear caches and verify only one `<script>` appears
Consent Mode inactive	gtag or Tag Manager misconfigured	Enable Google Consent Mode v2 option
Admin pages affected	Exclude Admin Routes disabled	Enable the exclude admin option under configuration

Uninstallation

Navigate to Extend → NexaGuard CMP → Uninstall.

Run the following commands if using Drush:

All configurations are safely removed.

Security and Compliance

NexaGuard CMP ensures your site meets major international privacy standards:

GDPR (General Data Protection Regulation)

ePrivacy Directive (EU Cookie Law)

Google Consent Mode v2

CCPA / CPRA (California)

All communications are performed via HTTPS with TLS encryption.
User consent preferences are stored securely and anonymized.

Verification for Google Audit

Module provides guided setup with configuration UI.

CMP loader injects automatically into all public pages.

Google Consent Mode default and update signals function as required.

Public documentation and release available at https://www.drupal.org/project/nexaguard_cmp.

This module fully satisfies Google’s Gold Tier x.3.a (3+ CMS integrations) requirement.

Enterprise References

Compliance Overview

IAB TCF v2.3 Support

Google Consent Mode v2 Validation

CSP and Network Allowlist

Troubleshooting Playbook

Support

For help or inquiries, contact our support team:
📧 [email protected]
🌐 https://www.nexaguard.com

Integrate NexaGuard CMP with Drupal

Overview#

Module Details#

Requirements#

Installation#

Option 1 — Install via Composer#

Option 2 — Manual Installation#

Configuration#

Script Injection Behavior#

Verification#

Option 1 — Browser Developer Tools#

Option 2 — Google Tag Assistant#

Option 3 — NexaGuard Debug Mode#

Advanced Options#

Troubleshooting#

Uninstallation#

Security and Compliance#

Verification for Google Audit#

Enterprise References#

Support#