Skip to content
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

RTB House: add fledge docs; reorganization #4605

Merged
merged 1 commit into from
May 31, 2023
Merged
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
37 changes: 31 additions & 6 deletions dev-docs/bidders/rtbhouse.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,20 @@ sidebarType: 1
| `bidfloor` | optional | Minimal CPM value | `0.01` | `float` |
| `channel` | optional | Inventory channel identifier, limited to 50 characters | `Partner 1 - News` | `string` |

#### ORTB Blocking
#### Please note:

* Since 4.43 the bidfloor param will be ignored if a value is specified via floor module.

* The channel param is available starting from Prebid 6.6.0. Please reach your RTBHouse representative for details on how to enable and use the channel param.

### ORTB Blocking
RTB House supports blocking advertisers in `badv` and categories in `bcat` parameters.
The blocked advertisers/categories list has no length limitation, but response timeout is more likely to occur as the number of entries grow.
Blocked advertisers list (`badv`) is an array of domains as strings.
Blocked categories list (`bcat`) is an array of IAB categories as strings.

For example:
##### Globally defined ORTB Blocking:
#### Globally defined ORTB Blocking:
```javascript
pbjs.setConfig({
ortb2: {
Expand All @@ -44,7 +50,7 @@ pbjs.setConfig({
}
)};
```
##### ORTB Blocking specific only to rtbhouse bidder:
#### ORTB Blocking specific only to rtbhouse bidder:
```javascript
pbjs.setBidderConfig({
bidders: ['rtbhouse'],
Expand All @@ -59,8 +65,27 @@ pbjs.setBidderConfig({
### Setting up the Prebid Server Adapter
If you’re a Prebid Server host company looking to enable the RTB House server-side adapter, you'll need to contact prebid@rtbhouse.com. They will guide you through the process. Do not use the default bidder config file as it will require custom partner code to be entered. It will be provided by RTB House.

### Please note:

* Since 4.43 the bidfloor param will be ignored if a value is specified via floor module.
### Protected Audience API (FLEDGE) support
There’s an option to receive demand for Protected Audience API (FLEDGE/PAAPI)
ads using RTB House bid adapter.
Prebid’s [fledgeForGpt](https://docs.prebid.org/dev-docs/modules/fledgeForGpt.html)
module and Google Ad Manager is currently required.

* The channel param is available starting from Prebid 6.6.0. Please reach your RTBHouse representative for details on how to enable and use the channel param.
The following steps should be taken to setup Protected Audience for RTB House:

1. Reach out to your RTB House representative for setup coordination.

2. Build and enable FLEDGE module as described in
[fledgeForGpt](https://docs.prebid.org/dev-docs/modules/fledgeForGpt.html)
module documentation.

a. Make sure to enable RTB House bidder to participate in FLEDGE. If there are any other bidders to be allowed for that, add them to the **bidders** array:
```javascript
pbjs.setBidderConfig({
bidders: ["rtbhouse"],
config: {
fledgeEnabled: true
}
});
```