From 7ff8bfcaece50e1b2846ca1fe5d7ab7a078a1a00 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20Wytr=C4=99bowicz?= <tomalecpub@gmail.com>
Date: Fri, 1 Mar 2024 20:16:57 +0100
Subject: [PATCH 1/3] Add gtag consent mode v0 support

---
 README.md                    |  1 +
 docs/gtag-consent-mode.md    |  7 +++++++
 src/Google/GlobalSiteTag.php | 23 +++++++++++++++++++++++
 3 files changed, 31 insertions(+)
 create mode 100644 docs/gtag-consent-mode.md

diff --git a/README.md b/README.md
index 432bc1f8c6..caedd54643 100644
--- a/README.md
+++ b/README.md
@@ -184,6 +184,7 @@ npm run -- wp-env run tests-cli -- wp wc update
 
 - [Usage Tracking](./src/Tracking/README.md)
 - [Hooks defined or used in GLA](./src/Hooks/README.md)
+- [gtag consent mode](./docs/gtag-consent-mode.md)
 
 <p align="center">
 	<br/><br/>
diff --git a/docs/gtag-consent-mode.md b/docs/gtag-consent-mode.md
new file mode 100644
index 0000000000..eaddbfb941
--- /dev/null
+++ b/docs/gtag-consent-mode.md
@@ -0,0 +1,7 @@
+## Googla Analytics (gtag) Consent Mode
+
+Unless you're running the [Google Analytics Integration](https://woo.com/products/woocommerce-google-analytics/) extension for a more sophisticated configuration, Google Listings and Ads will add Google's `gtag` to help you track some customer behavior.
+
+To respect your customers' privacy, we set up the default state of [consent mode](https://support.google.com/analytics/answer/9976101). We set it to deny all the parameters for visitors from the EEA region. You can add an extension or CMP that delivers a banner or any other UI to let visitors update their consent in runtime.
+
+You can also customize your own default state configuration using the `woocommerce_gla_gtag_consent` filter providing any snippet that uses [Google's `gtag('consent', 'default', {…})` API ](https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced).
diff --git a/src/Google/GlobalSiteTag.php b/src/Google/GlobalSiteTag.php
index 20d7fc192c..522989b2e5 100644
--- a/src/Google/GlobalSiteTag.php
+++ b/src/Google/GlobalSiteTag.php
@@ -254,6 +254,10 @@ protected function display_global_site_tag( string $ads_conversion_id ) {
 		<script>
 			window.dataLayer = window.dataLayer || [];
 			function gtag() { dataLayer.push(arguments); }
+			<?php
+				// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+				echo $this->get_consent_mode_config();
+			?>
 
 			gtag('js', new Date());
 			gtag('set', 'developer_id.<?php echo esc_js( self::DEVELOPER_ID ); ?>', true);
@@ -279,6 +283,25 @@ protected function get_gtag_config( string $ads_conversion_id ) {
 		);
 	}
 
+	/**
+	 * Get the default consent mode configuration.
+	 */
+	protected function get_consent_mode_config() {
+		$consent_mode_snippet = "gtag( 'consent', 'default', {
+				analytics_storage: 'denied',
+				ad_storage: 'denied',
+				ad_user_data: 'denied',
+				ad_personalization: 'denied',
+				region: ['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IS', 'IE', 'IT', 'LV', 'LI', 'LT', 'LU', 'MT', 'NL', 'NO', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'GB', 'CH'],
+			} );";
+		/**
+		 * Filters the default gtag consent mode configuration.
+		 *
+		 * @param string $consent_mode_snippet Default configuration with all the parameters `denied` for the EEA region.
+		 */
+		return apply_filters( 'woocommerce_gla_gtag_consent', $consent_mode_snippet );
+	}
+
 	/**
 	 * Add inline JavaScript to the page either as a standalone script or
 	 * attach it to Google Analytics for WooCommerce if it's installed

From 22410dfa780c4bad641bd2b9dd0a318c288fdf8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20Wytr=C4=99bowicz?= <tomalecpub@gmail.com>
Date: Mon, 4 Mar 2024 12:11:08 +0100
Subject: [PATCH 2/3] Mention how to update the consent mode in runtime

Addresses https://github.com/woocommerce/google-listings-and-ads/pull/2290#discussion_r1510985763
---
 docs/gtag-consent-mode.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/gtag-consent-mode.md b/docs/gtag-consent-mode.md
index eaddbfb941..fe023eceae 100644
--- a/docs/gtag-consent-mode.md
+++ b/docs/gtag-consent-mode.md
@@ -5,3 +5,5 @@ Unless you're running the [Google Analytics Integration](https://woo.com/product
 To respect your customers' privacy, we set up the default state of [consent mode](https://support.google.com/analytics/answer/9976101). We set it to deny all the parameters for visitors from the EEA region. You can add an extension or CMP that delivers a banner or any other UI to let visitors update their consent in runtime.
 
 You can also customize your own default state configuration using the `woocommerce_gla_gtag_consent` filter providing any snippet that uses [Google's `gtag('consent', 'default', {…})` API ](https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced).
+
+After the page loads, the consent for particular parameters can be updated by other plugins or custom code implementing UI for customer-facing configuration using [Google's consent API](https://developers.google.com/tag-platform/security/guides/consent?hl=en&consentmode=advanced#update-consent) (`gtag('consent', 'update', {…})`).

From de77d2be5088a8f4db69224d3bc7154c4ac8ddd8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20Wytr=C4=99bowicz?= <tomalecpub@gmail.com>
Date: Mon, 4 Mar 2024 12:15:33 +0100
Subject: [PATCH 3/3] Update WCGAI to GA4W branding

Address https://github.com/woocommerce/google-listings-and-ads/pull/2290/files#r1510986691
---
 docs/gtag-consent-mode.md    |  2 +-
 src/Google/GlobalSiteTag.php |  2 +-
 src/Proxies/GoogleGtagJs.php | 10 +++++-----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/gtag-consent-mode.md b/docs/gtag-consent-mode.md
index fe023eceae..8f819fe66f 100644
--- a/docs/gtag-consent-mode.md
+++ b/docs/gtag-consent-mode.md
@@ -1,6 +1,6 @@
 ## Googla Analytics (gtag) Consent Mode
 
-Unless you're running the [Google Analytics Integration](https://woo.com/products/woocommerce-google-analytics/) extension for a more sophisticated configuration, Google Listings and Ads will add Google's `gtag` to help you track some customer behavior.
+Unless you're running the [Google Analytics for WooCommerce](https://woo.com/products/woocommerce-google-analytics/) extension for a more sophisticated configuration, Google Listings and Ads will add Google's `gtag` to help you track some customer behavior.
 
 To respect your customers' privacy, we set up the default state of [consent mode](https://support.google.com/analytics/answer/9976101). We set it to deny all the parameters for visitors from the EEA region. You can add an extension or CMP that delivers a banner or any other UI to let visitors update their consent in runtime.
 
diff --git a/src/Google/GlobalSiteTag.php b/src/Google/GlobalSiteTag.php
index 522989b2e5..689af75e40 100644
--- a/src/Google/GlobalSiteTag.php
+++ b/src/Google/GlobalSiteTag.php
@@ -211,7 +211,7 @@ function () use ( $gtag_events ) {
 	/**
 	 * Activate the Global Site Tag framework:
 	 * - Insert GST code, or
-	 * - Include the Google Ads conversion ID in WooCommerce Google Analytics Integration output, if available
+	 * - Include the Google Ads conversion ID in WooCommerce Google Analytics for WooCommerce output, if available
 	 *
 	 * @param string $ads_conversion_id Google Ads account conversion ID.
 	 */
