@callforge/tracking-client 0.6.0 → 0.6.2

package/README.md

@@ -1,8 +1,6 @@
 # @callforge/tracking-client
 
-Lightweight client library for the CallForge tracking API. Handles location-aware phone number assignment with aggressive caching and preload optimization.
-
-**v0.6.0** - Adds `createCallIntent()` helper for click/callback deterministic attribution and fixes ESM/CJS exports.
+Lightweight client library for the CallForge tracking API. Handles location-aware phone number assignment with aggressive caching and optional preload optimization.
 
 ## Installation
 
@@ -26,12 +24,13 @@ const snippet = getPreloadSnippet({ categoryId: 'your-category-id' });
 ```
 
 Generated HTML:
+
 ```html
 <link rel="preconnect" href="https://tracking.callforge.io">
 <script>/* preload script */</script>
 ```
 
-### 2. Initialize and use the client
+### 2. Initialize and fetch a tracking session
 
 ```typescript
 import { CallForge } from '@callforge/tracking-client';
@@ -41,40 +40,53 @@ const client = CallForge.init({
   // endpoint: 'https://tracking-dev.callforge.io', // Optional: override for dev
 });
 
-// Promise style
 const session = await client.getSession();
 console.log(session.phoneNumber);  // "+17705550000" or null
 console.log(session.location);     // { city: "Woodstock", state: "Georgia", stateCode: "GA" } or null
