WC 8.0 & WP 6.3 Compatibility

[martynmjones]

GLA Manual Smoke Tests

Use this guide to smoke-test the plugin (for compatibility or other reasons). If there's a common use case or cause of errors not included, please add it!

After each step during testing, be sure to check the debug logs and the browser console for errors, warnings, or notices.

• Prerequisites: Wordpress.com and Google accounts, WooCommerce store with existing products and categories. (For example, see Importing WooCommerce Sample Data ).

• Install extension / Uninstall extension

Onboarding Wizard

Set up your accounts

• Connect wordpress.com
• Connect Google account
• Connect Google Account. Then change the URL and connect that account. You should be able to claim the website.
• Set up Google Merchant Center (Connect existing account).
• Set up Google Merchant Center (Create a new account).
• The "next" button should not be enabled until all accounts are connected.
• Verify the UI: FAQ can expand; check that doc links and tooltips are working.
• Onboarding: Verify that you can navigate back using the menu at the top.

Choose your audience and product listings

• The default language is preselected
• Select countries.
• Checking the "All countries" option hides the country select textbook.
• If United States is not selected, the card "Tax rate (required for U.S. only)" at the bottom is not displayed.
• If the "My shipping settings are simple. I can manually estimate flat shipping rates" option is checked
  • The "Estimated shipping rates" field is displayed
  • If the "Estimated shipping rates" field is 0, the "Free shipping for all orders" tag is displayed
  • If the "Estimated shipping rates" field is >0, the "I offer free shipping for orders over a certain price" field is displayed
  • If the "I offer free shipping for orders over a certain price" field is "Yes", the "Minimum order to qualify for free shipping" field is displayed
• If the "My shipping settings are complex. I will enter my shipping rates and times manually in Google Merchant Center" option is selected; both the shipping rate and Shipping time are hidden, and the "Continue" button is enabled
• The "Continue" button is disabled if no shipping time is entered on a simple shipping setup

Confirm store requirements

• Verify phone number
• Confirm Pre-Launch Checklist
• The "Continue" button is disabled until the Pre-Launch Checklist is checked and the Store address is valid

Complete your campaign

• The number of syncable products in the Product feed status section is shown
• The ad previews automatically rotate and the bestselling product, shop name, shop URL, and shop logo are composited with the reviews if applicable
• Verify the UI: FAQ can expand
• Complete onboarding without setting up paid ads
• Clicking on "Create a paid ad campaign" can show Google Ads, Ads audience, and Set your budget sections; The audience and budget sections should be shown in disabled
• Connect an existing Google Ads account
• Disconnect Google Ads account
• Create a new Google Ads account and connect it
• After a Google Ads account is connected, the audience and budget sections should be shown in enabled, and the countries selected in step 2 should be preselected in ads audience
• Ads audience selector only allows selecting the same set of the countries selected in step 2
• Changing ads audience should also display the suggested budget range below according to the selected countries
• Setting different budget values lower or higher than the suggestion should also display or hide the corresponding tip below
• Before setting up the billing method, there should be a billing information card for opening Google's billing setting page by a button or an alternative link
  • Button should open the billing setting page via a pop-up window aligned to the center of the current browser window
  • Alternative link should open the billing setting page via a new browser tab
• After completing the billing setting and waiting for a while, the billing information card should change to a setup successful message.
• The "Complete setup" button is disabled if any paid ads setup is not yet completed
• Complete onboarding with paid ads

After onboarding is complete:

• Navigate all Google Listings & Ads tabs (Reports, Product Feed, Settings) - The content loads with no errors or warnings

Google Listings & Ads > Dashboard

• Navigate to Marketing -> Google Listing & Ads -> Dashboard
• Edit free listings and make sure it can save successfully.
• Go into Edit free listings page and click on the top left back button. It should bring you back to the Dashboard page.
• Create a campaign by clicking the "Add paid campaign" button and ensure the journey works.
  • The "Select country/s" field works; you can search and select countries.
  • The FAQ display and expand/collapse correctly.
  • The "Continue" button is disabled until the "Select country/s" and "Daily average cost" fields have been filled.
• Create an Ads campaign without adding assets and confirm that the data is in Google Ads
• Edit an Ads campaign without adding assets and confirm that the data is in Google Ads
• Disable a campaign from the "Programs" table and ensure the campaign has been paused in Google ads.
• Remove a campaign from the "Programs" table and ensure the campaign has been removed in Google ads.
• Filter dashboard by date range
• Campaign Assets tour on the Dashboard page

   # SQL to reset the checked flag of tours
   DELETE FROM wp_options WHERE option_name = 'gla_tours';

  • The tour floats upon the Edit button of the first campaign after having at least one campaign.
  • The tour won't appear again after clicking on the [X] button to close it.
