Playground XYZ - new adapter

modules/playgroundxyzBidAdapter.js

@@ -0,0 +1,160 @@
+import * as utils from 'src/utils';
+import { registerBidder } from 'src/adapters/bidderFactory';
+import { BANNER } from 'src/mediaTypes';
+
+const BIDDER_CODE = 'playgroundxyz';
+const URL = 'https://ads.playground.xyz/host-config/prebid';
+
+export const spec = {
+  code: BIDDER_CODE,
+  aliases: ['playgroundxyz'],
+  supportedMediaTypes: [BANNER],
+
+  /**
+   * Determines whether or not the given bid request is valid.
+   *
+   * @param {object} bid The bid to validate.
+   * @return boolean True if this is a valid bid, and false otherwise.
+   */
+  isBidRequestValid: function (bid) {
+    return !!(bid.params.placementId);
+  },
+
+  /**
+   * Make a server request from the list of BidRequests.
+   *
+   * @param {BidRequest[]} bidRequests A non-empty list of bid requests which should be sent to the Server.
+   * @return ServerRequest Info describing the request to the server.
+   */
+  buildRequests: function (bidRequests, bidderRequest) {
+    const topLocation = utils.getTopWindowLocation();
+    const payload = JSON.stringify({
+      id: bidRequests[0].auctionId,
+      site: {
+        domain: window.location.protocol + '//' + topLocation.hostname,
+        name: topLocation.hostname,
+        page: topLocation.href,
+      },
+      device: {
+        ua: navigator.userAgent,
+        language: navigator.language,
+        devicetype: isMobile() ? 1 : isConnectedTV() ? 3 : 2,
+      },
+      imp: bidRequests.map(mapImpression)
+    });
+
+    const options = {
+      contentType: 'application/json',
+      withCredentials: false
+    };
+
+    return {
+      method: 'POST',
+      url: URL,
+      data: payload,
+      options,
+      bidderRequest
+    };
+  },
+
+  /**
+   * Unpack the response from the server into a list of bids.
+   *
+   * @param {*} serverResponse A successful response from the server.
+   * @return {Bid[]} An array of bids which were nested inside the server.
+   */
+  interpretResponse: function (serverResponse, { bidderRequest }) {
+    serverResponse = serverResponse.body;
+    const bids = [];
+
+    if (!serverResponse || serverResponse.error) {
+      let errorMessage = `in response for ${bidderRequest.bidderCode} adapter`;
+      if (serverResponse && serverResponse.error) { errorMessage += `: ${serverResponse.error}`; }
+      utils.logError(errorMessage);
+      return bids;
+    }
+
+    if (!utils.isArray(serverResponse.seatbid)) {
+      let errorMessage = `in response for ${bidderRequest.bidderCode} adapter `;
+      utils.logError(errorMessage += 'Malformed seatbid response');
+      return bids;
+    }
+
+    serverResponse.seatbid.forEach(sBid => {
+      if (sBid.hasOwnProperty('bid')) {
+        sBid.bid.forEach(iBid => {
+          if (iBid.price !== 0) {
+            const bid = newBid(iBid);
+            bids.push(bid);
+          }
+        });
+      }
+    });
+    return bids;
+  },
+
+  getUserSyncs: function (syncOptions) {
+    if (syncOptions.iframeEnabled) {
+      return [{
+        type: 'iframe',
+        url: '//acdn.adnxs.com/ib/static/usersync/v3/async_usersync.html'
+      }];
+    }
+  }
+}
+
+function newBid(bid) {
+  return {
+    requestId: bid.impid,
+    mediaType: BANNER,
+    cpm: bid.price,
+    creativeId: bid.adid,
+    ad: bid.adm,
+    width: bid.w,
+    height: bid.h,
+    ttl: 300,
+    netRevenue: true,
+    currency: 'USD',
+  };
+}
+
+function mapImpression(bid) {
+  return {
+    id: bid.bidId,
+    banner: mapBanner(bid),
+    ext: {
+      appnexus: {
+        placement_id: parseInt(bid.params.placementId, 10)
+      }
+    }
+  };
+}
+
+function mapBanner(bid) {
+  return {
+    w: parseInt(bid.sizes[0][0], 10),
+    h: parseInt(bid.sizes[0][1], 10),
+    format: mapSizes(bid.sizes)
+  };
+}
+
+function mapSizes(bidSizes) {
+  const format = [];
+  bidSizes.forEach(size => {
+    format.push({
+      w: parseInt(size[0], 10),
+      h: parseInt(size[1], 10)
+    });
+  });
+  return format;
+}
+
+function isMobile() {
+  return (/(ios|ipod|ipad|iphone|android)/i).test(navigator.userAgent);
+}
+
+function isConnectedTV() {
+  return (/(smart[-]?tv|hbbtv|appletv|googletv|hdmi|netcast\.tv|viera|nettv|roku|\bdtv\b|sonydtv|inettvbrowser|\btv\b)/i).test(global.navigator.userAgent);
+}
+
+registerBidder(spec);

modules/playgroundxyzBidAdapter.md

@@ -0,0 +1,72 @@
+# Overview
+
+```
+Module Name:  Playground XYZ Bid Adapter
+Module Type:  Bidder Adapter
+Maintainer: tech+prebid@playgroundxyz.com
+```
+
+# Description
+
+Connects to playgroundxyz ad server for bids.
+
+Playground XYZ bid adapter supports Banner.
+
+# Test Parameters
+```
+var adUnits = [
+   // Banner adUnit
+   {
+       code: 'banner-div',
+       sizes: [[300, 250], [300,600]],
+       bids: [{
+         bidder: 'playgroundxyz',
+         params: {
+           placementId: '10433394'
+         }
+       }]
+   },
+   // Video instream adUnit
+   {
+      code: 'video-instream',
+      sizes: [640, 480],
+      mediaTypes: {
+        video: {
+          context: 'instream'
+        },
+      },
+      bids: [{
+        bidder: 'playgroundxyz',
+        params: {
+          placementId: '9333431',
+          video: {
+            skippable: true,
+            playback_methods: ['auto_play_sound_off']
+          }
+        }
+      }]
+   },
+   // Video outstream adUnit
+   {
+     code: 'video-outstream',
+     sizes: [[640, 480]],
+     mediaTypes: {
+       video: {
+         context: 'outstream'
+       }
+     },
+     bids: [
+       {
+         bidder: 'playgroundxyz',
+         params: {
+           placementId: '5768085',
+           video: {
+             skippable: true,
+             playback_method: ['auto_play_sound_off']
+           }
+         }
+       }
+     ]
+   }
+];
+```