investigate supporting GA4

[devoncarew]

From the google analytics docs:

all standard Universal Analytics properties will stop processing new hits on July 1, 2023

We don't yet know whether we'll support GA4 in this package or leave that to another package. If we do support it here, it's enough of a protocol change that we likely wouldn't try for backwards compatibility in the APIs; i.e. v4 of this package and v5 would have different APIs (one that matched the needs of the older measurement protocol and one that matched the needs of GA4).

This issue tracks discussing whether this package will be upgraded to support GA4 or not.

--

Notes:

• deprecation notice: https://support.google.com/analytics/answer/11583528?hl=en
• GA4 info: https://support.google.com/analytics/answer/10089681
• GA4 protocol: https://developers.google.com/analytics/devguides/collection/protocol/ga4 and https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag

[bartekpacia]

For future readers: looks like Google has shifted its focus to a https://github.com/dart-lang/tools/tree/main/pkgs/unified_analytics, which:

This package is intended to be used on Dart and Flutter related tooling only.

This is not intended to be general purpose or consumed by the community.

Does this mean that package:usage will die on July 1st, 2023?

[devoncarew]

Hi @bartekpacia - yes, we have switched over to using a new package, speaking the GA4 protocol, but that's very purpose built to support the dart and flutter command line tools.

Given that, it's highly unlikely that we'll update this package to GA4 (this package was originally written to support the stagehand tool, a pre-cursor to dart create). I'll start the deprecation process for this package.

I think it's worth keeping this issue open however - I think it could be useful for people to coordinate on any replacement solutions. It's worth noting that there's not necessarily a lot of complexity in speaking to google analytics. I haven't looked at GA4 myself, but suspect (like the previous protocol) that it's not much more than just sending some well-formed http posts to a url end-point. In a web app, you might want to use js interop to wrap the existing JS library (gtag.js?). In a command-line / flutter app, you'd probably want to support some throttling and batching when actually sending the events.

[bartekpacia]

Thanks for answering!

I think it could be useful for people to coordinate on any replacement solutions.

Good idea :)

It's worth noting that there's not necessarily a lot of complexity in speaking to google analytics.

That's right, it's not that complex and the package isn't really necessary. In case anyone's interested, here's how we implemented basic analytics with GA4 in our CLI tool.

[mr-mmmmore]

Hey @bartekpacia, I am considering to develop my own GA4 client as you did, but it seems that the measurement protocol v4 has the required parameter app_instance_id ("This value needs to be retrieved through the Firebase SDK.") that seems to impose to have FirebaseAnalytics in the app. This is ruining my plans as my intention is to not have to add Firebase to the app.
How did you handled it? You don't seem to enforce this id as required parameter in your own client, does it work without it?

[bartekpacia]

Hi @mr-mmmmore,

I don't use app_instance_id (actually this the first time I hear about it) and everything works.

[mr-mmmmore]

OK, thanks, I'm going to try it.