• Campaign Assets

   // If the test environment is a local site, it may need to add this code snippet to
   // the end of the ./google-listings-and-ads.php file to pass the Final URL matching
   // and the SSL verification in the `wp_remote_get` calls.
  
   function replace_with_gmc_domain( $url ) {
      return str_replace( get_home_url(), 'https://domain-name-of-the-associated-google-mc-account', $url );
   }
   
   add_filter( 'page_link', 'replace_with_gmc_domain' );
   add_filter( 'term_link', 'replace_with_gmc_domain' );
   add_filter( 'post_type_link', 'replace_with_gmc_domain' );
   
   add_filter( 'https_ssl_verify', '__return_false' );
   add_filter( 'https_local_ssl_verify', '__return_false' );

  • In the Final URL card, it lists the homepage and shop pages by default and can search pages/posts/categories(taxonomies) by keywords.
  • Create a campaign with assets. All asset fields should be successfully saved.
  • Add assets to an existing campaign. All asset fields should be successfully saved.
  • Edit assets of a campaign. All asset fields should be successfully edited.
  • Should be able to remove the optional assets of a campaign.
  • An empty asset group is created first when saving assets to a campaign that doesn't have any (empty) asset groups:
    1. In GLA, create a campaign without assets.
    2. Go to Google Ads to delete the empty asset group for the newly created campaign.
    3. Back to GLA, refresh the web page, and go to edit the newly created campaign.
    4. Add assets and save changes.
  • Campaigns that already have assets are not allowed to change the Final URL.
  • All asset fields are disabled and collapsed if no selected Final URL and the "Launch paid campaign" button is disabled as well.
  • All asset fields are enabled and expanded after a Final URL is selected and the "Launch paid campaign" button is enabled as well.
  • Asset fields are filled in with asset suggestion data after a Final URL is selected.
  • When the number of values in each asset text field reaches its maximum limit, the add button is disabled.
  • The values in each asset text field that exceeds the minimum number requirement can be deleted.
  • After toggling the asset field, the edited values are kept. After going to step 1 and back to step 2, the edited values in asset fields are kept.
  • The "n/N characters" label below text inputs is turned to red color when exceeding its character count limit.
  • Landscape, Square and Portrait images share the maximum total number of 20.
  • Images are cropped to the required aspect ratios.
  • Images that already fit with the required aspect ratios can skip cropping.
  • Images that don't meet the required size are not allowed to be selected.
  • Before clicking on the submit button, there are no issue labels nor lists of invalid reasons except for the character count exceeding errors.
  • After clicking on the submit button without fulfilling all required asset fields, the form won't be submitted, the web page should be scrolled to the first incomplete field, and all incomplete fields show the number of issues in a label and a list of invalid reasons.
    

Google Listings & Ads > Reports

• Filter reports by data range.

Programs tab

• Try some values in the "Show" field:
  • "Single program"
  • "Comparison" between 2 or more programs

Products tab

• Try some values in the "Show" field:
  • Single product
  • Comparison view between 2 or more products

Google Listings & Ads > Product Feed

• Select a product in the "Product Feed" table and update the channel visibility
• Click on the pagination link on the Product table to ensure this works
• Click on the pagination link on the "Issues to resolve" table to ensure this works

Google Listings & Ads > Settings

• Perform Phone number update
• Disconnect Google Ads only
• Disconnect all google accounts.
• Reconnect by going through the onboarding steps

Sync Products with Google Merchant Center

Note that the following operations with Google MC can take some minutes.

The Mismatched URL will block product synchronization. To test this part in a local environment, please try making the following adjustments to the local env first:

1. Add this code snippet to google-listings-and-ads.php for skipping the URL matching check.

   add_filter( 'woocommerce_gla_ready_for_syncing', '__return_true' );

2. Clear related transients from DB.

   DELETE FROM wp_options where option_name LIKE '%gla_url_matches%';

• Visit wp-admin/admin.php?page=connection-test-admin-page.
• Go to the "Product Sync" section (at bottom of the page) and tick the option async for Sync All Products and Delete All Synced Products.
• If you have products in Google MC try to delete them using Delete All Synced Products.
• Check that they are deleted in the Google MC.
• Sync the products again using Sync All Products.
• Check that the products have been synced again.
• Edit any synced product (change the title) and confirm that the changes are reflected in the Merchant Center.

Gtag events

• Successfully run e2e tests in local env.
  • Currently, the npm run start:hot script would cause gtag-events.js to not be loaded. Please use npm run dev or npm start instead. See Using npm run start:hot would cause gtag-events.js to not be loaded on the store pages #1842