Migrate CNCF websites to GA4

[chalin]

Deprecation notice from Google (March 2022):

Universal Analytics will no longer process new data in standard properties beginning July 1, 2023. Prepare now by setting up and switching over to a Google Analytics 4 property. Learn more

We should migrate CNCF websites to GA4 as soon as possible so that by 2023Q3, when UA data collection stops, projects will already have 1+ year of historical data.

Resources

• Migrating to Google Analytics 4 details a suggested upgrade process.
  At a minimum we should implement stage 1 for all CNCF projects ASAP.
• Project migration status spreadsheet

Objectives

• OKR: https://github.com/cncf/workflow/issues/563
  • Note that some projects have multiple websites, which is why the number of sites to migrate increases over time as we report progress below.
• Complete the stage-1 migration of the top (velocity) 15 CNCF project websites by EOY 2022. Progress:
  • 33% (5/15) done as of 08/31
  • 60% (23/38) done as of 11/11
• Complete stage-2 & -3 migration for 30% or more of the top 15 CNCF project websites by EOY 2022. Progress:
  • 27% (4/15) done as of 08/31
  • 60% (23/38) done as of 11/11

---

Pilot projects (and a few more)

For the full migration-status details, see the status spreadsheet.

• kubernetes.io - Migrate to Google Analytics 4 (GA4) kubernetes/website#35299
• opentelemetry.io - Set up Google Analytics 4 open-telemetry/opentelemetry.io#1515
• Argo - Migrate to Google Analytics 4 (GA4) argoproj/argo-site#102
• backstage.io - [microsite] Setup Google Analytics 4 (GA4) backstage/backstage#12658
• Prometheus.io - Migrate to Google Analytics 4 (GA4) prometheus/docs#2181
• gRPC.io - Analytics: migrate to GA4 grpc/grpc.io#1001
• envoyproxy.io - Migrate to Google Analytics 4 (GA4) envoyproxy/envoy-website#273
• containerd.io - Migrate to Google Analytics 4 (GA4) containerd/containerd.io#131
• etcd.io - Set up Google Analytics 4 (GA4) etcd-io/website#595
• vitess.io - Migrate to Google Analytics 4 (GA4) vitessio/website#1098

Review:

• For all projects using Netlify snippet injection, ensure that the snippet is limited to production builds.

For a complete list of projects under migration, see the status spreadsheet.

/cc @nate-double-u @caniszczyk

[chalin]

@caniszczyk - might it make sense to consider a CLOMonitor check for this?

[chalin]

• Related: Suggested doc: add recommendation for analytics page #105

[chalin]

Hey all, the GA4 dashboard isn't very intuitive IMHO. For example, I haven't yet found a way to define a report (that can be saved) for 404 pages. Maybe we should have a short meeting to share our collective experiences along with any resources we have found useful up until now?

/cc @thisisobate

[thisisobate]

Yes! @chalin
That would be great!

[chalin]

All: FYI, here's a first try at this:

• Set up Google Analytics 4 open-telemetry/opentelemetry.io#1515

I'll be looking at streamlining the process and looking into using Hugo's support for GA.

[chalin]

All, I've moved the update process into its own "how to" page, Migrating to Google Analytics 4, since the page continues to evolve.

[chalin]

I'm wondering whether we should change the User and event data retention (for example, see the entry for OTel.io) from the default of 2 months to 14 months for all websites? (I've done it for OTel.) That config page has the following text:

You can change the retention period for data you send that is associated with cookies, user identifiers, or advertising identifiers. These controls don’t affect most standard reporting, which is based on aggregated data. Changes to these settings take effect after 24 hours. Learn more

It isn't clear what gets deleted.

[chalin]

Update:

• Kubernetes.io is done - Migrate to Google Analytics 4 (GA4) kubernetes/website#35299!
• Argo-CD done!
• The two Fluent projects (rank 11, not listed in the opening comment of this issue) have yet to be migrated to GA4, but I'll leave the project lead (@edsiper) handle it since we (CNCF) don't have access to the required resources.
• TiKV.org: progress to stage 2+ -- I'll handle that in 23Q1

[chalin]

All done! 😅 ✨