AG Data for PostHog
| 开发者 |
agstudioai
levskipg |
|---|---|
| 更新时间 | 2026年6月19日 03:07 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
AG Data for PostHog connects your WooCommerce store to PostHog — the open-source product analytics platform. Track the complete customer journey from first click to lifetime value, all within PostHog.
Why AG Data?
Most WooCommerce analytics plugins give you pageviews and basic events. AG Data gives you a full marketing attribution engine — first-touch/last-touch UTM tracking, ad click ID capture (Google, Meta, TikTok, Microsoft, LinkedIn), server-side first-party cookies that survive Safari ITP, and automatic LTV enrichment on every person profile.
Key Features
Server-Side Event Tracking
- Order Completed, Order Refunded, Order Status Changed
- Deduplication prevents double-counting
- Blocking API calls ensure delivery before marking as tracked
- Works with all payment gateways and checkout flows
- Product Viewed, Product List Viewed, Products Searched
- Product Added / Removed (classic and block-based carts)
- Cart Viewed, Checkout Started
- Product Clicked, Coupon Applied / Removed, Payment Info Entered
- Works without jQuery — block themes fully supported
- Captures UTM parameters and ad click IDs (gclid, fbclid, ttclid, msclkid, li_fat_id)
- Server-side first-party cookies bypass Safari ITP 24-hour restriction
- First-touch and last-touch attribution persisted to every order
- Days-to-conversion and session count tracking
- Falls back to WooCommerce 8.5+ native attribution when cookies are unavailable
- Attribution data included in all PostHog order events
- Reads PostHog JS SDK cookie server-side for seamless funnel connection
- Browser
posthog.identify()for logged-in users - Server-side
$identifywith$anon_distinct_idmerges anonymous and known profiles - PostHog funnels work end-to-end: Landing Page → Checkout Started → Order Completed
total_orders,lifetime_value,avg_order_value,last_order_dateupdated on every purchasefirst_order_date,acquisition_source,acquisition_medium,acquisition_campaignset once via$set_once- Build PostHog cohorts like "Customers with LTV > $500 acquired from Google Ads"
- Optional consent mode: starts PostHog opted-out with memory-only persistence
- Exposes
aphaOptIn()/aphaOptOut()JavaScript functions - Built-in support for CookieYes and Complianz consent management platforms
- HPOS (High-Performance Order Storage) compatible
- Cart and Checkout Blocks compatible
- Classic and block checkout flows supported
- Reverse proxy support for first-party tracking domains
- WordPress 5.8+
- WooCommerce 7.0+
- PHP 7.4+
- A PostHog account (free tier available at posthog.com)
安装:
- Upload the
ag-data-for-posthogfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- Go to WooCommerce > Settings > AG Data
- Enter your PostHog project API key (starts with
phc_) - Select your PostHog region (US or EU)
- Optionally configure a reverse proxy URL for first-party tracking
- Done! Events will start flowing to PostHog immediately.
常见问题:
Where do I find my PostHog API key?
Log in to PostHog, go to Project Settings, and copy the Project API Key. It starts with phc_.
Does AG Data work with PostHog Cloud and self-hosted?
Yes. Select US or EU for PostHog Cloud, or enter your self-hosted URL in the Custom Proxy URL field.
Will this slow down my site?
No. Server-side events use non-blocking HTTP calls. The frontend tracker is a lightweight script (~5KB) with no jQuery dependency. Attribution cookies are set server-side with minimal overhead.
Does AG Data work with Safari ITP?
Yes. Unlike JavaScript-set cookies (which Safari caps at 24 hours for URLs with tracking parameters), AG Data uses server-side setcookie() calls. These are treated as first-party cookies and persist for the full configured duration.
How does attribution work?
AG Data captures UTM parameters and ad click IDs (gclid, fbclid, ttclid, msclkid, li_fat_id) using server-side first-party cookies. First-touch and last-touch attribution data is persisted to every order and sent to PostHog, so you can analyze your full marketing funnel.
Does AG Data support WooCommerce Blocks checkout?
Yes. Both classic (shortcode) and block-based checkout flows are fully supported for identity persistence and event tracking.
更新日志:
1.5.3
- Fix: Adds app_source=wordpress to server-side Order Completed attribution
- Fix: Escapes PostHog JavaScript property names and $pageview in the inline bootstrap snippet
- New: Adds a stable funnel_session_id across WordPress pageview, checkout, and server-side order events
- New: Adds funnel_key, host, source_host, source_page, and URL properties for cleaner PostHog CRO reporting
- Fix: Captures $pageview manually after registering funnel properties so landing-page views can join to checkout/order events
- Renamed plugin to AG Data for PostHog
- Fix: Inline scripts now use wp_add_inline_script() for WordPress standards compliance
- Fix: Form identify race condition — added submit listener to catch email before Elementor/AJAX redirect
- Fix: Autofill safety net — input listener catches browser autofill without blur
- Fix: Reduced form identify debounce from 400ms to 100ms
- Fix: Order Completed now fires identify before capture — events use email as distinct_id
- Fix: Upsell orders use billing email instead of random UUID fallback
- New: Element visibility tracking — fire PostHog events when visitors see key page elements
- New: Add CSS class
apha-track-viewto any element (works with Elementor, Block Editor, raw HTML) - New: Custom event names via
data-apha-eventattribute - New: Custom visibility threshold via
data-apha-thresholdattribute (default 50%) - New: IntersectionObserver-based — no scroll listeners, great performance
- New: MutationObserver catches lazy-loaded/dynamic content
- New: "Element Visibility Tracking" toggle in WooCommerce > Settings > AG Data
- New: Consent-aware — re-initializes after opt-in when consent mode is active
- New: Form identification — identifies anonymous visitors in PostHog when they enter an email in any form (checkout, contact, signup)
- New: Supports WooCommerce classic checkout, block checkout, and generic forms (Elementor, CF7, WPForms, plain HTML)
- New: Auto-detects email and name fields on blur — captures even abandoned forms
- New: "Form Identification" toggle in WooCommerce > Settings > AG Data
- New: Respects person_profiles mode — uses setPersonProperties (always) or identify (identified_only)
- New: Consent-aware — re-initializes after opt-in when consent mode is active
- New: Marketing attribution engine with first-touch/last-touch UTM tracking
- New: Ad click ID capture (Google, Meta, TikTok, Microsoft, LinkedIn)
- New: Server-side first-party cookies (bypasses Safari ITP)
- New: LTV person enrichment (total_orders, lifetime_value, avg_order_value)
- New: Identity stitching — reads PostHog JS cookie server-side for seamless funnels
- New: Browser posthog.identify() for logged-in users
- New: Product Clicked, Coupon Applied/Removed, Payment Info Entered events
- New: Batch API endpoint support
- New: $set_once support for first_order_date, acquisition_source, created_at
- New: GDPR consent mode with CookieYes and Complianz integration
- New: WooCommerce 8.5+ native attribution fallback
- Fix: Race condition in Order Completed deduplication (TOCTOU)
- Fix: Replaced deprecated $create_alias with $identify + $anon_distinct_id
- Fix: Enabled capture_pageview for PostHog web analytics and session replay
- Fix: Standardized variant format (human-readable labels instead of IDs)
- Fix: jQuery dependency made optional for block themes
- Fix: False-positive product search detection
- Fix: Consolidated duplicate variation data loading (N+1 query)
- Improvement: Added payment_method, shipping_method, order_number, billing/shipping_country to Order Completed
- Improvement: Refund deduplication prevents duplicate Order Refunded events
- Improvement: Max products filter for data layer safety valve
- Initial release
- Server-side Order Completed, Order Refunded, Order Status Changed tracking
- Frontend Product Viewed, Product Added/Removed, Cart Viewed, Checkout Started
- Product List Viewed and Products Searched
- PostHog JS SDK integration with reverse proxy support
- WooCommerce HPOS and Blocks compatibility
- Identity management with cookie-based distinct IDs