Datalayer Tracking via DATA Reshape for WooCommerce

変更履歴

1.0.0

• New: Server-side order webhook (API Events tab). Sends a checkout_completed event server-to-server to DATA Reshape when an order reaches a configurable status (default Processing). It covers what the browser can’t — off-site payment gateways that confirm minutes or hours later (or where the shopper never returns to the thank-you page) and phone/admin orders that never had a browser session. Uses the order number as the event ID so DATA Reshape deduplicates it against the browser purchase event; if one signal is missing the other fills in, with no double counting.
• New: order_canceled event sent on Cancelled / Refunded orders.
• New: The webhook reuses your existing Tracking subdomain and Library ID; the only new credential is an Access token (the former “API key” field, relabeled). An admin error notice appears if the webhook is enabled without an Access token.
• New: Relays DATA Reshape’s first-party drespa cookie, captured on the order at checkout so it survives gateway callbacks and admin actions.
• New: The webhook sends the customer’s IP (from the WooCommerce order, which resolves the real visitor IP behind proxies/CDNs such as Cloudflare) so events aren’t attributed to the store server.
• New: Test mode routes webhooks to DATA Reshape’s /test validation endpoint (nothing delivered to destinations) and surfaces the returned errors and warnings as an admin notice.
• New: Optional “Log webhook activity” toggle records each request and response in the WooCommerce logs (source drswc-webhook) and reveals a Logs tab in the settings for setup debugging.
• New: drswc_webhook_payload filter to customize the outgoing webhook envelope.
• New: Staging/local safety guard. If the site address no longer matches where DATA Reshape was set up (e.g. a database copied to a staging or local site), tracking is paused automatically and an admin bar offers to resume live tracking, keep it in test mode (events sent as “dev”, not delivered), or dismiss — so a copy can’t pollute your production data.
• New: A one-time welcome notice after activation prompts you to review every settings tab and configure it as needed.
• New: A “Realtime Analytics” tab that opens the DATA Reshape realtime dashboard in a new browser tab.
• Change: stock_status is now emitted as a string (“in stock” / “out of stock”) instead of a boolean, matching DATA Reshape’s stored format and avoiding a coercion warning.
• Internal: the admin CSS and the static frontend JS were moved out of PHP into real assets/css and assets/js files, enqueued with the plugin version for cache-busting. No functional change.
• Internal: the plugin was reorganized from one large file into a thin bootstrap plus focused trait files under includes/. It remains a single class/singleton; no functional change.
• Compatibility: tested up to WordPress 7.0 and WooCommerce 11.0.

0.9.1

• Fix: Add-to-cart now tracks reliably on stores where another plugin or theme intercepts the product-page button click before the standard handlers can run (volume-discount widgets, bundle plugins, one-click upsells, and similar).
• Fix: Add-to-cart no longer silently drops when /wp-admin/admin-ajax.php is unreachable (security-plugin allow-lists, expired nonces, ad-blocker rules, network drops). The product-page event payload now ships pre-built with the page, so the push happens synchronously.

0.9

• Fix: Add-to-cart now tracks reliably on themes that hijack the single-product form with their own AJAX (Woodmart, custom builders, etc.). A new product-page click handler on the standard .single_add_to_cart_button fires the event before the theme’s submit logic runs, regardless of which AJAX library or endpoint the theme uses. Built-in 3-second JS dedup prevents double-fire when both this path and the legacy AJAX-listener path would trigger.
• Fix: Listing add-to-cart with WooCommerce’s “Redirect to cart page after successful addition” option enabled — the ?add-to-cart= link redirected to the cart page before any client-side hook could fire, so the event was lost. A new server-side woocommerce_add_to_cart action hook now stashes the pending event in session so it emits on the cart page after the redirect.
• Fix: Variable products on classic (non-AJAX) single-product pages now emit the chosen variation as products[0].id instead of the parent product id. The POST capture path was previously ignoring variation_id.
• Internal: the new server-side hook is intentionally gated on non-AJAX, non-REST, non-admin contexts so AJAX flows (already covered client-side) don’t double-fire.

0.8

• Consent integration overhauled. The legacy “Google Consent Mode granted by default” toggle (emitted a gtag('consent', 'update', ...) block) and the per-event envelope consent_default_grant toggle have both been removed. A single new “Grant consent by default” toggle now fires DATA Reshape’s native consent_updated push at session start — DATA Reshape detects most CMPs and Google Consent Mode v2 on its own, so this toggle defaults to OFF.
• Tax fields (tax_included, tax_percent) are now omitted entirely from product, coupon, and shipping payloads when WooCommerce tax is disabled (previously emitted as tax_included: false).
• Settings tabs renamed for clarity: “Browser events” → “Events”, “Server-side events” → “API Events”. The API Events tab is reserved for admin-recorded events (e.g. phone-call orders) and historical customer/order backfill — not a CAPI-style server-side mirror of browser events.
• Settings also reachable under Marketing → DATA Reshape (shortcut to the canonical WooCommerce → Settings → DATA Reshape page).
• Field labels simplified: “Server-side API endpoint” / “Server-side API key” → “API endpoint” / “API key”.
• Internal: narrative inline comments moved to CLAUDE.md; no functional impact.

0.7

• Hard cutover from window.dataLayer to DATA Reshape’s window.reshape API. Event names updated to the new spec (product_viewed, product_added_to_cart, cart_viewed, checkout_started, checkout_completed, etc.).
• Mid-funnel checkout events on legacy checkout: billing_address_added, shipping_detail_added, payment_method_selected.
• “Grant consent by default” and “Track checkout steps” toggles added.
• Identity emission tightened — user object sent only when logged in or in checkout with confirmed contact data.
• Variations carry parent_* fields; products emit categories[], stock status, type, created_at, image, gallery.
• Pricing decoupled from coupons — price / price_base are the buyer-visible regular / sale prices; coupons land in dedicated coupons[] arrays.
• New filters: drswc_event_payload, drswc_product_payload, drswc_user_payload, drswc_consent_payload.

0.6

• PII cache leak fix extended to cart/checkout pages (in addition to thankyou).
• HPOS and Cart/Checkout Blocks compatibility declared.

0.5

• Fixed PII leak on page-cached thankyou pages (LiteSpeed et al.) — identity now hydrated client-side from cookies.
• Removed browser-side SHA256 hashing — DATA Reshape hashes server-side.
• On-save tracking endpoint health check plus on-demand re-check button.
• wp.org update-available pill in the settings header.
• Loader URL tags the installed plugin version (&wp=).

0.4

• Fresh-install checkbox defaults flipped to off.
• Admin warning notice when the plugin is active but not configured.

0.3

• AJAX add-to-cart detection works with third-party plugins (QuadLayers etc.) and themes whose buttons don’t expose data-product_id.
• Removed the in-page dataLayer debug overlay.

0.1

• Initial release.