GA4 introduces a new parameter called value in several of its event types. Given that value is used for conversion events, and given "value" means different things to companies (does it include discount, shipping, tax?), we should ask the customer to provide this as a custom flag GA4.Value . We thought about providing a default value calculation, but we’d have to explain that in docs, and we as an API should be agnostic in terms of what value is.
Refund and Purchase events continue to use "Total Amount" as the value in line with UA. If the user passes in "GA4.Value", this will override the "Total Amount" and be used for the value.
Summary
GA4 introduces a new parameter called
value
in several of its event types. Given thatvalue
is used for conversion events, and given "value" means different things to companies (does it include discount, shipping, tax?), we should ask the customer to provide this as a custom flagGA4.Value
. We thought about providing a default value calculation, but we’d have to explain that in docs, and we as an API should be agnostic in terms of what value is.Refund
andPurchase
events continue to use "Total Amount" as thevalue
in line with UA. If the user passes in "GA4.Value", this will override the "Total Amount" and be used for thevalue
.