@streamscloud/streams-analytics-collector 2.0.8 → 2.0.9

package/dist/analytics/app-events-tracker.d.ts

@@ -113,6 +113,22 @@ export declare class AppEventsTracker {
      * @param streamId - The ID of the stream
      */
     static trackStreamProductClicked(productId: string, streamId: string): void;
+    /**
+     * Track when a product in a stream is shown to the user (basic, immediate call)
+     * @param productId - The ID of the product
+     * @param streamId - The ID of the stream
+     */
+    static trackStreamProductImpression(productId: string, streamId: string): void;
+    /**
+     * Track when a product in a stream is shown to the user, using viewport visibility tracking.
+     * The impression event will only be fired if the element becomes visible (at least 50% in viewport).
+     * The event is only fired once per productId per session/visit.
+     *
+     * @param el - The DOM element to observe (e.g., the product element)
+     * @param productId - The unique product ID for this element
+     * @param streamId - The ID of the stream
+     */
+    static trackStreamProductImpressionWithVisibility(el: HTMLElement, productId: string, streamId: string): void;
     /**
      * Track when a post is closed
      * @param postId - The ID of the post

package/dist/analytics/app-events-tracker.js

@@ -184,6 +184,31 @@ class AppEventsTracker {
     static trackStreamProductClicked(productId, streamId) {
         this.reportAppEvent(productId, AppEventType.StreamProductClick, streamId);
     }
+    /**
+     * Track when a product in a stream is shown to the user (basic, immediate call)
+     * @param productId - The ID of the product
+     * @param streamId - The ID of the stream
+     */
+    static trackStreamProductImpression(productId, streamId) {
+        this.reportAppEvent(productId, AppEventType.StreamProductImpression, streamId);
+    }
+    /**
+     * Track when a product in a stream is shown to the user, using viewport visibility tracking.
+     * The impression event will only be fired if the element becomes visible (at least 50% in viewport).
+     * The event is only fired once per productId per session/visit.
+     *
+     * @param el - The DOM element to observe (e.g., the product element)
+     * @param productId - The unique product ID for this element
+     * @param streamId - The ID of the stream
+     */
+    static trackStreamProductImpressionWithVisibility(el, productId, streamId) {
+        if (!el || !productId || !streamId)
+            return;
+        ViewportVisibilityTracker.registerTile(el, productId, (pid) => {
+            this.reportAppEvent(pid, AppEventType.StreamProductImpression, streamId);
+        });
+        // The ViewportVisibilityTracker will call the callback when visible
+    }
     /**
      * Track when a post is closed
      * @param postId - The ID of the post

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/streams-analytics-collector",
-  "version": "2.0.8",
+  "version": "2.0.9",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",