Add Google Analytics 4 and Universal Analytics Ecommerce translation layer

[igneel64]

Additional plugin utility functions to be paired up with the GA4-UA-ee capability https://deploy-preview-14--snowplow-axl-ecom.netlify.app/accelerators/ecommerce/tracking/ua_ga4_migration/

[miike]

This looks good to me, adding @jethron to have a look through too.

[jethron]

Looks like handy wrappers, thanks @igneel64! I think the single object arg vs multiple args is the only big thing I'd change. Maybe currency after that.

[jethron]

I think this is a reasonably sane default, but it's unfortunate that it has different semantics to undefined currency in GA... I think currencyCode was a relatively late addition to the ecommerce definition so a few implementations will not have it there and just use their single property-level currency so this isn't gonna be very compatible.

Would be nice if you could pass in a defaultCurrencyCode or something when you install the plugin and have that be used instead, probably a broader scope than this PR though. Failing that, it's annoying but maybe this should be an optional param in all the callers of these util functions so it can at least be easily hardcoded in GTM without needing a dataLayer update (which may involve a different team for our users).

[jethron]

Do we want to follow the normal v3 idiom of just taking a single object parameter instead of multiple ones?
Currently we lose the ability to specify contexts etc that the wrapped trackAddToCart function & co has.
Maybe that's a good incentive to do a native implementation.

[igneel64]

Yeap, as advertised in the accelerator page, this is a 'quick' way to migrate your most important GA ecommerce events to snowplow using these wrappers. If you are at a level of custom contexts on ecommerce events, then I think it is a good place to start the native migration.

I think this would be the point where the user would like to add their custom dimensions in a context, sent together with the standard snowplow ecommerce attributes.

Kinda torn again, it would be really easy make the second argument an options object which would include the required attributes, where needed e.g. finalCartValue, and the addition of custom contexts and tracker selection (will probably do that).

[igneel64]

@jethron
Added a simple options argument which for now reference the currency where required and any other attribute which is required in some cases. I believe that for now it is good enough for the simple translation layer and the extra contexts etc. could be a ticket to the native implementation.

[bundlemon]

BundleMon

Files added (6)

Status	Path	Size	Limits
✅	libraries/browser-tracker-core/dist/index.mod ule.js	+24.52KB	25KB / +10%
✅	trackers/javascript-tracker/dist/sp.js	+23.84KB	25KB / +10%
✅	trackers/javascript-tracker/dist/sp.lite.js	+14.53KB	15KB / +10%
✅	trackers/browser-tracker/dist/index.umd.min.j s	+14.4KB	15KB / +10%
✅	libraries/tracker-core/dist/index.module.js	+13.35KB	15KB / +10%
✅	trackers/browser-tracker/dist/index.module.js	+3.46KB	5KB / +10%

Total files change +94.09KB 0%

Final result: ✅

View report in BundleMon website ➡️

---

Current branch size history

[jethron]

Almost there... 😛