feat(prebid): enhance analytics with parsed user agent and device

Integrates the 'bowser' library to parse the raw user agent string into a
structured object, providing richer browser and OS information.
Includes OpenRTB2 device details in the auction end event payload.

Improves robustness of domain and EID extraction using nullish coalescing
to prevent errors from missing properties. Corrects a typo from 'cmp' to
'cpm' in the bid won event payload.

Author: dyachoksa

lib/addons/prebid/analytics.ts

@@ -3,6 +3,8 @@
 import type { WitnessProperties } from "../../edge/witness";
 import type OptableSDK from "../../sdk";
 
+import * as Bowser from "bowser";
+
 declare const SDK_WRAPPER_VERSION: string;
 
 declare global {
@@ -168,17 +170,9 @@ class OptablePrebidAnalytics {
       auctionId,
       timeout,
       bidderRequests: bidderRequests.map((br: any) => {
-        const {
-          bidderCode,
-          bidderRequestId,
-          ortb2: {
-            site: { domain },
-            user: {
-              ext: { eids },
-            },
-          },
-          bids = [],
-        } = br;
+        const { bidderCode, bidderRequestId, bids = [] } = br;
+        const domain = br.ortb2.site?.domain ?? "unknown";
+        const eids = br.ortb2.user?.eids ?? [];
 
         // Optable EIDs
         const optableEIDS = eids.filter((e: { inserter: string }) => e.inserter === "optable.co");
@@ -313,6 +307,8 @@ class OptablePrebidAnalytics {
     };
     this.log("bidWon filtered event", filteredEvent);
 
+    this.log("bidWon event", event);
+
     const auction = this.auctions.get(event.auctionId);
     if (!auction) {
       this.log("Missing 'auctionEnd' event. Skipping.");
@@ -356,17 +352,9 @@ class OptablePrebidAnalytics {
     let totalBids = 0;
 
     const requests = bidderRequests.map((br: any) => {
-      const {
-        bidderCode,
-        bidderRequestId,
-        ortb2: {
-          site: { domain },
-          user: {
-            ext: { eids },
-          },
-        },
-        bids = [],
-      } = br;
+      const { bidderCode, bidderRequestId, bids = [] } = br;
+      const domain = br.ortb2.site?.domain ?? "unknown";
+      const eids = br.ortb2.user?.eids ?? [];
 
       // Optable EIDs
       const optableEIDS = eids.filter((e: { inserter: string }) => e.inserter === "optable.co");
@@ -377,6 +365,7 @@ class OptablePrebidAnalytics {
         bidderCode,
         bidderRequestId,
         domain,
+        device: br.ortb2.device,
         optableTargetingDone: optableEIDS.length > 0,
         optableMatchers,
         optableSources,
@@ -408,22 +397,11 @@ class OptablePrebidAnalytics {
         br.optableMatchers.forEach((m: unknown) => oMatchersSet.add(m));
         br.optableSources.forEach((s: unknown) => oSourcesSet.add(s));
 
-        return {
-          optableTargetingDone: br.optableTargetingDone,
-          bidderCode: br.bidderCode,
-          bids: br.bids.map((b: any) => {
-            adUnitCode = adUnitCode || b.adUnitCode;
-
-            if (b.cpm != null) totalBids += 1;
-
-            return { floorMin: b.floorMin, cpm: b.cpm, size: b.size, bidId: b.bidId };
-          }),
-        };
+        return br;
       }),
       auctionId,
       adUnitCode,
       totalRequests: bidderRequests.length,
-      totalBids,
       optableSampling: this.config.samplingRate || 1,
       optableTargetingDone: oMatchersSet.size || oSourcesSet.size,
       optableMatchers: Array.from(oMatchersSet),
@@ -438,14 +416,15 @@ class OptablePrebidAnalytics {
           " CPM",
         bidderCode: bidWonEvent.bidderCode,
         adUnitCode: bidWonEvent.adUnitCode,
-        cpm: bidWonEvent.cmp,
+        cpm: bidWonEvent.cpm,
       },
       missed,
       url: `${window.location.hostname}${window.location.pathname}`,
       tenant: this.config.tenant!,
       // eslint-disable-next-line no-undef
       optableWrapperVersion: SDK_WRAPPER_VERSION || "unknown",
-      userAgent: window.navigator.userAgent,
+      userAgentRaw: window.navigator.userAgent,
+      userAgent: Bowser.parse(window.navigator.userAgent) as unknown as Record<string, any>,
     };
 
     // Log summary with bid counts

package-lock.json

@@ -35,6 +35,7 @@
   "dependencies": {
     "@babel/runtime": "^7.27.0",
     "@optable/web-sdk": "^0.40.0",
+    "bowser": "^2.12.1",
     "iab-openrtb": "^1.0.1",
     "js-sha256": "^0.11.0",
     "regenerator-runtime": "^0.13.7"