@datalyr/web 1.2.2 → 1.3.0

package/dist/datalyr.esm.js

@@ -1,5 +1,5 @@
 /**
- * @datalyr/web v1.2.2
+ * @datalyr/web v1.3.0
  * Datalyr Web SDK - Modern attribution tracking for web applications
  * (c) 2026 Datalyr Inc.
  * Released under the MIT License
@@ -3556,6 +3556,60 @@ class Datalyr {
             this.trackError(error, { event: eventName });
         }
     }
+    /**
+     * Track an app download click and redirect to the app store.
+     * Fires a $app_download_click event with full attribution data,
+     * then redirects the user to the appropriate store URL.
+     * For Android, encodes attribution params into the Play Store referrer
+     * so the mobile SDK can retrieve them deterministically after install.
+     */
+    trackAppDownloadClick(options) {
+        if (!this.initialized) {
+            console.warn('[Datalyr] SDK not initialized. Call init() first.');
+            return;
+        }
+        if (!this.shouldTrack())
+            return;
+        // Fire the event with target platform info — attribution data is
+        // automatically merged by createEventPayload via getAttributionData()
+        this.track('$app_download_click', {
+            target_platform: options.targetPlatform,
+            app_store_url: options.appStoreUrl,
+        });
+        // Flush immediately via sendBeacon before page navigates away
+        this.queue.forceFlush();
+        // For Android: append referrer param to Play Store URL with click attribution
+        if (options.targetPlatform === 'android' && options.appStoreUrl.includes('play.google.com')) {
+            const lastTouch = this.attribution.getLastTouch();
+            const referrerParams = new URLSearchParams();
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.clickId)
+                referrerParams.set('dl_click_id', lastTouch.clickId);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.clickIdType)
+                referrerParams.set('dl_click_id_type', lastTouch.clickIdType);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.source)
+                referrerParams.set('utm_source', lastTouch.source);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.medium)
+                referrerParams.set('utm_medium', lastTouch.medium);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.campaign)
+                referrerParams.set('utm_campaign', lastTouch.campaign);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.content)
+                referrerParams.set('utm_content', lastTouch.content);
+            if (lastTouch === null || lastTouch === void 0 ? void 0 : lastTouch.term)
+                referrerParams.set('utm_term', lastTouch.term);
+            try {
+                const url = new URL(options.appStoreUrl);
+                url.searchParams.set('referrer', referrerParams.toString());
+                window.location.href = url.toString();
+            }
+            catch (_a) {
+                // If URL parsing fails, redirect without referrer
+                window.location.href = options.appStoreUrl;
+            }
+        }
+        else {
+            window.location.href = options.appStoreUrl;
+        }
+    }
     /**
      * Identify a user
      */