@mixpeek/prebid 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +46 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -24,6 +24,18 @@
24
24
  | Analytics Adapter | Not analytics |
25
25
  | Identity Module | Not identity |
26
26
 
27
+ **SSPs and DSPs can immediately consume these signals via `ortb2.site.content` and `ortb2Imp.ext.data` without custom integration.**
28
+
29
+ ---
30
+
31
+ ## Who This Is For
32
+
33
+ - **Publishers** migrating off cookie-based targeting
34
+ - **SSPs** looking for contextual + adjacency signals
35
+ - **DSPs** pricing inventory using OpenRTB 2.6 context
36
+
37
+ Used in Mixpeek production demos and SSP pilots.
38
+
27
39
  ---
28
40
 
29
41
  ## Why Use This
@@ -35,6 +47,8 @@
35
47
  5. **Multimodal Analysis** - Text, image, video content understanding
36
48
  6. **Sub-100ms RTD Performance** - Optimized for header bidding latency
37
49
 
50
+ **Graceful Failure:** If Mixpeek is unavailable or times out, auctions proceed normally. The module never blocks bid requests.
51
+
38
52
  ---
39
53
 
40
54
  ## Minimal Setup (Copy-Paste Ready)
@@ -76,6 +90,38 @@ npm install @mixpeek/prebid
76
90
 
77
91
  ---
78
92
 
93
+ ## Shadow Mode (Risk-Free Testing)
94
+
95
+ Deploy in observation mode first — zero auction impact:
96
+
97
+ ```javascript
98
+ pbjs.setConfig({
99
+ realTimeData: {
100
+ auctionDelay: 0, // Don't delay auctions
101
+ dataProviders: [{
102
+ name: 'mixpeek',
103
+ waitForIt: false, // Don't wait for Mixpeek
104
+ params: {
105
+ apiKey: 'YOUR_API_KEY',
106
+ collectionId: 'YOUR_COLLECTION_ID',
107
+ namespace: 'YOUR_NAMESPACE',
108
+ debug: true // See what signals would be added
109
+ }
110
+ }]
111
+ }
112
+ })
113
+ ```
114
+
115
+ Shadow mode lets you:
116
+ - Verify signals are being generated correctly
117
+ - Monitor latency in your environment
118
+ - Confirm no auction disruption
119
+ - Review ortb2 output before enabling
120
+
121
+ When ready, switch to production mode by setting `waitForIt: true` and `auctionDelay: 250`.
122
+
123
+ ---
124
+
79
125
  ## Full Configuration
80
126
 
81
127
  ```javascript
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mixpeek/prebid",
3
- "version": "1.0.1",
3
+ "version": "1.0.3",
4
4
  "description": "Mixpeek RTD (Real-Time Data) Adapter for Prebid.js - Privacy-first contextual targeting with sub-100ms performance, ad adjacency awareness, and cookie-free bid enrichment",
5
5
  "main": "dist/mixpeekContextAdapter.js",
6
6
  "module": "src/modules/mixpeekContextAdapter.js",