Skip to content

Commit

Permalink
Merge remote-tracking branch 'upstream/master'
Browse files Browse the repository at this point in the history
  • Loading branch information
Skitelman committed Oct 2, 2023
2 parents e53b4f2 + e53aea8 commit bd74766
Show file tree
Hide file tree
Showing 20 changed files with 950 additions and 334 deletions.
2 changes: 2 additions & 0 deletions _includes/dev-docs/loads-external-javascript.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
{: .alert.alert-warning :}

Check failure on line 1 in _includes/dev-docs/loads-external-javascript.md

View workflow job for this annotation

GitHub Actions / run markdownlint

First line in a file should be a top-level heading

_includes/dev-docs/loads-external-javascript.md:1 MD041/first-line-heading/first-line-h1 First line in a file should be a top-level heading [Context: "{: .alert.alert-warning :}"] https://github.com/DavidAnson/markdownlint/blob/v0.29.0/doc/md041.md
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
2 changes: 1 addition & 1 deletion dev-docs/bidder-adaptor.md
Original file line number Diff line number Diff line change
Expand Up @@ -1282,7 +1282,7 @@ registerBidder(spec);
* If you support one or more userId modules, add `userId: (list of supported vendors)`. No default value.
* If you support video and/or native mediaTypes add `media_types: video, native`. Note that display is added by default. If you don't support display, add "no-display" as the first entry, e.g. `media_types: no-display, native`. No default value.
* If you support the COPPA flag, add `coppa_supported: true`. Default is false.
* If you support the IAB's GPP consent string, add `gpp_supported: true`. Default is false.
* If you support the IAB's GPP consent string, add `gpp_sids` with a comma separated list of section names, e.g. `gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp`. Default is None.
* If you support the [supply chain](/dev-docs/modules/schain.html) feature, add `schain_supported: true`. Default is false.
* If you support passing a demand chain on the response, add `dchain_supported: true`. Default is false.
* If your bidder doesn't work well with safeframed creatives, add `safeframes_ok: false`. This will alert publishers to not use safeframed creatives when creating the ad server entries for your bidder. No default value.
Expand Down
1 change: 1 addition & 0 deletions dev-docs/bidders/acuityads.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ tcfeu_supported: true
usp_supported: true
coppa_supported: true
schain_supported: true
gpp_supported: true
userId: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
media_types: banner, video, native
safeframes_ok: true
Expand Down
1 change: 1 addition & 0 deletions dev-docs/bidders/concert.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ media_types: banner
tcfeu_supported: false
usp_supported: true
gpp_supported: true
userIds: sharedId, unifiedId, uid2
sidebarType: 1
---

Expand Down
70 changes: 70 additions & 0 deletions dev-docs/bidders/illumin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
layout: bidder
title: Illumin
description: Prebid Illumin Bidder Adaptor
biddercode: illumin
filename: illuminBidAdapter
userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
tcfeu_supported: true
usp_supported: true
coppa_supported: false
schain_supported: true
gpp_supported: true
floors_supported: true
media_types: banner, video
prebid_member: false
safeframes_ok: false
deals_supported: false
pbs_app_supported: false
fpd_supported: false
ortb_blocking_supported: false
multiformat_supported: will-bid-on-one
pbjs: true
sidebarType: 1
---

### Bid Params

{: .table .table-bordered .table-striped }
| Name | Scope | Description | Example | Type |
|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
| `cId` | required | The connection ID from Illumin. | `'562524b21b1c1f08117fc7f9'` | `string` |
| `pId` | required | The publisher ID from Illumin. | `'59ac17c192832d0011283fe3'` | `string` |
| `bidFloor` | optional | The minimum bid value desired. Illumin will not respond with bids lower than this value. | `0.90` | `float` |

## Example

```javascript
var adUnits = [{
code: 'banner-div',
mediaTypes: {
banner: {
sizes: [
[300, 250],
[728, 90]
]
}
},
bids: [{
bidder: 'illumin',
params: {
cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
bidFloor: 1.23 // Optional
}
}]
}
];

// configure pbjs to enable user syncing
pbjs.setConfig({
userSync: {
filterSettings: {
iframe: {
bidders: 'illumin',
filter: 'include'
}
}
}
});
```
1 change: 1 addition & 0 deletions dev-docs/bidders/incrementx.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ biddercode: incrementx
media_types: banner
tcfeu_supported: false
multiformat_supported: will-bid-on-one
filename: incrxBidAdapter
sidebarType: 1
---

