Brainx Bid Adapter : initial release

modules/brainxBidAdapter.js

@@ -0,0 +1,128 @@
+import { deepAccess, generateUUID, isArray, logWarn } from '../src/utils.js';
+import { registerBidder } from '../src/adapters/bidderFactory.js';
+// import { config } from 'src/config.js';
+import { BANNER } from '../src/mediaTypes.js';
+import { ortbConverter } from '../libraries/ortbConverter/converter.js'
+import { config } from '../src/config.js';
+
+const BIDDER_CODE = 'brainx';
+const METHOD = 'POST';
+const TTL = 200;
+const NET_REV = true;
+
+const converter = ortbConverter({
+  context: {
+    // `netRevenue` and `ttl` are required properties of bid responses - provide a default for them
+    netRevenue: NET_REV, // or false if your adapter should set bidResponse.netRevenue = false
+    ttl: TTL // default bidResponse.ttl (when not specified in ORTB response.seatbid[].bid[].exp)
+  }
+});
+
+export const spec = {
+  code: BIDDER_CODE,
+  // gvlid: IAB_GVL_ID,
+  // aliases: [
+  //   { code: "myalias", gvlid: IAB_GVL_ID_IF_DIFFERENT }
+  // ],
+  isBidRequestValid: function (bid) {
+    if (!(hasBanner(bid) || hasVideo(bid))) {
+      logWarn('Invalid bid request - missing required mediaTypes');
+      return false;
+    }
+    if (!(bid && bid.params)) {
+      logWarn('Invalid bid request - missing required bid data');
+      return false;
+    }
+
+    if (!(bid.params.pubId)) {
+      logWarn('Invalid bid request - missing required field pubId');
+      return false;
+    }
+    return true;
+  },
+  buildRequests(bidRequests, bidderRequest) {
+    const data = converter.toORTB({ bidRequests, bidderRequest })
+    const device = config.getConfig('device') || {};
+    // console.log('data-==========', data);
+    // console.log('bidRequests-==========', bidRequests);
+    // console.log('bidderRequest-==========', bidderRequest);
+    data.user = {
+      buyeruid: generateUUID()
+    }
+    data.device.ip = navigator.ip || '202.100.48.46';
+    data.device.os = 'Android'
+    data.device.geo = device.geo || {
+      country: 'HKG'
+    };
+
+    return {
+      method: METHOD,
+      url: `${String(deepAccess(bidRequests[0], 'params.endpoint'))}?token=${String(deepAccess(bidRequests[0], 'params.pubId'))}`,
+      data
+    }
+  },
+  interpretResponse(response, request) {
+    let bids = [];
+    // console.log('response-==========', response);
+    // console.log('request-==========', request);
+    // const bids = converter.fromORTB({ response: response.body, request: request.data }).bids;
+    if (response.body && response.body.seatbid && isArray(response.body.seatbid)) {
+      response.body.seatbid.forEach(function (bidder) {
+        if (isArray(bidder.bid)) {
+          bidder.bid.map((bid) => {
+            let serverBody = response.body;
+            // bidRequest = request.originalBidRequest,
+            let mediaType = BANNER;
+            let currency = serverBody.cur || 'USD'
+
+            const cpm = (parseFloat(bid.price) || 0).toFixed(2);
+            const categories = deepAccess(bid, 'cat', []);
+
+            const bidRes = {
+              ad: bid.adm,
+              width: bid.w,
+              height: bid.h,
+              requestId: bid.impid,
+              cpm: cpm,
+              currency: currency,
+              mediaType: mediaType,
+              ttl: TTL,
+              creativeId: bid.crid || bid.id,
+              netRevenue: NET_REV,
+              nurl: bid.nurl,
+              lurl: bid.lurl,
+              meta: {
+                mediaType: mediaType,
+                primaryCatId: categories[0],
+                secondaryCatIds: categories.slice(1),
+              }
+            };
+            if (bid.adomain && isArray(bid.adomain) && bid.adomain.length > 0) {
+              bidRes.meta.advertiserDomains = bid.adomain;
+              bidRes.meta.clickUrl = bid.adomain[0];
+            }
+            bids.push(bidRes);
+          })
+        }
+      });
+    }
+
+    // console.log('bids-==========', bids);
+    return bids;
+  },
+  // getUserSyncs: function (syncOptions, serverResponses, gdprConsent, uspConsent) { },
+  // onTimeout: function (timeoutData) { },
+  // onBidWon: function (bid) { },
+  // onSetTargeting: function (bid) { },
+  // onBidderError: function ({ error, bidderRequest }) { },
+  // onAdRenderSucceeded: function (bid) { },
+  supportedMediaTypes: [BANNER]
+}
+function hasBanner(bidRequest) {
+  return !!deepAccess(bidRequest, 'mediaTypes.banner');
+}
+function hasVideo(bidRequest) {
+  return !!deepAccess(bidRequest, 'mediaTypes.video');
+}
+
+registerBidder(spec);

modules/brainxBidAdapter.md

@@ -0,0 +1,56 @@
+# brianx Bidder Adapter
+
+## Overview
+
+```
+Module Name: brianx Bidder Adapter
+Module Type: Bidder Adapter
+Maintainer: [email protected]
+```
+
+## Description
+
+Module that connects to brianx's demand sources
+
+## Bid Parameters
+
+| Name        | Scope    | Type      | Description                              | Example          |
+| -------     | -------- | ------    | ---------------------------------------  | ---------------- |
+| `pubId`     | required | String    | The Pub Id provided by Brainx Ads.       | `F7B53DBC-85C1-4685-9A06-9CF4B6261FA3`   |
+| `endpoint`  | required | String    | The endpoint provided by Brainx Url.     | `http://adx-engine-gray.tec-do.cn/bid`   |
+
+## Example
+
+### Banner Ads
+
+```javascript
+var adUnits = [{
+  code: 'banner-ad-div',
+  mediaTypes: {
+    banner: {
+      sizes: [
+            [320, 250],
+            [320, 480]
+        ]
+    }
+  },
+  bids: [{
+    bidder: 'brianx',
+    params: {
+      pubId: 'F7B53DBC-85C1-4685-9A06-9CF4B6261FA3',
+      endpoint: 'http://adx-engine-gray.tec-do.cn/bid'
+    }
+  }]
+}];
+```
+
+* For video ads, enable prebid cache.
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        ortbVersion: '2.5'
+    },
+    debug: true // or false
+});
+```