updating stage from master (#2316)

* reverted optanon in header (#2315) Co-authored-by: Steve <ssuranie@appnexus.com> * LiveIntent registration link fix (#2300) * Add LiveIntent ID module to the overview * Update LiveIntent ID docs - remove 'providedIdentifierName' parameter, as it's removed from code (prebid/Prebid.js#5407) - adjust links in the docs - new privacy policy - code examples updated to include the storage part * typo fix * added registration information * LiveIntent registration link fix * Update oftmedia.md (#2308) forgot to insert the code " schain_supported: true", same as appnexus. thanks! * Delete pb-is-amp.html (#2311) Duplicate file with trailing space after the name * Update invibes.md (#2312) * parrableIdSystem: Add an optional timezone and timezone offset allow/block filter (#2184) * PBID-11: Update Parrable ID system configuration example to remove storage options * PBID-25: Add docs for Parrable ID timezone filtering feature config * PBID-25: Fix grammar in userId timezone filtering * add native support for ablida bid adapter (#2164) * Blue Billywig bid adapter - add video param to docs (#2198) * add Blue Billywig bidder adaptor dev docs * Add missing empty line * move empty line to right place... Co-authored-by: Klaas-Jan Boon <klaas-janboon@live.nl> Co-authored-by: Klaas-Jan Boon <klaas-janboon@ip-172-16-224-85.eu-west-1.compute.internal> * Document auctionDebug (#2255) * Document auctionDebug * Update integrate-with-the-prebid-analytics-api.md Co-authored-by: MartianTribe <steve@martiantribe.com> Co-authored-by: Steve <ssuranie@appnexus.com> Co-authored-by: amoltchan <56824198+amoltchan@users.noreply.github.com> Co-authored-by: murilodiko <murilomcozza@gmail.com> Co-authored-by: AaronColbyPrice <67345931+AaronColbyPrice@users.noreply.github.com> Co-authored-by: invibes <51820283+invibes@users.noreply.github.com> Co-authored-by: Ian Flournoy <ian@flournoy.us> Co-authored-by: Dan <webmaster@kakao-karten.de> Co-authored-by: Klaas-Jan Boon <awisoewas@gmail.com> Co-authored-by: Klaas-Jan Boon <klaas-janboon@live.nl> Co-authored-by: Klaas-Jan Boon <klaas-janboon@ip-172-16-224-85.eu-west-1.compute.internal> Co-authored-by: Patrick McCann <patmmccann@gmail.com>
prebid · Sep 8, 2020 · 83f8ac7 · 83f8ac7
1 parent 530893e
commit 83f8ac7
Show file tree

Hide file tree

Showing 8 changed files with 35 additions and 138 deletions.
diff --git a/_includes/video/pb-is-amp.html b/_includes/video/pb-is-amp.html
diff --git a/dev-docs/bidders/ablida.md b/dev-docs/bidders/ablida.md
@@ -3,7 +3,7 @@ layout: bidder
 title: ablida
 description: Prebid ablida Bidder Adaptor
 pbjs: true
-media_types: banner
+media_types: banner, native
 biddercode: ablida
 ---
 

diff --git a/dev-docs/bidders/bluebillywig.md b/dev-docs/bidders/bluebillywig.md
@@ -22,3 +22,4 @@ userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrable
 | `accountId`    | required | Your publication ID at Blue Billywig  | `642` | `integer` |
 | `rendererCode`    | required | The name of the renderer to use in your Blue Billywig publication  | `"renderer"` | `string` |
 | `connections`     | required | Back-ends to connect with. For every value in this a param matching the back-end should exist too. | `["bluebillywig"]` | `array` |
+| `video`     | optional | Any OpenRTB 2.5 video params to additionally send along to the SSPs. | `{"maxduration": 30}` | `object` |
diff --git a/dev-docs/bidders/invibes.md b/dev-docs/bidders/invibes.md
@@ -6,6 +6,7 @@ pbjs: true
 biddercode: invibes
 gdpr_supported: true
 tcf2_supported: true
+pbs: true
 ---
 
 ### Bid Params

diff --git a/dev-docs/bidders/oftmedia.md b/dev-docs/bidders/oftmedia.md
@@ -10,6 +10,7 @@ tcf2_supported: true
 coppa_supported: true
 usp_supported: true
 pbs: true
+schain_supported: true
 ---
 
 ### Bid Params

diff --git a/dev-docs/integrate-with-the-prebid-analytics-api.md b/dev-docs/integrate-with-the-prebid-analytics-api.md
@@ -135,6 +135,10 @@ The callback will receive an object with the following attributes:
 }
 ```
 
+#### Listening for errors
+
+There are two error events analytics modules may wish to listen for: auctionDebug and adRenderFailed. The former is any error that would be normally logged to console and there can be a great many. The latter may happen for the following reasons: (PREVENT_WRITING_ON_MAIN_DOCUMENT, NO_AD, CANNOT_FIND_AD, EXCEPTION, MISSING_DOC_OR_ADID)
+
 #### Analytics adapter best practices
 
 + listen only to the events required

diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md
@@ -426,7 +426,7 @@ The adapters can be implemented to use the lipibid as the identifier and segment
 
 #### LiveIntent ID Registration
 
-Please register with us if you’re not a LiveIntent customer already: https://www.liveintent.com/prebid-registration/
+Please register with us if you’re not a LiveIntent customer already: [https://www.liveintent.com/prebid-registration/](https://www.liveintent.com/prebid-registration/)
 
 When adding LiveIntent’s ID to your Prebid.js package, you disclose or make available Personal Information to LiveIntent.  This information made available to LiveIntent is used to (i) connect with and reference data that already exists in LiveIntent’s graph (the “LiveIntent Graph”), and (ii) authenticate and validate data in aggregate to improve the performance of the services LiveIntent provides. By activating LiveIntent’s module, you hereby confirm that with regard to all individuals to whom Personal Information relates, you have, at or before the point of collecting Personal Information or making Personal Information available to LiveIntent, provided any legally required notices, obtained any legally required consents, and provided individuals with an opportunity to opt-out of the sharing of Personal Information, if such an opt-out is required under applicable laws, such that LiveIntent can provide service to you as described here and in LiveIntent’s privacy policies for the services which can be found at [https://www.liveintent.com/services-privacy-policy/](https://www.liveintent.com/services-privacy-policy/) 
 
@@ -616,6 +616,12 @@ In addition to the parameters documented above in the Basic Configuration sectio
 | --- | --- | --- | --- | --- |
 | params | Required | Object | Details for the Parrable ID. | |
 | params.partner | Required | String | A list of one or more comma-separated Parrable Partner Client IDs for the Parrable-aware bid adapters you are using.  Please obtain Parrable Partner Client IDs from them and/or obtain your own. | `'30182847-e426-4ff9-b2b5-9ca1324ea09b'` |
+| params.timezoneFilter | Optional | Object | Configures a timezone or timezone offset filter | |
+| params.timezoneFilter.allowedZones | Optional | Array[String] | description | `[ 'America/Anchorage' ]` |
+| params.timezoneFilter.allowedOffsets | Optional | Array[Number] | description | `[ -4 ]` |
+| params.timezoneFilter.blockedZones | Optional | Array[String] | description | `[ 'America/New_York' ]` |
+| params.timezoneFilter.blockedOffsets | Optional | Array[Number] | description | `[ -5 ]` |
+
 
 {: .alert.alert-info :}
 NOTE: The Parrable ID that is delivered to Prebid is encrypted by Parrable with a time-based key and updated frequently in the browser to enforce consumer privacy requirements and thus will be different on every page view, even for the same user.
@@ -624,6 +630,15 @@ The Parrable ID system manages a cookie with the name of `_parrable_id` containi
 This cookie is used also by standalone Parrable integrations outside of Prebid.
 It is for this reason that the cookie name is not configurable for the Parrable ID system.
 
+#### Timezone and Timezone Offset Filtering
+
+The Parrable ID system enables a publisher to configure lists of **allowed** timezones (eg. `Europe/Dublin`) and/or timezone offsets (eg. `-4`) as well as a lists of **blocked** timezones and timezone offsets.
+
+- With no configuration (`params.timezoneFilter` not set, or all of the lists are empty) all impressions are permitted.
+- With only allow lists configured a browser must match either a timezone or timezone offset for it to not be filtered.
+- With only block lists configured an impression will be filtered only if it is from a browser matching a blocked timezone or timezone offset.
+- An impression from a browser that matches any allowed timezone or timezone offset, but does not match a blocked timezone or timezone offset will engage in the Parrable ID syncronization process.
+- If a browser has a stored Parrable ID then it will not be filtered even if the browser is in a timezone or timezone offset that is blocked.
 
 #### Parrable ID Examples
 

diff --git a/dev-docs/publisher-api-reference.md b/dev-docs/publisher-api-reference.md
@@ -1211,6 +1211,7 @@ The available events are:
 | requestBids   | Bids have been requested from adapters (i.e. pbjs.requestBids() was called) | None |
 | addAdUnits    | Ad units have been added to the auction | None |
 | adRenderFailed| Ad rendering failed | Object containing 'reason' and 'message' |
+| auctionDebug  | An error was logged to the console | Object containing 'type' and 'arguments' |
 | bidderDone    | A bidder has signaled they are done responding | Bid request object |
 | tcf2Enforcement | There was a TCF2 enforcement action taken | `{ storageBlocked: ['moduleA', 'moduleB'], biddersBlocked: ['moduleB'], analyticsBlocked: ['moduleC'] }` |
 
@@ -1271,6 +1272,16 @@ Events example 3: Dynamically modify the auction
 	pbjs.onEvent('beforeRequestBids', bidderFilter);
 {% endhighlight %}
 
+Events example 4: Log errors and render fails to your own endpoint
+{% highlight js %}
+        pbjs.onEvent('adRenderFailed', function () {
+              // pub-specific logic to call their own endpoint
+            });
+	pbjs.onEvent('auctionDebug', function () {
+              // pub-specific logic to call their own endpoint
+            });
+{% endhighlight %}
+
 <hr class="full-rule" />
 
 <a name="module_pbjs.enableAnalytics"></a>