ETARGET adapter ortb2 site and user specs

dev-docs/bidders/etarget.md

@@ -2,6 +2,21 @@
 layout: bidder
 title: Etarget
 description: Prebid Etarget Bidder Adaptor 
+dev_docs
+nav_section: reference
+hide: true
+biddercode: etarget
+media_types: banner, video
+gdpr_supported: true
+usp_supported: true
+pbjs: true
+fpd_supported: true
+gvl_id: 29
+---
+
+
+### bid params
+=======
 pbjs: true
 biddercode: etarget
 media_types: banner, video
@@ -16,5 +31,66 @@ fpd_supported: true
 
 | Name | Scope | Description | Example |
 | :--- | :---- | :---------- | :------ |
-| `refid` | required | | `12345` |
+| `refid` | required | Placement ID | `12345` |
 | `country` | required | Country domain | `1` |
+| `options` | optional | Additional data | `{site:'example.com'}` |
+
+#### First Party Data
+
+In release 5.0 and later, publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+- ortb2.site.ext.data.*
+- ortb2.site.keywords
+- ortb2.site.content.data[]
+- ortb2.user.ext.data.*
+- ortb2.user.data[]
+
+With regards to Contextual and Audience segments, the Magnite exchange supports the IAB standard taxonomies. See [the segment management user guide](https://resources.rubiconproject.com/resource/publisher-resources/segment-management-user-guide/) for more information.
+
+Example first party data that's available to all bidders and all adunits:
+```
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      keywords: "kw1,kw2",            
+      ext: {
+        data: {
+           prodtype: ["tech","mobile"] 
+        }
+      }
+    },
+    user: {
+      ext: {
+        data: {
+          ucat:["new"]                 
+        }
+      }
+    }
+  }
+};
+```
+
+Example of first party data available only to the ETARGET bidder. Applies across all ad units.
+```
+pbjs.setBidderConfig({
+  bidders: ["etarget"],
+  config: {
+    ortb2: {
+      site: {
+        keywords: "kw1,kw2",             
+        ext: {
+          data: {
+            prodtype: ["tech","mobile"]  
+          }
+        }
+      },
+      user: {
+        ext: {
+          data: {
+            ucat:["new"]                 
+          }
+        }
+      }
+    }
+  }
+};
+```