@bidkernel/analytics 0.6.0 → 0.7.0

package/dist/index.mjs

@@ -859,7 +859,14 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   slotViewabilityRecords = /* @__PURE__ */ new Map();
   elementToSlotId = /* @__PURE__ */ new Map();
   slotRefreshIndices = /* @__PURE__ */ new Map();
+  slotLastAuctionIds = /* @__PURE__ */ new Map();
   pendingThresholdListeners = /* @__PURE__ */ new Map();
+  // Impression deduplication per slot and refresh cycle (strictly 1 impression per cycle)
+  slotEmittedImpressionKeys = /* @__PURE__ */ new Set();
+  // Winning bid cache from bidWon to marry with subsequent render triggers (adRenderSucceeded, video, etc.)
+  cachedWinningBids = /* @__PURE__ */ new Map();
+  // Active video player attachment cleanup routines
+  videoDetachCleanups = /* @__PURE__ */ new Set();
   constructor(config) {
     this.config = {
       endpoint: config.endpoint || "",
@@ -1005,6 +1012,16 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     }
     this.slotViewabilityRecords.clear();
     this.elementToSlotId.clear();
+    for (const cleanup of this.videoDetachCleanups) {
+      try {
+        cleanup();
+      } catch {
+      }
+    }
+    this.videoDetachCleanups.clear();
+    this.cachedWinningBids.clear();
+    this.slotEmittedImpressionKeys.clear();
+    this.slotLastAuctionIds.clear();
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
@@ -1327,6 +1344,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         if (options?.bid !== void 0) existing.bidPayload = options.bid;
         if (options?.metadata !== void 0) existing.metadata = options.metadata;
       }
