@bidkernel/analytics 0.18.0 → 0.20.0

package/dist/index.mjs

@@ -290,7 +290,6 @@ var TraceEventType = {
   TRACE_EVENT_TYPE_UNSPECIFIED: 0,
   AUCTION_START: 1,
   AUCTION_END: 2,
-  BID_RESPONSE: 3,
   BID_WIN: 4,
   /** IMPRESSION - ad rendered into DOM */
   IMPRESSION: 5,
@@ -298,7 +297,6 @@ var TraceEventType = {
   VIEWABLE: 6,
   /** TIME_IN_VIEW - accumulated in-viewport duration (once per render cycle end) */
   TIME_IN_VIEW: 7,
-  REFRESH: 8,
   ERROR: 9,
   SLOT_DEFINED: 10,
   SLOT_DESTROYED: 11,
@@ -321,14 +319,14 @@ var BidderOutcome = {
 };
 function createBaseTraceEventBatch() {
   return {
-    propertyId: "",
-    pageviewId: "",
-    sessionId: "",
+    propertyId: new Uint8Array(0),
+    pageviewId: new Uint8Array(0),
+    sessionId: new Uint8Array(0),
     pageUrl: "",
     country: "",
     region: "",
     deviceType: "",
-    userId: "",
+    userId: new Uint8Array(0),
     domain: "",
     events: [],
     browser: "",
@@ -340,14 +338,14 @@ function createBaseTraceEventBatch() {
 }
 var TraceEventBatch = {
   encode(message, writer = new BinaryWriter()) {
-    if (message.propertyId !== void 0 && message.propertyId !== "") {
-      writer.uint32(10).string(message.propertyId);
+    if (message.propertyId !== void 0 && message.propertyId.length !== 0) {
+      writer.uint32(10).bytes(message.propertyId);
     }
-    if (message.pageviewId !== void 0 && message.pageviewId !== "") {
-      writer.uint32(18).string(message.pageviewId);
+    if (message.pageviewId !== void 0 && message.pageviewId.length !== 0) {
+      writer.uint32(18).bytes(message.pageviewId);
     }
-    if (message.sessionId !== void 0 && message.sessionId !== "") {
-      writer.uint32(26).string(message.sessionId);
+    if (message.sessionId !== void 0 && message.sessionId.length !== 0) {
+      writer.uint32(26).bytes(message.sessionId);
     }
     if (message.pageUrl !== void 0 && message.pageUrl !== "") {
       writer.uint32(34).string(message.pageUrl);
@@ -361,8 +359,8 @@ var TraceEventBatch = {
     if (message.deviceType !== void 0 && message.deviceType !== "") {
       writer.uint32(58).string(message.deviceType);
     }
-    if (message.userId !== void 0 && message.userId !== "") {
-      writer.uint32(66).string(message.userId);
+    if (message.userId !== void 0 && message.userId.length !== 0) {
+      writer.uint32(66).bytes(message.userId);
     }
     if (message.domain !== void 0 && message.domain !== "") {
       writer.uint32(74).string(message.domain);
@@ -400,21 +398,21 @@ var TraceEventBatch = {
           if (tag !== 10) {
             break;
           }
-          message.propertyId = reader.string();
+          message.propertyId = reader.bytes();
           continue;
         }
         case 2: {
           if (tag !== 18) {
             break;
           }
-          message.pageviewId = reader.string();
+          message.pageviewId = reader.bytes();
           continue;
         }
         case 3: {
           if (tag !== 26) {
             break;
           }
-          message.sessionId = reader.string();
+          message.sessionId = reader.bytes();
           continue;
         }
         case 4: {
@@ -449,7 +447,7 @@ var TraceEventBatch = {
           if (tag !== 66) {
             break;
           }
-          message.userId = reader.string();
+          message.userId = reader.bytes();
           continue;
         }
         case 9: {
@@ -518,12 +516,12 @@ function createBaseTraceEvent() {
     timestampMs: 0,
     type: 0,
     eventName: "",
-    auctionId: "",
-    transactionId: "",
+    auctionId: new Uint8Array(0),
+    transactionId: new Uint8Array(0),
     adUnitCode: "",
     bid: void 0,
     namespace: "",
-    eventId: "",
+    eventId: new Uint8Array(0),
     metadata: {},
     viewableDurationMs: void 0,
     bidderOutcomes: []
@@ -540,11 +538,11 @@ var TraceEvent = {
     if (message.eventName !== void 0 && message.eventName !== "") {
       writer.uint32(26).string(message.eventName);
     }
-    if (message.auctionId !== void 0 && message.auctionId !== "") {
-      writer.uint32(34).string(message.auctionId);
+    if (message.auctionId !== void 0 && message.auctionId.length !== 0) {
+      writer.uint32(34).bytes(message.auctionId);
     }
-    if (message.transactionId !== void 0 && message.transactionId !== "") {
-      writer.uint32(42).string(message.transactionId);
+    if (message.transactionId !== void 0 && message.transactionId.length !== 0) {
+      writer.uint32(42).bytes(message.transactionId);
     }
     if (message.adUnitCode !== void 0 && message.adUnitCode !== "") {
       writer.uint32(50).string(message.adUnitCode);
@@ -555,8 +553,8 @@ var TraceEvent = {
     if (message.namespace !== void 0 && message.namespace !== "") {
       writer.uint32(66).string(message.namespace);
     }
-    if (message.eventId !== void 0 && message.eventId !== "") {
-      writer.uint32(74).string(message.eventId);
+    if (message.eventId !== void 0 && message.eventId.length !== 0) {
+      writer.uint32(74).bytes(message.eventId);
     }
     globalThis.Object.entries(message.metadata || {}).forEach(([key, value]) => {
       TraceEvent_MetadataEntry.encode({ key, value }, writer.uint32(82).fork()).join();
@@ -603,14 +601,14 @@ var TraceEvent = {
           if (tag !== 34) {
             break;
           }
-          message.auctionId = reader.string();
+          message.auctionId = reader.bytes();
           continue;
         }
         case 5: {
           if (tag !== 42) {
             break;
           }
-          message.transactionId = reader.string();
+          message.transactionId = reader.bytes();
           continue;
         }
         case 6: {
@@ -638,7 +636,7 @@ var TraceEvent = {
           if (tag !== 74) {
             break;
           }
-          message.eventId = reader.string();
+          message.eventId = reader.bytes();
           continue;
         }
         case 10: {
@@ -721,24 +719,21 @@ var TraceEvent_MetadataEntry = {
   }
 };
 function createBaseBidderOutcomeEntry() {
-  return { bidder: "", adUnitCode: "", mediaType: "", outcome: 0, latencyMs: 0 };
+  return { adUnitCode: "", outcome: 0, bid: void 0, refreshIndex: 0 };
 }
 var BidderOutcomeEntry = {
   encode(message, writer = new BinaryWriter()) {
-    if (message.bidder !== void 0 && message.bidder !== "") {
-      writer.uint32(10).string(message.bidder);
-    }
     if (message.adUnitCode !== void 0 && message.adUnitCode !== "") {
       writer.uint32(18).string(message.adUnitCode);
     }
-    if (message.mediaType !== void 0 && message.mediaType !== "") {
-      writer.uint32(26).string(message.mediaType);
-    }
     if (message.outcome !== void 0 && message.outcome !== 0) {
       writer.uint32(32).int32(message.outcome);
     }
-    if (message.latencyMs !== void 0 && message.latencyMs !== 0) {
-      writer.uint32(41).double(message.latencyMs);
+    if (message.bid !== void 0) {
+      BidTrace.encode(message.bid, writer.uint32(50).fork()).join();
+    }
+    if (message.refreshIndex !== void 0 && message.refreshIndex !== 0) {
+      writer.uint32(56).int32(message.refreshIndex);
     }
     return writer;
   },
@@ -749,13 +744,6 @@ var BidderOutcomeEntry = {
     while (reader.pos < end) {
       const tag = reader.uint32();
       switch (tag >>> 3) {
-        case 1: {
-          if (tag !== 10) {
-            break;
-          }
-          message.bidder = reader.string();
-          continue;
-        }
         case 2: {
           if (tag !== 18) {
             break;
@@ -763,25 +751,25 @@ var BidderOutcomeEntry = {
           message.adUnitCode = reader.string();
           continue;
         }
-        case 3: {
-          if (tag !== 26) {
+        case 4: {
+          if (tag !== 32) {
             break;
           }
-          message.mediaType = reader.string();
+          message.outcome = reader.int32();
           continue;
         }
-        case 4: {
-          if (tag !== 32) {
+        case 6: {
+          if (tag !== 50) {
             break;
           }
-          message.outcome = reader.int32();
+          message.bid = BidTrace.decode(reader, reader.uint32());
           continue;
         }
-        case 5: {
-          if (tag !== 41) {
+        case 7: {
+          if (tag !== 56) {
             break;
           }
-          message.latencyMs = reader.double();
+          message.refreshIndex = reader.int32();
           continue;
         }
       }
@@ -928,8 +916,28 @@ var BidTrace = {
   }
 };
 
+// src/ids.ts
+var CANONICAL_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+var UUID_BYTES = 16;
+var utf8Encoder = typeof TextEncoder !== "undefined" ? new TextEncoder() : null;
+var utf8Decoder = typeof TextDecoder !== "undefined" ? new TextDecoder() : null;
+function idToBytes(id) {
+  if (!id) return new Uint8Array(0);
+  if (CANONICAL_UUID.test(id)) {
+    const hex = id.replace(/-/g, "");
+    const out2 = new Uint8Array(UUID_BYTES);
+    for (let i = 0; i < UUID_BYTES; i++) {
+      out2[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out2;
+  }
+  if (utf8Encoder) return utf8Encoder.encode(id);
+  const out = new Uint8Array(id.length);
+  for (let i = 0; i < id.length; i++) out[i] = id.charCodeAt(i) & 255;
+  return out;
+}
+
 // src/prebid-analytics.ts
-var BATCH_SIZE = 20;
 var FLUSH_INTERVAL_MS = 1e4;
 var MAX_ERRORS_PER_SESSION = 50;
 var MAX_QUEUE_SIZE = 200;
@@ -946,12 +954,10 @@ var PENDING_BATCH_CLEANUP_DELAY_MS = 1e4;
 var EVENT_NAME_TO_TYPE = {
   auctionStart: TraceEventType.AUCTION_START,
   auctionEnd: TraceEventType.AUCTION_END,
-  bidResponse: TraceEventType.BID_RESPONSE,
   bidWin: TraceEventType.BID_WIN,
   adRenderFailed: TraceEventType.AD_RENDER_FAILED,
   click: TraceEventType.CLICK,
   impression: TraceEventType.IMPRESSION,
-  refresh: TraceEventType.REFRESH,
   timeInView: TraceEventType.TIME_IN_VIEW,
   viewable: TraceEventType.VIEWABLE
 };
@@ -1615,8 +1621,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const record = this.slotViewabilityRecords.get(slotId);
     if (record && record.element !== element) {
       this.observeSlot(element, slotId, {
-        refreshIndex: record.refreshIndex,
-        emitRefreshEvent: false
+        refreshIndex: record.refreshIndex
       });
     }
   }
@@ -1804,18 +1809,6 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         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;
@@ -2078,16 +2071,6 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         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);
@@ -2206,7 +2189,8 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     }
   }
   trackRawEvent(level, eventName, data) {
-    const eventType = EVENT_NAME_TO_TYPE[eventName] ?? (level === "ERROR" ? TraceEventType.ERROR : TraceEventType.TRACE_EVENT_TYPE_UNSPECIFIED);
+    const eventType = EVENT_NAME_TO_TYPE[eventName] ?? (level === "ERROR" ? TraceEventType.ERROR : void 0);
+    if (eventType === void 0) return;
     this.enqueue(eventType, eventName, data, level);
   }
   setUserId(userId) {
@@ -2262,6 +2246,19 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       bidderOutcomes
     });
   }
+  /**
+   * The render cycle an auction ending now would fill for an ad unit: 0 for
+   * a slot that has never rendered on this pageview, otherwise one past the
+   * cycle it last rendered. The index only advances when a creative renders,
+   * so two unfilled refresh auctions in a row report the same cycle; both
+   * count as refreshes, which is the point. Stamped on AUCTION_END bidder
+   * outcomes in enqueue; there is no per-refresh event.
+   */
+  auctionCycleIndex(adUnitCode) {
+    if (!adUnitCode) return 0;
+    const last = this.slotRefreshIndices.get(adUnitCode) ?? this.slotViewabilityRecords.get(adUnitCode)?.refreshIndex;
+    return last === void 0 ? 0 : last + 1;
+  }
   handleBidRequested(data) {
     if (this.isDuplicate("bidRequested", data)) return;
     this.log("DEBUG", "bidRequested", data);
@@ -2277,11 +2274,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         const key = `${bidder}:${adUnitCode}`;
         if (!auctionMap.has(key)) {
           auctionMap.set(key, {
-            bidder,
             adUnitCode,
-            mediaType,
             outcome: BidderOutcome.BIDDER_OUTCOME_NO_RESPONSE,
-            latencyMs: 0
+            bid: { bidder, mediaType, latencyMs: 0 }
           });
         }
       });
@@ -2297,43 +2292,23 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     const latencyMs = Number.isFinite(data.timeToRespond) ? data.timeToRespond : 0;
     const resMediaTypes = Object.keys(data.mediaTypes || {});
     const mediaType = data.mediaType || (data.mediaTypes?.video ? "video" : resMediaTypes.length > 0 ? resMediaTypes[0] : "banner");
-    if (auctionId && bidder) {
-      const auctionMap = this.getOrCreateAuctionOutcomes(auctionId);
-      const key = `${bidder}:${adUnitCode}`;
-      const entry = auctionMap.get(key);
-      const outcome = cpm > 0 ? BidderOutcome.BIDDER_OUTCOME_BID : BidderOutcome.BIDDER_OUTCOME_NO_BID;
-      if (entry) {
-        entry.outcome = outcome;
-        entry.latencyMs = latencyMs;
-        if (mediaType) entry.mediaType = mediaType;
-      } else {
-        auctionMap.set(key, {
-          bidder,
-          adUnitCode,
-          mediaType,
-          outcome,
-          latencyMs
-        });
-      }
-    }
-    if (cpm > 0) {
-      this.enqueue(TraceEventType.BID_RESPONSE, "bidResponse", {
-        auctionId,
-        transactionId: data.transactionId || "",
-        adUnitCode,
-        bid: {
-          bidder,
-          cpm,
-          currency: data.originalCurrency ?? data.currency ?? "USD",
-          ...parseBidDimensions(data),
-          dealId: data.dealId || "",
-          mediaType,
-          latencyMs,
-          advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
-          creativeId: data.creativeId || ""
-        }
-      });
-    }
+    if (!auctionId || !bidder) return;
+    const bid = cpm > 0 ? {
+      bidder,
+      cpm,
+      currency: data.originalCurrency ?? data.currency ?? "USD",
+      ...parseBidDimensions(data),
+      dealId: data.dealId || "",
+      mediaType,
+      latencyMs,
+      advertiserDomain: data.meta?.advertiserDomains?.[0] || "",
+      creativeId: data.creativeId || ""
+    } : { bidder, mediaType, latencyMs };
+    this.getOrCreateAuctionOutcomes(auctionId).set(`${bidder}:${adUnitCode}`, {
+      adUnitCode,
+      outcome: cpm > 0 ? BidderOutcome.BIDDER_OUTCOME_BID : BidderOutcome.BIDDER_OUTCOME_NO_BID,
+      bid
+    });
   }
   handleBidTimeout(data) {
     if (this.isDuplicate("bidTimeout", data)) return;
@@ -2350,14 +2325,12 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         const entry = auctionMap.get(key);
         if (entry) {
           entry.outcome = BidderOutcome.BIDDER_OUTCOME_TIMEOUT;
-          if (latencyMs > 0) entry.latencyMs = latencyMs;
+          if (latencyMs > 0 && entry.bid) entry.bid.latencyMs = latencyMs;
         } else {
           auctionMap.set(key, {
-            bidder,
             adUnitCode,
-            mediaType: "banner",
             outcome: BidderOutcome.BIDDER_OUTCOME_TIMEOUT,
-            latencyMs
+            bid: { bidder, mediaType: "banner", latencyMs }
           });
         }
       }
@@ -2426,11 +2399,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         }
       } else {
         auctionMap.set(key, {
-          bidder,
           adUnitCode,
-          mediaType: "banner",
           outcome: BidderOutcome.BIDDER_OUTCOME_NO_BID,
-          latencyMs: 0
+          bid: { bidder, mediaType: "banner", latencyMs: 0 }
         });
       }
     }
@@ -2497,13 +2468,6 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         record.viewableFired = false;
         record.accumulatedTimeInViewMs = 0;
       }
-      this.enqueue(TraceEventType.REFRESH, "refresh", {
-        auctionId: resolvedAuctionId,
-        transactionId: resolvedTransactionId,
-        adUnitCode,
-        bid: bidTrace,
-        metadata: { refresh_index: String(nextRefreshIndex) }
-      });
     } else if (adUnitCode) {
       if (resolvedAuctionId) {
         this.slotLastAuctionIds.set(adUnitCode, resolvedAuctionId);
@@ -2579,8 +2543,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
           transactionId: resolvedTransactionId,
           mediaType: resolvedMediaType,
           bid: bidTrace,
-          refreshIndex: currentRefreshIndex,
-          emitRefreshEvent: false
+          refreshIndex: currentRefreshIndex
         });
       }
     }
@@ -2593,12 +2556,14 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (!this.shouldSample(type, level)) return;
     extendSession();
     const protoEvent = {
-      eventId: generateUUID(),
+      eventId: idToBytes(generateUUID()),
       timestampMs: Date.now(),
       type,
-      eventName,
-      auctionId: data.auctionId || "",
-      transactionId: data.transactionId || "",
+      // Typed events have a fixed name that ingest derives from `type`; only
+      // ERROR events carry theirs, which names the failure.
+      eventName: type === TraceEventType.ERROR ? eventName : "",
+      auctionId: idToBytes(String(data.auctionId || "")),
+      transactionId: idToBytes(String(data.transactionId || "")),
       adUnitCode: data.adUnitCode || data.elementId || "",
       namespace: data.ns || data.namespace || ""
     };
@@ -2606,9 +2571,9 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       protoEvent.bid = {
         bidder: data.bid.bidder || "",
         cpm: Number.isFinite(data.bid.cpm) ? data.bid.cpm : 0,
-        // No defaults here: handlers with a priced bid (bidResponse, bidWon,
-        // impression) set currency/mediaType themselves. Defaulting for the
-        // rest would stamp fake "USD"/"banner" on noBid and bidRequest rows.
+        // No defaults here: handlers with a priced bid (bidWon, impression)
+        // set currency/mediaType themselves. Defaulting for the rest would
+        // stamp fake "USD"/"banner" on rows that carried no bid.
         currency: data.bid.currency || "",
         width: Number.isFinite(data.bid.width) ? data.bid.width : 0,
         height: Number.isFinite(data.bid.height) ? data.bid.height : 0,
@@ -2623,7 +2588,12 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       protoEvent.viewableDurationMs = Number.isFinite(data.viewableDurationMs) ? data.viewableDurationMs : 0;
     }
     if (data.bidderOutcomes && Array.isArray(data.bidderOutcomes)) {
-      protoEvent.bidderOutcomes = data.bidderOutcomes;
+      protoEvent.bidderOutcomes = data.bidderOutcomes.map(
+        (entry) => ({
+          ...entry,
+          refreshIndex: entry.refreshIndex ?? this.auctionCycleIndex(entry.adUnitCode || "")
+        })
+      );
     }
     const metadata = { ...data.metadata };
     if (data.error !== void 0 && data.error !== null) {
@@ -2640,11 +2610,11 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
       protoEvent.metadata = boundedMetadata;
     }
     this.queue.push(protoEvent);
-    if (this.queue.length > MAX_QUEUE_SIZE) {
-      this.queue.splice(0, this.queue.length - MAX_QUEUE_SIZE);
-    }
-    if (this.queue.length >= BATCH_SIZE) {
+    if (this.queue.length >= MAX_QUEUE_SIZE) {
       this.flush();
+      if (this.queue.length > MAX_QUEUE_SIZE) {
+        this.queue.splice(0, this.queue.length - MAX_QUEUE_SIZE);
+      }
     } else if (REVENUE_FLUSH_TYPES.has(type) && this.revenueFlushTimer === null) {
       this.revenueFlushTimer = setTimeout(() => {
         this.revenueFlushTimer = null;
@@ -2676,14 +2646,14 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
     if (this.queue.length === 0 || !this.config.endpoint) return null;
     const domain = typeof window !== "undefined" ? window.location.hostname : "";
     const buildBatch = (evts) => ({
-      propertyId: this.config.propertyId,
-      pageviewId: this.config.pageviewId,
-      sessionId: this.config.sessionId,
+      propertyId: idToBytes(this.config.propertyId),
+      pageviewId: idToBytes(this.config.pageviewId),
+      sessionId: idToBytes(this.config.sessionId),
       pageUrl: this.pageUrl,
       country: this.config.country,
       region: this.config.region,
       deviceType: this.config.deviceType,
-      userId: this.config.userId,
+      userId: idToBytes(this.config.userId),
       domain,
       events: evts
     });
@@ -2703,7 +2673,7 @@ var BidkernelPrebidAnalytics = class _BidkernelPrebidAnalytics {
         const [dropped] = this.queue.splice(0, 1);
         this.log(
           "WARN",
-          `Dropping oversized event ${dropped?.eventName || dropped?.eventId} (${encoded.byteLength} bytes exceeds the ${MAX_PAYLOAD_BYTES}-byte cap on its own)`
+          `Dropping oversized event (type ${dropped?.type}, ${encoded.byteLength} bytes exceeds the ${MAX_PAYLOAD_BYTES}-byte cap on its own)`
         );
         continue;
       }
@@ -3752,8 +3722,7 @@ function attachVideoPlayer(analytics, target, options) {
       transactionId: transactionId || cachedInitial?.transactionId,
       mediaType: "video",
       bid: cachedInitial?.bidTrace || options?.bid,
-      metadata: options?.metadata,
-      emitRefreshEvent: false
+      metadata: options?.metadata
     });
   }
   const cleanup = () => {

package/package.json

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