Provide more specific messaging on the GTM and GA integration screens

[techanvil]

Feature Description

Now that we have the ability to lookup a Tag Manager container by tag ID, we should implement the more specific messaging for the GTM and GA integration screens that was originally specced for https://github.com/google/site-kit-wp/issues/7990 (see https://github.com/google/site-kit-wp/issues/7989#issuecomment-1915654586).

---

Do not alter or remove anything below. The following sections will be managed by moderators only.

Acceptance criteria

• When setting up or editing Tag Manager settings, the messages and screens shown when the GTM container's tag points to a measurement ID should be updated as follows:
  • If GA4 is already connected, having a measurement ID, and the selected Tag Manager container has a Google Tag (googtag) which has the measurement ID as a destination, then display the following screen (which was originally shown when UA was setup and a property ID matched).
  • Screenshot:
  • The message should be modified to say: "Looks like you’re using Google Analytics. Your Analytics property with measurement ID xxxxxxxxxxx is already set up in your Google Tag Manager configuration, so Site Kit will switch to using Google Tag Manager for Analytics."
  • The CTA should be modified as per the screenshot above (to "Confirm & Continue").
  • If GA4 is not connected, but the selected Tag Manager container has a Google Tag (googtag) which has a measurement ID as a destination, then display the following screen:
  • Screenshot:
  • The message and the CTAs should match the above screenshot.
  • Clicking on "Continue to Analytics setup" should take the user to the Connect Service Analytics screen. (/wp-admin/admin.php?page=googlesitekit-dashboard&slug=analytics&reAuth=true). The text which should be added just below the heading and above the "Please select the account information below." line is as follows:
    • When the selected measurement ID in the Analytics form exists as a destination for current GTM container's tag: "A Google Tag Manager container with a tag for the selected property with measurement ID G-XXXXXXXXXX was found on your site, so Site Kit will not place its own tag. If you would prefer to have Site Kit insert this tag, remove it from your Google Tag Manager container and update later in Settings."
    • When the measurement ID is not present as a destination: "An existing Google Analytics property with measurement ID G-XXXXXXXXXX was found on your site, added by Google Tag Manager."

Implementation Brief

• [ ]

Test Coverage

QA Brief

Changelog entry

[jimmymadon]

@techanvil Thanks for creating this issue. I reviewed this initially and then discussed it on our AC sync today.

1. As mentioned in the comment in issue #7989:

"We will not check if the Google Tag points to an actual GA4 web data stream until perhaps direct API support is available to find these details from a Google Tag ID"

The above is pretty much the only thing we can do now, i.e. when Analytics is not already connected, we can tell the user for sure now that their Google Tag Manager container contains a tag that points to a Analytics 4 Measurement ID. We agreed that this isn't something that is worth our time and effort as this information doesn't change anything for our users. We already "assume" this to be the case and suggest the user connect Analytics when we implemented issue #7990.

2. All the remaining cases, which are when Analytics is connected and the Measurement ID in the GTM container matches or does not match the Measurement ID in our Analytics config are pointless now. This is because:
   • UA duplicated events when tags were duplicated on a page. This is why SK was programmed to switch to using the GTM tag and not placing the Analytics tag.
   • Not placing the GA4 tag now in SK has other implications which @aaemnnosttv pointed out - like not tracking custom dimensions, etc.
   • So we want to make sure that we always insert our own GA4 tag regardless of any tags found within GTM. GA4 does not duplicate events if the same measurement ID tags are duplicated on a page.

So I think we can close this issue. This is good documentation that we have reviewed #7989/#7990 after the Google Tag API development.

c.c. @aaemnnosttv

[aaemnnosttv]

Thanks @jimmymadon – it sounds like there isn't much benefit to implementing this as defined as you noted but I'd like to get @techanvil 's perspective in case we've missed anything in our review.