diff --git a/src/Proxies/GoogleGtagJs.php b/src/Proxies/GoogleGtagJs.php
index 80d667a3b8..325afd2514 100644
--- a/src/Proxies/GoogleGtagJs.php
+++ b/src/Proxies/GoogleGtagJs.php
@@ -16,7 +16,7 @@ class GoogleGtagJs {
 	/**
 	 * GoogleGtagJs constructor.
 	 *
-	 * Load the WooCommerce Google Analytics Integration extension settings.
+	 * Load the WooCommerce Google Analytics for WooCommerce extension settings.
 	 */
 	public function __construct() {
 		$this->wcga_settings = get_option( 'woocommerce_google_analytics_settings', [] );
@@ -36,20 +36,20 @@ public function __construct() {
 	}
 
 	/**
-	 * Determine whether WooCommerce Google Analytics Integration is already
+	 * Determine whether WooCommerce Google Analytics for WooCommerce is already
 	 * injecting the gtag <script> code.
 	 *
 	 * @return bool True if the <script> code is present.
 	 */
 	public function is_adding_framework() {
-		// WooCommerce Google Analytics Integration is disabled for admin users.
+		// WooCommerce Google Analytics for WooCommerce is disabled for admin users.
 		$is_admin = is_admin() || current_user_can( 'manage_options' );
 
 		return ! $is_admin && class_exists( '\WC_Google_Gtag_JS' ) && $this->is_gtag_page() && $this->has_required_settings();
 	}
 
 	/**
-	 * Determine whether the current page has WooCommerce Google Analytics Integration enabled.
+	 * Determine whether the current page has WooCommerce Google Analytics for WooCommerce enabled.
 	 *
 	 * @return bool If the page is a Analytics-enabled page.
 	 */
@@ -61,7 +61,7 @@ private function is_gtag_page(): bool {
 	}
 
 	/**
-	 * In order for WooCommerce Google Analytics Integration to include the Global Site Tag
+	 * In order for WooCommerce Google Analytics for WooCommerce to include the Global Site Tag
 	 * framework, it needs to be enabled in the settings and a Measurement ID must be provided.
 	 *
 	 * @return bool True if Global Site Tag is enabled and a Measurement ID is provided.