From a983122fd30f34d12dc1c174f4b2dde7a55526c3 Mon Sep 17 00:00:00 2001 From: Samuel Alejandro Maldonado Garcia Date: Thu, 28 Aug 2025 09:09:35 -0400 Subject: [PATCH 1/3] Add Alva (alvads) bidder adapter documentation --- dev-docs/bidders/alvads.md | 137 +++++++++++++++++++++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 dev-docs/bidders/alvads.md diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md new file mode 100644 index 0000000000..fa247c1647 --- /dev/null +++ b/dev-docs/bidders/alvads.md @@ -0,0 +1,137 @@ +--- +layout: bidder +title: Alva +description: Prebid Alva Bidder Adapter +pbjs: true +pbs_app_supported: false +biddercode: alvads +media_types: banner, video +--- + +# Overview + +**Module Name:** alvadsBidAdapter +**Module Type:** Bidder +**Maintainer:** [alvads@oyealva.com](mailto:alvads@oyealva.com) + +--- + +# Description + +The **Alva Bid Adapter** allows publishers to connect their banner and video inventory with the Alva demand platform. + +- **Bidder Code:** `alvads` +- **Supported Media Types:** `banner`, `video` +- **Protocols:** OpenRTB 2.5 via `POST` (banner and video) +- **Dynamic Endpoints:** The adapter uses a default endpoint, but can be overridden via `params.endpoint`. + +--- + +# Test Parameters + +### Banner Example + +```javascript +var adUnits = [{ + code: 'div-banner', + mediaTypes: { + banner: { + sizes: [[300, 250], [320, 100]] + } + }, + bids: [{ + bidder: 'alvads', + params: { + publisherId: 'pub-123', // required + tagid: 'tag-456', // required for banner + bidfloor: 0.50, // optional + userId: '+59165352182', // optional + endpoint: 'https://custom-endpoint.com/openrtb' // optional, overrides default + } + }] +}]; +``` + +### Video Example + +```javascript +var adUnits = [{ + code: 'video-ad', + mediaTypes: { + video: { + context: 'instream', + playerSize: [[640, 360]] + } + }, + bids: [{ + bidder: 'alvads', + params: { + publisherId: 'pub-123', // required + bidfloor: 0.5, // optional + userId: '+59165352182', // optional + endpoint: 'https://custom-endpoint.com/video' // optional, overrides default + } + }] +}]; +``` + +--- + +# Request Information + +### Banner / Video +- **Default Endpoint:** + ``` + https://helios-ads-qa-core.ssidevops.com/decision/openrtb + ``` +- **Method:** `POST` +- **Payload:** OpenRTB 2.5 request containing `site`, `device`, `user`, `regs`, and `imp`. +- **Dynamic Endpoint:** Can be overridden via `bid.params.endpoint`. + +--- + +# Response Information + +### Banner +The response is standard OpenRTB with `seatbid`. + +```json +{ + "id": "response-id", + "seatbid": [{ + "bid": [{ + "impid": "imp-123", + "price": 0.50, + "adm": "
Creative
", + "crid": "creative-1", + "w": 320, + "h": 100, + "ext": { + "vast_url": "http://example.com/vast.xml" + }, + "adomain": ["example.com"] + }] + }], + "cur": "USD" +} +``` + +### Interpretation +- If `adm` contains ``, the adapter sets `mediaType: 'video'` and includes `vastXml` & `vastUrl`. +- Otherwise, `mediaType: 'banner'` and the ad contains the HTML markup. + +--- + +# Additional Details + +- **Defaults:** + - `netRevenue = true` + - `ttl = 300` + - Banner fallback size: `320x100` + - Video fallback size: `1280x720` + +- **Callbacks:** + - `onTimeout` → logs timeout events + - `onBidWon` → logs winning bids + +--- From 0c68c7bb6ca8d79d43255de60ad5d151583c6b6b Mon Sep 17 00:00:00 2001 From: Samuel Alejandro Maldonado Garcia Date: Thu, 28 Aug 2025 09:18:57 -0400 Subject: [PATCH 2/3] initial doc --- dev-docs/bidders/alvads.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md index fa247c1647..c7de495ca6 100644 --- a/dev-docs/bidders/alvads.md +++ b/dev-docs/bidders/alvads.md @@ -6,6 +6,9 @@ pbjs: true pbs_app_supported: false biddercode: alvads media_types: banner, video +gdpr_supported: true +usp_supported: true +coppa_supported: false --- # Overview From d65911deab92b4d2ac97faa579bf3669a2ac65f0 Mon Sep 17 00:00:00 2001 From: Samuel Alejandro Maldonado Garcia Date: Thu, 11 Sep 2025 09:55:31 -0400 Subject: [PATCH 3/3] added bidfloor support --- ADS - Acceso directo.lnk | Bin 0 -> 885 bytes dev-docs/bidders/alvads.md | 12 ++++++++++++ 2 files changed, 12 insertions(+) create mode 100644 ADS - Acceso directo.lnk diff --git a/ADS - Acceso directo.lnk b/ADS - Acceso directo.lnk new file mode 100644 index 0000000000000000000000000000000000000000..192bf02077e7d432721f25569068a5ae8812c27b GIT binary patch literal 885 zcmah{Ur3Wt6hEJtxE^w=Wow$wLQ||Ut%o)mxVCbL;b5$yt=QZqF5SMlZ`FcI>7kGu z1rfxckg{aaAA_PIEMKf1dRRSJ<{o;r43l1Z3HqJ8RCs=P9x&B0cLL&nakqrcA0GCAU9lV zfc-!vz?@m{0C;%-9k2pON6dLX_kl<(B%e^oZt;1Pa6<7ZfoPyNB*y|F+2;r=JxMw4 zV>+~wjQD&)`U_Qt4?^>bHOG=krE_sF-3dRfY0kRr=T80TKT>i!(>RuTv!(32=Kkfm z;D-n6)BlUV26YwD@JZBea=YB$Oyi&IG}t=&Gq-j`>DqJ{{t!2=25Nylq)?C&6rm)^ zLd#^Jda{!Rls$+Zqre}(0*`{fDA0>CGR0uAZs3w)U4`VvriI!k^R0UIt%V~0(Dko( zH^9G&Gq`avuz2t5V3z^Z!Xlce;9=s2;v|u+g|-V4aSDTG00cv@48j+rZje6?5(@IT z+G;>lTN*|D_W{i7_R(Oy^~!tA<0+cxnAYX^X{!LysRnxa;9(s5-$(XgZo-K7h>MHk uY8Fq#)e5u54Ih?A9rx04=cu#AIATo=ZA7e_6P!TFFY`FtL?)iCzt(R7=D}D1 literal 0 HcmV?d00001 diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md index c7de495ca6..9f605579d4 100644 --- a/dev-docs/bidders/alvads.md +++ b/dev-docs/bidders/alvads.md @@ -27,6 +27,18 @@ The **Alva Bid Adapter** allows publishers to connect their banner and video inv - **Supported Media Types:** `banner`, `video` - **Protocols:** OpenRTB 2.5 via `POST` (banner and video) - **Dynamic Endpoints:** The adapter uses a default endpoint, but can be overridden via `params.endpoint`. +- **Price Floors:** Supported via `bid.getFloor()`. If configured, the adapter will send `bidfloor` and `bidfloorcur` per impression. + +--- +# Parameters + +| Parameter | Required | Description | +|------------ |---------------- |------------ | +| publisherId | Yes | Publisher ID assigned by Alva | +| tagid | Banner only | Required for banner impressions | +| bidfloor | No | Optional; adapter supports floors module via `bid.getFloor()` | +| userId | No | Optional; used for user identification | +| endpoint | No | Optional; overrides default endpoint | ---