From 366985652a89b217da4b1125a502e5d876c019be Mon Sep 17 00:00:00 2001 From: dveljovicTX <69788339+dveljovicTX@users.noreply.github.com> Date: Tue, 2 Nov 2021 09:35:20 +0100 Subject: [PATCH 1/3] Create gb_xandr.md --- dev-docs/bidders/gb_xandr.md | 200 +++++++++++++++++++++++++++++++++++ 1 file changed, 200 insertions(+) create mode 100644 dev-docs/bidders/gb_xandr.md diff --git a/dev-docs/bidders/gb_xandr.md b/dev-docs/bidders/gb_xandr.md new file mode 100644 index 0000000000..0b3db87cbb --- /dev/null +++ b/dev-docs/bidders/gb_xandr.md @@ -0,0 +1,200 @@ +--- +layout: bidder +title: GoldbachXandr +description: Prebid GoldbachXandr Bidder Adaptor +biddercode: gb_xandr +media_types: banner, video, native +gdpr_supported: true +prebid_member: true +userIds: criteo, unifiedId, netId, identityLink, flocId, uid2 +schain_supported: true +coppa_supported: true +usp_supported: true +getFloor: true +pbjs: true +pbs: true +gvl_id: 32 +--- + +### Table of Contents + +- [Bid Params](#goldbach-xandr-bid-params) +- [Video Object](#goldbach-xandr-video-object) +- [User Object](#goldbach-xandr-user-object) +- [App Object](#goldbach-xandr-app-object) +- [Custom Targeting keys](#custom-targeting-keys) +- [Passing Keys Without Values](#goldbach-xandr-no-value) +- [User Sync in AMP](#goldbach-xandr-amp) +- [Debug Auction](#goldbach-xandr-debug-auction) + + + +{: .alert.alert-danger :} +All GoldbachXandr (Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher. If placements from two different publishers are included in the call, the GoldbachXandr bidder will not return any demand for those placements.
+*Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the GoldbachXandr adapter.* + +#### Bid Params + +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | +|---------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|------------------| +| `placementId` | required | The placement ID from GoldbachXandr. You may identify a placement using the `invCode` and `member` instead of a placement ID. The `placementID` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. Legacy code can retain the `string` value. **Prebid Server requires an integer value.** | `234234` | `integer` | +| `member` | optional | The member ID from GoldbachXandr. Must be used with `invCode`. | `'12345'` | `string` | +| `invCode` | optional | The inventory code from GoldbachXandr. Must be used with `member`. | `'abc123'` | `string` | +| `publisherId` | optional | The publisher ID from GoldbachXandr. It is used by the GoldbachXandr end point to identify the publisher when `placementId` is not provided and `invCode` goes wrong. The `publisherId` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. | `12345` | `integer` | +| `frameworks` | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `integer` | +| `user` | optional | Object that specifies information about an external user. See [User Object](#goldbach-xandr-user-object) for details. | `user: { age: 25, gender: 0, dnt: true}` | `object` | +| `allowSmallerSizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` | +| `usePaymentRule` (PBJS) or `use_pmt_rule` (PBS) | optional | If `true`, Xandr will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` | +| `keywords` | optional | A set of key-value pairs applied to all ad slots on the page. Mapped to [buy-side segment targeting](https://monetize.xandr.com/docs/segment-targeting) (login required). Values can be empty. See [Passing Keys Without Values](#goldbach-xandr-no-value) below for examples. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an GoldbachXandr account manager. | `keywords: { genre: ['rock', 'pop'] }` | `object` | +| `video` | optional | Object containing video targeting parameters. See [Video Object](#goldbach-xandr-video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` | +| `app` | optional | Object containing mobile app parameters. See the [App Object](#goldbach-xandr-app-object) for details. | `app : { id: 'app-id'}` | `object` | +| `reserve` | optional | Sets a floor price for the bid that is returned. If floors have been configured in the GoldbachXandr Console, those settings will override what is configured here unless 'Reserve Price Override' is checked. See [Xandr docs](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-a-floor-rule.html) | `0.90` | `float` | +| `position` | optional | Identify the placement as above or below the fold. Allowed values: Unknown: `unknown`; Above the fold: `above`; Below the fold: `below` | `'above'` | `string` | +| `trafficSourceCode` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` | +| `supplyType` | optional | Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app` | `'web'` | `string` | +| `supplyType` | optional | Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app` | `'web'` | `string` | +| `pubClick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using GoldbachXandr click tracking properly. | `'http://click.adserver.com/'` | `string` | +| `extInvCode` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` | +| `externalImpId` | optional | Specifies the unique identifier of an externally generated auction. | `'bacbab02626452b097f6030b3c89ac05'` | `string` | +| `generate_ad_pod_id`| optional | Signal to GoldbachXandr to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS. | `true` | `boolean` | + + + +#### Video Object + +{: .table .table-bordered .table-striped } +| Name | Description | Type | +|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------| +| `minduration` | Integer that defines the minimum video ad duration in seconds. | `integer` | +| `maxduration` | Integer that defines the maximum video ad duration in seconds. | `integer` | +|`context` | A string that indicates the type of video ad requested. Allowed values: `"pre_roll"`; `"mid_roll"`; `"post_roll"`; `"outstream"`. | `string` | +| `skippable` | Boolean which, if `true`, means the user can click a button to skip the video ad. Defaults to `false`. | `boolean` | +|`skipoffset`| Integer that defines the number of seconds until an ad can be skipped. Assumes `skippable` setting was set to `true`. | `integer` | +| `playback_method` | A string that sets the playback method supported by the publisher. Allowed values: `"auto_play_sound_on"`; `"auto_play_sound_off"`; `"click_to_play"`; `"mouse_over"`; `"auto_play_sound_unknown"`. | `string` | +| `frameworks` | Array of integers listing API frameworks supported by the publisher. Allowed values: None: `0`; VPAID 1.0: `1`; VPAID 2.0: `2`; MRAID 1.0: `3`; MRAID 2.0: `4`; ORMMA: `5`; OMID 1.0 `6`. | `Array` | + + + + +#### User Object + +{: .table .table-bordered .table-striped } +| Name | Description | Example | Type | +|-------------------|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|------------------| +| `age` | The age of the user. | `35` | `integer` | +| `externalUid` | Specifies a string that corresponds to an external user ID for this user. | `'1234567890abcdefg'` | `string` | +| `segments` | Specifies the segments to which the user belongs. | `[1, 2]` | `Array` | +| `gender` | Specifies the gender of the user. Allowed values: Unknown: `0`; Male: `1`; Female: `2` | `1` | `integer` | +| `dnt` | Do not track flag. Indicates if tracking cookies should be disabled for this auction | `true` | `boolean` | +| `language` | Two-letter ANSI code for this user's language. | `EN` | `string` | + + + + +#### App Object + +GoldbachXandr supports using prebid within a mobile app's webview. If you are interested in using an SDK, please see [Prebid Mobile]({{site.baseurl}}/prebid-mobile/prebid-mobile.html) instead. + +{: .table .table-bordered .table-striped } +| Name | Description | Example | Type | +|-------------------|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|------------------| +| `id` | The App ID. | `'B1O2W3M4AN.com.prebid.webview'` | `string` | +| `device_id` | Object that contains the advertising identifiers of the user (`idfa`, `aaid`, `md5udid`, `sha1udid`, or `windowsadid`). | `{ aaid: "38400000-8cf0-11bd-b23e-10b96e40000d" }` | `object` | +| `geo` | Object that contains the latitude (`lat`) and longitude (`lng`) of the user. | `{ lat: 40.0964439, lng: -75.3009142 }` | `object` | + + + +#### Custom Targeting keys + +GoldbachXandr returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs. + +``` +pbjs.bidderSettings = { + goldbach-xandr: { + adserverTargeting: [ + { + key: "apn_buyer_memberid", // Use key configured in your adserver + val: function(bidResponse) { + return bidResponse.goldbach-xandr.buyerMemberId; + } + }, + { + key: "apn_prio", // Use key configured in your adserver + val: function(bidResponse) { + return bidResponse.goldbach-xandr.dealPriority; + } + }, { + key: "apn_dealcode", // Use key configured in your adserver + val: function(bidResponse) { + return bidResponse.goldbach-xandr.dealCode; + } + } + ] + } +} +``` + + + +#### Passing Keys Without Values + +It's possible to use the `keywords` parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to GoldbachXandr. The following are examples of sending keys with empty values: + + +``` +keywords: { + myKeyword: '', + myOtherKeyword: [''] +} +``` + +The preceding example passes the key `myKeyword` with an empty value. The key `myOtherKeyword` contains an empty value array. + +You can define keys with values and without values in the same `keywords` definition. In this next example, we've defined the key `color` with an array of values: `red`, `blue`, and `green`. We've followed that with the key `otherKeyword` with an empty value array. + +``` +keywords: { + color: ['red', 'blue', 'green'], + otherKeyword: [''] +} +``` + + + +#### User Sync in AMP + +If you are syncing user id's with Prebid Server and are using GoldbachXandr' managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details. + + + +#### Mobile App Display Manager Version + +The GoldbachXandr endpoint expects `imp.displaymanagerver` to be populated for mobile app sources +requests, however not all SDKs will populate this field. If the `imp.displaymanagerver` field +is not supplied for an `imp`, but `request.app.ext.prebid.source` +and `request.app.ext.prebid.version` are supplied, the adapter will fill in a value for +`diplaymanagerver`. It will concatenate the two `app` fields as `-` fo fill in +the empty `displaymanagerver` before sending the request to GoldbachXandr. + +#### Debug Auction + +{: .alert.alert-danger :} +Enabling the GoldbachXandr Debug Auction feature should only be done for diagnosing the GoldbachXandr auction. Do not enable this feature in a production setting where it may impact users. + +To understand what is happening behind the scenes during an auction, you can enable a debug auction by adding an `apn_prebid_debug` cookie with a JSON string. For example: + +{% highlight js %} +{ "enabled": true, "dongle": "QWERTY", "debug_timeout": 1000, "member_id": 958 } +{% endhighlight %} + +To view the results of the debug auction, add the `pbjs_debug=true` query string parameter and open your browser's developer console. + +{: .table .table-bordered .table-striped } +| Name | Description | Example | Type | +|-------------------|-----------------------------------------------------------------|-----------------------|------------------| +| `enabled` | Toggle the debug auction to occur | `true` | `boolean` | +| `dongle` | Your account's unique debug password. | `QWERTY` | `string` | +| `member_id` | The ID of the member running the debug auction | `958` | `integer` | +| `debug_timeout` | The timeout for the debug auction results to be returned | `3000` | `integer` | + From 9cdd1af99cb1afc96ac9c6e9e40859fe14caa6d4 Mon Sep 17 00:00:00 2001 From: Dusan Veljovic Date: Wed, 17 Nov 2021 09:56:09 +0100 Subject: [PATCH 2/3] renamed the file --- dev-docs/bidders/{gb_xandr.md => goldbach.md} | 83 +++++++++---------- 1 file changed, 41 insertions(+), 42 deletions(-) rename dev-docs/bidders/{gb_xandr.md => goldbach.md} (72%) diff --git a/dev-docs/bidders/gb_xandr.md b/dev-docs/bidders/goldbach.md similarity index 72% rename from dev-docs/bidders/gb_xandr.md rename to dev-docs/bidders/goldbach.md index 0b3db87cbb..841af42524 100644 --- a/dev-docs/bidders/gb_xandr.md +++ b/dev-docs/bidders/goldbach.md @@ -1,8 +1,8 @@ --- layout: bidder -title: GoldbachXandr -description: Prebid GoldbachXandr Bidder Adaptor -biddercode: gb_xandr +title: Goldbach +description: Prebid Goldbach Bidder Adaptor +biddercode: goldbach media_types: banner, video, native gdpr_supported: true prebid_member: true @@ -13,53 +13,52 @@ usp_supported: true getFloor: true pbjs: true pbs: true -gvl_id: 32 --- ### Table of Contents -- [Bid Params](#goldbach-xandr-bid-params) -- [Video Object](#goldbach-xandr-video-object) -- [User Object](#goldbach-xandr-user-object) -- [App Object](#goldbach-xandr-app-object) +- [Bid Params](#godlbach-bid-params) +- [Video Object](#godlbach-video-object) +- [User Object](#godlbach-user-object) +- [App Object](#godlbach-app-object) - [Custom Targeting keys](#custom-targeting-keys) -- [Passing Keys Without Values](#goldbach-xandr-no-value) -- [User Sync in AMP](#goldbach-xandr-amp) -- [Debug Auction](#goldbach-xandr-debug-auction) +- [Passing Keys Without Values](#godlbach-no-value) +- [User Sync in AMP](#godlbach-amp) +- [Debug Auction](#godlbach-debug-auction) - + {: .alert.alert-danger :} -All GoldbachXandr (Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher. If placements from two different publishers are included in the call, the GoldbachXandr bidder will not return any demand for those placements.
-*Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the GoldbachXandr adapter.* +All Goldbach (Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher. If placements from two different publishers are included in the call, the Goldbach bidder will not return any demand for those placements.
+*Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the Goldbach adapter.* #### Bid Params {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | |---------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|------------------| -| `placementId` | required | The placement ID from GoldbachXandr. You may identify a placement using the `invCode` and `member` instead of a placement ID. The `placementID` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. Legacy code can retain the `string` value. **Prebid Server requires an integer value.** | `234234` | `integer` | -| `member` | optional | The member ID from GoldbachXandr. Must be used with `invCode`. | `'12345'` | `string` | -| `invCode` | optional | The inventory code from GoldbachXandr. Must be used with `member`. | `'abc123'` | `string` | -| `publisherId` | optional | The publisher ID from GoldbachXandr. It is used by the GoldbachXandr end point to identify the publisher when `placementId` is not provided and `invCode` goes wrong. The `publisherId` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. | `12345` | `integer` | +| `placementId` | required | The placement ID from Goldbach. You may identify a placement using the `invCode` and `member` instead of a placement ID. The `placementID` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. Legacy code can retain the `string` value. **Prebid Server requires an integer value.** | `234234` | `integer` | +| `member` | optional | The member ID from Goldbach. Must be used with `invCode`. | `'12345'` | `string` | +| `invCode` | optional | The inventory code from Goldbach. Must be used with `member`. | `'abc123'` | `string` | +| `publisherId` | optional | The publisher ID from Goldbach. It is used by the Goldbach end point to identify the publisher when `placementId` is not provided and `invCode` goes wrong. The `publisherId` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. | `12345` | `integer` | | `frameworks` | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `integer` | -| `user` | optional | Object that specifies information about an external user. See [User Object](#goldbach-xandr-user-object) for details. | `user: { age: 25, gender: 0, dnt: true}` | `object` | +| `user` | optional | Object that specifies information about an external user. See [User Object](#godlbach-user-object) for details. | `user: { age: 25, gender: 0, dnt: true}` | `object` | | `allowSmallerSizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` | | `usePaymentRule` (PBJS) or `use_pmt_rule` (PBS) | optional | If `true`, Xandr will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` | -| `keywords` | optional | A set of key-value pairs applied to all ad slots on the page. Mapped to [buy-side segment targeting](https://monetize.xandr.com/docs/segment-targeting) (login required). Values can be empty. See [Passing Keys Without Values](#goldbach-xandr-no-value) below for examples. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an GoldbachXandr account manager. | `keywords: { genre: ['rock', 'pop'] }` | `object` | -| `video` | optional | Object containing video targeting parameters. See [Video Object](#goldbach-xandr-video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` | -| `app` | optional | Object containing mobile app parameters. See the [App Object](#goldbach-xandr-app-object) for details. | `app : { id: 'app-id'}` | `object` | -| `reserve` | optional | Sets a floor price for the bid that is returned. If floors have been configured in the GoldbachXandr Console, those settings will override what is configured here unless 'Reserve Price Override' is checked. See [Xandr docs](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-a-floor-rule.html) | `0.90` | `float` | +| `keywords` | optional | A set of key-value pairs applied to all ad slots on the page. Mapped to [buy-side segment targeting](https://monetize.xandr.com/docs/segment-targeting) (login required). Values can be empty. See [Passing Keys Without Values](#godlbach-no-value) below for examples. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Goldbach account manager. | `keywords: { genre: ['rock', 'pop'] }` | `object` | +| `video` | optional | Object containing video targeting parameters. See [Video Object](#godlbach-video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` | +| `app` | optional | Object containing mobile app parameters. See the [App Object](#godlbach-app-object) for details. | `app : { id: 'app-id'}` | `object` | +| `reserve` | optional | Sets a floor price for the bid that is returned. If floors have been configured in the Goldbach Console, those settings will override what is configured here unless 'Reserve Price Override' is checked. See [Xandr docs](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-a-floor-rule.html) | `0.90` | `float` | | `position` | optional | Identify the placement as above or below the fold. Allowed values: Unknown: `unknown`; Above the fold: `above`; Below the fold: `below` | `'above'` | `string` | | `trafficSourceCode` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` | | `supplyType` | optional | Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app` | `'web'` | `string` | | `supplyType` | optional | Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app` | `'web'` | `string` | -| `pubClick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using GoldbachXandr click tracking properly. | `'http://click.adserver.com/'` | `string` | +| `pubClick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Goldbach click tracking properly. | `'http://click.adserver.com/'` | `string` | | `extInvCode` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` | | `externalImpId` | optional | Specifies the unique identifier of an externally generated auction. | `'bacbab02626452b097f6030b3c89ac05'` | `string` | -| `generate_ad_pod_id`| optional | Signal to GoldbachXandr to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS. | `true` | `boolean` | +| `generate_ad_pod_id`| optional | Signal to Goldbach to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS. | `true` | `boolean` | - + #### Video Object @@ -75,7 +74,7 @@ All GoldbachXandr (Xandr) placements included in a single call to `requestBids` | `frameworks` | Array of integers listing API frameworks supported by the publisher. Allowed values: None: `0`; VPAID 1.0: `1`; VPAID 2.0: `2`; MRAID 1.0: `3`; MRAID 2.0: `4`; ORMMA: `5`; OMID 1.0 `6`. | `Array` | - + #### User Object @@ -90,11 +89,11 @@ All GoldbachXandr (Xandr) placements included in a single call to `requestBids` | `language` | Two-letter ANSI code for this user's language. | `EN` | `string` | - + #### App Object -GoldbachXandr supports using prebid within a mobile app's webview. If you are interested in using an SDK, please see [Prebid Mobile]({{site.baseurl}}/prebid-mobile/prebid-mobile.html) instead. +Goldbach supports using prebid within a mobile app's webview. If you are interested in using an SDK, please see [Prebid Mobile]({{site.baseurl}}/prebid-mobile/prebid-mobile.html) instead. {: .table .table-bordered .table-striped } | Name | Description | Example | Type | @@ -107,27 +106,27 @@ GoldbachXandr supports using prebid within a mobile app's webview. If you are in #### Custom Targeting keys -GoldbachXandr returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs. +Goldbach returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs. ``` pbjs.bidderSettings = { - goldbach-xandr: { + godlbach: { adserverTargeting: [ { key: "apn_buyer_memberid", // Use key configured in your adserver val: function(bidResponse) { - return bidResponse.goldbach-xandr.buyerMemberId; + return bidResponse.appnexus.buyerMemberId; } }, { key: "apn_prio", // Use key configured in your adserver val: function(bidResponse) { - return bidResponse.goldbach-xandr.dealPriority; + return bidResponse.appnexus.dealPriority; } }, { key: "apn_dealcode", // Use key configured in your adserver val: function(bidResponse) { - return bidResponse.goldbach-xandr.dealCode; + return bidResponse.appnexus.dealCode; } } ] @@ -135,11 +134,11 @@ pbjs.bidderSettings = { } ``` - + #### Passing Keys Without Values -It's possible to use the `keywords` parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to GoldbachXandr. The following are examples of sending keys with empty values: +It's possible to use the `keywords` parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to Goldbach. The following are examples of sending keys with empty values: ``` @@ -160,27 +159,27 @@ keywords: { } ``` - + #### User Sync in AMP -If you are syncing user id's with Prebid Server and are using GoldbachXandr' managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details. +If you are syncing user id's with Prebid Server and are using Goldbach' managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details. - + #### Mobile App Display Manager Version -The GoldbachXandr endpoint expects `imp.displaymanagerver` to be populated for mobile app sources +The Goldbach endpoint expects `imp.displaymanagerver` to be populated for mobile app sources requests, however not all SDKs will populate this field. If the `imp.displaymanagerver` field is not supplied for an `imp`, but `request.app.ext.prebid.source` and `request.app.ext.prebid.version` are supplied, the adapter will fill in a value for `diplaymanagerver`. It will concatenate the two `app` fields as `-` fo fill in -the empty `displaymanagerver` before sending the request to GoldbachXandr. +the empty `displaymanagerver` before sending the request to Goldbach. #### Debug Auction {: .alert.alert-danger :} -Enabling the GoldbachXandr Debug Auction feature should only be done for diagnosing the GoldbachXandr auction. Do not enable this feature in a production setting where it may impact users. +Enabling the Goldbach Debug Auction feature should only be done for diagnosing the Goldbach auction. Do not enable this feature in a production setting where it may impact users. To understand what is happening behind the scenes during an auction, you can enable a debug auction by adding an `apn_prebid_debug` cookie with a JSON string. For example: From 50eb4af4739e8ed0d8b3640811d6cb132cc6c978 Mon Sep 17 00:00:00 2001 From: Andrew Date: Thu, 18 Nov 2021 19:34:33 -0800 Subject: [PATCH 3/3] Update dev-docs/bidders/goldbach.md --- dev-docs/bidders/goldbach.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/goldbach.md b/dev-docs/bidders/goldbach.md index 841af42524..6f9b4f7fc5 100644 --- a/dev-docs/bidders/goldbach.md +++ b/dev-docs/bidders/goldbach.md @@ -163,7 +163,7 @@ keywords: { #### User Sync in AMP -If you are syncing user id's with Prebid Server and are using Goldbach' managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details. +If you are syncing user id's with Prebid Server and are using Goldbach's managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details.