General Testing

For compatibility and general smoke testing

Prereqs:

Configured WooCommerce with products, and a valid payment processor (dev Stripe, or cash on delivery option in WC Settings > Payments) so that you can complete checkout.
Recommended (you can also check the requests manually tho) to use a debugger tool like Google Analytics Debugger Extension or Tag Assistant (official)
⚠️ Be sure to check the browser console as well as the WP debug log for errors.
⚠️ Make sure there are no Ad blockers in your browser.
⚠️ For testing the tracking try in incognito or without being logged in as admin
🧪 Means the test is covered in E2E tests

0. Installation 🧪

🧪 Activating the plugin doesn't cause errors.
🧪 Deactivating the plugin doesn't cause errors.

1. Settings

🧪 Go to Settings ( WooCommerce → Settings → Integration → Google Analytics )
🧪 Confirm it loads OK.
Confirm that "Product Identification" appears and you can select between Product ID and SKU
Confirm that "Google Analytics Tracking ID" field appears. Add a test tracking like: G-28QSQJCS9D
Select all: "Display Advertising" Support, Purchase Transactions, Add to Cart Events, Remove from Cart Events, Product Impressions from Listing Pages, Product Clicks from Listing Pages, Product Detail Views, Checkout Process Initiated

2. Check scrips and data is loaded 🧪

🧪 As guest or not admin. Check google-tag-manager-js script is loading async https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX
🧪 As guest or not admin. Check woocommerce-google-analytics-integration-gtag-js-after script is loaded with all the gtag config: gtag("config", "G-XXXX", {"track_404":true,"allow_google_signals":true,"logged_in":false,"linker":{"domains":[],"allow_incoming":false},"custom_map":{"dimension1":"logged_in"}});
🧪 As guest or not admin. Check woocommerce-google-analytics-integration-js script is loaded the main file
🧪 As guest or not admin. Check woocommerce-google-analytics-integration-data-js-after script is loaded with all the window.ga4w config: i.e for the cart page: window.ga4w = { data: {"cart":{"items":[{"id":9154,"name":"Incredible Bronze Watch"
🧪 As guest or not admin. Go to shop and verify page_view is sent
🧪 Log as admin. None of those scripts should be attached.

3. Check consent

Check that the default consent is enabled


// Set up default consent state.
 for ( const mode of [{"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"]}] \|\| [] ) {
  gtag( "consent", "default", { "wait_for_update": 500, ...mode } );
  }
  gtag("js", new Date());
  gtag("set", "developer_id.dOGY3NW", true);
  gtag("config", "G-XXXXX", {"track_404":true,"allow_google_signals":true,"logged_in":false,"linker":{"domains":[],"allow_incoming":false},"custom_map":{"dimension1":"logged_in"}});

Add a snippet for changing those settings, and verify is being sent in the debugger:

add_filter( 'woocommerce_ga_gtag_consent_modes', function ( $consent_modes ) {
		$consent_modes[] =
			array(
				'analytics_storage' => 'granted',
				'ad_storage' => 'granted',
				'ad_user_data' => 'granted',
				'ad_personalization' => 'granted',
				'region' => ['ES'],
			);
		return $consent_modes;
	} );

4. Check the default theme shop page events

🧪 Go to that page and verify that view_item_list is being triggered for the products in the grid.
🧪 Click on Add to Cart in one of the products and verify add_to_cart is being triggered.
Click on the product image in one of the products and verify that select_content is being triggered.

5. Check blocks (Products Collection) events

Prereqs. Create a page with "Products Collection" block on it.

🧪 Go to that page and verify that view_item_list is being triggered for the products in the grid.
🧪 Click on Add to Cart in one of the products and verify add_to_cart is being triggered.
Click on the product image in one of the products and verify that select_content is being triggered.

6. Check blocks (All Products) events

Prereqs. Create a page with "All Products" block on it.

🧪 Go to that page and verify that view_item_list is being triggered for the products in the grid.
🧪 Click on Add to Cart in one of the products and verify add_to_cart is being triggered.
Click on the product image in one of the products and verify that select_content is being triggered.

7. Check triggers (Classic pages) events

Prereqs. Create a page with [products] shortcode on it.

🧪 Go to that page and verify that view_item_list is being triggered for the products in the grid.
🧪 Click on Add to Cart in one of the products and verify add_to_cart is being triggered.
Click on the product image in one of the products and verify that select_content is being triggered.

8. Check Single product page events

🧪 In the single product page check that view_item is triggered.
🧪 In the single product page check that view_item_list is triggered for the related items.
🧪 Add one of those related items to the cart. Verify add_to_cart is being triggered.
Click on the name of one of those related items. Verify that select_content is being triggered.
🧪 In the single product page. Add the item to cart. Verify add_to_cart is being triggered.
🧪 In a variable page. Add the item to cart. Verify add_to_cart is being triggered.

9. Check Cart

🧪 Open the cart on the side and remove an item. Verify that remove_from_cart event was triggered.
🧪 Go to the cart page and remove an item. Verify that remove_from_cart event was triggered.

10. Check Purchase

🧪 Add an item to the cart. And go to Checkout. Verify that begin_checkout was triggered.
🧪 Place the order. Verify that purchase was triggered.

11. Disabling events

Go to Settings and uncheck everything in "Event Tracking" section.
Verify thatview_item_list event is not being triggered anymore.
Verify that add_to_cart event is not being triggered anymore.
Verify that select_content event is not being triggered anymore.
Verify that view_item event is not being triggered anymore.
Verify that remove_from_cart event is not being triggered anymore.
Verify that begin_checkout is not triggered.
Verify that purchase is not triggered.

12. WP Consent API integration

⚠️ Note: Consent defaults are only set for the EEA regions. If running these tests from a country where defaults are not set then a VPN can be used or alternatively set defaults for your country using the following filter.

add_filter(
	'woocommerce_ga_gtag_consent_modes',
	function ( $consent_modes ) {
		$consent_modes[] =
			array(
				'ad_storage'         => 'denied',
				'ad_user_data'       => 'denied',
				'ad_personalization' => 'denied',
				'analytics_storage'  => 'denied',
				'region'             => array( 'GB' ), // <-- Set your country code here
			);
	return $consent_modes;
	}
);

Provide feedback

Saved searches

Use saved searches to filter your results more quickly