README

本扩展旨在解决 Magento 收入报告与 Google Analytics 中收入报告不一致的问题。

这个问题出现的原因是因为有一些人在返回到 Magento 成功页面之前关闭了浏览器窗口。由于 Google Analytics 是基于 JavaScript 的，因此是客户端基于的，所以 GA 购买事件不会被触发，订单也不会在分析中注册。

这个问题的另一个原因是人们决定在以后的时间通过不同的平台（如 PSP）支付，例如使用电子邮件中的链接。

安装

composer require elgentos/serversideanalytics2
bin/magento setup:upgrade

设置 GA 数据的 GraphQL 查询示例

mutation AddGaUserId($cartId: String!, $gaUserId: String, $gaSessionId: String) {
                            AddGaUserId(input: {
                                    cartId: $cartId
                                    gaUserId: $gaUserId
                                    gaSessionId: $gaSessionId
                                }
                            ),
                            {
                               cartId
                               maskedId
                            }
                    }

注意事项

• 此扩展完全禁用了成功页面上的 JS 购买事件。但是，它会跟踪页面浏览。
• 此扩展仅跟踪 付费 订单（它在 sales_order_payment_pay 上触发）。未付款订单永远不会显示在分析中。这是我们当前客户的用例，效果可能会有所不同。欢迎提交用于跟踪未付款订单的代码的 PR。

更多信息

• 与 UA 测量协议和 GA4 测量协议兼容；
• 当 Magento 处于开发者模式时启用调试。查看 var/log/system.log 中的日志；
• 异常将被记录到 var/log/exceptions.log；
• 在有效发票的基础上检索有效载荷中的产品，而不是基于订单；
• 已添加一个事件，允许您在购买事件中添加或覆盖产品自定义字段；elgentos_serversideanalytics_product_item_transport_object；
• 已添加一个事件，允许您在购买事件中添加或覆盖交易数据自定义字段；elgentos_serversideanalytics_transaction_data_transport_object；
• 已添加一个事件，允许您在购买事件中添加或覆盖跟踪数据字段；elgentos_serversideanalytics_tracking_data_transport_object；
• 可以通过在有效载荷中带有 $payment（\Magento\Sales\Order\Payment）对象的 test_event_for_serversideanalytics 上触发来进行测试；
• magerun2 dev:events:fire --eventName sales_order_payment_pay --parameters "payment::\Magento\Sales\Model\Order\Payment:X;invoice::\Magento\Sales\Model\Order\Invoice:X";