Expand Down
1 change: 1 addition & 0 deletions dev-docs/bidders/integr8.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,5 @@ sidebarType: 1
|---------------|----------|------------------------------------------------------------------------|--------------------|-----------|
| `propertyId` | required |Property id | `"12345"` | `string` |
| `placementId` | required |Placement id | `"54321"` | `string` |
| `deliveryUrl` | optional |Custom endpoint url for the bid request | `"https://central.sea.integr8.digital/bid"` | `string` |
| `data` | optional |Catalog data (contents) and/or inventory data (custom key/value pairs) | `{catalogs: [{ catalogId: "699229", items: ["193", "4", "1"] }], inventory: { category: ["tech"], query: ["iphone 12"] }}` | `object` |
1 change: 1 addition & 0 deletions dev-docs/bidders/mobfoxpb.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ tcfeu_supported: true
pbjs: true
pbs: true
pbs_app_supported: true
gpp_supported: true
gvl_id: 311
enable_download: true
sidebarType: 1
Expand Down
2 changes: 1 addition & 1 deletion dev-docs/bidders/viant.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ tcfeu_supported: false
coppa_supported: true
usp_supported: true
gpp_supported: false
schain_supported: false
schain_supported: true
userId: uid2, unifiedId
pbjs: true
prebid_member: true
Expand Down
3 changes: 1 addition & 2 deletions dev-docs/modules/a1MediaRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,7 @@ sidebarType : 1

# A1Media RTD Module

{: .alert.alert-warning :}
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
{% include dev-docs/loads-external-javascript.md %}

The A1Media RTD module loads a script for obtaining A1Media user segments, providing the user segment data to bid-requests.

Expand Down
3 changes: 1 addition & 2 deletions dev-docs/modules/aaxBlockmeterRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,7 @@ The module enables publishers with an AAX relationship to measure traffic coming

AAX can also help publishers monetize this traffic by allowing them to serve [acceptable ads](https://acceptableads.com/about/) to these adblock visitors and recover their lost revenue. [Reach out to us](https://www.aax.media/try-blockmeter/) to know more.

{: .alert.alert-warning :}
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
{% include dev-docs/loads-external-javascript.md %}

## Configuration

Expand Down
3 changes: 1 addition & 2 deletions dev-docs/modules/arcspanRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,7 @@ sidebarType : 1

ArcSpan is a real-time audience monetization platform focused on the needs of the world’s finest publishers and retailers. Unlock the true value of your first-party audience data while providing advertisers the targeting performance they need.

{: .alert.alert-warning :}
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
{% include dev-docs/loads-external-javascript.md %}

### Usage

Expand Down
3 changes: 1 addition & 2 deletions dev-docs/modules/geoedgeRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,7 @@ sidebarType : 1
The Geoedge Realtime module lets publishers block bad ads such as automatic redirects, malware, offensive creatives and landing pages.
To use this module, you'll need to work with [Geoedge](https://www.geoedge.com/publishers-real-time-protection/) to get an account and cutomer key.

{: .alert.alert-warning :}
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
{% include dev-docs/loads-external-javascript.md %}

## Integration

Expand Down
3 changes: 1 addition & 2 deletions dev-docs/modules/medianetRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,7 @@ The module currently provisions Media.net's Intelligent Refresh configured by th

Intelligent Refresh (IR) module lets publisher refresh their ad inventory without affecting page experience of visitors through configured criteria. The module optionally provides tracking of refresh inventory and appropriate targeting in GAM. Publisher configured criteria is fetched via an external JS payload.

{: .alert.alert-warning :}
Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.
{% include dev-docs/loads-external-javascript.md %}

## Configuration

Expand Down
29 changes: 29 additions & 0 deletions dev-docs/publisher-api-reference/setConfig.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ Core config:
* [Turn on send all bids mode](#setConfig-Send-All-Bids)
* [Configure send bids control](#setConfig-Send-Bids-Control)
* [Bid cache](#setConfig-Use-Bid-Cache)
* [Minimum bid cache TTL](#setConfig-minBidCacheTTL)
* [Event history TTL](#setConfig-eventHistoryTTL)
* [Set the order in which bidders are called](#setConfig-Bidder-Order)
* [Set the page URL](#setConfig-Page-URL)
* [Set price granularity](#setConfig-Price-Granularity)
Expand Down Expand Up @@ -279,6 +281,33 @@ pbjs.setConfig({
});
```

#### Minimum bid cache TTL

<a id="setConfig-minBidCacheTTL"></a>

By default, Prebid keeps every bid it receives stored in memory until the user leaves the page. This can cause high memory usage on long-running single-page apps; you can configure Prebid to drop stale bids from memory with `minBidCacheTTL`:

```javascript
pbjs.setConfig({
minBidCacheTTL: 60 // minimum time (in seconds) that bids should be kept in cache
})
```

When set, bids are only kept in memory for the duration of their TTL or the value of `minBidCacheTTL`, whichever is greater. Setting `minBidCacheTTL: 0` causes bids to be dropped as soon as they expire.

#### Event history TTL

<a id="setConfig-eventHistoryTTL"></a>

By default, Prebid keeps in memory a log of every event since the initial page load, and makes it available to analytics adapters and [getEvents()](/dev-docs/publisher-api-reference/getEvents.html).
This can cause high memory usage on long-running single-page apps; you can set a limit on how long events are preserved with `eventHistoryTTL`:

```javascript
pbjs.setConfig({
eventHistoryTTL: 60 // maximum time (in seconds) that events should be kept in memory
})
```

#### Bidder Order

Set the order in which bidders are called:
Expand Down
Loading

0 comments on commit bd74766

Please sign in to comment.