@affiliateo/web 2.2.0 → 2.3.1

package/README.md

@@ -171,8 +171,12 @@ attributes become metadata (kebab-case → snake_case, up to 10 params).
 </section>
 ```
 
-Fires once when the section becomes 50%+ visible. Great for landing pages
-where you want to know which sections convert.
+Fires the first time any pixel of the section overlaps the viewport.
+Maximum permissiveness — if the user scrolled enough to see even a sliver,
+it counts. Earlier versions required 50% visibility, which was unreachable
+for tall sections (a pricing page with comparison tables silently dropped
+out of every funnel). Great for landing pages where you want to know
+which sections convert.
 
 ### Goal naming rules
 

package/dist/provider.js

@@ -331,6 +331,17 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
         // the viewport. Use IntersectionObserver (cheap, off the scroll hot
         // path) and unobserve after the first fire so the same element can't
         // double-count if the user scrolls back up.
+        //
+        // No options object → IntersectionObserver defaults to
+        // { threshold: 0, rootMargin: '0px 0px 0px 0px' }, which fires the
+        // instant ANY pixel of the section overlaps the viewport. That's
+        // exactly the semantic merchants want for "did the visitor reach
+        // this section": if they scrolled enough to see even a sliver of
+        // it, count it. Earlier versions used { threshold: 0.5 }, which
+        // was unreachable for tall sections (a 1600px pricing section in
+        // an 800px viewport tops out at ~50% intersection ratio and never
+        // crossed the threshold) — funnel steps tied to those sections
+        // silently dropped from every merchant's conversion count.
         const scrollFired = new WeakSet();
         let scrollObserver = null;
         let scrollMo = null;
@@ -347,7 +358,7 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
                         track(goal);
                     scrollObserver?.unobserve(entry.target);
                 }
-            }, { threshold: 0.5 });
+            });
             // Observe everything that exists at mount time.
             document.querySelectorAll('[data-affiliateo-scroll]').forEach((el) => {
                 scrollObserver?.observe(el);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@affiliateo/web",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Affiliateo web SDK — affiliate attribution and tracking for web apps",
   "main": "dist/index.js",
   "module": "dist/index.js",