Additional mobile SDK video parameters, add auctionSettingsId (#5979)

* docs: new video params

* docs: add info about global property 'auctionSettingsId'.

* docs: wordsmithing

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: fix typo

---------

Co-authored-by: bretg <bgorsline@gmail.com>

Author: mdanylov-sigma

_includes/mobile/video-params.md

@@ -20,7 +20,8 @@ Notes:
 {: .alert.alert-warning :}
 Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
 
-#### plcmnt
+#### plcmt
+
 {:.no_toc}
 
 The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--plcmt-subtypes---video-) Placement Type for the auction can be expressed as an integer or you can use an enum for easier readability.
@@ -31,7 +32,7 @@ The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/
 - `4` or `NoContent` or `Standalone` : Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.
 
 Notes:
-- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmnt=3 if no placement value is supplied.
+- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmt=3 if no placement value is supplied.
 
 {: .alert.alert-warning :}
 Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
@@ -99,3 +100,31 @@ Array of OpenRTB 2.6 playback methods. If none are specified, any method may be
 - `6` or `Signals.Protocols.VAST_3_0_Wrapper` : VAST 3.0 Wrapper
 - `7` or `Signals.Protocols.VAST_4_0` : VAST 4.0
 - `8` or `Signals.Protocols.VAST_4_0_Wrapper` : VAST 4.0 Wrapper
+
+#### battr
+{:.no_toc}
+
+  Array or enum of OpenRTB 2.6 blocked creative attributes. Values can be one of:
+
+- `1` or `Signals.CreativeAttribute.AudioAd_Autoplay` : Audio Ad (Autoplay)
+- `2` or `Signals.CreativeAttribute.AudioAd_UserInitiated` : Audio Ad (User Initiated)
+- `3` or `Signals.CreativeAttribute.Expandable_Automatic` : Expandable (Automatic)
+- `4` or `Signals.CreativeAttribute.Expandable_Click` : Expandable (User Initiated - Click)
+- `5` or `Signals.CreativeAttribute.Expandable_Rollover` : Expandable (User Initiated - Rollover)
+- `6` or `Signals.CreativeAttribute.InBanner_Autoplay` : In-Banner Video Ad (Autoplay)
+- `7` or `Signals.CreativeAttribute.InBanner_UserInitiated` : In-Banner Video Ad (User Initiated)
+- `8` or `Signals.CreativeAttribute.Pop` : Pop (e.g., Over, Under, or Upon Exit)
+- `9` or `Signals.CreativeAttribute.Provocative` or `Signals.CreativeAttribute.SuggestiveImagery` : Provocative or Suggestive Imagery
+- `10` or `Signals.CreativeAttribute.Shaky`, `Signals.CreativeAttribute.Flashing`, `Signals.CreativeAttribute.Flickering`, `Signals.CreativeAttribute.ExtremeAnimation` or `Signals.CreativeAttribute.Smileys` : Shaky, Flashing, Flickering, Extreme Animation, Smileys
+- `11` or `Signals.CreativeAttribute.Surveys` : Surveys
+- `12` or `Signals.CreativeAttribute.TextOnly` : Text Only
+- `13` or `Signals.CreativeAttribute.UserInteractive` : User Interactive (e.g., Embedded Games)
+- `14` or `Signals.CreativeAttribute.WindowsDialog` or `Signals.CreativeAttribute.AlertStyle` : Windows Dialog or Alert Style
+- `15` or `Signals.CreativeAttribute.AudioButton` : Has Audio On/Off Button
+- `16` or `Signals.CreativeAttribute.SkipButton` : Ad Provides Skip Button (e.g. VPAID-rendered skip button on pre-roll video)
+- `17` or `Signals.CreativeAttribute.AdobeFlash` : Adobe Flash
+
+#### isSkippable
+{:.no_toc}
+
+Boolean representing the OpenRTB 2.6 video ad skippability.

prebid-mobile/pbm-api/android/code-integration-android.md

