FAQ

I see no data in Google Analytics. Check the Status block on the General tab first: it must say Ready. Then:

• open the storefront in a private window, not logged in as an administrator, because administrators are not tracked by default;
• turn on Debug mode and watch GA4 → Admin → DebugView and the browser console ([GA4 ecommerce] … lines);
• with Consent Mode in Basic mode, nothing is sent until the visitor accepts Google Analytics 4 in the cookie dialog.

Page views and purchases are counted twice. Another tag is also sending them. Disable the core Google Analytics add-on, and remove GA snippets from your theme or other add-ons. To keep an existing tag, turn off Load the tag on the storefront.

Do I need Google Tag Manager? No. gtag.js mode needs only the measurement ID. Use GTM if you already manage other tags there. The add-on then only pushes to the dataLayer, and you decide in GTM what to send.

Why do the events say “denied” for my visitors outside Europe? Your GDPR add-on asks for explicit consent. In that mode the cookie dialog reports denied until the visitor accepts, in every country. Consent Mode Advanced still sends cookieless pings, which GA4 uses for modeling.

Will a purchase be reported if the customer uses an ad blocker? Yes, if the Measurement Protocol API secret is set and the fallback is on. The order is sent from the server after the configured delay, with the same transaction_id. It is not sent when the customer denied analytics consent.

What if the customer reloads the “thank you” page? Nothing happens. The purchase is printed only the first time the landing page is shown.

Payments through PayPal or another gateway that redirects the customer. The client ID is saved when the order is placed. If the customer comes back to the landing page, the browser reports the purchase. If they never come back, the server sends it once the payment status is final (not Incomplete).

How are refunds sent? Pick the statuses that mean “refunded” under Server-side events. When an order enters one of them, a full refund is sent once. Partial refunds are not sent automatically: CS-Cart has no partial refund document.

Which prices are sent? The unit price after catalog promotions, in the customer’s currency or in a fixed currency (setting). The catalog promotion amount is sent as discount. For purchases, value is the order total or the discounted subtotal (setting), with tax and shipping as separate parameters.

Does it work with product variations and options? Yes. item_variant contains the variation features (for example Color: White, Size: Large) and the selected options.

Multi-Vendor: why do I see several purchases for one checkout? Multi-Vendor splits a checkout into one order per vendor. Each vendor order is a separate transaction with the vendor name as affiliation, the same way refunds and vendor payouts work.

Does the add-on slow down the store? Events are computed from data CS-Cart already loaded. Item details (categories, brand, vendor) are loaded with a few batched queries per page. The fallback runs at most every 5 minutes and handles only a few orders per storefront request. Set up the cron job to keep it off the storefront.

Can I add my own events? Yes. Call kvGa4.send({event: 'name', params: {…}}) in the browser. It uses the same transport (gtag or dataLayer) and debug logging. See the Developer guide.

No data arrives in Google Analytics and the admin panel shows a license notice. Open Add-ons → Manage add-ons → Ecommerce Tracking Pro → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.

Does the add-on work on my staging copy? Yes. Subdomains of your licensed domain (for example staging.example.com) and local development hosts (localhost, private IP addresses, *.local, *.test) are covered by the same license.

What happens if your license server is down? Nothing visible: the add-on keeps the last verified result and keeps working for 14 days while it retries. The admin panel shows a notice from the first failed check.

Does the license check slow down my storefront? No. The check runs in the admin panel or from cron, once a day. The storefront only reads the stored result.

Is this add-on made by Google? No. Google Analytics and Google Tag Manager are trademarks of Google LLC. This add-on is made by Kavio Labs and is not endorsed by Google.

Still stuck?

Work through the troubleshooting guide, then contact support with your CS-Cart version, edition, PHP version and the add-on version (1.1.1).