Whittfield Holmes

<p><strong>BrandMeetsCode DataLayer Tracker</strong> sends <strong>structured data</strong> to <code>window.dataLayer</code> so Google Tag Manager or your own tags can consume consistent events and page context.</p>
<p>By <strong>Whittfield Holmes</strong> at <strong><a href="https://brandmeetscode.com/" rel="nofollow ugc">Brand Meets Code</a></strong>. Listed on WordPress.org as <strong>BrandMeetsCode DataLayer Tracker</strong>; the wp-admin menu is <strong>DataLayer Tracker</strong>.</p>
<p>This plugin is <strong>fully functional</strong> with <strong>no license checks</strong>, <strong>no trial period</strong>, <strong>no usage quotas</strong>, and <strong>no disabled settings</strong> in wp-admin.</p>
<h4>Included features</h4>
<ul>
<li><strong>Page & content context</strong> — page type, IDs, title, URL, slug/path, categories/tags, referrer, <strong>UTM parameters</strong></li>
<li><strong>Visitor & device hints</strong> — resolution, timezone offset, browser language; optional cookie exposure rules</li>
<li><strong>Logged-in user context</strong> — role-style flags and optional <strong>hashed user id</strong> (modes you configure)</li>
<li><strong>Engagement</strong> — scroll depth (modes), scroll back up, focus/blur, time on page, <strong>active time</strong>, <strong>hover intent</strong>, <strong>video progress</strong>, default clicks; optional deeper click/field/section options where listed in Settings</li>
<li><strong>Forms</strong> — <code>form_view</code>, <code>form_field_start</code>, <code>form_submit</code>, <code>form_error</code>, <code>form_abandon</code>; optional form-vendor shortcut mode</li>
<li><strong>WooCommerce (when enabled)</strong> — browser <strong>GA4-style ecommerce</strong> events (view_item, add_to_cart, purchase, etc.) when WooCommerce is active</li>
<li><strong>Google Tag Manager</strong> — optional container <strong>snippet</strong> output from settings (you configure tags inside GTM)</li>
<li><strong>Consent-aware loading</strong> — delay until consent, CMP preference, TCF option, fallbacks</li>
<li><strong>Page URL filtering</strong> — regex exclude list</li>
<li><strong>Sessions</strong> — client-side session timeout/heartbeat options</li>
<li><strong>Debugging</strong> — console logging levels and admin <strong>debug overlay</strong> (core panels)</li>
<li><strong>Developer-friendly</strong> — hooks/filters; push custom <code>window.dataLayer</code> events from theme or other plugins</li>
</ul>
<h4>Consent Management</h4>
<p>Auto-detection and integration patterns vary by CMP; you remain responsible for correct legal configuration on your site.</p>
<h4>Google Tag Manager</h4>
<p>Optional <strong>snippet</strong> + consistent <strong>dataLayer</strong> pushes. Configure tags, triggers, and variables inside GTM.</p>
<h3>External Services</h3>
<h4>Google Tag Manager (optional — only when you configure a container ID)</h4>
<p>This plugin includes an optional feature to inject the Google Tag Manager container snippet on your site’s front end. This feature is <strong>disabled by default</strong> and only activates when you enter a GTM Container ID in the plugin settings and enable the snippet toggle.</p>
<p><strong>What it does:</strong> When enabled, the plugin outputs the standard GTM <code><script></code> and <code><noscript></code> tags that load <code>https://www.googletagmanager.com/gtm.js</code>. This causes the visitor’s browser to contact Google’s servers to load the GTM container.</p>
<p><strong>What data is sent:</strong> When GTM loads, Google receives the visitor’s IP address, browser, and the URL being viewed — the same data sent by any website that loads GTM. No additional data is sent by this plugin beyond the standard GTM request. The plugin itself populates <code>window.dataLayer</code> in the browser; it is your GTM configuration that determines what analytics data leaves the site.</p>
<p><strong>When it is sent:</strong> Only on front-end page loads when the visitor’s browser downloads the GTM script. If the consent-delay feature is enabled, the snippet is withheld until the visitor grants consent via your CMP.</p>
<p><strong>Service provider:</strong> Google LLC</p>
<ul>
<li><strong>Terms of Service:</strong> <a href="https://policies.google.com/terms" rel="nofollow ugc">Google Terms of Service</a></li>
<li><strong>Privacy Policy:</strong> <a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
<li><strong>GTM documentation:</strong> <a href="https://marketingplatform.google.com/about/tag-manager/" rel="nofollow ugc">Google Tag Manager</a></li>
</ul>
<h4>WordPress Admin AJAX</h4>
<p>All plugin settings saves, the setup wizard, and admin actions use WordPress’s built-in <code>admin-ajax.php</code> endpoint. All requests go to your own WordPress installation. No data is sent to external servers by these requests.</p>
<p><strong>Important:</strong> You are responsible for ensuring that any third-party analytics services (GTM, GA4, etc.) you configure on your site comply with applicable data-protection laws (GDPR, CCPA, etc.) and that visitors are properly informed. This plugin provides consent-delay and CMP-detection functionality to help withhold scripts until consent is obtained, but legal compliance remains your responsibility.</p>
<h3>Privacy Policy</h3>
<p>BrandMeetsCode DataLayer Tracker may expose, depending entirely on which options you enable:</p>
<ul>
<li>Page URL, titles, and taxonomy-style context</li>
<li>Logged-in user fields you choose to surface, including optional <strong>hashed</strong> identifiers</li>
<li>Engagement signals (scroll depth, timing, generic form interactions)</li>
<li>WooCommerce-related item data when ecommerce tracking is enabled</li>
<li>Structured event data pushed to <code>window.dataLayer</code> for use by analytics tools you configure</li>
</ul>
<p>This plugin does not send data to any external server on your behalf. You are responsible for consent, disclosure, and lawful basis for any analytics tools you add to your site. The plugin does not replace legal or DPO review.</p>
<p>Data is exposed to the browser <code>dataLayer</code>; downstream tags decide what leaves the site.</p>
<h3>Support</h3>
<h4>Documentation</h4>
<ul>
<li>Full Documentation: <a href="https://datalayer-tracker.com/knowledge-base" rel="nofollow ugc">https://datalayer-tracker.com/knowledge-base</a></li>
<li>Video Tutorials: <a href="https://youtube.com/@whittfieldholmes" rel="nofollow ugc">YouTube Channel</a></li>
</ul>
<h4>Community Support</h4>
<ul>
<li>Support Forum: <a href="https://wordpress.org/support/plugin/brandmeetscode-datalayer-tracker" rel="ugc">WordPress.org</a></li>
</ul>
<h3>Developer Hooks</h3>
<h4>Filters (examples)</h4>
<pre><code>add_filter(
    'brandatr_before_push',
    static function ( $event ) {
        $event['custom_field'] = 'value';

        return $event;
    }
);

