Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
103 changes: 92 additions & 11 deletions dev-docs/bidders/connectad.md
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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
gpp_supported: true
gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp

Please state the legislations you support. gpp_supported is deprecated.
See https://docs.prebid.org/dev-docs/bidder-adaptor.html#submitting-your-adapter

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
multiformat_supported: true
multiformat_supported: will-bid-on-any, will-bid-on-one, will-not-bid

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.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove unsupported server-side media support claim

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.yaml and src/main/resources/bidder-config/connectad.yaml), which still advertise only banner for 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 👍 / 👎.

Copy link
Copy Markdown
Contributor

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


## 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

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style

dev-docs/bidders/connectad.md:43:186 MD060/table-column-style Table column style [Table pipe does not align with header for style "aligned"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 43 in dev-docs/bidders/connectad.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style

dev-docs/bidders/connectad.md:43:174 MD060/table-column-style Table column style [Table pipe does not align with header for style "aligned"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.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:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html). The following fields are supported:

please use relativ links


- `ortb2.site.*`
- `ortb2.user.*`

AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`:
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](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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).
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).

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-->
Loading