-
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
Open
rtuschkany
wants to merge
7
commits into
prebid:master
Choose a base branch
from
rtuschkany:master
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+92
−11
Open
ConnectAd Update #6593
Changes from all commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
b5c0166
ConnectAd: documentation update
rtuschkany 877f6ab
Merge branch 'prebid:master' into master
rtuschkany 0d86643
Update dev-docs/bidders/connectad.md
rtuschkany ce6e22c
Update dev-docs/bidders/connectad.md
rtuschkany 86ed146
Update dev-docs/bidders/connectad.md
rtuschkany bb2ec00
Update dev-docs/bidders/connectad.md
rtuschkany 5769f2a
Update dev-docs/bidders/connectad.md
rtuschkany File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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_sids: tcfeu, tcfca, usnat, usstate_all, usp | ||
| 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: will-bid-on-any, will-bid-on-one, will-not-bid | ||
| 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. | ||
|
|
||
| ## 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](/features/firstPartyData.html). The following fields are supported: | ||
|
|
||
| - `ortb2.site.*` | ||
| - `ortb2.user.*` | ||
|
|
||
| AdUnit-specific data is supported using `adUnit.ortb2Imp.ext.*`: | ||
|
|
||
| ```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](/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests). | ||
|
|
||
| ### 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--> | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
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.
The linked Prebid.js PR only updates the client-side adapter, and I checked the current Prebid Server Go and Java bidder configs (
static/bidder-info/connectad.yamlandsrc/main/resources/bidder-config/connectad.yaml), which still advertise onlybannerfor ConnectAd site/app media types. Leaving this server-side statement in the docs will tell PBS publishers that video/native requests are supported even though those adapters will still be configured as banner-only, so server-side video/native setups can be rejected or fail to bid until the PBS adapters/configs are actually updated.Useful? React with 👍 / 👎.
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.
@rtuschkany is there a linked PR to add the support in PBS as well? If so, please link. Otherwise resolve this comment
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.
prebid/prebid-server#4785
prebid/prebid-server-java#4506