+      if (options?.auctionId) {
+        this.slotLastAuctionIds.set(resolvedSlotId, options.auctionId);
+      }
       if (el) {
         if (existing.element && existing.element !== el && this.intersectionObserver) {
           this.intersectionObserver.unobserve(existing.element);
@@ -1339,6 +1359,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     } else {
       const initialRefreshIndex = options?.refreshIndex ?? this.slotRefreshIndices.get(resolvedSlotId) ?? 0;
       this.slotRefreshIndices.set(resolvedSlotId, initialRefreshIndex);
+      if (options?.auctionId) {
+        this.slotLastAuctionIds.set(resolvedSlotId, options.auctionId);
+      }
       const listeners = this.pendingThresholdListeners.get(resolvedSlotId) || /* @__PURE__ */ new Set();
       this.pendingThresholdListeners.delete(resolvedSlotId);
       const record = {
@@ -1394,7 +1417,485 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     this.unobserveSlot(slotId);
     this.slotViewabilityRecords.delete(slotId);
     this.slotRefreshIndices.delete(slotId);
+    this.slotLastAuctionIds.delete(slotId);
     this.pendingThresholdListeners.delete(slotId);
+    const prefix = `${escapeKeyPart(slotId)}:`;
+    for (const key of Array.from(this.slotEmittedImpressionKeys)) {
+      if (key === slotId || key.startsWith(prefix)) {
+        this.slotEmittedImpressionKeys.delete(key);
+      }
+    }
+    this.cachedWinningBids.delete(slotId);
+  }
+  hasImpressionEmitted(slotId, refreshIndex, auctionId, creativeId) {
+    const rIndex = refreshIndex ?? this.slotRefreshIndices.get(slotId) ?? 0;
+    const baseSlotKey = `${escapeKeyPart(slotId)}:${rIndex}`;
+    if (creativeId) {
+      if (auctionId) {
+        return this.slotEmittedImpressionKeys.has(
+          `${baseSlotKey}:auc:${escapeKeyPart(auctionId)}:${escapeKeyPart(creativeId)}`
+        ) || this.slotEmittedImpressionKeys.has(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+      }
+      return this.slotEmittedImpressionKeys.has(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+    }
+    if (auctionId) {
+      return this.slotEmittedImpressionKeys.has(`${baseSlotKey}:auc:${escapeKeyPart(auctionId)}`);
+    }
+    return this.slotEmittedImpressionKeys.has(baseSlotKey);
+  }
+  markImpressionEmitted(slotId, refreshIndex, auctionId, creativeId) {
+    const baseSlotKey = `${escapeKeyPart(slotId)}:${refreshIndex}`;
+    this.slotEmittedImpressionKeys.add(baseSlotKey);
+    if (creativeId) {
+      this.slotEmittedImpressionKeys.add(`${baseSlotKey}:${escapeKeyPart(creativeId)}`);
+    }
+    if (auctionId) {
+      this.slotEmittedImpressionKeys.add(`${baseSlotKey}:auc:${escapeKeyPart(auctionId)}`);
+      if (creativeId) {
+        this.slotEmittedImpressionKeys.add(
+          `${baseSlotKey}:auc:${escapeKeyPart(auctionId)}:${escapeKeyPart(creativeId)}`
+        );
+      }
+    }
+  }
+  recordImpression(slotId, options) {
+    if (!this.isEnabled) return false;
+    const resolvedSlotId = slotId || options?.adUnitCode || "";
+    const adUnitCode = options?.adUnitCode || resolvedSlotId;
+    const cached = (options?.auctionId && resolvedSlotId ? this.cachedWinningBids.get(`${options.auctionId}:${resolvedSlotId}`) : void 0) || (options?.auctionId && adUnitCode ? this.cachedWinningBids.get(`${options.auctionId}:${adUnitCode}`) : void 0) || (resolvedSlotId ? this.cachedWinningBids.get(resolvedSlotId) : void 0) || (adUnitCode ? this.cachedWinningBids.get(adUnitCode) : void 0);
+    const rawBid = options?.bid || cached?.rawBid || {};
+    const auctionId = options?.auctionId || rawBid.auctionId || cached?.auctionId || "";
+    const transactionId = options?.transactionId || rawBid.transactionId || cached?.transactionId || "";
+    const creativeId = rawBid.creativeId || cached?.bidTrace?.creativeId || options?.bid?.creativeId || "";
+    const mediaType = options?.mediaType || rawBid.mediaType || cached?.bidTrace?.mediaType || "banner";
+    const targetSlot = resolvedSlotId || adUnitCode;
+    const rec = (resolvedSlotId ? this.slotViewabilityRecords.get(resolvedSlotId) : void 0) || (adUnitCode ? this.slotViewabilityRecords.get(adUnitCode) : void 0);
+    const lastAuctionId = targetSlot ? this.slotLastAuctionIds.get(targetSlot) || (rec ? rec.auctionId : void 0) : void 0;
+    const isDifferentAuction = Boolean(
+      targetSlot && auctionId && lastAuctionId && lastAuctionId !== auctionId && options?.refreshIndex === void 0
+    );
+    const bidTrace = {
+      bidder: rawBid.bidderCode || rawBid.bidder || cached?.bidTrace?.bidder || "",
+      cpm: Number.isFinite(rawBid.originalCpm) ? rawBid.originalCpm : Number.isFinite(rawBid.cpm) ? rawBid.cpm : cached?.bidTrace?.cpm ?? 0,
+      currency: rawBid.originalCurrency ?? rawBid.currency ?? cached?.bidTrace?.currency ?? "USD",
+      ...parseBidDimensions(rawBid).width ? parseBidDimensions(rawBid) : cached?.bidTrace ? { width: cached.bidTrace.width, height: cached.bidTrace.height } : parseBidDimensions(rawBid),
+      dealId: rawBid.dealId || cached?.bidTrace?.dealId || "",
+      mediaType,
+      latencyMs: Number.isFinite(rawBid.timeToRespond) ? rawBid.timeToRespond : cached?.bidTrace?.latencyMs ?? 0,
+      advertiserDomain: rawBid.meta?.advertiserDomains?.[0] || cached?.bidTrace?.advertiserDomain || "",
+      creativeId: rawBid.creativeId || cached?.bidTrace?.creativeId || ""
+    };
+    if (isDifferentAuction && targetSlot) {
+      this.flushSlotTimeInView(targetSlot);
+      const nextRefreshIndex = (this.slotRefreshIndices.get(targetSlot) ?? (rec ? rec.refreshIndex : 0)) + 1;
+      this.slotRefreshIndices.set(targetSlot, nextRefreshIndex);
+      this.slotLastAuctionIds.set(targetSlot, auctionId);
+      if (rec) {
+        rec.refreshIndex = nextRefreshIndex;
+        rec.auctionId = auctionId;
+        rec.transactionId = transactionId;
+        rec.bidPayload = bidTrace;
+        rec.viewableFired = false;
+        rec.accumulatedTimeInViewMs = 0;
+      }
+      this.enqueue(TraceEventType.REFRESH, "refresh", {
+        auctionId,
+        transactionId,
+        adUnitCode: targetSlot,
+        bid: bidTrace,
+        metadata: {
+          ...options?.metadata,
+          refresh_index: String(nextRefreshIndex)
+        }
+      });
+    } else if (targetSlot) {
+      if (auctionId) {
+        this.slotLastAuctionIds.set(targetSlot, auctionId);
+      }
+      if (!this.slotRefreshIndices.has(targetSlot)) {
+        this.slotRefreshIndices.set(targetSlot, 0);
+      }
+    }
+    const currentRefreshIndex = options?.refreshIndex ?? (resolvedSlotId ? this.slotRefreshIndices.get(resolvedSlotId) ?? (adUnitCode ? this.slotRefreshIndices.get(adUnitCode) : void 0) ?? (rec ? rec.refreshIndex : 0) : 0);
+    const alreadyEmitted = resolvedSlotId && this.hasImpressionEmitted(resolvedSlotId, currentRefreshIndex, auctionId, creativeId) || adUnitCode && adUnitCode !== resolvedSlotId && this.hasImpressionEmitted(adUnitCode, currentRefreshIndex, auctionId, creativeId);
+    if (alreadyEmitted) {
+      this.log(
+        "DEBUG",
+        `Impression already emitted for slot ${resolvedSlotId || adUnitCode} in cycle ${currentRefreshIndex}`
+      );
+      return false;
+    }
+    if (resolvedSlotId)
+      this.markImpressionEmitted(resolvedSlotId, currentRefreshIndex, auctionId, creativeId);
+    if (adUnitCode && adUnitCode !== resolvedSlotId)
+      this.markImpressionEmitted(adUnitCode, currentRefreshIndex, auctionId, creativeId);
+    this.enqueue(TraceEventType.IMPRESSION, "impression", {
+      auctionId,
+      transactionId,
+      adUnitCode,
+      bid: bidTrace,
+      metadata: {
+        ...options?.metadata,
+        refresh_index: String(currentRefreshIndex)
+      }
+    });
+    if (rec) {
+      if (!rec.bidPayload && bidTrace) rec.bidPayload = bidTrace;
+      if (!rec.auctionId && auctionId) rec.auctionId = auctionId;
+      if (!rec.transactionId && transactionId) rec.transactionId = transactionId;
+    }
+    return true;
+  }
+  /**
+   * Bridges Google IMA SDK AdsManager events to Bidkernel analytics.
+   * Defers IMPRESSION emission until AdEvent.STARTED (or IMPRESSION),
+   * tracks milestones (FIRST_QUARTILE, MIDPOINT, THIRD_QUARTILE, COMPLETE),
+   * and handles AD_ERROR.
+   */
+  attachImaAdsManager(adsManager, options) {
+    if (!adsManager || typeof adsManager.addEventListener !== "function") {
+      this.log("WARN", "Invalid AdsManager passed to attachImaAdsManager");
+      return () => {
+      };
+    }
+    const slotId = options?.slotId || options?.adUnitCode || "video";
+    const adUnitCode = options?.adUnitCode || slotId;
+    const auctionId = options?.auctionId || "";
+    const transactionId = options?.transactionId || "";
+    const getWinningBid = () => {
+      return (auctionId ? this.cachedWinningBids.get(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.cachedWinningBids.get(`${auctionId}:${slotId}`) : void 0) || this.cachedWinningBids.get(adUnitCode) || (slotId !== adUnitCode ? this.cachedWinningBids.get(slotId) : void 0);
+    };
+    const onAdStartedOrImpression = (event) => {
+      this.log("DEBUG", "IMA AdEvent.STARTED / IMPRESSION received", event);
+      const ad = typeof event?.getAd === "function" ? event.getAd() : event?.ad;
+      const adData = {};
+      if (ad) {
+        adData.creativeId = (typeof ad.getCreativeId === "function" ? ad.getCreativeId() : ad.creativeId) || "";
+        adData.adId = (typeof ad.getAdId === "function" ? ad.getAdId() : ad.id) || "";
+        adData.title = (typeof ad.getTitle === "function" ? ad.getTitle() : ad.title) || "";
+        adData.duration = typeof ad.getDuration === "function" ? ad.getDuration() : ad.duration;
+        adData.advertiserName = typeof ad.getAdvertiserName === "function" ? ad.getAdvertiserName() : "";
+      }
+      const cached = getWinningBid();
+      const mergedBid = {
+        ...cached?.rawBid || options?.bid,
+        mediaType: "video",
+        creativeId: adData.creativeId || cached?.bidTrace?.creativeId || options?.bid?.creativeId || ""
+      };
+      const emitted = this.recordImpression(slotId, {
+        adUnitCode,
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        mediaType: "video",
+        bid: mergedBid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video",
+          ...adData.title ? { ad_title: adData.title } : {},
+          ...Number.isFinite(adData.duration) ? { ad_duration_s: String(adData.duration) } : {}
+        }
+      });
+      if (emitted && options?.onImpression) {
+        try {
+          options.onImpression(slotId, { ad, bid: mergedBid });
+        } catch (e) {
+          this.log("ERROR", "Error in onImpression callback", e);
+        }
+      }
+    };
+    const onMilestone = (milestone) => {
+      this.log("DEBUG", `IMA AdEvent milestone: ${milestone}`);
+      if (options?.onMilestone) {
+        try {
+          options.onMilestone(milestone, slotId);
+        } catch (e) {
+          this.log("ERROR", "Error in onMilestone callback", e);
+        }
+      }
+    };
+    const onAdClick = (event) => {
+      this.log("DEBUG", "IMA AdEvent.CLICK received", event);
+      const cached = getWinningBid();
+      this.enqueue(TraceEventType.CLICK, "click", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video"
+        }
+      });
+    };
+    const onAdError = (event) => {
+      this.log("WARN", "IMA AdErrorEvent received", event);
+      const err = typeof event?.getError === "function" ? event.getError() : event?.error || event;
+      const msg = (err && typeof err.getMessage === "function" ? err.getMessage() : err?.message) || String(err || "IMA ad error");
+      const code = (err && typeof err.getErrorCode === "function" ? err.getErrorCode() : err?.code) || "";
+      const cached = getWinningBid();
+      this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          reason: "ima_ad_error",
+          message: msg,
+          ...code ? { ima_error_code: String(code) } : {}
+        },
+        error: typeof err === "object" ? err : new Error(msg)
+      });
+      if (options?.onError) {
+        try {
+          options.onError(err);
+        } catch (e) {
+          this.log("ERROR", "Error in onError callback", e);
+        }
+      }
+    };
+    const googleIma = typeof window !== "undefined" ? window.google?.ima : void 0;
+    const adEventType = googleIma?.AdEvent?.Type || {};
+    const adErrorEventType = googleIma?.AdErrorEvent?.Type || {};
+    const listeners = [
+      { type: adEventType.STARTED || "started", handler: onAdStartedOrImpression },
+      { type: adEventType.IMPRESSION || "impression", handler: onAdStartedOrImpression },
+      {
+        type: adEventType.FIRST_QUARTILE || "firstQuartile",
+        handler: () => onMilestone("firstQuartile")
+      },
+      { type: adEventType.MIDPOINT || "midpoint", handler: () => onMilestone("midpoint") },
+      {
+        type: adEventType.THIRD_QUARTILE || "thirdQuartile",
+        handler: () => onMilestone("thirdQuartile")
+      },
+      { type: adEventType.COMPLETE || "complete", handler: () => onMilestone("complete") },
+      { type: adEventType.CLICK || "click", handler: onAdClick },
+      { type: adErrorEventType.AD_ERROR || "adError", handler: onAdError }
+    ];
+    for (const { type, handler } of listeners) {
+      try {
+        adsManager.addEventListener(type, handler);
+      } catch {
+      }
+    }
+    const cleanup = () => {
+      for (const { type, handler } of listeners) {
+        try {
+          adsManager.removeEventListener(type, handler);
+        } catch {
+        }
+      }
+      this.videoDetachCleanups.delete(cleanup);
+    };
+    this.videoDetachCleanups.add(cleanup);
+    return cleanup;
+  }
+  /**
+   * Attaches render hooks and viewability tracking to a video player.
+   * Supports HTML5 <video> elements, container elements, or Google IMA AdsManager.
+   */
+  attachVideoPlayer(target, options) {
+    if (!target) {
+      this.log("WARN", "attachVideoPlayer called with null/undefined target");
+      return () => {
+      };
+    }
+    let el = null;
+    if (typeof target === "string") {
+      if (typeof document !== "undefined") {
+        try {
+          el = document.querySelector(target) || document.getElementById(target);
+        } catch {
+          el = document.getElementById(target);
+        }
+      }
+    } else if (typeof HTMLElement !== "undefined" && target instanceof HTMLElement) {
+      el = target;
+    } else if (target && typeof target === "object" && target.nodeType === 1) {
+      el = target;
+    } else if (
+      // Check if target is an IMA AdsManager
+      typeof target.addEventListener === "function" && (typeof target.init === "function" || typeof target.start === "function" || typeof target.getCuePoints === "function" || typeof target.getVolume === "function" || target.__imaAdsManager)
+    ) {
+      return this.attachImaAdsManager(target, options);
+    } else if (target && typeof target.addEventListener === "function") {
+      el = target;
+    }
+    const slotId = options?.slotId || options?.adUnitCode || (el ? el.id : "") || "video";
+    const adUnitCode = options?.adUnitCode || slotId;
+    const auctionId = options?.auctionId || "";
+    const transactionId = options?.transactionId || "";
+    const getWinningBid = () => {
+      return (auctionId ? this.cachedWinningBids.get(`${auctionId}:${adUnitCode}`) : void 0) || (auctionId && slotId !== adUnitCode ? this.cachedWinningBids.get(`${auctionId}:${slotId}`) : void 0) || this.cachedWinningBids.get(adUnitCode) || (slotId !== adUnitCode ? this.cachedWinningBids.get(slotId) : void 0);
+    };
+    let videoEl = null;
+    if (el) {
+      if (el.tagName && el.tagName.toLowerCase() === "video") {
+        videoEl = el;
+      } else {
+        videoEl = el.querySelector("video");
+      }
+    }
+    const quartilesFired = {
+      q1: false,
+      q2: false,
+      q3: false,
+      q4: false
+    };
+    const triggerPlaybackImpression = (activeVideo) => {
+      const vEl = activeVideo || videoEl || (el?.querySelector ? el.querySelector("video") : null);
+      const cached = getWinningBid();
+      const mergedBid = {
+        ...cached?.rawBid || options?.bid,
+        mediaType: "video"
+      };
+      const emitted = this.recordImpression(slotId, {
+        adUnitCode,
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        mediaType: "video",
+        bid: mergedBid,
+        metadata: {
+          ...options?.metadata,
+          media_type: "video",
+          ...vEl && Number.isFinite(vEl.duration) ? { video_duration_s: String(Math.round(vEl.duration)) } : {}
+        }
+      });
+      if (emitted && options?.onImpression) {
+        try {
+          options.onImpression(slotId, { element: vEl || el, bid: mergedBid });
+        } catch (e) {
+          this.log("ERROR", "Error in onImpression callback", e);
+        }
+      }
+    };
+    const handlePlaying = (e) => {
+      this.log("DEBUG", "HTML5 video playing event received");
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      triggerPlaybackImpression(targetVideo);
+    };
+    const handleTimeUpdate = (e) => {
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      if (targetVideo && targetVideo.currentTime > 0) {
+        triggerPlaybackImpression(targetVideo);
+        if (Number.isFinite(targetVideo.duration) && targetVideo.duration > 0) {
+          const progress = targetVideo.currentTime / targetVideo.duration;
+          if (progress >= 0.25 && !quartilesFired.q1) {
+            quartilesFired.q1 = true;
+            options?.onMilestone?.("firstQuartile", slotId);
+          }
+          if (progress >= 0.5 && !quartilesFired.q2) {
+            quartilesFired.q2 = true;
+            options?.onMilestone?.("midpoint", slotId);
+          }
+          if (progress >= 0.75 && !quartilesFired.q3) {
+            quartilesFired.q3 = true;
+            options?.onMilestone?.("thirdQuartile", slotId);
+          }
+        }
+      }
+    };
+    const handleEnded = () => {
+      if (!quartilesFired.q4) {
+        quartilesFired.q4 = true;
+        options?.onMilestone?.("complete", slotId);
+      }
+    };
+    const handleError = (e) => {
+      const targetVideo = e?.target instanceof HTMLVideoElement ? e.target : videoEl;
+      const err = targetVideo?.error || videoEl?.error;
+      const cached = getWinningBid();
+      const msg = err ? `HTML5 video error code ${err.code}: ${err.message}` : "Video playback error";
+      this.log("WARN", msg);
+      this.enqueue(TraceEventType.AD_RENDER_FAILED, "adRenderFailed", {
+        auctionId: auctionId || cached?.auctionId,
+        transactionId: transactionId || cached?.transactionId,
+        adUnitCode,
+        bid: cached?.bidTrace || options?.bid,
+        metadata: {
+          ...options?.metadata,
+          reason: "html5_video_error",
+          message: msg,
+          ...err?.code ? { video_error_code: String(err.code) } : {}
+        },
+        error: err ? new Error(msg) : void 0
+      });
+      if (options?.onError) {
+        try {
+          options.onError(err);
+        } catch (e2) {
+          this.log("ERROR", "Error in onError callback", e2);
+        }
+      }
+    };
+    const attachListenersToVideo = (targetVideo) => {
+      targetVideo.addEventListener("playing", handlePlaying);
+      targetVideo.addEventListener("play", handlePlaying);
+      targetVideo.addEventListener("timeupdate", handleTimeUpdate);
+      targetVideo.addEventListener("ended", handleEnded);
+      targetVideo.addEventListener("error", handleError);
+    };
+    const removeListenersFromVideo = (targetVideo) => {
+      targetVideo.removeEventListener("playing", handlePlaying);
+      targetVideo.removeEventListener("play", handlePlaying);
+      targetVideo.removeEventListener("timeupdate", handleTimeUpdate);
+      targetVideo.removeEventListener("ended", handleEnded);
+      targetVideo.removeEventListener("error", handleError);
+    };
+    let mutationObserver = null;
+    if (el && el !== videoEl) {
+      el.addEventListener("playing", handlePlaying, true);
+      el.addEventListener("play", handlePlaying, true);
+      el.addEventListener("timeupdate", handleTimeUpdate, true);
+      el.addEventListener("ended", handleEnded, true);
+      el.addEventListener("error", handleError, true);
+    }
+    if (videoEl) {
+      attachListenersToVideo(videoEl);
+    }
+    if (el && el.tagName?.toLowerCase() !== "video" && typeof MutationObserver !== "undefined") {
+      mutationObserver = new MutationObserver(() => {
+        const found = el.querySelector("video");
+        if (found && found !== videoEl) {
+          if (videoEl) removeListenersFromVideo(videoEl);
+          videoEl = found;
+          if (videoEl) attachListenersToVideo(videoEl);
+        }
+      });
+      mutationObserver.observe(el, { childList: true, subtree: true });
+    }
+    const cachedInitial = getWinningBid();
+    if (options?.trackViewability !== false && el) {
+      this.observeSlot(el, slotId, {
+        adUnitCode,
+        auctionId: auctionId || cachedInitial?.auctionId,
+        transactionId: transactionId || cachedInitial?.transactionId,
+        mediaType: "video",
+        bid: cachedInitial?.bidTrace || options?.bid,
+        metadata: options?.metadata,
+        emitRefreshEvent: false
+      });
+    }
+    const cleanup = () => {
+      if (mutationObserver) {
+        mutationObserver.disconnect();
+        mutationObserver = null;
+      }
+      if (el && el !== videoEl) {
+        el.removeEventListener("playing", handlePlaying, true);
+        el.removeEventListener("play", handlePlaying, true);
+        el.removeEventListener("timeupdate", handleTimeUpdate, true);
+        el.removeEventListener("ended", handleEnded, true);
+        el.removeEventListener("error", handleError, true);
+      }
+      if (videoEl) {
+        removeListenersFromVideo(videoEl);
+      }
+      this.videoDetachCleanups.delete(cleanup);
+    };
+    this.videoDetachCleanups.add(cleanup);
+    return cleanup;
   }
   onTimeInViewThreshold(slotId, thresholdMs, callback) {
     const listener = {
@@ -1607,21 +2108,45 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
   handleBidWon(data) {
     if (this.isDuplicate("bidWon", data)) return;
     this.log("DEBUG", "bidWon", data);
-    this.enqueue(TraceEventType.BID_WIN, "bidWon", {
-      auctionId: data.auctionId || "",
-      transactionId: data.transactionId || "",
-      adUnitCode: data.adUnitCode || "",
-      bid: {
-        bidder: data.bidderCode || data.bidder || "",
-        cpm: Number.isFinite(data.originalCpm) ? data.originalCpm : Number.isFinite(data.cpm) ? data.cpm : 0,
-        currency: data.originalCurrency ?? data.currency ?? "USD",
-        ...parseBidDimensions(data),
-        dealId: data.dealId || "",
-        mediaType: data.mediaType || "banner",
-        latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
-        advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
-        creativeId: data.creativeId || ""
+    const auctionId = data.auctionId || "";
+    const transactionId = data.transactionId || "";
+    const adUnitCode = data.adUnitCode || data.adId || "";
+    const bidTrace = {
+      bidder: data.bidderCode || data.bidder || "",
+      cpm: Number.isFinite(data.originalCpm) ? data.originalCpm : Number.isFinite(data.cpm) ? data.cpm : 0,
+      currency: data.originalCurrency ?? data.currency ?? "USD",
+      ...parseBidDimensions(data),
+      dealId: data.dealId || "",
+      mediaType: data.mediaType || "banner",
+      latencyMs: Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0,
+      advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
+      creativeId: data.creativeId || ""
+    };
+    if (adUnitCode) {
+      const cachedEntry = {
+        bidTrace,
+        auctionId,
+        transactionId,
+        adUnitCode,
+        rawBid: data,
+        timestamp: Date.now()
+      };
+      this.cachedWinningBids.set(adUnitCode, cachedEntry);
+      if (data.adId && data.adId !== adUnitCode) {
+        this.cachedWinningBids.set(data.adId, cachedEntry);
       }
+      if (auctionId) {
+        this.cachedWinningBids.set(`${auctionId}:${adUnitCode}`, cachedEntry);
+        if (data.adId && data.adId !== adUnitCode) {
+          this.cachedWinningBids.set(`${auctionId}:${data.adId}`, cachedEntry);
+        }
+      }
+    }
+    this.enqueue(TraceEventType.BID_WIN, "bidWon", {
+      auctionId,
+      transactionId,
+      adUnitCode,
+      bid: bidTrace
     });
   }
   handleNoBid(data) {
@@ -1660,44 +2185,81 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (this.isDuplicate("adRenderSucceeded", data)) return;
     this.log("DEBUG", "adRenderSucceeded", data);
     const bid = data.bid || data || {};
-    const adUnitCode = data.adUnitCode || bid.adUnitCode || "";
+    const adUnitCode = data.adUnitCode || bid.adUnitCode || data.adId || bid.adId || "";
     const auctionId = bid.auctionId || data.auctionId || "";
     const transactionId = bid.transactionId || data.transactionId || "";
     const mediaType = bid.mediaType || "banner";
+    const slotKey = data.adUnitCode || bid.adUnitCode || "";
+    const altKey = data.adId || bid.adId || "";
+    const cached = (auctionId && slotKey ? this.cachedWinningBids.get(`${auctionId}:${slotKey}`) : void 0) || (auctionId && altKey ? this.cachedWinningBids.get(`${auctionId}:${altKey}`) : void 0) || (slotKey ? this.cachedWinningBids.get(slotKey) : void 0) || (altKey ? this.cachedWinningBids.get(altKey) : void 0);
     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 || ""
+      bidder: bid.bidderCode || bid.bidder || cached?.bidTrace?.bidder || "",
+      cpm: Number.isFinite(bid.originalCpm) ? bid.originalCpm : Number.isFinite(bid.cpm) ? bid.cpm : cached?.bidTrace?.cpm ?? 0,
+      currency: bid.originalCurrency ?? bid.currency ?? cached?.bidTrace?.currency ?? "USD",
+      ...parseBidDimensions(bid).width ? parseBidDimensions(bid) : cached?.bidTrace ? { width: cached.bidTrace.width, height: cached.bidTrace.height } : parseBidDimensions(bid),
+      dealId: bid.dealId || cached?.bidTrace?.dealId || "",
+      mediaType: mediaType || cached?.bidTrace?.mediaType || "banner",
+      latencyMs: Number.isFinite(bid.timeToRespond) ? bid.timeToRespond : cached?.bidTrace?.latencyMs ?? 0,
+      advertiserDomain: bid.meta?.advertiserDomains?.[0] || cached?.bidTrace?.advertiserDomain || "",
+      creativeId: bid.creativeId || cached?.bidTrace?.creativeId || ""
     };
-    const isRefresh = adUnitCode && (this.slotViewabilityRecords.has(adUnitCode) || this.slotRefreshIndices.has(adUnitCode) && this.slotRefreshIndices.get(adUnitCode) > 0);
+    const resolvedAuctionId = auctionId || cached?.auctionId || "";
+    const resolvedTransactionId = transactionId || cached?.transactionId || "";
+    const record = adUnitCode ? this.slotViewabilityRecords.get(adUnitCode) : void 0;
+    const isDifferentAuction = record && resolvedAuctionId && record.auctionId && record.auctionId !== resolvedAuctionId;
+    const isRefresh = Boolean(adUnitCode && record && isDifferentAuction);
     if (isRefresh) {
       this.flushSlotTimeInView(adUnitCode);
-      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? 0) + 1;
+      const nextRefreshIndex = (this.slotRefreshIndices.get(adUnitCode) ?? (record ? record.refreshIndex : 0)) + 1;
       this.slotRefreshIndices.set(adUnitCode, nextRefreshIndex);
+      this.slotLastAuctionIds.set(adUnitCode, resolvedAuctionId);
+      if (record) {
+        record.refreshIndex = nextRefreshIndex;
+        record.auctionId = resolvedAuctionId;
+        record.transactionId = resolvedTransactionId;
+        record.bidPayload = bidTrace;
+        record.viewableFired = false;
+        record.accumulatedTimeInViewMs = 0;
+      }
       this.enqueue(TraceEventType.REFRESH, "refresh", {
-        auctionId,
-        transactionId,
+        auctionId: resolvedAuctionId,
+        transactionId: resolvedTransactionId,
         adUnitCode,
         bid: bidTrace,
         metadata: { refresh_index: String(nextRefreshIndex) }
       });
-    } else if (adUnitCode && !this.slotRefreshIndices.has(adUnitCode)) {
-      this.slotRefreshIndices.set(adUnitCode, 0);
+    } else if (adUnitCode) {
+      if (resolvedAuctionId) {
+        this.slotLastAuctionIds.set(adUnitCode, resolvedAuctionId);
+      }
+      if (!this.slotRefreshIndices.has(adUnitCode)) {
+        this.slotRefreshIndices.set(adUnitCode, 0);
+      }
     }
-    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? 0 : 0;
-    this.enqueue(TraceEventType.IMPRESSION, "impression", {
-      auctionId,
-      transactionId,
+    const currentRefreshIndex = adUnitCode ? this.slotRefreshIndices.get(adUnitCode) ?? (record ? record.refreshIndex : 0) : 0;
+    const alreadyEmitted = adUnitCode ? this.hasImpressionEmitted(
       adUnitCode,
-      bid: bidTrace,
-      metadata: { refresh_index: String(currentRefreshIndex) }
-    });
+      currentRefreshIndex,
+      resolvedAuctionId,
+      bidTrace.creativeId
+    ) : false;
+    if (!alreadyEmitted) {
+      if (adUnitCode) {
+        this.markImpressionEmitted(
+          adUnitCode,
+          currentRefreshIndex,
+          resolvedAuctionId,
+          bidTrace.creativeId
+        );
+      }
+      this.enqueue(TraceEventType.IMPRESSION, "impression", {
+        auctionId: resolvedAuctionId,
+        transactionId: resolvedTransactionId,
+        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;
@@ -1725,8 +2287,8 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       if (el) {
         this.observeSlot(el, adUnitCode || targetId, {
           adUnitCode,
-          auctionId,
-          transactionId,
+          auctionId: resolvedAuctionId,
+          transactionId: resolvedTransactionId,
           mediaType,
           bid: bidTrace,
           refreshIndex: currentRefreshIndex,
@@ -1968,7 +2530,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (this.persistedCleanupTimer) clearTimeout(this.persistedCleanupTimer);
     this.persistedCleanupTimer = setTimeout(() => {
       this.persistedCleanupTimer = null;
-      for (const key of [...this.persistedBatchKeys]) {
+      for (const key of Array.from(this.persistedBatchKeys)) {
         this.removePersistedBatch(key);
       }
     }, PENDING_BATCH_CLEANUP_DELAY_MS);
@@ -2138,7 +2700,28 @@ function getbidkernel(alias = "bidkernel") {
   }
   const win = window;
   win[alias] = win[alias] || { q: [] };
-  return win[alias];
+  const sdk = win[alias];
+  if (!sdk.attachVideoPlayer) {
+    sdk.attachVideoPlayer = (target, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.attachVideoPlayer ? inst.attachVideoPlayer(target, options) : () => {
+      };
+    };
+  }
+  if (!sdk.attachImaAdsManager) {
+    sdk.attachImaAdsManager = (adsManager, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.attachImaAdsManager ? inst.attachImaAdsManager(adsManager, options) : () => {
+      };
+    };
+  }
+  if (!sdk.recordImpression) {
+    sdk.recordImpression = (slotId, options) => {
+      const inst = win._bidkernelPrebidAnalytics;
+      return inst?.recordImpression ? inst.recordImpression(slotId, options) : false;
+    };
+  }
+  return sdk;
 }
 export {
   BidkernelPrebidAnalytics,