New adapter: cortex

libraries/teqblazeUtils/bidderUtils.ts

@@ -28,10 +28,9 @@ const PROTOCOL_PATTERN = /^[a-z0-9.+-]+:/i;
 
 type Mode = 'every' | 'some';
 
-interface TeqBlazeBidParams {
-  placementId?: string | number;
-  endpointId?: string | number;
-}
+export type TeqBlazeBidParams =
+  | { placementId: string | number; endpointId?: string | number }
+  | { placementId?: string | number; endpointId: string | number };
 
 interface RequestBody {
   deviceWidth: number;

modules/cortexBidAdapter.md

@@ -0,0 +1,88 @@
+# Overview
+
+```
+Module Name: Cortex Bidder Adapter
+Module Type: Cortex Bidder Adapter
+Maintainer: dev@cortextech.it
+```
+
+# Description
+
+Connects to Cortex exchange for bids.
+Cortex bid adapter supports Banner, Video (instream and outstream) and Native.
+
+# Bid Params
+
+| Name | Scope | Description | Example | Type |
+|---|---|---|---|---|
+| placementId | optional* | Placement ID from the Cortex platform. Required when `endpointId` is not set. | `'testBanner'` | `string` |
+| endpointId | optional* | Endpoint ID from the Cortex platform. Required when `placementId` is not set. | `'testEndpoint'` | `string` |
+
+\* At least one of `placementId` or `endpointId` must be provided.
+
+# Test Parameters
+```
+    var adUnits = [
+                // Will return static test banner
+                {
+                    code: 'adunit1',
+                    mediaTypes: {
+                        banner: {
+                            sizes: [ [300, 250], [320, 50] ],
+                        }
+                    },
+                    bids: [
+                        {
+                            bidder: 'cortex',
+                            params: {
+                                placementId: 'testBanner',
+                            }
+                        }
+                    ]
+                },
+                {
+                    code: 'addunit2',
+                    mediaTypes: {
+                        video: {
+                            playerSize: [ [640, 480] ],
+                            context: 'instream',
+                            minduration: 5,
+                            maxduration: 60,
+                        }
+                    },
+                    bids: [
+                        {
+                            bidder: 'cortex',
+                            params: {
+                                placementId: 'testVideo',
+                            }
+                        }
+                    ]
+                },
+                {
+                    code: 'addunit3',
+                    mediaTypes: {
+                        native: {
+                            title: {
+                                required: true
+                            },
+                            body: {
+                                required: true
+                            },
+                            icon: {
+                                required: true,
+                                size: [64, 64]
+                            }
+                        }
+                    },
+                    bids: [
+                        {
+                            bidder: 'cortex',
+                            params: {
+                                placementId: 'testNative',
+                            }
+                        }
+                    ]
+                }
+            ];
+```

modules/cortexBidAdapter.ts

@@ -0,0 +1,25 @@
+import { type BidderSpec, registerBidder } from '../src/adapters/bidderFactory.js';
+import { BANNER, NATIVE, VIDEO } from '../src/mediaTypes.js';
+import { isBidRequestValid, buildRequests, interpretResponse, getUserSyncs, type TeqBlazeBidParams } from '../libraries/teqblazeUtils/bidderUtils.ts';
+
+declare module '../src/adUnits' {
+  interface BidderParams {
+    [BIDDER_CODE]: TeqBlazeBidParams;
+  }
+}
+
+const BIDDER_CODE = 'cortex';
+const AD_URL = 'https://eu.targetadserver.com/pbjs';
+const SYNC_URL = 'https://sync.targetadserver.com';
+
+export const spec: BidderSpec<typeof BIDDER_CODE> = {
+  code: BIDDER_CODE,
+  supportedMediaTypes: [BANNER, VIDEO, NATIVE],
+
+  isBidRequestValid: isBidRequestValid(),
+  buildRequests: buildRequests(AD_URL),
+  interpretResponse,
+  getUserSyncs: getUserSyncs(SYNC_URL)
+};
+
+registerBidder(spec);