@bidkernel/analytics 0.4.0 → 0.5.0

package/dist/index.mjs

@@ -805,7 +805,8 @@ function parseBidDimensions(bid) {
     height: Number.isFinite(bid?.height) ? bid.height : 0
   };
 }
-var BidkernelPrebidAnalytics = class {
+var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
+  static activeInstances = /* @__PURE__ */ new Set();
   config;
   queue = [];
   errorCount = 0;
@@ -821,6 +822,12 @@ var BidkernelPrebidAnalytics = class {
   consecutiveSendFailures = 0;
   nextSendAllowedAt = 0;
   replayedEventCount = 0;
+  // Viewability & refresh tracking
+  intersectionObserver = null;
+  slotViewabilityRecords = /* @__PURE__ */ new Map();
+  elementToSlotId = /* @__PURE__ */ new Map();
+  slotRefreshIndices = /* @__PURE__ */ new Map();
+  pendingThresholdListeners = /* @__PURE__ */ new Map();
   constructor(config) {
     this.config = {
       endpoint: config.endpoint || "",
@@ -834,19 +841,36 @@ var BidkernelPrebidAnalytics = class {
       auctionEnabled: config.auctionEnabled ?? true,
       warningsEnabled: config.warningsEnabled ?? true,
       errorsEnabled: config.errorsEnabled ?? true,
+      viewabilityEnabled: config.viewabilityEnabled ?? true,
       logLevel: config.logLevel || "INFO",
       pbjsGlobalName: config.pbjsGlobalName || "pbjs",
       attachPbjsListeners: config.attachPbjsListeners ?? true
     };
-    this.boundFlushBeacon = () => this.flushBeacon();
+    this.boundFlushBeacon = () => {
+      this.flushAllSlotsTimeInView();
+      this.flushBeacon();
+    };
     this.boundVisibilityChange = () => this.handleVisibilityChange();
   }
   enable() {
     if (this.isEnabled) return;
     this.isEnabled = true;
+    _BidkernelPrebidAnalytics.activeInstances.add(this);
     if (!this.config.endpoint) {
       this.log("WARN", "Endpoint is empty. Analytics events will not be transmitted.");
     }
+    if (this.config.viewabilityEnabled) {
+      if (typeof IntersectionObserver !== "undefined") {
+        this.intersectionObserver = new IntersectionObserver(this.handleIntersection.bind(this), {
+          threshold: [0.5]
+        });
+        for (const record of this.slotViewabilityRecords.values()) {
+          if (record.element) {
+            this.intersectionObserver.observe(record.element);
+          }
+        }
+      }
+    }
     if (this.config.attachPbjsListeners) {
       const win = typeof window !== "undefined" ? window : {};
       const pbjs = win[this.config.pbjsGlobalName] || {};
@@ -926,7 +950,28 @@ var BidkernelPrebidAnalytics = class {
   }
   disable() {
     if (!this.isEnabled) return;
+    this.flushAllSlotsTimeInView();
     this.isEnabled = false;
+    _BidkernelPrebidAnalytics.activeInstances.delete(this);
+    for (const record of this.slotViewabilityRecords.values()) {
+      if (record.dwellTimer) {
+        clearTimeout(record.dwellTimer);
+        record.dwellTimer = null;
+        record.dwellStartedAt = null;
+      }
+      for (const l of record.thresholdListeners) {
+        if (l.timer) {
+          clearTimeout(l.timer);
+          l.timer = null;
+        }
+      }
+    }
+    if (this.intersectionObserver) {
+      this.intersectionObserver.disconnect();
+      this.intersectionObserver = null;
+    }
+    this.slotViewabilityRecords.clear();
+    this.elementToSlotId.clear();
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
@@ -950,8 +995,443 @@ var BidkernelPrebidAnalytics = class {
     this.flush();
   }
   handleVisibilityChange() {
-    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+    if (typeof document === "undefined") return;
+    if (document.visibilityState === "hidden") {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      for (const record of this.slotViewabilityRecords.values()) {
+        if (record.inView && record.lastEnteredViewAt !== null) {
+          record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+          record.lastEnteredViewAt = null;
+          this.checkThresholdListeners(record);
+        }
+        if (record.dwellTimer) {
+          clearTimeout(record.dwellTimer);
+          record.dwellTimer = null;
+          record.dwellStartedAt = null;
+        }
+        for (const l of record.thresholdListeners) {
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+        const durationMs = Math.round(record.accumulatedTimeInViewMs);
+        if (durationMs > 0) {
+          this.enqueue(TraceEventType.TIME_IN_VIEW, "timeInView", {
+            auctionId: record.auctionId,
+            transactionId: record.transactionId,
+            adUnitCode: record.adUnitCode,
+            viewableDurationMs: durationMs,
+            bid: record.bidPayload,
+            metadata: {
+              ...record.metadata,
+              refresh_index: String(record.refreshIndex)
+            }
+          });
+        }
+      }
       this.flushBeacon();
+    } else if (document.visibilityState === "visible") {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      for (const record of this.slotViewabilityRecords.values()) {
+        if (record.inView) {
+          record.lastEnteredViewAt = now;
+          if (!record.viewableFired && record.dwellTimer === null) {
+            const dwellTarget = record.mediaType === "video" ? 2e3 : 1e3;
+            record.dwellStartedAt = now;
+            record.dwellTimer = setTimeout(() => {
+              this.handleDwellComplete(record);
+            }, dwellTarget);
+          }
+          this.scheduleThresholdTimers(record);
+        }
+      }
+    }
+  }
+  handleIntersection(entries) {
+    for (const entry of entries) {
+      let slotId = this.elementToSlotId.get(entry.target);
+      if (!slotId) {
+        for (const instance of _BidkernelPrebidAnalytics.activeInstances) {
+          if (instance !== this && instance.elementToSlotId.has(entry.target)) {
+            instance.handleIntersection([entry]);
+            break;
+          }
+        }
+        continue;
+      }
+      const record = this.slotViewabilityRecords.get(slotId);
+      if (!record) continue;
+      const isViewableRatio = entry.isIntersecting && (entry.intersectionRatio === void 0 || entry.intersectionRatio >= 0.5);
+      const isDocVisible = typeof document === "undefined" || document.visibilityState === "visible";
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      if (isViewableRatio) {
+        if (!record.inView) {
+          record.inView = true;
+          if (isDocVisible) {
+            record.lastEnteredViewAt = now;
+            if (!record.viewableFired && record.dwellTimer === null) {
+              const dwellTarget = record.mediaType === "video" ? 2e3 : 1e3;
+              record.dwellStartedAt = now;
+              record.dwellTimer = setTimeout(() => {
+                this.handleDwellComplete(record);
+              }, dwellTarget);
+            }
+            this.scheduleThresholdTimers(record);
+          }
+        }
+      } else {
+        if (record.inView) {
+          if (record.lastEnteredViewAt !== null) {
+            record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+            record.lastEnteredViewAt = null;
+          }
+          record.inView = false;
+          this.checkThresholdListeners(record);
+        }
+        if (record.dwellTimer !== null) {
+          clearTimeout(record.dwellTimer);
+          record.dwellTimer = null;
+          record.dwellStartedAt = null;
+        }
+        for (const l of record.thresholdListeners) {
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+      }
+    }
+  }
+  handleDwellComplete(record) {
+    record.dwellTimer = null;
+    record.dwellStartedAt = null;
+    if (!record.inView) return;
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") return;
+    if (!record.viewableFired) {
+      record.viewableFired = true;
+      this.enqueue(TraceEventType.VIEWABLE, "viewable", {
+        auctionId: record.auctionId,
+        transactionId: record.transactionId,
+        adUnitCode: record.adUnitCode,
+        bid: record.bidPayload,
+        metadata: {
+          ...record.metadata,
+          refresh_index: String(record.refreshIndex)
+        }
+      });
+    }
+  }
+  scheduleThresholdTimers(record) {
+    if (!record.inView || typeof document !== "undefined" && document.visibilityState === "hidden") {
+      return;
+    }
+    const currentTotal = this.getCurrentTimeInView(record);
+    for (const listener of record.thresholdListeners) {
+      if (listener.fired) continue;
+      if (currentTotal >= listener.thresholdMs) {
+        listener.fired = true;
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+          listener.timer = null;
+        }
+        try {
+          listener.callback(record.slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold listener callback", e);
+        }
+      } else {
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+        }
+        const remaining = listener.thresholdMs - currentTotal;
+        listener.timer = setTimeout(() => {
+          listener.timer = null;
+          if (!listener.fired && record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+            const nowTotal = this.getCurrentTimeInView(record);
+            if (nowTotal >= listener.thresholdMs) {
+              listener.fired = true;
+              try {
+                listener.callback(record.slotId, nowTotal);
+              } catch (e) {
+                this.log("ERROR", "Error in threshold listener callback", e);
+              }
+            }
+          }
+        }, remaining);
+      }
+    }
+  }
+  checkThresholdListeners(record) {
+    const currentTotal = this.getCurrentTimeInView(record);
+    for (const listener of record.thresholdListeners) {
+      if (!listener.fired && currentTotal >= listener.thresholdMs) {
+        listener.fired = true;
+        if (listener.timer) {
+          clearTimeout(listener.timer);
+          listener.timer = null;
+        }
+        try {
+          listener.callback(record.slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold listener callback", e);
+        }
+      }
+    }
+  }
+  getCurrentTimeInView(record) {
+    let total = record.accumulatedTimeInViewMs;
+    if (record.inView && record.lastEnteredViewAt !== null) {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      total += Math.max(0, now - record.lastEnteredViewAt);
+    }
+    return total;
+  }
+  flushSlotTimeInView(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return;
+    if (record.inView && record.lastEnteredViewAt !== null) {
+      const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+      record.accumulatedTimeInViewMs += Math.max(0, now - record.lastEnteredViewAt);
+      record.lastEnteredViewAt = null;
+    }
+    const durationMs = Math.round(record.accumulatedTimeInViewMs);
+    if (durationMs > 0) {
+      this.enqueue(TraceEventType.TIME_IN_VIEW, "timeInView", {
+        auctionId: record.auctionId,
+        transactionId: record.transactionId,
+        adUnitCode: record.adUnitCode,
+        viewableDurationMs: durationMs,
+        bid: record.bidPayload,
+        metadata: {
+          ...record.metadata,
+          refresh_index: String(record.refreshIndex)
+        }
+      });
+    }
+    record.accumulatedTimeInViewMs = 0;
+  }
+  flushAllSlotsTimeInView() {
+    for (const slotId of Array.from(this.slotViewabilityRecords.keys())) {
+      this.flushSlotTimeInView(slotId);
+    }
+  }
+  observeSlot(element, slotId, options) {
+    if (!this.config.viewabilityEnabled) return;
+    let el = null;
+    if (typeof element === "string") {
+      if (typeof document !== "undefined") {
+        try {
+          el = document.querySelector(element) || document.getElementById(element);
+        } catch {
+          el = document.getElementById(element);
+        }
+        if (!el) {
+          el = document.getElementById(element);
+        }
+      }
+    } else {
+      el = element;
+    }
+    const resolvedSlotId = slotId || options?.adUnitCode || (el ? el.id : "") || generateUUID();
+    const existing = this.slotViewabilityRecords.get(resolvedSlotId);
+    if (existing) {
+      const isNewRefreshCycle = options?.refreshIndex === void 0 || options.refreshIndex > existing.refreshIndex;
+      if (isNewRefreshCycle) {
+        this.flushSlotTimeInView(resolvedSlotId);
+        const nextRefreshIndex = options?.refreshIndex !== void 0 ? options.refreshIndex : (this.slotRefreshIndices.get(resolvedSlotId) ?? existing.refreshIndex) + 1;
+        this.slotRefreshIndices.set(resolvedSlotId, nextRefreshIndex);
+        if (options?.emitRefreshEvent !== false) {
+          this.enqueue(TraceEventType.REFRESH, "refresh", {
+            auctionId: options?.auctionId || existing.auctionId,
+            transactionId: options?.transactionId || existing.transactionId,
+            adUnitCode: resolvedSlotId,
+            bid: options?.bid ?? existing.bidPayload,
+            metadata: {
+              ...options?.metadata,
+              refresh_index: String(nextRefreshIndex)
+            }
+          });
+        }
+        if (existing.dwellTimer) {
+          clearTimeout(existing.dwellTimer);
+          existing.dwellTimer = null;
+          existing.dwellStartedAt = null;
+        }
+        for (const l of existing.thresholdListeners) {
+          l.fired = false;
+          if (l.timer) {
+            clearTimeout(l.timer);
+            l.timer = null;
+          }
+        }
+        existing.viewableFired = false;
+        existing.accumulatedTimeInViewMs = 0;
+        const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+        existing.lastEnteredViewAt = existing.inView ? now : null;
+        existing.refreshIndex = nextRefreshIndex;
+        existing.auctionId = options?.auctionId || existing.auctionId;
+        existing.transactionId = options?.transactionId || existing.transactionId;
+        existing.mediaType = options?.mediaType || existing.mediaType || "banner";
+        existing.bidPayload = options?.bid !== void 0 ? options.bid : existing.bidPayload;
+        existing.metadata = options?.metadata ?? existing.metadata;
+        if (existing.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+          const dwellTarget = existing.mediaType === "video" ? 2e3 : 1e3;
+          existing.dwellStartedAt = now;
+          existing.dwellTimer = setTimeout(() => {
+            this.handleDwellComplete(existing);
+          }, dwellTarget);
+          this.scheduleThresholdTimers(existing);
+        }
+      } else {
+        existing.auctionId = options?.auctionId || existing.auctionId;
+        existing.transactionId = options?.transactionId || existing.transactionId;
+        existing.mediaType = options?.mediaType || existing.mediaType;
+        if (options?.bid !== void 0) existing.bidPayload = options.bid;
+        if (options?.metadata !== void 0) existing.metadata = options.metadata;
+      }
+      if (el) {
+        if (existing.element && existing.element !== el && this.intersectionObserver) {
+          this.intersectionObserver.unobserve(existing.element);
+          this.elementToSlotId.delete(existing.element);
+        }
+        existing.element = el;
+        this.elementToSlotId.set(el, resolvedSlotId);
+        this.intersectionObserver?.observe(el);
+      }
+    } else {
+      const initialRefreshIndex = options?.refreshIndex ?? this.slotRefreshIndices.get(resolvedSlotId) ?? 0;
+      this.slotRefreshIndices.set(resolvedSlotId, initialRefreshIndex);
+      const listeners = this.pendingThresholdListeners.get(resolvedSlotId) || /* @__PURE__ */ new Set();
+      this.pendingThresholdListeners.delete(resolvedSlotId);
+      const record = {
+        slotId: resolvedSlotId,
+        element: el,
+        adUnitCode: options?.adUnitCode || resolvedSlotId,
+        auctionId: options?.auctionId || "",
+        transactionId: options?.transactionId || "",
+        mediaType: options?.mediaType || "banner",
+        bidPayload: options?.bid,
+        metadata: options?.metadata,
+        refreshIndex: initialRefreshIndex,
+        inView: false,
+        lastEnteredViewAt: null,
+        accumulatedTimeInViewMs: 0,
+        viewableFired: false,
+        dwellTimer: null,
+        dwellStartedAt: null,
+        thresholdListeners: listeners
+      };
+      this.slotViewabilityRecords.set(resolvedSlotId, record);
+      if (el) {
+        this.elementToSlotId.set(el, resolvedSlotId);
+        this.intersectionObserver?.observe(el);
+      }
+    }
+  }
+  unobserveSlot(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return;
+    this.flushSlotTimeInView(slotId);
+    if (record.dwellTimer) {
+      clearTimeout(record.dwellTimer);
+      record.dwellTimer = null;
+      record.dwellStartedAt = null;
+    }
+    for (const l of record.thresholdListeners) {
+      if (l.timer) {
+        clearTimeout(l.timer);
+        l.timer = null;
+      }
+    }
+    record.thresholdListeners = /* @__PURE__ */ new Set();
+    if (record.element && this.intersectionObserver) {
+      this.intersectionObserver.unobserve(record.element);
+      this.elementToSlotId.delete(record.element);
+      record.element = null;
+    }
+    record.inView = false;
+    record.lastEnteredViewAt = null;
+  }
+  destroySlot(slotId) {
+    this.unobserveSlot(slotId);
+    this.slotViewabilityRecords.delete(slotId);
+    this.slotRefreshIndices.delete(slotId);
+    this.pendingThresholdListeners.delete(slotId);
+  }
+  onTimeInViewThreshold(slotId, thresholdMs, callback) {
+    const listener = {
+      thresholdMs,
+      callback,
+      timer: null,
+      fired: false
+    };
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (record) {
+      record.thresholdListeners.add(listener);
+      const currentTotal = this.getCurrentTimeInView(record);
+      if (currentTotal >= thresholdMs) {
+        listener.fired = true;
+        try {
+          callback(slotId, currentTotal);
+        } catch (e) {
+          this.log("ERROR", "Error in threshold callback", e);
+        }
+      } else if (record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+        const remaining = thresholdMs - currentTotal;
+        listener.timer = setTimeout(() => {
+          listener.timer = null;
+          if (!listener.fired && record.inView && (typeof document === "undefined" || document.visibilityState === "visible")) {
+            const nowTotal = this.getCurrentTimeInView(record);
+            if (nowTotal >= thresholdMs) {
+              listener.fired = true;
+              try {
+                callback(slotId, nowTotal);
+              } catch (e) {
+                this.log("ERROR", "Error in threshold callback", e);
+              }
+            }
+          }
+        }, remaining);
+      }
+    } else {
+      if (!this.pendingThresholdListeners.has(slotId)) {
+        this.pendingThresholdListeners.set(slotId, /* @__PURE__ */ new Set());
+      }
+      this.pendingThresholdListeners.get(slotId).add(listener);
+    }
+    return () => {
+      if (listener.timer) {
+        clearTimeout(listener.timer);
+        listener.timer = null;
+      }
+      if (record) {
+        record.thresholdListeners.delete(listener);
+      }
+      const pending = this.pendingThresholdListeners.get(slotId);
+      if (pending) {
+        pending.delete(listener);
+      }
+    };
+  }
+  getViewabilityState(slotId) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (!record) return void 0;
+    const timeInViewMs = Math.round(this.getCurrentTimeInView(record));
+    return {
+      inView: record.inView,
+      viewable: record.viewableFired,
+      timeInViewMs,
+      refreshIndex: record.refreshIndex
+    };
+  }
+  getRefreshIndex(slotId) {
+    return this.slotRefreshIndices.get(slotId) ?? 0;
+  }
+  triggerSlotRefresh(slotId, options) {
+    const record = this.slotViewabilityRecords.get(slotId);
+    if (record && record.element) {
+      this.observeSlot(record.element, slotId, options);
     }
   }
   trackRawEvent(level, eventName, data) {
@@ -966,6 +1446,8 @@ var BidkernelPrebidAnalytics = class {
   }
   navigate(pageviewId, pageUrl) {
     this.disable();
+    this.slotRefreshIndices.clear();
+    this.pendingThresholdListeners.clear();
     this.config.pageviewId = pageviewId || generateUUID();
     if (pageUrl) {
       try {
@@ -1140,23 +1622,81 @@ var BidkernelPrebidAnalytics = class {
   handleAdRenderSucceeded(data) {
     if (this.isDuplicate("adRenderSucceeded", data)) return;
     this.log("DEBUG", "adRenderSucceeded", data);
-    const bid = data.bid || {};
+    const bid = data.bid || data || {};
+    const adUnitCode = data.adUnitCode || bid.adUnitCode || "";
+    const auctionId = bid.auctionId || data.auctionId || "";
+    const transactionId = bid.transactionId || data.transactionId || "";
+    const mediaType = bid.mediaType || "banner";
+    const bidTrace = {
+      bidder: bid.bidderCode || bid.bidder || "",
+      cpm: Number.isFinite(bid.originalCpm) ? bid.originalCpm : Number.isFinite(bid.cpm) ? bid.cpm : 0,
+      currency: bid.originalCurrency ?? bid.currency ?? "USD",
+      ...parseBidDimensions(bid),
+      dealId: bid.dealId || "",
+      mediaType,
+      latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : 0,
+      advertiserDomain: bid.meta?.advertiserDomains?.[0] || "",
+      creativeId: bid.creativeId || ""
+    };
+    const isRefresh = adUnitCode && (this.slotViewabilityRecords.has(adUnitCode) || this.slotRefreshIndices.has(adUnitCode) && this.slotRefreshIndices.get(adUnitCode) > 0);
+    if (isRefresh) {
+      this.flushSlotTimeInView(adUnitCode);
+      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? 0) + 1;
+      this.slotRefreshIndices.set(adUnitCode, nextRefreshIndex);
+      this.enqueue(TraceEventType.REFRESH, "refresh", {
+        auctionId,
+        transactionId,
+        adUnitCode,
+        bid: bidTrace,
+        metadata: { refresh_index: String(nextRefreshIndex) }
+      });
+    } else if (adUnitCode && !this.slotRefreshIndices.has(adUnitCode)) {
+      this.slotRefreshIndices.set(adUnitCode, 0);
+    }
+    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? 0 : 0;
     this.enqueue(TraceEventType.IMPRESSION, "impression", {
-      auctionId: bid.auctionId || data.auctionId || "",
-      transactionId: bid.transactionId || data.transactionId || "",
-      adUnitCode: data.adUnitCode || bid.adUnitCode || "",
-      bid: {
-        bidder: bid.bidderCode || bid.bidder || "",
-        cpm: Number.isFinite(bid.originalCpm) ? bid.originalCpm : Number.isFinite(bid.cpm) ? bid.cpm : 0,
-        currency: bid.originalCurrency ?? bid.currency ?? "USD",
-        ...parseBidDimensions(bid),
-        dealId: bid.dealId || "",
-        mediaType: bid.mediaType || "banner",
-        latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : 0,
-        advertiserDomain: bid.meta?.advertiserDomains?.[0] || "",
-        creativeId: bid.creativeId || ""
-      }
+      auctionId,
+      transactionId,
+      adUnitCode,
+      bid: bidTrace,
+      metadata: { refresh_index: String(currentRefreshIndex) }
     });
+    if (this.config.viewabilityEnabled && typeof document !== "undefined") {
+      let el = null;
+      const targetId = adUnitCode || data.adId || bid.adId;
+      if (targetId) {
+        el = document.getElementById(targetId);
+      }
+      if (!el && typeof window !== "undefined" && window.googletag?.pubads) {
+        try {
+          const slots = window.googletag.pubads().getSlots();
+          for (const slot of slots) {
+            if (slot.getAdUnitPath?.() === adUnitCode || slot.getSlotElementId?.() === adUnitCode) {
+              el = document.getElementById(slot.getSlotElementId());
+              if (el) break;
+            }
+          }
+        } catch {
+        }
+      }
+      if (!el && targetId) {
+        try {
+          el = document.querySelector(`[data-ad-slot="${targetId}"]`) || document.querySelector(`#${targetId}`);
+        } catch {
+        }
+      }
+      if (el) {
+        this.observeSlot(el, adUnitCode || targetId, {
+          adUnitCode,
+          auctionId,
+          transactionId,
+          mediaType,
+          bid: bidTrace,
+          refreshIndex: currentRefreshIndex,
+          emitRefreshEvent: false
+        });
+      }
+    }
   }
   isDuplicate(eventName, data) {
     return this.deduper.isDuplicate(eventName, data);
@@ -1202,6 +1742,9 @@ var BidkernelPrebidAnalytics = class {
     if (data.gpid) {
       metadata.gpid = String(data.gpid);
     }
+    if (data.refreshIndex !== void 0 && metadata.refresh_index === void 0) {
+      metadata.refresh_index = String(data.refreshIndex);
+    }
     if (Object.keys(metadata).length > 0) {
       protoEvent.metadata = metadata;
     }
@@ -1292,6 +1835,12 @@ var BidkernelPrebidAnalytics = class {
       this.log("ERROR", "Failed to send batch", err);
       this.handleSendFailure(payload.events);
     });
+    if (typeof process !== "undefined" && typeof process._tickCallback === "function") {
+      try {
+        process._tickCallback();
+      } catch {
+      }
+    }
   }
   handleSendFailure(events) {
     this.consecutiveSendFailures++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bidkernel/analytics",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Bidkernel auction analytics: a standalone Prebid.js analytics adapter, plus TypeScript bindings for the Bidkernel ad SDK.",
   "keywords": [
     "advertising",