prebid.js 9.40.0 → 9.41.0

package/modules/epomDspBidAdapter.md

@@ -0,0 +1,170 @@
+# Overview
+
+```
+Module Name:  Epom DSP Bid Adapter
+Module Type:  Bidder Adapter
+Maintainer: support@epom.com
+```
+
+# Description
+
+The **Epom DSP Bid Adapter** allows publishers to connect with the Epom DSP Exchange for programmatic advertising. It supports banner formats and adheres to the OpenRTB protocol.
+
+## Supported Features
+
+| Feature             | Supported |
+|---------------------|-----------|
+| **TCF 2.0 Support** | ✅ Yes     |
+| **US Privacy (CCPA)** | ✅ Yes     |
+| **GPP Support**    | ✅ Yes     |
+| **Media Types**     | Banner    |
+| **Floors Module**   | ✅ Yes     |
+| **User Sync**       | iframe, image |
+| **GDPR Compliance** | ✅ Yes     |
+
+# Integration Guide for Publishers
+
+## Basic Configuration
+
+Below is an example configuration for integrating the Epom DSP Bid Adapter into your Prebid.js setup.
+
+### Sample Banner Ad Unit
+
+```javascript
+var adUnits = [
+  {
+    code: 'epom-banner-div',
+    mediaTypes: {
+      banner: {
+        sizes: [            
+            [300, 250],
+            [728, 90],
+            [160, 600],
+        ]
+      }
+    },
+    bids: [
+      {
+        bidder: 'epom_dsp',
+        params: {
+          endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+        }
+      }
+    ]
+  }
+];
+```
+
+---
+
+# Params
+
+The following parameters can be configured in the `params` object for the **Epom DSP Bid Adapter**.
+
+| Parameter      | Type     | Required | Description                                                             |
+|--------------|----------|----------|-------------------------------------------------------------------------|
+| `endpoint`   | string   | Yes      | The URL of the Epom DSP bidding endpoint.                               |
+| `adUnitId`   | string   | No       | Unique identifier for the Ad Unit.                                      |
+| `bidfloor`   | number   | No       | Minimum CPM value for the bid in USD.                                   |
+
+---
+
+# Global Settings (Optional)
+
+You can define **global configuration parameters** for the **Epom DSP Bid Adapter** using `pbjs.setBidderConfig`. This is **optional** and allows centralized control over bidder settings.
+
+### Example Global Configuration
+
+```javascript
+pbjs.setBidderConfig({
+    bidders: ['epom_dsp'],
+    config: {
+        epomSettings: {
+            endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+        }
+    }
+});
+```
+
+---
+
+# Response Format
+
+The **Epom DSP Bid Adapter** complies with the OpenRTB protocol and returns responses in the following format:
+
+```json
+{
+  "bids": [
+    {
+      "requestId": "12345",
+      "cpm": 1.50,
+      "currency": "USD",
+      "width": 300,
+      "height": 250,
+      "ad": "<div>Ad content</div>",
+      "creativeId": "abc123",
+      "ttl": 300,
+      "netRevenue": true
+    }
+  ]
+}
+```
+
+### Response Fields
+
+| Field         | Type     | Description                                      |
+|--------------|----------|--------------------------------------------------|
+| `requestId`  | string   | Unique identifier for the bid request.           |
+| `cpm`        | number   | Cost per thousand impressions (CPM) in USD.      |
+| `currency`   | string   | Currency of the bid (default: USD).              |
+| `width`      | number   | Width of the ad unit in pixels.                  |
+| `height`     | number   | Height of the ad unit in pixels.                 |
+| `ad`         | string   | HTML markup for rendering the ad.                |
+| `creativeId` | string   | Identifier for the creative.                     |
+| `ttl`        | number   | Time-to-live for the bid (in seconds).           |
+| `netRevenue` | boolean  | Indicates whether the CPM is net revenue.        |
+
+---
+
+# GDPR and Privacy Compliance
+
+The **Epom DSP Bid Adapter** supports GDPR and CCPA compliance. Consent information can be passed via:
+
+- `bidderRequest.gdprConsent`
+- `bidderRequest.uspConsent`
+
+---
+
+# Support
+
+For integration assistance, contact [Epom Support](mailto:support@epom.com).
+
+---
+
+# Examples
+
+## Basic Banner Ad Unit
+
+```javascript
+var adUnits = [
+  {
+    code: 'epom-banner',
+    mediaTypes: {
+      banner: {
+        sizes: [            
+            [300, 250],
+            [728, 90],
+            [160, 600],
+        ]
+      }
+    },
+    bids: [
+      {
+        bidder: 'epom_dsp',
+        params: {
+          endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+        }
+      }
+    ]
+  }
+];

package/modules/equativBidAdapter.js

@@ -14,11 +14,11 @@ import { deepAccess, deepSetValue, logError, logWarn, mergeDeep } from '../src/u
 const BIDDER_CODE = 'equativ';
 const COOKIE_SYNC_ORIGIN = 'https://apps.smartadserver.com';
 const COOKIE_SYNC_URL = `${COOKIE_SYNC_ORIGIN}/diff/templates/asset/csync.html`;
+const DEFAULT_TTL = 300;
 const LOG_PREFIX = 'Equativ:';
 const PID_STORAGE_NAME = 'eqt_pid';
 
 let nwid = 0;
-
 let impIdMap = {};
 
 /**
@@ -61,6 +61,14 @@ function getFloor(bid, mediaType, width, height, currency) {
     .floor || bid.params.bidfloor || -1;
 }
 
+/**
+ * Gets value of the local variable impIdMap
+ * @returns {*} Value of impIdMap
+ */
+export function getImpIdMap() {
+  return impIdMap;
+};
+
 /**
  * Evaluates impressions for validity.  The entry evaluated is considered valid if NEITHER of these conditions are met:
  * 1) it has a `video` property defined for `mediaTypes.video` which is an empty object
@@ -135,7 +143,10 @@ export const spec = {
       serverResponse.body.seatbid
         .filter(seat => seat?.bid?.length)
         .forEach(seat =>
-          seat.bid.forEach(bid => bid.impid = impIdMap[bid.impid])
+          seat.bid.forEach(bid => {
+            bid.impid = impIdMap[bid.impid];
+            bid.ttl = typeof bid.exp === 'number' && bid.exp > 0 ? bid.exp : DEFAULT_TTL;
+          })
         );
     }
 
@@ -193,7 +204,7 @@ export const spec = {
 export const converter = ortbConverter({
   context: {
     netRevenue: true,
-    ttl: 300,
+    ttl: DEFAULT_TTL
   },
 
   imp(buildImp, bidRequest, context) {