+```
 
-// Subscription style
-client.onReady((session) => {
-  document.getElementById('phone').textContent = session.phoneNumber;
-  document.getElementById('city').textContent = session.location?.city;
+### 3. Deterministic click/callback attribution (optional)
+
+If you initiate calls programmatically (click-to-call / callback), you can request a short-lived `callIntentToken`. CallForge will consume this once to deterministically map the call back to the web session that requested it.
+
+```typescript
+// In the browser:
+const { callIntentToken } = await client.createCallIntent();
+
+// Send to your backend and attach to the call you initiate
+await fetch('/api/callback', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ callIntentToken }),
 });
 ```
 
-### 3. GA4 Integration
+Notes:
+- `callIntentToken` is short-lived and single-use.
+- Treat it as an opaque secret (do not log it).
+
+### 4. GA4 Integration
 
-To enable GA4 call event tracking, provide your GA4 Measurement ID:
+To enable GA4 call event tracking, CallForge needs the GA4 `client_id` for the visitor (from the `_ga` cookie).
+Optionally provide your GA4 Measurement ID to improve client ID capture reliability when Google Analytics loads late.
 
 ```typescript
 const client = CallForge.init({
   categoryId: 'your-category-id',
-  ga4MeasurementId: 'G-XXXXXXXXXX',  // Required for GA4 integration
+  ga4MeasurementId: 'G-XXXXXXXXXX', // Recommended
 });
 ```
 
-**Requirements:**
-1. Google Analytics 4 must be installed on your site (`gtag.js`)
-2. Provide `ga4MeasurementId` in client config
-3. Configure GA4 credentials in CallForge dashboard (Categories → Edit → GA4 tab)
+Requirements:
+1. Google Analytics 4 must be installed on your site and allowed to set the `_ga` cookie (gtag.js or GTM).
+2. Configure GA4 credentials in CallForge dashboard (Measurement ID + API secret).
 
-**How it works:**
-- Uses `gtag('get', measurementId, 'client_id', callback)` to capture the GA4 client ID
-- Callback fires when GA4 is ready - no polling needed
-- Client ID is automatically sent to CallForge for call event attribution
+How it works:
+- Extracts the GA4 `client_id` from the `_ga` cookie and sends it to CallForge as `ga4ClientId`.
+- If `ga4MeasurementId` is configured and `gtag` is available, also uses `gtag('get', measurementId, 'client_id', ...)` (with a short retry window).
+- If `ga4ClientId` becomes available after a session is created, the client will refresh once to sync it to CallForge.
 
-**Manual override:** If you need to pass a custom GA4 client ID:
+Manual override:
 
 ```typescript
 client.setParams({
@@ -82,7 +94,7 @@ client.setParams({
 });
 ```
 
-### 4. Track conversion parameters (optional)
+### 5. Track conversion parameters (optional)
 
 The client automatically captures ad platform click IDs from the URL:
 
@@ -95,14 +107,13 @@ The client automatically captures ad platform click IDs from the URL:
 You can also add custom parameters:
 
 ```typescript
-// Add custom tracking parameters
 client.setParams({
   customerId: '456',
   landingPage: 'pricing',
 });
 
 // Parameters are automatically sent with every API request
-const session = await client.getSession();
+await client.getSession();
 ```
 
 ## API Reference
@@ -115,18 +126,19 @@ Initialize the tracking client.
 interface CallForgeConfig {
   categoryId: string;        // Required - which number pool to use
   endpoint?: string;         // Optional - defaults to 'https://tracking.callforge.io'
-  ga4MeasurementId?: string; // Optional - GA4 Measurement ID (e.g., "G-XXXXXXXXXX")
-                             // Enables gtag callback instead of cookie polling
+  siteKey?: string;          // Optional - cache partition key (defaults to window.location.hostname)
+  ga4MeasurementId?: string; // Optional - GA4 Measurement ID (e.g., 'G-XXXXXXXXXX')
 }
 ```
 
 ### `client.getSession()`
 
-Get tracking session data. Returns cached data if valid, otherwise fetches from API.
+Get tracking session data. Returns cached data if valid, otherwise fetches from the API.
 
 ```typescript
 interface TrackingSession {
-  sessionId: string | null;
+  sessionToken: string;      // Signed, opaque token used to refresh the session
+  leaseId: string | null;    // Deterministic assignment lease ID (when available)
   phoneNumber: string | null;
   location: {
     city: string;
@@ -136,11 +148,20 @@ interface TrackingSession {
 }
 ```
 
-**Behavior:**
-- Returns `null` values immediately if no `loc_physical_ms` in URL (no API call)
-- Returns cached data if valid (same location, not expired)
-- Fetches fresh data if cache expired or location changed
-- Throws on network errors or API errors
+Behavior:
+- Returns cached data if valid.
+- Fetches fresh data when cache is missing/expired.
+- If `loc_physical_ms` is present in the URL, cached sessions are only reused when it matches the cached `locId`.
+- Throws on network errors or API errors.
+
+### `client.createCallIntent()`
+
+Create a short-lived call intent token for click/callback deterministic attribution.
+
+```typescript
+const intent = await client.createCallIntent();
+console.log(intent.callIntentToken);
+```
 
 ### `client.onReady(callback)`
 
@@ -164,11 +185,10 @@ client.setParams({
 });
 ```
 
-**Behavior:**
-- Merges with existing params (later calls override earlier values)
-- Parameters are sent with every `getSession()` API request
-- Persisted in localStorage alongside session data
-- Auto-captured params (gclid, etc.) are included automatically
+Behavior:
+- Merges with existing params (later calls override earlier values).
+- Parameters are sent with every `getSession()` API request.
+- Persisted in localStorage alongside session data.
 
 ### `getPreloadSnippet(config)`
 
@@ -180,6 +200,7 @@ import { getPreloadSnippet } from '@callforge/tracking-client';
 const html = getPreloadSnippet({
   categoryId: 'your-category-id',
   endpoint: 'https://tracking.callforge.io', // Optional
+  siteKey: 'example.com', // Optional
 });
 ```
 
@@ -194,32 +215,22 @@ The client automatically extracts these parameters from the URL:
 | `gclid` | Google Ads Click ID |
 | `gbraid` | Google app-to-web (iOS 14+) |
 | `wbraid` | Google web-to-app |
-| `msclkid` | Microsoft/Bing Ads |
-| `fbclid` | Facebook/Meta Ads |
-
-**Note:** `ga4ClientId` is captured via `gtag('get')` callback when `ga4MeasurementId` is configured.
-
-### Persistence
-
-- Parameters are stored in localStorage alongside the session
-- On subsequent visits, cached params are used (URL may no longer have them)
-- Custom params via `setParams()` merge with auto-captured params
-- Later values override earlier ones (custom > cached > auto-captured)
+| `msclkid` | Microsoft/Bing Ads Click ID |
+| `fbclid` | Facebook/Meta Ads Click ID |
 
 ### API Request Format
 
-Parameters are sent as sorted query string for cache consistency:
+Parameters are sent as a sorted query string for cache consistency:
 
 ```
-/v1/tracking/session?categoryId=cat-123&fbclid=456&gclid=abc&loc_physical_ms=1014221
+/v1/tracking/session?categoryId=cat-123&fbclid=456&gclid=abc&loc_physical_ms=1014221&sessionToken=...
 ```
 
 ## Caching Behavior
 
-- **Cache key:** `loc_physical_ms` parameter from URL
-- **TTL:** 30 minutes (controlled by server)
-- **Storage:** localStorage (falls back to memory if unavailable)
-- **Invalidation:** Cache clears when location changes
+- Cache key: `cf_tracking_v1_<siteKey>_<categoryId>`
+- TTL: controlled by the server `expiresAt` response (currently 30 minutes)
+- Storage: localStorage (falls back to memory if unavailable)
 
 ## Error Handling
 
@@ -229,7 +240,7 @@ try {
   if (session.phoneNumber) {
     // Use phone number
   } else {
-    // No phone number available for this location
+    // No phone number available
   }
 } catch (err) {
   // Network error or API error
@@ -248,52 +259,10 @@ import type {
   TrackingLocation,
   TrackingParams,
   ReadyCallback,
+  CallIntentResponse,
 } from '@callforge/tracking-client';
 ```
 
-### TrackingParams
-
-```typescript
-interface TrackingParams {
-  gclid?: string;       // Google Ads Click ID
-  gbraid?: string;      // Google app-to-web (iOS 14+)
-  wbraid?: string;      // Google web-to-app
-  msclkid?: string;     // Microsoft/Bing Ads
-  fbclid?: string;      // Facebook/Meta Ads
-  ga4ClientId?: string; // Google Analytics 4 Client ID (auto-captured via gtag callback)
-  [key: string]: string | undefined;  // Custom params
-}
-```
-
-## GA4 Events
-
-When GA4 is configured for a category, CallForge sends these events to Google Analytics 4 via the Measurement Protocol:
-
-| Event Name | When Sent | Description |
-|------------|-----------|-------------|
-| `phone_call` | Call initiated | A phone call was placed to the tracking number |
-| `call_conversion` | Call qualified | The call met conversion criteria (e.g., duration threshold) |
-| `call_conversion_billable` | Call billable | The call was both qualified AND billable |
-
-**Event Parameters:**
-
-All events include:
-- `session_id` - CallForge session ID
-- `phone_number` - Tracking number dialed
-- `category` - Category slug
-
-`call_conversion` and `call_conversion_billable` also include:
-- `call_duration` - Call duration in seconds
-- `buyer` - Buyer the call was routed to (if applicable)
-
-**Setup:**
-1. In Google Analytics 4, go to Admin → Data Streams → your web stream
-2. Copy the **Measurement ID** (e.g., `G-XXXXXXXXXX`)
-3. Go to Admin → Data Streams → Measurement Protocol API secrets → Create
-4. Copy the **API Secret**
-5. In CallForge dashboard: Categories → Edit category → GA4 tab
-6. Enable GA4, paste Measurement ID and API Secret, save
-
 ## Environment URLs
 
 | Environment | Endpoint |

package/dist/index.d.mts

@@ -8,7 +8,7 @@ interface CallForgeConfig {
     endpoint?: string;
     /** Optional - explicit site key for cache partitioning. Defaults to window.location.hostname */
     siteKey?: string;
-    /** Optional - GA4 Measurement ID (e.g., "G-XXXXXXXXXX"). Enables gtag callback instead of cookie polling. */
+    /** Optional - GA4 Measurement ID (e.g., "G-XXXXXXXXXX"). Enables gtag-based client_id capture for late-loading GA. */
     ga4MeasurementId?: string;
 }
 /**
@@ -121,10 +121,20 @@ declare class CallForge {
      */
     getQueuedParams(): TrackingParams;
     /**
-     * Capture the GA4 client ID using gtag callback.
-     * Only runs if ga4MeasurementId is configured.
+     * Capture the GA4 client ID.
+     *
+     * Prefer `_ga` cookie parsing (works even when gtag is not loaded yet).
+     * If ga4MeasurementId is configured and gtag is available, use gtag as a fallback.
      */
     private captureGA4ClientId;
+    private startGA4ClientIdPolling;
+    /**
+     * Extract GA4 client_id from the `_ga` cookie.
+     *
+     * Example cookie value: `GA1.1.1234567890.1234567890`
+     * Returns: `1234567890.1234567890`
+     */
+    private getGA4ClientIdFromCookie;
     private fetchSession;
     private getLocationId;
     private getAutoParams;
@@ -132,6 +142,7 @@ declare class CallForge {
     private saveToCache;
     private formatSession;
     private formatApiResponse;
+    private syncGA4ClientIdIfNeeded;
     private buildUrl;
 }
 

package/dist/index.d.ts

@@ -8,7 +8,7 @@ interface CallForgeConfig {
     endpoint?: string;
     /** Optional - explicit site key for cache partitioning. Defaults to window.location.hostname */
     siteKey?: string;
-    /** Optional - GA4 Measurement ID (e.g., "G-XXXXXXXXXX"). Enables gtag callback instead of cookie polling. */
+    /** Optional - GA4 Measurement ID (e.g., "G-XXXXXXXXXX"). Enables gtag-based client_id capture for late-loading GA. */
     ga4MeasurementId?: string;
 }
 /**
@@ -121,10 +121,20 @@ declare class CallForge {
      */
     getQueuedParams(): TrackingParams;
     /**
-     * Capture the GA4 client ID using gtag callback.
-     * Only runs if ga4MeasurementId is configured.
+     * Capture the GA4 client ID.
+     *
+     * Prefer `_ga` cookie parsing (works even when gtag is not loaded yet).
+     * If ga4MeasurementId is configured and gtag is available, use gtag as a fallback.
      */
     private captureGA4ClientId;
+    private startGA4ClientIdPolling;
+    /**
+     * Extract GA4 client_id from the `_ga` cookie.
+     *
+     * Example cookie value: `GA1.1.1234567890.1234567890`
+     * Returns: `1234567890.1234567890`
+     */
+    private getGA4ClientIdFromCookie;
     private fetchSession;
     private getLocationId;
     private getAutoParams;
@@ -132,6 +142,7 @@ declare class CallForge {
     private saveToCache;
     private formatSession;
     private formatApiResponse;
+    private syncGA4ClientIdIfNeeded;
     private buildUrl;
 }
 

package/dist/index.js

@@ -155,6 +155,7 @@ var CallForge = class _CallForge {
     };
     this.cache = new TrackingCache(config.categoryId, config.siteKey);
     this.captureGA4ClientId();
+    this.startGA4ClientIdPolling();
   }
   /**
    * Initialize the CallForge tracking client.
@@ -213,6 +214,20 @@ var CallForge = class _CallForge {
    */
   async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
+    if (params.ga4ClientId) {
+      const sync = async () => {
+        try {
+          await this.syncGA4ClientIdIfNeeded();
+        } catch (e) {
+        }
+      };
+      if (this.sessionPromise) {
+        void this.sessionPromise.then(sync).catch(() => {
+        });
+      } else {
+        void sync();
+      }
+    }
   }
   /**
    * Get the currently queued custom params.
@@ -221,25 +236,67 @@ var CallForge = class _CallForge {
     return __spreadValues({}, this.customParams);
   }
   /**
-   * Capture the GA4 client ID using gtag callback.
-   * Only runs if ga4MeasurementId is configured.
+   * Capture the GA4 client ID.
+   *
+   * Prefer `_ga` cookie parsing (works even when gtag is not loaded yet).
+   * If ga4MeasurementId is configured and gtag is available, use gtag as a fallback.
    */
   captureGA4ClientId() {
-    if (!this.config.ga4MeasurementId) {
+    if (this.customParams.ga4ClientId) {
       return;
     }
-    if (typeof window === "undefined" || !window.gtag) {
+    const fromCookie = this.getGA4ClientIdFromCookie();
+    if (fromCookie) {
+      this.setParams({ ga4ClientId: fromCookie });
       return;
     }
+    if (!this.config.ga4MeasurementId) return;
+    if (typeof window === "undefined" || !window.gtag) return;
     window.gtag("get", this.config.ga4MeasurementId, "client_id", (clientId) => {
       if (clientId) {
         this.setParams({ ga4ClientId: clientId });
       }
     });
   }
+  startGA4ClientIdPolling() {
+    if (!this.config.ga4MeasurementId) return;
+    if (typeof window === "undefined") return;
+    if (this.customParams.ga4ClientId) return;
+    const MAX_ATTEMPTS = 20;
+    const INTERVAL_MS = 250;
+    let attempts = 0;
+    const poll = () => {
+      if (this.customParams.ga4ClientId) return;
+      this.captureGA4ClientId();
+      attempts += 1;
+      if (this.customParams.ga4ClientId) return;
+      if (attempts >= MAX_ATTEMPTS) return;
+      window.setTimeout(poll, INTERVAL_MS);
+    };
+    window.setTimeout(poll, INTERVAL_MS);
+  }
+  /**
+   * Extract GA4 client_id from the `_ga` cookie.
+   *
+   * Example cookie value: `GA1.1.1234567890.1234567890`
+   * Returns: `1234567890.1234567890`
+   */
+  getGA4ClientIdFromCookie() {
+    if (typeof document === "undefined") return null;
+    const match = document.cookie.match(/(?:^|;\s*)_ga=([^;]+)/);
+    if (!match) return null;
+    const cookieValue = decodeURIComponent(match[1] || "");
+    const parts = cookieValue.split(".");
+    if (parts.length < 2) return null;
+    const partA = parts[parts.length - 2];
+    const partB = parts[parts.length - 1];
+    if (!/^\d+$/.test(partA) || !/^\d+$/.test(partB)) return null;
+    return `${partA}.${partB}`;
+  }
   async fetchSession() {
     var _a;
     const locationId = this.getLocationId();
+    this.captureGA4ClientId();
     if (typeof window !== "undefined" && window.__cfTracking) {
       try {
         const data2 = await window.__cfTracking;
@@ -254,6 +311,13 @@ var CallForge = class _CallForge {
     }
     const cached = this.cache.get(locationId);
     if (cached) {
+      const autoParams2 = this.getAutoParams();
+      const params2 = __spreadValues(__spreadValues(__spreadValues({}, autoParams2), cached.params), this.customParams);
+      if (params2.ga4ClientId && cached.params.ga4ClientId !== params2.ga4ClientId) {
+        const data2 = await this.fetchFromApi(locationId, cached.sessionToken, params2);
+        this.saveToCache(locationId, data2, params2);
+        return this.formatApiResponse(data2);
+      }
       return this.formatSession(cached);
     }
     const autoParams = this.getAutoParams();
@@ -327,6 +391,21 @@ var CallForge = class _CallForge {
       location: data.location
     };
   }
+  async syncGA4ClientIdIfNeeded() {
+    const ga4ClientId = this.customParams.ga4ClientId;
+    if (!ga4ClientId) return;
+    const locationId = this.getLocationId();
+    const sessionToken = this.cache.getSessionToken(locationId);
+    if (!sessionToken) return;
+    const autoParams = this.getAutoParams();
+    const cachedParams = this.cache.getParams();
+    const params = __spreadValues(__spreadValues(__spreadValues({}, autoParams), cachedParams), this.customParams);
+    if (cachedParams.ga4ClientId === params.ga4ClientId) {
+      return;
+    }
+    const data = await this.fetchFromApi(locationId, sessionToken, params);
+    this.saveToCache(locationId, data, params);
+  }
   buildUrl(locationId, sessionToken, params) {
     const { categoryId, endpoint } = this.config;
     const queryParams = {
@@ -371,6 +450,8 @@ var u=new URLSearchParams(location.search);
 var loc=u.get('loc_physical_ms');
 var ap=['gclid','gbraid','wbraid','msclkid','fbclid','gad_campaignid','gad_source'];
 var p={};
+var m=document.cookie.match(/(?:^|;\\s*)_ga=([^;]+)/);
+if(m){try{var g=decodeURIComponent(m[1]||'');var s=g.split('.');if(s.length>=2){var a=s[s.length-2],b=s[s.length-1];if(/^\\d+$/.test(a)&&/^\\d+$/.test(b))p.ga4ClientId=a+'.'+b}}catch(e){}}
 for(var i=0;i<ap.length;i++){var v=u.get(ap[i]);if(v)p[ap[i]]=v}
 var site='${config.siteKey || ""}'||location.hostname||'unknown-site';
 var key='cf_tracking_v1_'+site+'_${categoryId}';

package/dist/index.mjs

@@ -131,6 +131,7 @@ var CallForge = class _CallForge {
     };
     this.cache = new TrackingCache(config.categoryId, config.siteKey);
     this.captureGA4ClientId();
+    this.startGA4ClientIdPolling();
   }
   /**
    * Initialize the CallForge tracking client.
@@ -189,6 +190,20 @@ var CallForge = class _CallForge {
    */
   async setParams(params) {
     this.customParams = __spreadValues(__spreadValues({}, this.customParams), params);
+    if (params.ga4ClientId) {
+      const sync = async () => {
+        try {
+          await this.syncGA4ClientIdIfNeeded();
+        } catch (e) {
+        }
+      };
+      if (this.sessionPromise) {
+        void this.sessionPromise.then(sync).catch(() => {
+        });
+      } else {
+        void sync();
+      }
+    }
   }
   /**
    * Get the currently queued custom params.
@@ -197,25 +212,67 @@ var CallForge = class _CallForge {
     return __spreadValues({}, this.customParams);
   }
   /**
-   * Capture the GA4 client ID using gtag callback.
-   * Only runs if ga4MeasurementId is configured.
+   * Capture the GA4 client ID.
+   *
+   * Prefer `_ga` cookie parsing (works even when gtag is not loaded yet).
+   * If ga4MeasurementId is configured and gtag is available, use gtag as a fallback.
    */
   captureGA4ClientId() {
-    if (!this.config.ga4MeasurementId) {
+    if (this.customParams.ga4ClientId) {
       return;
     }
-    if (typeof window === "undefined" || !window.gtag) {
+    const fromCookie = this.getGA4ClientIdFromCookie();
+    if (fromCookie) {
+      this.setParams({ ga4ClientId: fromCookie });
       return;
     }
+    if (!this.config.ga4MeasurementId) return;
+    if (typeof window === "undefined" || !window.gtag) return;
     window.gtag("get", this.config.ga4MeasurementId, "client_id", (clientId) => {
       if (clientId) {
         this.setParams({ ga4ClientId: clientId });
       }
     });
   }
+  startGA4ClientIdPolling() {
+    if (!this.config.ga4MeasurementId) return;
+    if (typeof window === "undefined") return;
+    if (this.customParams.ga4ClientId) return;
+    const MAX_ATTEMPTS = 20;
+    const INTERVAL_MS = 250;
+    let attempts = 0;
+    const poll = () => {
+      if (this.customParams.ga4ClientId) return;
+      this.captureGA4ClientId();
+      attempts += 1;
+      if (this.customParams.ga4ClientId) return;
+      if (attempts >= MAX_ATTEMPTS) return;
+      window.setTimeout(poll, INTERVAL_MS);
+    };
+    window.setTimeout(poll, INTERVAL_MS);
+  }
+  /**
+   * Extract GA4 client_id from the `_ga` cookie.
+   *
+   * Example cookie value: `GA1.1.1234567890.1234567890`
+   * Returns: `1234567890.1234567890`
+   */
+  getGA4ClientIdFromCookie() {
+    if (typeof document === "undefined") return null;
+    const match = document.cookie.match(/(?:^|;\s*)_ga=([^;]+)/);
+    if (!match) return null;
+    const cookieValue = decodeURIComponent(match[1] || "");
+    const parts = cookieValue.split(".");
+    if (parts.length < 2) return null;
+    const partA = parts[parts.length - 2];
+    const partB = parts[parts.length - 1];
+    if (!/^\d+$/.test(partA) || !/^\d+$/.test(partB)) return null;
+    return `${partA}.${partB}`;
+  }
   async fetchSession() {
     var _a;
     const locationId = this.getLocationId();
+    this.captureGA4ClientId();
     if (typeof window !== "undefined" && window.__cfTracking) {
       try {
         const data2 = await window.__cfTracking;
@@ -230,6 +287,13 @@ var CallForge = class _CallForge {
     }
     const cached = this.cache.get(locationId);
     if (cached) {
+      const autoParams2 = this.getAutoParams();
+      const params2 = __spreadValues(__spreadValues(__spreadValues({}, autoParams2), cached.params), this.customParams);
+      if (params2.ga4ClientId && cached.params.ga4ClientId !== params2.ga4ClientId) {
+        const data2 = await this.fetchFromApi(locationId, cached.sessionToken, params2);
+        this.saveToCache(locationId, data2, params2);
+        return this.formatApiResponse(data2);
+      }
       return this.formatSession(cached);
     }
     const autoParams = this.getAutoParams();
@@ -303,6 +367,21 @@ var CallForge = class _CallForge {
       location: data.location
     };
   }
+  async syncGA4ClientIdIfNeeded() {
+    const ga4ClientId = this.customParams.ga4ClientId;
+    if (!ga4ClientId) return;
+    const locationId = this.getLocationId();
+    const sessionToken = this.cache.getSessionToken(locationId);
+    if (!sessionToken) return;
+    const autoParams = this.getAutoParams();
+    const cachedParams = this.cache.getParams();
+    const params = __spreadValues(__spreadValues(__spreadValues({}, autoParams), cachedParams), this.customParams);
+    if (cachedParams.ga4ClientId === params.ga4ClientId) {
+      return;
+    }
+    const data = await this.fetchFromApi(locationId, sessionToken, params);
+    this.saveToCache(locationId, data, params);
+  }
   buildUrl(locationId, sessionToken, params) {
     const { categoryId, endpoint } = this.config;
     const queryParams = {
@@ -347,6 +426,8 @@ var u=new URLSearchParams(location.search);
 var loc=u.get('loc_physical_ms');
 var ap=['gclid','gbraid','wbraid','msclkid','fbclid','gad_campaignid','gad_source'];
 var p={};
+var m=document.cookie.match(/(?:^|;\\s*)_ga=([^;]+)/);
+if(m){try{var g=decodeURIComponent(m[1]||'');var s=g.split('.');if(s.length>=2){var a=s[s.length-2],b=s[s.length-1];if(/^\\d+$/.test(a)&&/^\\d+$/.test(b))p.ga4ClientId=a+'.'+b}}catch(e){}}
 for(var i=0;i<ap.length;i++){var v=u.get(ap[i]);if(v)p[ap[i]]=v}
 var site='${config.siteKey || ""}'||location.hostname||'unknown-site';
 var key='cf_tracking_v1_'+site+'_${categoryId}';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callforge/tracking-client",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",