add_filter(
    'brandatr_should_track_event',
    static function ( $should_track, $event_name ) {
        if ( 'unwanted_event' === $event_name ) {
            return false;
        }

        return $should_track;
    },
    10,
    2
);
</code></pre>
<h4>Actions</h4>
<pre><code>// Run code after consent granted
add_action('brandatr_consent_granted', function($consent_types) {
    // Your code here
});

// Run code after dataLayer push
add_action('brandatr_after_push', function($event) {
    // Your code here
});
</code></pre>
<h4>JavaScript API</h4>
<pre><code>// Push custom event
window.dataLayer.push({
    event: 'custom_event',
    custom_param: 'value'
});

// Get session context
const context = window.ADTSession?.getContext();

// Check consent
const hasConsent = window.hasConsent('analytics');<h3>Credits</h3>
</code></pre>
<p>Developed by <strong>Whittfield Holmes</strong> at <strong><a href="https://brandmeetscode.com/" rel="nofollow ugc">Brand Meets Code</a></strong>.</p>
<p>Special thanks to the WordPress community, beta testers, and all users who provide feedback and feature requests.</p>


BrandMeetsCode DataLayer Tracker

GTM-ready dataLayer: consent-aware events, engagement, admin debug overlay, optional WooCommerce. Fully free—no license keys or locked settings.

BrandMeetsCode DataLayer Tracker vs PixelYourSite – Your smart PIXEL (TAG) & API Manager