Set up Google Analytics 4 (GA4)

[chalin]

Hi all, I've been asked to help in setting up GA4; @zijianjoy wrote cncf/sandbox#196:

Sounds good, @nate-double-u Please feel free to comment here for how to move forward integrating with CNCF analytics account. The kubeflow website is located in https://github.com/kubeflow/website

I lead the earlier CNCF effort to upgrade project websites to GA4, so @nate-double-u has asked me to help (he's at KubeCon). I can follow a similar process for Kubeflow if you'd like. I'll outline the steps here.

Tasks

• Create a GA4 site tag under the CNCF projects account.
  New GA4 stream measurement ID: G-Y2KDEK0998
• Configure the website to use the new site tag. We have two options here:
  • (Option A) Configure GA4 site tag through Docsy config -
    Use the new CNCF GA4 site tag in Hugo config #3627
  • (Option B) Configure GA4 website ID (gtag.js) through Netlify snippet injection, "Google Analytics 4 - only in production", just before </head>:

    {% if CONTEXT == 'production' %}
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-Y2KDEK0998"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
    
      gtag('config', 'G-Y2KDEK0998');
    </script>
    {% endif %}

• Confirm that the GA4 site tag is receiving events
• Cleanup: drop config using the old UA ID:

  website/config.toml

  Lines 81 to 83 in 746e719

  	[services]
  	[services.googleAnalytics]
  	id = "UA-135379910-1"

  
  Use the new CNCF GA4 site tag in Hugo config #3627

Pre-migration analytics info for the website

• UA ID UA-135379910-1 is registered using gtag.js
• Hosted on Netlify

Followup

• Upgrade to Docsy >= 0.8.0 for full support of GA4 #3629

References

Onboarding tracker issue:

• [PROJECT ONBOARDING] Kubeflow cncf/sandbox#196

I know that there existed an issue for the migration already, but given that UA properties aren't functional anymore, this is "Set up" more than a migration:

• migrate to Google Analtics v4 before July 1, 2023 (+ share data with community) #3402

/cc @caniszczyk @nate-double-u @zijianjoy

[thesuperzapper]

@chalin do we also want to migrate the google search console ownership?

Which is currently done via this file: https://github.com/kubeflow/website/blob/master/static/google65401334ad4c38b1.html

[zijianjoy]

Thank you @chalin for working on this item! I have approved your PR and feel free to comment here if we need any action to complete the task. (Validation, cleanup, etc.)

[chalin]

Hi, I'm back at the office, and slowly catching up. I'm glad to see GA4 setup!
I'll come back here to respond to questions when I next have the time.

[chalin]

@chalin do we also want to migrate the google search console ownership?

Which is currently done via this file: https://github.com/kubeflow/website/blob/master/static/google65401334ad4c38b1.html

@thesuperzapper - moving this thread to:

• Search console config / ownership cleanup #3638