Start.io: setting buyeruid on the OpenRTB request, md files updated (prebid#14650)

* Start.io - Create User ID submodule and improve adapter

* Update modules/startioIdSystem.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix: Adjust spacing formatting in getStorageManager parameters

* Fix: Adjust spacing formatting in getStorageManager parameters (#2)

* Refactor: Remove unused storage management logic from StartIO ID module and set default storage expiration

* Refactor: Remove unused storage management logic from StartIO ID module and set default storage expiration

* Enhance: Add configurable storage options and expiration to StartIO ID module

* Docs: Update StartIO ID module documentation with storage configuration details

* Docs: Update StartIO ID module documentation with storage configuration details

* Docs: Add build instructions and module details to Start.io ID system file (#4)

* Docs: Add build instructions and module details to Start.io ID system documentation (#5)

* Apply suggestion from @IlliaMil

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Matan Arbel <matan.arbel@start.io>

Author: 3 people

modules/startioBidAdapter.js

@@ -51,6 +51,11 @@ const converter = ortbConverter({
       request.regs.ext.us_privacy = bidderRequest.uspConsent;
     }
 
+    const startioEid = request.user?.ext?.eids?.find(eid => eid.source === 'start.io');
+    if (startioEid?.uids?.[0]?.id) {
+      request.user.buyeruid = startioEid.uids[0].id;
+    }
+
     request.bcat = ortb?.bcat || bidParams?.bcat;
     request.badv = ortb?.badv || bidParams?.badv;
     request.bapp = ortb?.bapp || bidParams?.bapp;

modules/startioBidAdapter.md

@@ -10,6 +10,14 @@ Maintainer: prebid@start.io
 
 The Start.io Bid Adapter enables publishers to integrate with Start.io's demand sources for banner, video and native ad formats. The adapter supports OpenRTB standards and processes bid requests efficiently using the Prebid.js framework.
 
+# Build
+
+To build Prebid.js with the Start.io User ID submodule and bid adapter, include the following modules:
+
+```bash
+gulp build --modules=startioBidAdapter,userId,startioIdSystem,consentManagementTcf,consentManagementGpp,consentManagementUsp,...
+```
+
 # Test Parameters
 ```
 var adUnits = [

modules/startioIdSystem.md

@@ -4,6 +4,14 @@ The Start.io User ID submodule generates and persists a unique user identifier b
 
 For integration support, contact prebid@start.io.
 
+## Build
+
+To build Prebid.js with the Start.io User ID submodule and bid adapter, include the following modules:
+
+```bash
+gulp build --modules=startioBidAdapter,userId,startioIdSystem,consentManagementTcf,consentManagementGpp,consentManagementUsp,...
+```
+
 ### Prebid Params Enabling User Sync
 
 To enable iframe-based user syncing for Start.io, include the `filterSettings` configuration in your `userSync` setup:

test/spec/modules/startioBidAdapter_spec.js

@@ -259,6 +259,41 @@ describe('Prebid Adapter: Startio', function () {
       expect(request.regs.coppa).to.equal(1);
     });
 
+    it('should set buyeruid from start.io eid', function () {
+      let bidderRequest = deepClone(DEFAULT_BIDDER_REQUEST);
+      bidderRequest.ortb2 = {
+        user: {
+          ext: {
+            eids: [
+              { source: 'start.io', uids: [{ id: 'test-startio-id', atype: 1 }] }
+            ]
+          }
+        }
+      };
+
+      const request = spec.buildRequests([DEFAULT_REQUEST_DATA], bidderRequest)[0].data;
+
+      expect(request.user).to.exist;
+      expect(request.user.buyeruid).to.equal('test-startio-id');
+    });
+
+    it('should not set buyeruid when start.io eid is absent', function () {
+      let bidderRequest = deepClone(DEFAULT_BIDDER_REQUEST);
+      bidderRequest.ortb2 = {
+        user: {
+          ext: {
+            eids: [
+              { source: 'other.com', uids: [{ id: 'other-id', atype: 1 }] }
+            ]
+          }
+        }
+      };
+
+      const request = spec.buildRequests([DEFAULT_REQUEST_DATA], bidderRequest)[0].data;
+
+      expect(request.user?.buyeruid).to.not.exist;
+    });
+
     it('should provide blocked parameters', function () {
       let bidRequest = deepClone(DEFAULT_REQUEST_DATA);
       let bidderRequest = deepClone(DEFAULT_BIDDER_REQUEST);