{"id":289074,"date":"2026-06-18T08:57:49","date_gmt":"2026-06-18T08:57:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/advanced-posthog-analytics\/"},"modified":"2026-06-18T19:07:22","modified_gmt":"2026-06-18T19:07:22","slug":"ag-data-for-posthog","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/ag-data-for-posthog\/","author":17209228,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5.3","stable_tag":"1.5.3","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"AG Data for PostHog","header_author":"AGStudio.ai","header_description":"PostHog Analytics for WooCommerce \u2014 server-side event tracking, marketing attribution engine, identity stitching, and LTV enrichment.","assets_banners_color":"fbfbfc","last_updated":"2026-06-18 19:07:22","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/alexgodlewski\/ag-data-for-posthog","header_author_uri":"https:\/\/github.com\/alexgodlewski","rating":0,"author_block_rating":0,"active_installs":0,"downloads":39,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.5.3":{"tag":"1.5.3","author":"levskipg","date":"2026-06-18 19:07:22"}},"upgrade_notice":{"1.4.0":"

Plugin renamed to AG Data for PostHog. All functionality and settings are preserved \u2014 no reconfiguration needed.<\/p>","1.3.1":"

Fixes identity stitching \u2014 form identify now fires on submit (not just blur), Order Completed events use email as distinct_id, and upsell orders are properly attributed.<\/p>","1.3.0":"

New element visibility tracking lets you know who actually saw key content on your landing pages \u2014 not just who triggered a pageview. Add apha-track-view<\/code> class to any element.<\/p>","1.2.0":"

New form identification feature links anonymous visitors to PostHog profiles when they enter their email in any form. Works with all form builders and WooCommerce checkout flows.<\/p>","1.1.0":"

Major update: marketing attribution engine, identity stitching fix for PostHog funnels, LTV enrichment, and consent management. Recommended for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3577736,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3577736,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3577736,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3577736,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3577736,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.5.3"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[232,9067,282,214764,286],"plugin_category":[36,45],"plugin_contributors":[267687],"plugin_business_model":[],"class_list":["post-289074","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-attribution","plugin_tags-ecommerce","plugin_tags-posthog","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-levskipg","plugin_committers-levskipg"],"banners":{"banner":"https:\/\/ps.w.org\/ag-data-for-posthog\/assets\/banner-772x250.png?rev=3577736","banner_2x":"https:\/\/ps.w.org\/ag-data-for-posthog\/assets\/banner-1544x500.png?rev=3577736","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/ag-data-for-posthog\/assets\/icon.svg?rev=3577736","icon":"https:\/\/ps.w.org\/ag-data-for-posthog\/assets\/icon.svg?rev=3577736","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"\n

AG Data for PostHog connects your WooCommerce store to PostHog<\/a> \u2014 the open-source product analytics platform. Track the complete customer journey from first click to lifetime value, all within PostHog.<\/p>\n\n

Why AG Data?<\/h4>\n\n

Most WooCommerce analytics plugins give you pageviews and basic events. AG Data gives you a full marketing attribution engine<\/strong> \u2014 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.<\/p>\n\n

Key Features<\/h4>\n\n

