Added Android and iOS Documentation for arbitrary ORTB

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

@@ -31,17 +31,17 @@
 
 If you need to use a CMP way, ensure that you don't set any of the following API properties. 
 
 
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
 
 ### Subject To GPDR
 {:.no_toc}
 
 Enable (true) or disable (false) the ability to provide consent.
 
 ```
 TargetingParams.isSubjectToGDPR()
 TargetingParams.setSubjectToGDPR(true)
 ```
@@ -49,7 +49,7 @@
 ### GDPR Consent String
 {:.no_toc}
 
 ```
 val consent = TargetingParams.getGDPRConsentString();
 TargetingParams.setGDPRConsentString(string);
 ```
@@ -57,7 +57,7 @@
 ### Purpose Consent
 {:.no_toc}
 
 ```
 val consent = TargetingParams.getPurposeConsents()
 TargetingParams.setPurposeConsents(string)
 ```
@@ -68,11 +68,11 @@
 
 Example:
 
 ```
 TargetingParams.setSubjectToCOPPA(true);
 ```
 
 
 ## Parameters
 
 The tables below list the methods and properties that the Prebid Rendering API uses for customization.
@@ -81,7 +81,7 @@
 It is advised that you strictly follow the recommendations in the tables below. Any field marked with an ❗is required and recommended. 
 
 1. [Targeting Params](#targeting)
 2. [SDK Settings](#prebidrenderingsettings)
 
 ### Targeting
 
@@ -99,11 +99,11 @@
 | Keywords                   | `addUserKeywords`         | Comma separated list of keywords, interests, or intent. | Optional |
 | Lat, Lon                   | `setUserLatLng`           | Location of the user’s home base defined by a provided longitude and latitude. It's highly recommended to provide Geo data to improve the request.| Optional |
 | Publisher Name                  | `setPublisherName`        | Publisher name (may be aliased at the publisher’s request).| Recommended if available  |
 | Store Url               | `setStoreUrl`    | The URL for the mobile application in Google Play. That field is required in the request. <br />**For example:**` https://play.google.com/store/apps/details?id=com.outfit7.talkingtom`. | ❗ Required  |
 | User ID                        | `setUserId`               | ID of the user within the app. For example: `"24601"` | ❗ Highly Recommended  |
 |Year of Birth|`setYearOfBirth`| The year of user's birth||
 
 
 Example:
 
 ``` java
@@ -113,6 +113,22 @@
 TargetingParams.setUserAge(18); 
 ```
 
+### ORTBConfig
+
+(requires SDK v2.2.1)
+
+Provides a way for app publishers to customize most ORTB fields in the partial bid request that Prebid Mobile sends to the Prebid Server.  The customization comes in the form of the ortbConfig parameter that takes a JSON String as input.  The JSON string must follow the [ORTB guidelines](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/develop/2.6.md#321---object-bidrequest-) as it will be merged with the current JSON of the bid request. If you choose to input extra data using the setORTBConfig() method, please extensively test your requests sent to Prebid Server. 
+
+There are certain protected fields such as regs, device, geo, ext.gdpr, ext.us_privacy, and ext.consent which cannot be changed.
+
+``` kotlin
+adUnitConfiguration?.ortbConfig = "{"ext":{"prebid":{"debug":1,"trace":"verbose"}}}"
+```
+
+``` kotlin
+adUnit?.ortbConfig = "{"ext":{"prebid":{"debug":1,"trace":"verbose"}}}"
+```
+
 ### Global User Targeting
 
 

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

@@ -266,6 +266,22 @@ Store location in the user's section
 public func setLatitude(_ latitude: Double, longitude: Double)
 ```
 
+### ORTBConfig
+
+(requires SDK v2.2.1)
+
+Provides a way for app publishers to customize most ORTB fields in the partial bid request that Prebid Mobile sends to the Prebid Server.  The customization comes in the form of the setORTBConfig() method that takes a JSON String as input.  The JSON string must follow the [ORTB guidelines](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/develop/2.6.md#321---object-bidrequest-) as it will be merged with the current JSON of the bid request. If you choose to input extra data using the setORTBConfig() method, please extensively test your requests sent to Prebid Server. 
+
+There are certain protected fields such as regs, device, geo, ext.gdpr, ext.us_privacy, and ext.consent which cannot be changed.
+
+``` swift
+adUnitConfig.setOrtbConfig("{"ext":{"prebid":{"debug":1,"trace":"verbose"}}}")
+```
+
+``` swift
+adUnit.setOrtbConfig("{"ext":{"prebid":{"debug":1,"trace":"verbose"}}}")
+```
+
 ## User Identity API
 
 Prebid SDK supports two interfaces to pass / maintain User IDs and ID vendor details: