GIA — GA4 Ecommerce Tracking for WooCommerce

سجل التغييرات

0.6

• Fix: add_to_cart no longer double-fires on AJAX archive adds when detection is set to both — hook path skips AJAX when the JavaScript handler is active
• Fix: view_item_list no longer re-counts products on Product Collection load-more — impressed nodes are deduplicated client-side
• Fix: Dashboard traffic, product grid, and customer insights date windows use bound_for_backend() so legacy and HPOS order stores agree on timezone
• Fix: Catalog sale discount on view_item / view_item_list uses the same tax mode as resolved price
• Fix: Server-side Measurement Protocol purchase, refund, and renewal events no longer blocked by frontend-only gates (pause, role exclusion, or admin context)
• Improvement: Cache-safe purchase tracking — thank-you page loads purchase via Ajax so page cache cannot reuse stale event data
• Improvement: Browser purchase timing setting — match server trigger (default) to avoid counting pending or failed orders in GA4
• Improvement: Add to cart detection setting — choose WooCommerce hooks, JavaScript, or both for theme compatibility
• Improvement: Order edit screen meta box shows browser/MP tracking status, consent, UTMs, landing page, and GA4 IDs
• Improvement: select_item list attribution on WooCommerce Product Collection blocks
• Improvement: _giawc_frontend_tracked is set after the browser fires purchase, not when PHP renders the page
• Improvement: Server-side Measurement Protocol purchase validates order status before send
• Improvement: Admin notice recommends excluding the order-received page from full-page cache
• Improvement: Unified tax mode — exclude tax from event values now applies to cart, checkout, variation view_item, and line-item prices (not just purchase)
• Improvement: URL pattern exclusions — disable gtag and ecommerce scripts on matching paths (glob or regex)
• Improvement: Custom thank-you page ID for non-standard order confirmation pages
• Improvement: Role-based tracking exclusion beyond administrators (comma-separated role slugs)
• Improvement: Per-page “Disable GA4 tracking” meta box on public post types
• Improvement: FSE template-part block detection — block tracking loads when cart/checkout/mini-cart live only in block templates
• Improvement: Product Collection re-fires view_item_list when filters or pagination update the grid
• Improvement: All Products and cart cross-sells block list attribution
• Improvement: Tax-correct variation prices on view_item re-fire via giawc_price
• Improvement: Optional add_to_wishlist when YITH WooCommerce Wishlist is active
• Improvement: Blocks checkout handlers wrapped in fault isolation so tracking errors cannot break checkout
• Improvement: Consent script gating — Consent Mode event deferral or strong block until analytics consent
• Improvement: Custom region consent rules (e.g. US-CA:denied, DK:denied) with priority over geo defaults
• Improvement: CMP auto-detect on activation — Cookiebot/CookieYes script attributes pre-enabled
• Improvement: CookieYes data-cookieyes script attribute toggle
• Improvement: window.giawcConsent API and giawc_event_should_defer / giawc_should_track_event filters
• Improvement: gtag defer-until-idle load strategy for PageSpeed
• Improvement: Purchase debug logging when browser purchase is skipped
• Improvement: Settings import from GTM4WP, Google Analytics for WooCommerce, or GTM Kit when no Measurement ID is set
• Improvement: Admin setup checklist and import success notice
• Improvement: get_product_data() per-request memoization reduces duplicate term, meta, and tax work on archive pages
• Improvement: Tracking reconciliation uses SQL aggregates instead of hydrating every order object
• Improvement: Product performance grid loads SKU from SQL instead of wc_get_product() per sold product
• Improvement: Giawc_Tracking_Gate::should_track() memoizes per user and queried object within a request
• Improvement: Page builder preview exclusion — skip tracking on Divi, Beaver Builder, Elementor, Bricks, and other builder edit/preview requests
• Improvement: Pause browser tracking toggle — disable all frontend gtag and ecommerce events while server-side purchase backup, settings, and dashboard keep working
• Improvement: Additional measurement IDs — send the same gtag config to extra comma-separated GA4 properties (agency, staging, or duplicate streams)
• Improvement: Split analytics capabilities — separate view vs. configure access via giawc_allow_view_analytics, giawc_allow_configure_tracking, and capability filters
• Improvement: Admin assets load only on GIA admin screens (giawc-*) for better performance
• Improvement: gtag.js loads with async by default (unless defer-until-idle strategy is selected)
• Improvement: LiteSpeed Cache bypass on admin AJAX and REST responses used by the dashboard

0.5

• Fix: Blocks add_shipping_info and add_payment_info used non-existent store APIs (corrected against WooCommerce core)
• Fix: Mini-cart remove links now tracked via data-ga4-item attribute
• Fix: Product JSON in HTML attributes uses WooCommerce wc_esc_json() for safe encoding
• Fix: Dequeue WooCommerce Blocks built-in Google Analytics script to prevent duplicate gtag configuration and double-fired events on block cart/checkout
• Fix: Validate order key on thank-you page before firing browser purchase events
• Fix: Tabbed settings panels render fields correctly (WooCommerce table wrapper compatibility)
• Refocus: GA4 ecommerce event tracking (removed profit/COGS, journey analytics, Meta CAPI, ad spend)
• Renamed from Trackify to GIA GA4
• Streamlined dashboard: Overview weekly insights, Traffic, Products, Customers, Settings
• Removed profit columns from product reports and weekly insights
• Improvement: Measurement Protocol sends session_id, event_id, and engagement_time_msec on purchase/refund
• Improvement: item_list_id / item_list_name persist from select_item through cart and purchase events
• Improvement: Full items[] payloads on add-to-cart and remove-from-cart (classic + Blocks)
• Improvement: Sale discount on GA4 line items when products are on sale
• Improvement: view_promotion for on-sale products and store notices
• Improvement: Blocks checkout uses official WooCommerce cart/payment stores and checkout failure events
• Improvement: payment_failure documented as always-on (not behind Extra GA4 events)
• Improvement: Blocks cart/checkout prices use Store API line totals and cart totals (WooCommerce minor-unit format)
• Improvement: Accept Google Tag measurement IDs (GT-) in addition to G- IDs
• Improvement: Blocks mini-cart tracking on all WooCommerce Blocks stores with deduplicated remove-from-cart events
• Improvement: Per-event enable/disable toggles for core GA4 ecommerce events
• Improvement: Cross-domain linker settings (domains + incoming parameters)
• Improvement: Product Bundles use minimum bundle price in GA4 item data
• Improvement: Admin warning when Google Analytics for WooCommerce or Site Kit snippet may duplicate GIA GA4 tracking
• Improvement: Settings page reorganized into Connection, Privacy, Events, and Advanced tabs
• Richer GA4 item data, improved server-side deduplication, and Blocks checkout tracking fixes. Recommended for all stores.

0.4

• Improvement: Tabbed analytics dashboard (overview, products, customers)
• Improvement: First-touch UTM attribution saved to order meta
• Improvement: HPOS-compatible traffic source queries
• Improvement: Server-side purchase deduplication and new vs returning customer on purchase
• Improvement: Coupon, shipping, payment, and payment failure checkout events
• Improvement: Product image, GTIN, hierarchical categories, and brand in item data
• Improvement: WordPress script enqueue compliance (wp_add_inline_script)
• Improvement: Namespace prefix giawc_ throughout

0.3

• Improvement: WordPress.org compliance updates (prefixes, PHPCS, enqueue standards)
• Improvement: Database query optimization and HPOS compatibility
• Removed: Meta and TikTok tracking

0.2

• Fix: PHP fatal error in settings API compatibility
• Improvement: Code standards compliance

0.1

• Initial release