@@ -323,6 +323,16 @@ To stop sending stored bid response signals use the following method:
 void clearStoredBidResponses()
 ```
 
+### AuctionSettingsId
+{:.no_toc}
+
+Allows you to separate account from "auction settings". This is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. This allows each app to have different global parameters like timeout, price granularity, etc. Please work with your Prebid Server provider to determine what to enter here. 
+
+```kotlin
+PrebidMobile.setAuctionSettingsId(YOUR_AUCTION_SETTINGS_ID)
+var auctionSettingsId = PrebidMobile.getAuctionSettingsId()
+```
+
 ### Debug
 {:.no_toc}
 

prebid-mobile/pbm-api/android/pbm-targeting-android.md

@@ -188,6 +188,29 @@ void clearStoredBidResponses()
 
 Parameters: none.
 
+#### setAuctionSettingsId()
+
+For the SDK to separate out account from "auction settings".
+
+Signature:
+
+```kotlin
+func setAuctionSettingsId(settingsId: String)
+```
+
+Parameters: 
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| settingsId | optional | string | Use the settingsId to separate account from "auction settings", allowing each app to have different global parameters defined on the server side. If specified, the settingsId is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. | "abc321" |
+
+Examples:
+
+```kotlin
+PrebidMobile.setAuctionSettingsId("abc321")
+```
+
 #### setLogLevel
 
 Controls the level of logging output to the console.

prebid-mobile/pbm-api/ios/code-integration-ios.md

@@ -257,6 +257,8 @@ The `Prebid` class is a singleton that enables the user to apply global settings
 
 `prebidServerHost`: String containing configuration your Prebid Server host with which Prebid SDK will communicate. Choose from the system-defined Prebid Server hosts or define your own custom Prebid Server host.
 
+`auctionSettingsId`: Allows you to separate account from "auction settings". This is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. This allows each app to have different global parameters like timeout, price granularity, etc. Please work with your Prebid Server provider to determine what to enter here. 
+
 `shareGeoLocation`: Optional Bool, if this flag is True AND the app collects the user’s geographical location data, Prebid Mobile will send the user’s geographical location data to Prebid Server. If this flag is False OR the app does not collect the user’s geographical location data, Prebid Mobile will not populate any user geographical location information in the call to Prebid Server. The default setting is false.
 
 `logLevel`: Optional level of logging to output in the console. Options are one of the following sorted by a verbosity of the log:
@@ -378,6 +380,9 @@ do {
 // Account Id
 Prebid.shared.prebidServerAccountId = "1234"
 
+// Auction Settings Id (Optional)
+Prebid.shared.auctionSettingsId = "7890"
+
 // Geolocation
 Prebid.shared.shareGeoLocation = true
 

prebid-mobile/pbm-api/ios/pbm-targeting-ios.md

@@ -48,6 +48,7 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 | prebidServerAccountId | either | string | init | Your Prebid Server team will tell you whether this is required or not and if so, the value. | "abc123" |
 | prebidServerHost | optional | enum | init | Starting from PrebidMobile `3.0.0` the property is removed<wbr>This can take the values "Appnexus", "Rubicon", or "Custom". If "Custom", you need to use the setCustomPrebidServerUrl() method to set a URL. This is where the Prebid SDK will send the auction information. Your Prebid Server team will tell you which value to use. The default is "Custom". | "Custom" |
 | customStatusEndpoint | optional | string | init | Use this URL to check the status of Prebid Server. The default status endpoint is the PBS URL appended with '/status'. | `https://prebidserver`<wbr>`.example`<wbr>`.com/custom`<wbr>`/status` |
+| auctionSettingsId | optional | string | init | For the SDK to separate account from "auction settings", allowing each app to have different global parameters defined on the server side. If specified, the auctionSettingsId is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is populated by default. | "abc321" |
 | shareGeoLocation | optional | boolean | ORTB | If this flag is true AND the app collects the user’s geographical location data, Prebid Mobile will send the user’s lat/long geographical location data to the Prebid Server. The default is false. | `true` |
 | locationUpdatesEnabled | optional | boolean | ORTB | If true, the SDK will periodically try to listen for location updates. Default is `false`. | `true` |
 | logLevel | optional | enum | SDK control | This property controls the level of logging output to the console. The value can be .error, .info, .debug, .verbose, .warn, .severe, and .info. The default is `.debug`. | `.error` |