-
Notifications
You must be signed in to change notification settings - Fork 1.4k
ConnectAd Update #6593
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
ConnectAd Update #6593
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -1,34 +1,115 @@ | ||||||
| --- | ||||||
| layout: bidder | ||||||
| title: ConnectAd | ||||||
| description: ConnectAd Prebid Adaptor | ||||||
| description: ConnectAd Prebid Adapter | ||||||
| biddercode: connectad | ||||||
| media_types: banner | ||||||
| media_types: banner, video, native, audio | ||||||
| tcfeu_supported: true | ||||||
| usp_supported: true | ||||||
| coppa_supported: true | ||||||
| gpp_supported: true | ||||||
| schain_supported: true | ||||||
| dchain_supported: true | ||||||
| userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId | ||||||
| prebid_member: true | ||||||
| safeframes_ok: true | ||||||
| floors_supported: true | ||||||
| deals_supported: true | ||||||
| pbjs: true | ||||||
| pbs: true | ||||||
| pbs_app_supported: true | ||||||
| fpd_supported: true | ||||||
| ortb_blocking_supported: true | ||||||
| gvl_id: 138 | ||||||
| multiformat_supported: true | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
Choose one of the allowed values on how your system behaves with multi-format requests. |
||||||
| sidebarType: 1 | ||||||
| endpoint_compression: true | ||||||
| --- | ||||||
|
|
||||||
| ### Prebid Server Note | ||||||
|
|
||||||
| {% include dev-docs/pbjs-adapter-required-for-pbs.md %} | ||||||
| ## Prebid Server Note | ||||||
|
|
||||||
| Please reach out to your ConnectAd Account Manager before configuring the S2S adapter for approval and setup. | ||||||
|
|
||||||
| ### Bid Params | ||||||
| The ConnectAd server-side adapters (Java and Go) have been modernized to fully support **Video** and **Native** ad formats, OpenRTB 2.6 dynamic bid type resolution, and complete request payload (`imp.ext`) preservation. | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
The linked Prebid.js PR only updates the client-side adapter, and I checked the current Prebid Server Go and Java bidder configs ( Useful? React with 👍 / 👎.
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @rtuschkany is there a linked PR to add the support in PBS as well? If so, please link. Otherwise resolve this comment |
||||||
|
|
||||||
| ## Bid Params | ||||||
|
|
||||||
| {: .table .table-bordered .table-striped } | ||||||
| | Name | Scope | Description | Example | Type | | ||||||
| |-------------|----------|--------------------------------|---------|-----------| | ||||||
| | `siteId` | required | The site ID from ConnectAd. | 12345 | integer | | ||||||
| | `networkId` | required | The network ID from ConnectAd. | 10047 | integer | | ||||||
| | `bidfloor` | optional | Requested Floorprice | 0.15 | number | | ||||||
| | Name | Scope | Description | Example | Type | | ||||||
| |---------------|----------|---------------------------------------------------------------------------------------------------------------|-------------------------------|-----------| | ||||||
| | `siteId` | required | The site ID from ConnectAd. | 12345 | integer | | ||||||
| | `networkId` | required | The network ID from ConnectAd. | 10047 | integer | | ||||||
| | `bidfloor` | optional | Requested Floorprice (fallback if the Price Floors module does not set one). | 0.15 | number | | ||||||
| | `endpointUrl` | optional | Prebid.js only: override the bid endpoint URL for testing or a custom datacenter. Ignored by Prebid Server. | `https://i.connectad.io/api/v3` | string | | ||||||
|
Check failure on line 43 in dev-docs/bidders/connectad.md
|
||||||
|
|
||||||
| ## Additional Features | ||||||
|
|
||||||
| - **Video & Native Support**: ConnectAd now supports standard Prebid Video and Native formats via the `ortbConverter`. | ||||||
| - **Viewability Measurement**: The Prebid.js adapter natively integrates standardized viewability measurement (`percentInView`). | ||||||
| - **OpenRTB 2.6**: Full support for OpenRTB 2.6 standards, including dynamic bid type resolution. | ||||||
|
|
||||||
| ## User Sync | ||||||
|
|
||||||
| ConnectAd recommends enabling user syncing via iFrame. This significantly improves user match rates and overall monetization performance. Be sure to call `pbjs.setConfig()` only once. | ||||||
|
|
||||||
| ```javascript | ||||||
| pbjs.setConfig({ | ||||||
| userSync: { | ||||||
| iframeEnabled: true, | ||||||
| filterSettings: { | ||||||
| iframe: { | ||||||
| bidders: ['connectad'], | ||||||
| filter: 'include' | ||||||
| } | ||||||
| } | ||||||
| } | ||||||
| }); | ||||||
| ``` | ||||||
|
|
||||||
| **Note:** *Combine the above configuration with any other UserSync configuration. Multiple `setConfig()` calls overwrite each other and only the last call for a given attribute will take effect.* | ||||||
|
|
||||||
| ## First Party Data | ||||||
|
|
||||||
| Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
please use relativ links |
||||||
|
|
||||||
| - `ortb2.site.*` | ||||||
| - `ortb2.user.*` | ||||||
|
|
||||||
| AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ```javascript | ||||||
| pbjs.setConfig({ | ||||||
| ortb2: { | ||||||
| site: { | ||||||
| keywords: 'sports, news', | ||||||
| content: { | ||||||
| language: 'en' | ||||||
| } | ||||||
| }, | ||||||
| user: { | ||||||
| keywords: 'automotive' | ||||||
| } | ||||||
| } | ||||||
| }); | ||||||
| ``` | ||||||
|
|
||||||
| ## Endpoint Compression | ||||||
|
|
||||||
| The ConnectAd adapter supports gzip compression for outgoing requests, which is built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests). | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
please use relative links |
||||||
|
|
||||||
| ### Disabling Compression | ||||||
|
|
||||||
| You can disable gzip compression at the bidder level using `pbjs.setBidderConfig`. Set the `gzipEnabled` value to `false`: | ||||||
|
|
||||||
| ```javascript | ||||||
| pbjs.que.push(function () { | ||||||
| pbjs.setBidderConfig({ | ||||||
| bidders: ['connectad'], | ||||||
| config: { | ||||||
| gzipEnabled: false | ||||||
| } | ||||||
| }); | ||||||
| }); | ||||||
| ``` | ||||||
|
|
||||||
| <!-- workaround bug where code blocks at end of a file are incorrectly formatted--> | ||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please state the legislations you support.
gpp_supportedis deprecated.See https://docs.prebid.org/dev-docs/bidder-adaptor.html#submitting-your-adapter