elgentos/serversideanalytics2

There is no license information available for the latest version (1.2.11) of this package.

Elgentos_ServerSideAnalytics for magento 2

1.2.11 2024-03-27 12:54 UTC

Requires

• php: >=8.1.0
• 8ctopus/php-ga-measurement-protocol: ^2.0
• br33f/php-ga4-mp: ^0.1.0

Unknown License

• peterjaap

README

This extension aims to solve the problem of discrepancies between Magento revenue reports and the revenue reports in Google Analytics.

That problem arises due to the fact that a certain number of people close the browser window before returning to Magento's success page. Since Google Analytics is Javascript based, and thus client based, the GA Purchase Event will not be fired and the order will not be registered in Analytics.

Another reason why this problem arises is that people decide to pay at a later point in time through a different platform (like the PSP's), using a link in an email for example.

Installations

composer require elgentos/serversideanalytics2
bin/magento setup:upgrade

Sample query for GraphQL to set the GA data

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

Caveats

• This extension disables the JS Purchase Event on the success page altogether. It will however track the pageview.
• This extension only tracks paid orders (it fires on sales_order_payment_pay). Non-paid orders will never show up in Analytics. This is our current clients' use case, mileage may differ. PR's for code to also track non-paid orders are welcomed.

Further info

• Compatible with UA Measurement Protocol and GA4 Measurement Protocol;
• Debugging is enabled when Magento is in developer mode. See var/log/system.log for the log;
• Exceptions will be logged to var/log/exceptions.log;
• The products in the payload are retrieve on invoice-basis, not on order-basis;
• An event has been added for you to add or overwrite custom fields to products in the purchase event; elgentos_serversideanalytics_product_item_transport_object;
• An event has been added for you to add or overwrite custom fields to transaction data in the purchase event; elgentos_serversideanalytics_transaction_data_transport_object;
• An event has been added for you to add or overwrite fields to tracking data in the purchase event; elgentos_serversideanalytics_tracking_data_transport_object;
• Testing can be done by dispatching test_event_for_serversideanalytics with a $payment (\Magento\Sales\Order\Payment) object in the payload;
• magerun2 dev:events:fire --eventName sales_order_payment_pay --parameters "payment::\Magento\Sales\Model\Order\Payment:X;invoice::\Magento\Sales\Model\Order\Invoice:X";