Server-Side Event Tracking<\/strong><\/p>\n\n

    \n
  • Order Completed, Order Refunded, Order Status Changed<\/li>\n
  • Deduplication prevents double-counting<\/li>\n
  • Blocking API calls ensure delivery before marking as tracked<\/li>\n
  • Works with all payment gateways and checkout flows<\/li>\n<\/ul>\n\n

    Frontend Event Tracking<\/strong><\/p>\n\n

      \n
    • Product Viewed, Product List Viewed, Products Searched<\/li>\n
    • Product Added \/ Removed (classic and block-based carts)<\/li>\n
    • Cart Viewed, Checkout Started<\/li>\n
    • Product Clicked, Coupon Applied \/ Removed, Payment Info Entered<\/li>\n
    • Works without jQuery \u2014 block themes fully supported<\/li>\n<\/ul>\n\n

      Marketing Attribution Engine<\/strong><\/p>\n\n

        \n
      • Captures UTM parameters and ad click IDs (gclid, fbclid, ttclid, msclkid, li_fat_id)<\/li>\n
      • Server-side first-party cookies bypass Safari ITP 24-hour restriction<\/li>\n
      • First-touch and last-touch attribution persisted to every order<\/li>\n
      • Days-to-conversion and session count tracking<\/li>\n
      • Falls back to WooCommerce 8.5+ native attribution when cookies are unavailable<\/li>\n
      • Attribution data included in all PostHog order events<\/li>\n<\/ul>\n\n

        Identity Stitching<\/strong><\/p>\n\n

          \n
        • Reads PostHog JS SDK cookie server-side for seamless funnel connection<\/li>\n
        • Browser posthog.identify()<\/code> for logged-in users<\/li>\n
        • Server-side $identify<\/code> with $anon_distinct_id<\/code> merges anonymous and known profiles<\/li>\n
        • PostHog funnels work end-to-end: Landing Page \u2192 Checkout Started \u2192 Order Completed<\/li>\n<\/ul>\n\n

          LTV Person Enrichment<\/strong><\/p>\n\n

            \n
          • total_orders<\/code>, lifetime_value<\/code>, avg_order_value<\/code>, last_order_date<\/code> updated on every purchase<\/li>\n
          • first_order_date<\/code>, acquisition_source<\/code>, acquisition_medium<\/code>, acquisition_campaign<\/code> set once via $set_once<\/code><\/li>\n
          • Build PostHog cohorts like \"Customers with LTV > $500 acquired from Google Ads\"<\/li>\n<\/ul>\n\n

            GDPR \/ Consent Management<\/strong><\/p>\n\n

              \n
            • Optional consent mode: starts PostHog opted-out with memory-only persistence<\/li>\n
            • Exposes aphaOptIn()<\/code> \/ aphaOptOut()<\/code> JavaScript functions<\/li>\n
            • Built-in support for CookieYes and Complianz consent management platforms<\/li>\n<\/ul>\n\n

              WooCommerce Compatibility<\/strong><\/p>\n\n

                \n
              • HPOS (High-Performance Order Storage) compatible<\/li>\n
              • Cart and Checkout Blocks compatible<\/li>\n
              • Classic and block checkout flows supported<\/li>\n
              • Reverse proxy support for first-party tracking domains<\/li>\n<\/ul>\n\n

                Requirements<\/h4>\n\n
                  \n
                • WordPress 5.8+<\/li>\n
                • WooCommerce 7.0+<\/li>\n
                • PHP 7.4+<\/li>\n
                • A PostHog account (free tier available at posthog.com)<\/li>\n<\/ul>\n\n

                  External services<\/h3>\n\n

                  This plugin connects to PostHog, a third-party product analytics service, to send your store's analytics and e-commerce event data. This connection is required for the plugin to work \u2014 its entire purpose is to record analytics in PostHog. No data is sent until you enter a PostHog Project API key in the plugin settings.<\/p>\n\n

                  What PostHog is used for:<\/p>\n\n

                    \n
                  • Receiving server-side e-commerce events (Order Completed, Order Refunded, Order Status Changed).<\/li>\n
                  • Receiving frontend browsing events (Product Viewed, Cart Viewed, Checkout Started, and similar) via the PostHog JavaScript SDK, which is loaded on your site's pages from your configured PostHog host.<\/li>\n
                  • Storing person profiles enriched with order\/LTV data and marketing attribution data.<\/li>\n<\/ul>\n\n

                    What data is sent, and when:<\/p>\n\n

                      \n
                    • While a visitor browses your store, the PostHog JavaScript SDK captures pageviews and browsing events. This includes page URLs, referrer, UTM parameters, ad click IDs (gclid, fbclid, ttclid, msclkid, li_fat_id), and a PostHog-generated anonymous identifier.<\/li>\n
                    • When an order is placed, refunded, or changes status, the plugin sends order data from your server \u2014 order ID, totals, currency, line items, payment and shipping method, and billing\/shipping country. For logged-in users, a WordPress-based identifier and the customer email may also be sent so anonymous and known profiles can be merged.<\/li>\n
                    • Requests are sent to the PostHog host you configure in the settings (PostHog US Cloud, PostHog EU Cloud, or your own self-hosted\/proxy URL).<\/li>\n<\/ul>\n\n

                      Service provider: PostHog Inc.\nTerms of Service: https:\/\/posthog.com\/terms\nPrivacy Policy: https:\/\/posthog.com\/privacy<\/p>\n\n\n

                        \n
                      1. Upload the ag-data-for-posthog<\/code> folder to \/wp-content\/plugins\/<\/code><\/li>\n
                      2. Activate the plugin through the Plugins menu in WordPress<\/li>\n
                      3. Go to WooCommerce > Settings > AG Data<\/li>\n
                      4. Enter your PostHog project API key (starts with phc_<\/code>)<\/li>\n
                      5. Select your PostHog region (US or EU)<\/li>\n
                      6. Optionally configure a reverse proxy URL for first-party tracking<\/li>\n
                      7. Done! Events will start flowing to PostHog immediately.<\/li>\n<\/ol>\n\n\n
                        \n

                        Where do I find my PostHog API key?<\/h3><\/dt>\n

                        Log in to PostHog, go to Project Settings, and copy the Project API Key. It starts with phc_<\/code>.<\/p><\/dd>\n

                        Does AG Data work with PostHog Cloud and self-hosted?<\/h3><\/dt>\n

                        Yes. Select US or EU for PostHog Cloud, or enter your self-hosted URL in the Custom Proxy URL field.<\/p><\/dd>\n

                        Will this slow down my site?<\/h3><\/dt>\n

                        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.<\/p><\/dd>\n

                        Does AG Data work with Safari ITP?<\/h3><\/dt>\n

                        Yes. Unlike JavaScript-set cookies (which Safari caps at 24 hours for URLs with tracking parameters), AG Data uses server-side setcookie()<\/code> calls. These are treated as first-party cookies and persist for the full configured duration.<\/p><\/dd>\n

                        How does attribution work?<\/h3><\/dt>\n

                        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.<\/p><\/dd>\n

                        Does AG Data support WooCommerce Blocks checkout?<\/h3><\/dt>\n

                        Yes. Both classic (shortcode) and block-based checkout flows are fully supported for identity persistence and event tracking.<\/p><\/dd>\n\n<\/dl>\n\n\n

                        1.5.3<\/h4>\n\n
                          \n
                        • Fix: Adds app_source=wordpress to server-side Order Completed attribution<\/li>\n<\/ul>\n\n

                          1.5.2<\/h4>\n\n
                            \n
                          • Fix: Escapes PostHog JavaScript property names and $pageview in the inline bootstrap snippet<\/li>\n<\/ul>\n\n

                            1.5.1<\/h4>\n\n
                              \n
                            • New: Adds a stable funnel_session_id across WordPress pageview, checkout, and server-side order events<\/li>\n
                            • New: Adds funnel_key, host, source_host, source_page, and URL properties for cleaner PostHog CRO reporting<\/li>\n
                            • Fix: Captures $pageview manually after registering funnel properties so landing-page views can join to checkout\/order events<\/li>\n<\/ul>\n\n

                              1.4.0<\/h4>\n\n
                                \n
                              • Renamed plugin to AG Data for PostHog<\/li>\n
                              • Fix: Inline scripts now use wp_add_inline_script() for WordPress standards compliance<\/li>\n<\/ul>\n\n

                                1.3.1<\/h4>\n\n
                                  \n
                                • Fix: Form identify race condition \u2014 added submit listener to catch email before Elementor\/AJAX redirect<\/li>\n
                                • Fix: Autofill safety net \u2014 input listener catches browser autofill without blur<\/li>\n
                                • Fix: Reduced form identify debounce from 400ms to 100ms<\/li>\n
                                • Fix: Order Completed now fires identify before capture \u2014 events use email as distinct_id<\/li>\n
                                • Fix: Upsell orders use billing email instead of random UUID fallback<\/li>\n<\/ul>\n\n

                                  1.3.0<\/h4>\n\n
                                    \n
                                  • New: Element visibility tracking \u2014 fire PostHog events when visitors see key page elements<\/li>\n
                                  • New: Add CSS class apha-track-view<\/code> to any element (works with Elementor, Block Editor, raw HTML)<\/li>\n
                                  • New: Custom event names via data-apha-event<\/code> attribute<\/li>\n
                                  • New: Custom visibility threshold via data-apha-threshold<\/code> attribute (default 50%)<\/li>\n
                                  • New: IntersectionObserver-based \u2014 no scroll listeners, great performance<\/li>\n
                                  • New: MutationObserver catches lazy-loaded\/dynamic content<\/li>\n
                                  • New: \"Element Visibility Tracking\" toggle in WooCommerce > Settings > AG Data<\/li>\n
                                  • New: Consent-aware \u2014 re-initializes after opt-in when consent mode is active<\/li>\n<\/ul>\n\n

                                    1.2.0<\/h4>\n\n
                                      \n
                                    • New: Form identification \u2014 identifies anonymous visitors in PostHog when they enter an email in any form (checkout, contact, signup)<\/li>\n
                                    • New: Supports WooCommerce classic checkout, block checkout, and generic forms (Elementor, CF7, WPForms, plain HTML)<\/li>\n
                                    • New: Auto-detects email and name fields on blur \u2014 captures even abandoned forms<\/li>\n
                                    • New: \"Form Identification\" toggle in WooCommerce > Settings > AG Data<\/li>\n
                                    • New: Respects person_profiles mode \u2014 uses setPersonProperties (always) or identify (identified_only)<\/li>\n
                                    • New: Consent-aware \u2014 re-initializes after opt-in when consent mode is active<\/li>\n<\/ul>\n\n

                                      1.1.0<\/h4>\n\n
                                        \n
                                      • New: Marketing attribution engine with first-touch\/last-touch UTM tracking<\/li>\n
                                      • New: Ad click ID capture (Google, Meta, TikTok, Microsoft, LinkedIn)<\/li>\n
                                      • New: Server-side first-party cookies (bypasses Safari ITP)<\/li>\n
                                      • New: LTV person enrichment (total_orders, lifetime_value, avg_order_value)<\/li>\n
                                      • New: Identity stitching \u2014 reads PostHog JS cookie server-side for seamless funnels<\/li>\n
                                      • New: Browser posthog.identify() for logged-in users<\/li>\n
                                      • New: Product Clicked, Coupon Applied\/Removed, Payment Info Entered events<\/li>\n
                                      • New: Batch API endpoint support<\/li>\n
                                      • New: $set_once support for first_order_date, acquisition_source, created_at<\/li>\n
                                      • New: GDPR consent mode with CookieYes and Complianz integration<\/li>\n
                                      • New: WooCommerce 8.5+ native attribution fallback<\/li>\n
                                      • Fix: Race condition in Order Completed deduplication (TOCTOU)<\/li>\n
                                      • Fix: Replaced deprecated $create_alias with $identify + $anon_distinct_id<\/li>\n
                                      • Fix: Enabled capture_pageview for PostHog web analytics and session replay<\/li>\n
                                      • Fix: Standardized variant format (human-readable labels instead of IDs)<\/li>\n
                                      • Fix: jQuery dependency made optional for block themes<\/li>\n
                                      • Fix: False-positive product search detection<\/li>\n
                                      • Fix: Consolidated duplicate variation data loading (N+1 query)<\/li>\n
                                      • Improvement: Added payment_method, shipping_method, order_number, billing\/shipping_country to Order Completed<\/li>\n
                                      • Improvement: Refund deduplication prevents duplicate Order Refunded events<\/li>\n
                                      • Improvement: Max products filter for data layer safety valve<\/li>\n<\/ul>\n\n

                                        1.0.0<\/h4>\n\n
                                          \n
                                        • Initial release<\/li>\n
                                        • Server-side Order Completed, Order Refunded, Order Status Changed tracking<\/li>\n
                                        • Frontend Product Viewed, Product Added\/Removed, Cart Viewed, Checkout Started<\/li>\n
                                        • Product List Viewed and Products Searched<\/li>\n
                                        • PostHog JS SDK integration with reverse proxy support<\/li>\n
                                        • WooCommerce HPOS and Blocks compatibility<\/li>\n
                                        • Identity management with cookie-based distinct IDs<\/li>\n<\/ul>","raw_excerpt":"PostHog Analytics for WooCommerce. Server-side event tracking, marketing attribution engine, identity stitching, and LTV enrichment.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/289074","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=289074"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/levskipg"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=289074"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=289074"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=289074"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=289074"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=289074"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=289074"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}