prebid.js 7.20.0 → 7.22.0

package/modules/33acrossBidAdapter.js

@@ -11,6 +11,7 @@ import {
   logWarn,
   getWindowSelf,
   mergeDeep,
+  pick
 } from '../src/utils.js';
 import { BANNER, VIDEO } from '../src/mediaTypes.js';
 
@@ -242,7 +243,8 @@ function _getMRAKey(bidRequest) {
 // Infer the necessary data from valid bid for a minimal ttxRequest and create HTTP request
 function _createServerRequest({ bidRequests, gdprConsent = {}, uspConsent, pageUrl, ttxSettings }) {
   const ttxRequest = {};
-  const { siteId, test } = bidRequests[0].params;
+  const firstBidRequest = bidRequests[0];
+  const { siteId, test } = firstBidRequest.params;
 
   /*
    * Infer data for the request payload
@@ -254,13 +256,13 @@ function _createServerRequest({ bidRequests, gdprConsent = {}, uspConsent, pageU
   });
 
   ttxRequest.site = { id: siteId };
-  ttxRequest.device = _buildDeviceORTB();
+  ttxRequest.device = _buildDeviceORTB(firstBidRequest.ortb2?.device);
 
   if (pageUrl) {
     ttxRequest.site.page = pageUrl;
   }
 
-  ttxRequest.id = bidRequests[0].auctionId;
+  ttxRequest.id = firstBidRequest.auctionId;
 
   if (gdprConsent.consentString) {
     ttxRequest.user = setExtensions(ttxRequest.user, {
@@ -268,9 +270,9 @@ function _createServerRequest({ bidRequests, gdprConsent = {}, uspConsent, pageU
     });
   }
 
-  if (Array.isArray(bidRequests[0].userIdAsEids) && bidRequests[0].userIdAsEids.length > 0) {
+  if (Array.isArray(firstBidRequest.userIdAsEids) && firstBidRequest.userIdAsEids.length > 0) {
     ttxRequest.user = setExtensions(ttxRequest.user, {
-      'eids': bidRequests[0].userIdAsEids
+      'eids': firstBidRequest.userIdAsEids
     });
   }
 
@@ -294,9 +296,9 @@ function _createServerRequest({ bidRequests, gdprConsent = {}, uspConsent, pageU
     }
   };
 
-  if (bidRequests[0].schain) {
+  if (firstBidRequest.schain) {
     ttxRequest.source = setExtensions(ttxRequest.source, {
-      'schain': bidRequests[0].schain
+      'schain': firstBidRequest.schain
     });
   }
 
@@ -739,10 +741,9 @@ function _createSync({ siteId = 'zzz000000000003zzz', gdprConsent = {}, uspConse
 }
 
 // BUILD REQUESTS: DEVICE
-function _buildDeviceORTB() {
+function _buildDeviceORTB(device = {}) {
   const win = getWindowSelf();
-
-  return {
+  const deviceProps = {
     ext: {
       ttx: {
         ...getScreenDimensions(),
@@ -752,7 +753,13 @@ function _buildDeviceORTB() {
         mtp: win.navigator.maxTouchPoints
       }
     }
-  };
+  }
+
+  if (device.sua) {
+    deviceProps.sua = pick(device.sua, [ 'browsers', 'platform', 'model' ]);
+  }
+
+  return deviceProps;
 }
 
 function getTopMostAccessibleWindow() {

package/modules/adyoulikeBidAdapter.js

@@ -227,17 +227,23 @@ function createEndpointQS(bidderRequest) {
   const qs = {};
   if (bidderRequest) {
     const ref = bidderRequest.refererInfo;
-    if (ref?.location) {
-      // RefererUrl will be removed in a future version.
-      qs.RefererUrl = encodeURIComponent(ref.location);
-      if (ref.numIframes > 0) {
-        qs.SafeFrame = true;
+    if (ref) {
+      if (ref.location) {
+        // RefererUrl will be removed in a future version.
+        qs.RefererUrl = encodeURIComponent(ref.location);
+        if (!ref.reachedTop) {
+          qs.SafeFrame = true;
+        }
       }
+
+      qs.PageUrl = encodeURIComponent(ref.topmostLocation);
+      qs.PageReferrer = encodeURIComponent(ref.location);
     }
 
+    // retreive info from ortb2 object if present (prebid7)
     const siteInfo = bidderRequest.ortb2?.site;
     if (siteInfo) {
-      qs.PageUrl = encodeURIComponent(siteInfo.page);
+      qs.PageUrl = encodeURIComponent(siteInfo.page || ref?.topmostLocation);
       qs.PageReferrer = encodeURIComponent(siteInfo.ref || ref?.location);
     }
   }

package/modules/asoBidAdapter.js

@@ -4,6 +4,7 @@ import {
   deepSetValue,
   getDNT,
   inIframe,
+  isArray,
   isFn,
   logWarn,
   parseSizesInput,
@@ -19,6 +20,7 @@ const BIDDER_CODE = 'aso';
 const DEFAULT_SERVER_URL = 'https://srv.aso1.net';
 const DEFAULT_SERVER_PATH = '/prebid/bidder';
 const OUTSTREAM_RENDERER_URL = 'https://acdn.adnxs.com/video/outstream/ANOutstreamVideo.js';
+const VERSION = '$prebid.version$_1.1';
 const TTL = 300;
 
 export const spec = {
@@ -59,7 +61,7 @@ export const spec = {
 
       serverRequests.push({
         method: 'POST',
-        url: getEnpoint(bidRequest),
+        url: getEndpoint(bidRequest),
         data: payload,
         options: {
           withCredentials: true,
@@ -272,11 +274,9 @@ function createVideoImp(bidRequest, videoParams) {
   return imp;
 }
 
-function getEnpoint(bidRequest) {
-  const serverUrl = bidRequest.params.serverUrl || DEFAULT_SERVER_URL;
-  const serverPath = bidRequest.params.serverPath || DEFAULT_SERVER_PATH;
-
-  return serverUrl + serverPath + '?zid=' + bidRequest.params.zone + '&pbjs=$prebid.version$';
+function getEndpoint(bidRequest) {
+  const serverUrl = bidRequest.params.server || DEFAULT_SERVER_URL;
+  return serverUrl + DEFAULT_SERVER_PATH + '?zid=' + bidRequest.params.zone + '&pbjs=' + VERSION;
 }
 
 function getConsentsIds(gdprConsent) {
@@ -341,6 +341,11 @@ function createBasePayload(bidRequest, bidderRequest) {
     deepSetValue(payload, 'user.ext.eids', eids);
   }
 
+  const schainData = deepAccess(bidRequest, 'schain.nodes');
+  if (isArray(schainData) && schainData.length > 0) {
+    deepSetValue(payload, 'source.ext.schain', bidRequest.schain);
+  }
+
   return payload;
 }
 

package/modules/asoBidAdapter.md

@@ -14,12 +14,11 @@ For more information, please visit [Adserver.Online](https://adserver.online).
 
 # Parameters
 
-| Name          | Scope    | Description             | Example   | Type      |
-|---------------|----------|-------------------------|-----------|-----------|
-| `zone`        | required | Zone ID                 | `73815`   | `Integer` |
-| `attr`        | optional | Custom targeting params | `{keywords: ["a", "b"]}` | `Object` |
-
-
+| Name      | Scope    | Description             | Example                | Type       |
+|-----------|----------|-------------------------|------------------------|------------|
+| `zone`    | required | Zone ID                 | `73815`                | `Integer`  |
+| `attr`    | optional | Custom targeting params | `{foo: ["a", "b"]}`    | `Object`   |
+| `server`  | optional | Custom bidder endpoint  | `https://endpoint.url` | `String`   |
 
 # Test parameters for banner
 ```js

package/modules/brightcomBidAdapter.js

@@ -75,6 +75,26 @@ function buildRequests(bidReqs, bidderRequest) {
       deepSetValue(brightcomBidReq, 'user.ext.consent', bidderRequest.gdprConsent.consentString);
     }
 
+    if (bidderRequest && bidderRequest.uspConsent) {
+      deepSetValue(brightcomBidReq, 'regs.ext.us_privacy', bidderRequest.uspConsent);
+    }
+
+    if (config.getConfig('coppa') === true) {
+      deepSetValue(brightcomBidReq, 'regs.coppa', 1);
+    }
+
+    if (bidReqs[0] && bidReqs[0].schain) {
+      deepSetValue(brightcomBidReq, 'source.ext.schain', bidReqs[0].schain)
+    }
+
+    if (bidReqs[0] && bidReqs[0].userIdAsEids) {
+      deepSetValue(brightcomBidReq, 'user.ext.eids', bidReqs[0].userIdAsEids || [])
+    }
+
+    if (bidReqs[0] && bidReqs[0].userId) {
+      deepSetValue(brightcomBidReq, 'user.ext.ids', bidReqs[0].userId || [])
+    }
+
     return {
       method: 'POST',
       url: URL,
@@ -103,7 +123,7 @@ function interpretResponse(serverResponse) {
     logWarn('Brightcom server returned empty/non-json response: ' + JSON.stringify(serverResponse.body));
     return [];
   }
-  const { body: {id, seatbid} } = serverResponse;
+  const {body: {id, seatbid}} = serverResponse;
   try {
     const brightcomBidResponses = [];
     if (id &&
@@ -164,9 +184,9 @@ function _isViewabilityMeasurable(element) {
   return !_isIframe() && element !== null;
 }
 
-function _getViewability(element, topWin, { w, h } = {}) {
+function _getViewability(element, topWin, {w, h} = {}) {
   return getWindowTop().document.visibilityState === 'visible'
-    ? _getPercentInView(element, topWin, { w, h })
+    ? _getPercentInView(element, topWin, {w, h})
     : 0;
 }
 
@@ -182,8 +202,8 @@ function _getMinSize(sizes) {
   return sizes.reduce((min, size) => size.h * size.w < min.h * min.w ? size : min);
 }
 
-function _getBoundingBox(element, { w, h } = {}) {
-  let { width, height, left, top, right, bottom } = element.getBoundingClientRect();
+function _getBoundingBox(element, {w, h} = {}) {
+  let {width, height, left, top, right, bottom} = element.getBoundingClientRect();
 
   if ((width === 0 || height === 0) && w && h) {
     width = w;
@@ -192,7 +212,7 @@ function _getBoundingBox(element, { w, h } = {}) {
     bottom = top + h;
   }
 
-  return { width, height, left, top, right, bottom };
+  return {width, height, left, top, right, bottom};
 }
 
 function _getIntersectionOfRects(rects) {
@@ -225,16 +245,16 @@ function _getIntersectionOfRects(rects) {
   return bbox;
 }
 
-function _getPercentInView(element, topWin, { w, h } = {}) {
-  const elementBoundingBox = _getBoundingBox(element, { w, h });
+function _getPercentInView(element, topWin, {w, h} = {}) {
+  const elementBoundingBox = _getBoundingBox(element, {w, h});
 
   // Obtain the intersection of the element and the viewport
-  const elementInViewBoundingBox = _getIntersectionOfRects([ {
+  const elementInViewBoundingBox = _getIntersectionOfRects([{
     left: 0,
     top: 0,
     right: topWin.innerWidth,
     bottom: topWin.innerHeight
-  }, elementBoundingBox ]);
+  }, elementBoundingBox]);
 
   let elementInViewArea, elementTotalArea;
 

package/modules/dacIdSystem.js

@@ -5,12 +5,111 @@
  * @requires module:modules/userId
  */
 
-import { submodule } from '../src/hook.js';
-import { getStorageManager } from '../src/storageManager.js';
+import {
+  logError,
+  logInfo,
+  logWarn
+} from '../src/utils.js';
+import {
+  ajax
+} from '../src/ajax.js'
+import {
+  submodule
+} from '../src/hook.js';
+import {
+  getStorageManager
+} from '../src/storageManager.js';
 
 export const storage = getStorageManager();
 
-export const cookieKey = '_a1_f';
+export const FUUID_COOKIE_NAME = '_a1_f';
+export const AONEID_COOKIE_NAME = '_a1_d';
+export const API_URL = 'https://penta.a.one.impact-ad.jp/aud';
+const COOKIES_EXPIRES = 60 * 60 * 24 * 1000; // 24h
+const LOG_PREFIX = 'User ID - dacId submodule: ';
+
+/**
+ * @returns {{fuuid: string, uid: string}} -
+ */
+function getCookieId() {
+  return {
+    fuuid: storage.getCookie(FUUID_COOKIE_NAME),
+    uid: storage.getCookie(AONEID_COOKIE_NAME)
+  };
+}
+
+/**
+ * set uid to cookie.
+ * @param {string} uid -
+ * @returns {void} -
+ */
+function setAoneidToCookie(uid) {
+  if (uid) {
+    const expires = new Date(Date.now() + COOKIES_EXPIRES).toUTCString();
+    storage.setCookie(
+      AONEID_COOKIE_NAME,
+      uid,
+      expires,
+      'none'
+    );
+  }
+}
+
+/**
+ * @param {string} oid -
+ * @param {string} fuuid -
+ * @returns {string} -
+ */
+function getApiUrl(oid, fuuid) {
+  return `${API_URL}?oid=${oid}&fu=${fuuid}`;
+}
+
+/**
+ * @param {string} oid -
+ * @param {string} fuuid -
+ * @returns {{callback: function}} -
+ */
+function fetchAoneId(oid, fuuid) {
+  return {
+    callback: (callback) => {
+      const ret = {
+        fuuid,
+        uid: undefined
+      };
+      const callbacks = {
+        success: (response) => {
+          if (response) {
+            try {
+              const responseObj = JSON.parse(response);
+              if (responseObj.error) {
+                logWarn(LOG_PREFIX + 'There is no permission to use API: ' + responseObj.error);
+                return callback(ret);
+              }
+              if (!responseObj.uid) {
+                logWarn(LOG_PREFIX + 'AoneId is null');
+                return callback(ret);
+              }
+              ret.uid = responseObj.uid;
+              setAoneidToCookie(ret.uid);
+            } catch (error) {
+              logError(LOG_PREFIX + error);
+            }
+          }
+          callback(ret);
+        },
+        error: (error) => {
+          logError(LOG_PREFIX + error);
+          callback(ret);
+        }
+      };
+      const apiUrl = getApiUrl(oid, fuuid);
+      ajax(apiUrl, callbacks, undefined, {
+        method: 'GET',
+        withCredentials: true
+      });
+    },
+  };
+}
 
 export const dacIdSystemSubmodule = {
   /**
@@ -20,38 +119,57 @@ export const dacIdSystemSubmodule = {
   name: 'dacId',
 
   /**
-   * performs action to obtain id
-   * @function
-   * @returns { {id: {dacId: string}} | undefined }
+   * decode the stored id value for passing to bid requests
+   * @param { {fuuid: string, uid: string} } id
+   * @returns { {dacId: {fuuid: string, dacId: string} } | undefined }
    */
-  getId: function() {
-    const newId = storage.getCookie(cookieKey);
-    if (!newId) {
-      return undefined;
-    }
-    const result = {
-      dacId: newId
+  decode(id) {
+    if (id && typeof id === 'object') {
+      return {
+        dacId: {
+          fuuid: id.fuuid,
+          id: id.uid
+        }
+      }
     }
-    return {id: result};
   },
 
   /**
-   * decode the stored id value for passing to bid requests
+   * performs action to obtain id
    * @function
-   * @param { {dacId: string} } value
-   * @returns { {dacId: {id: string} } | undefined }
+   * @returns { {id: {fuuid: string, uid: string}} | undefined }
    */
-  decode: function(value) {
-    if (value && typeof value === 'object') {
-      const result = {};
-      if (value.dacId) {
-        result.id = value.dacId
-      }
-      return {dacId: result};
+  getId(config) {
+    const cookie = getCookieId();
+
+    if (!cookie.fuuid) {
+      logInfo(LOG_PREFIX + 'There is no fuuid in cookie')
+      return undefined;
     }
-    return undefined;
-  },
 
-}
+    if (cookie.fuuid && cookie.uid) {
+      logInfo(LOG_PREFIX + 'There is fuuid and AoneId in cookie')
+      return {
+        id: {
+          fuuid: cookie.fuuid,
+          uid: cookie.uid
+        }
+      };
+    }
+
+    const configParams = (config && config.params) || {};
+    if (!configParams || typeof configParams.oid !== 'string') {
+      logWarn(LOG_PREFIX + 'oid is not defined');
+      return {
+        id: {
+          fuuid: cookie.fuuid,
+          uid: undefined
+        }
+      };
+    }
+
+    return fetchAoneId(configParams.oid, cookie.fuuid);
+  }
+};
 
 submodule('userId', dacIdSystemSubmodule);

package/modules/dacIdSystem.md

@@ -1,7 +1,7 @@
 ## AudienceOne User ID Submodule
 
 AudienceOne ID, provided by [D.A.Consortium Inc.](https://www.dac.co.jp/), is ID for ad targeting by using 1st party cookie.
-Please contact D.A.Consortium Inc. before using this ID.
+Please visit [https://solutions.dac.co.jp/audienceone](https://solutions.dac.co.jp/audienceone) and request your Owner ID to get started.
 
 ## Building Prebid with AudienceOne ID Support
 
@@ -17,7 +17,10 @@ The following configuration parameters are available:
 pbjs.setConfig({
     userSync: {
         userIds: [{
-            name: 'dacId'
+            name: 'dacId',
+            params: {
+                'oid': '55h67qm4ck37vyz5'
+            }
         }]
     }
 });
@@ -26,3 +29,5 @@ pbjs.setConfig({
 | Param under userSync.userIds[] | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
 | name | Required | String | The name of this module. | `"dacId"` |
+| params | Required | Object | Details of module params. | |
+| params.oid | Required | String | This is the Owner ID value obtained via D.A.Consortium Inc. | `"55h67qm4ck37vyz5"` |

package/modules/fledgeForGpt.md

@@ -1,34 +1,33 @@
-## Overview
+# Overview
+This module allows Prebid.js to support FLEDGE by integrating it with GPT's [experimental FLEDGE
+support](https://github.com/google/ads-privacy/tree/master/proposals/fledge-multiple-seller-testing).
 
-This module enables the handling of fledge auction by GPT.
-Bid adapters can now return component auction configs in addition to bids.
+To learn more about FLEDGE in general, go [here](https://github.com/WICG/turtledove/blob/main/FLEDGE.md).
 
-Those component auction configs will be registered to the GPT ad slot,
-and GPT will be responsible to run fledge auction and render the winning fledge ad.
+This document covers the steps necessary for publishers to enable FLEDGE on their inventory. It also describes
+the changes Bid Adapters need to implement in order to support FLEDGE.
 
-Find out more [here](https://github.com/WICG/turtledove/blob/main/FLEDGE.md).
-
-## Integration
-
-Build the fledge module into the Prebid.js package with:
+## Publisher Integration
+Publishers wishing to enable FLEDGE support must do two things. First, they must compile Prebid.js with support for this module.
+This is accomplished by adding the `fledgeForGpt` module to the list of modules they are already using:
 
 ```
 gulp build --modules=fledgeForGpt,...
 ```
 
-## Module Configuration Parameters
+Second, they must enable FLEDGE in their Prebid.js configuration. To provide a high degree of flexiblity for testing, FLEDGE
+settings exist at the module level, the bidder level, and the slot level.
+
+### Module Configuration
+This module exposes the following settings:
 
 |Name |Type |Description |Notes |
 | :------------ | :------------ | :------------ |:------------ |
 |enabled | Boolean |Enable/disable the module |Defaults to `false` |
 
-## Configuration
+As noted above, FLEDGE support is disabled by default. To enable it, set the `enabled` value to `true` for this module
+using the `setConfig` method of Prebid.js:
 
-Fledge support need to be enabled at 3 levels:
-- `fledgeForGpt` module
-- bidder
-- adunit
-### enabling the fledgeForGpt module
 ```js
 pbjs.que.push(function() {
   pbjs.setConfig({
@@ -39,7 +38,17 @@ pbjs.que.push(function() {
 });
 ```
 
-### enablingthe  bidder
+### Bidder Configuration
+This module adds the following setting for bidders:
+
+|Name |Type |Description |Notes |
+| :------------ | :------------ | :------------ |:------------ |
+| fledgeEnabled | Boolean | Enable/disable a bidder to participate in FLEDGE | Defaults to `false` |
+
+In addition to enabling FLEDGE at the module level, individual bidders must also be enabled. This allows publishers to
+selectively test with one or more bidders as they desire. To enable one or more bidders, use the `setBidderConfig` method
+of Prebid.js:
+
 ```js
 pbjs.setBidderConfig({
     bidders: ["openx"],
@@ -49,12 +58,81 @@ pbjs.setBidderConfig({
 });
 ```
 
-### enabling the adunit
-ortb2Imp.ext.ae on the adunit must be set 1
+### AdUnit Configuration
+Enabling an adunit for FLEDGE eligibility is accomplished by setting an attribute of the `ortb2Imp` object for that
+adunit.
+
+|Name |Type |Description |Notes |
+| :------------ | :------------ | :------------ |:------------ |
+| ortb2Imp.ext.ae | Integer | Auction Environment: 1 indicates FLEDGE eligible, 0 indicates it is not | Absence indicates this is not FLEDGE eligible |
+
+The `ae` field stands for Auction Environment and was chosen to be consistent with the field that GAM passes to bidders
+in their Open Bidding and Exchange Bidding APIs. More details on that can be found
+[here](https://github.com/google/ads-privacy/tree/master/proposals/fledge-rtb#bid-request-changes-indicating-interest-group-auction-support)
+In practice, this looks as follows:
+
 ```js
-ortb2Imp: {
-    ext: {
-        ae: 1
+pbjs.addAdUnits({
+    code: "my-adunit-div",
+    // other config here
+    ortb2Imp: {
+        ext: {
+            ae: 1
+        }
+    }
+});
+```
+
+## Bid Adapter Integration
+Chrome has enabled a two-tier auction in FLEDGE. This allows multiple sellers (frequently SSPs) to act on behalf of the publisher with
+a single entity serving as the final decision maker. In their [current approach](https://github.com/google/ads-privacy/tree/master/proposals/fledge-multiple-seller-testing),
+GPT has opted to run the final auction layer while allowing other SSPs/sellers to participate as
+[Component Auctions](https://github.com/WICG/turtledove/blob/main/FLEDGE.md#21-initiating-an-on-device-auction) which feed their
+bids to the final layer. To learn more about Component Auctions, go [here](https://github.com/WICG/turtledove/blob/main/FLEDGE.md#24-scoring-bids-in-component-auctions).
+
+The FLEDGE auction, including Component Auctions, are configured via an `AuctionConfig` object that defines the parameters of the auction for a given
+seller. This module enables FLEDGE support by allowing bid adaptors to return `AuctionConfig` objects in addition to bids. If a bid adaptor returns an
+`AuctionConfig` object, Prebid.js will register it with the appropriate GPT ad slot so the bidder can participate as a Component Auction in the overall
+FLEDGE auction for that slot. More details on the GPT API can be found [here](https://developers.google.com/publisher-tag/reference#googletag.config.componentauctionconfig).
+
+Modifying a bid adapter to support FLEDGE is a straightforward process and consists of the following steps:
+1. Detecting when a bid request is FLEDGE eligible
+2. Responding with AuctionConfig
+
+FLEDGE eligibility is made available to bid adapters through the `bidderRequest.fledgeEnabled` field.
+The [`bidderRequest`](https://docs.prebid.org/dev-docs/bidder-adaptor.html#bidderrequest-parameters) object is passed to
+the [`buildRequests`](https://docs.prebid.org/dev-docs/bidder-adaptor.html#building-the-request) method of an adapter. Bid adapters
+who wish to participate should read this flag and pass it to their server. FLEDGE eligibility depends on a number of parameters:
+
+1. Chrome enablement
+2. Publisher participatipon in the [Origin Trial](https://developer.chrome.com/docs/privacy-sandbox/unified-origin-trial/#configure)
+3. Publisher Prebid.js configuration (detailed above)
+
+When a bid request is FLEDGE enabled, a bid adapter can return a tuple consisting of bids and AuctionConfig objects rather than just a list of bids:
+
+```js
+function interpretResponse(resp, req) {
+    // Load the bids from the response - this is adapter specific
+    const bids = parseBids(resp);
+
+    // Load the auctionConfigs from the response - also adapter specific
+    const auctionConfigs = parseAuctionConfigs(resp);
+
+    if (auctionConfigs) {
+        // Return a tuple of bids and auctionConfigs. It is possible that bids could be null.
+        return {bids, auctionConfigs};
+    } else {
+        return bids;
     }
 }
 ```
+
+An AuctionConfig must be associated with an adunit and auction, and this is accomplished using the value in the `bidId` field from the objects in the
+`validBidRequests` array passed to the `buildRequests` function - see [here](https://docs.prebid.org/dev-docs/bidder-adaptor.html#ad-unit-params-in-the-validbidrequests-array)
+for more details. This means that the AuctionConfig objects returned from `interpretResponse` must contain a `bidId` field whose value corresponds to
+the request it should be associated with. This may raise the question: why isn't the AuctionConfig object returned as part of the bid? The
+answer is that it's possible to participate in the FLEDGE auction without returning a contextual bid.
+
+An example of this can be seen in the OpenX OpenRTB bid adapter [here](https://github.com/prebid/Prebid.js/blob/master/modules/openxOrtbBidAdapter.js#L327).
+
+Other than the addition of the `bidId` field, the AuctionConfig object should adhere to the requirements set forth in FLEDGE. The details of creating an   AuctionConfig object are beyond the scope of this document.