Alvads Bid Adapter : initial release

[SamuelAlejandroNT]

alvadsBidAdapter: support OpenRTB 2.5 POST requests with banner & video
Documentation PR: prebid/prebid.github.io#6231

Overview

Module Name: alvadsBidAdapter
Module Type: bidder
Maintainer: [email protected]

Type of Change

• New bidder adapter
• Feature
• Bugfix
• Refactoring / code style / build / CI

---

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 for both banner and video
• Dynamic Endpoints: The adapter can use a default endpoint or a custom endpoint provided in the bid params.

---

Test Parameters

Banner Example

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

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

• Endpoint:

  https://helios-ads-qa-core.ssidevops.com/decision/openrtb
  

• Method: POST
• Payload: OpenRTB 2.5 request containing site, device, user, regs, imp.
• Dynamic Endpoint: The request URL can be overridden by bid.params.endpoint.

Response Information

Banner

The response is standard OpenRTB with seatbid. Example:

{
  "id": "response-id",
  "seatbid": [{
    "bid": [{
      "impid": "imp-123",
      "price": 0.50,
      "adm": "<div>Creative</div>",   
      "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 ad contains the HTML.

Additional Details

• Defaults:

  • netRevenue = true
  • ttl = 300
  • Banner fallback size: 320x100
  • Video fallback size: 1280x720

• Callbacks:

  • onTimeout → logs timeout events
  • onBidWon → logs winning bid

[SamuelAlejandroNT]

Hi, I noticed that the failing tests don’t seem related to this adapter. Could it be that they are flaky in CI (since window.pbjs sometimes shows as undefined)?

All unit tests for alvadsBidAdapter are passing locally. Just wanted to check if this is expected or if I should re-run the workflow.

[SamuelAlejandroNT]

Hi, tests are passing. Waiting for workflow approval from a maintainer.

[github-actions]

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

• modules/alvadsBidAdapter.js (+1 error)

[osazos]

• Your adapter must support the floors module

Please link your prebid.github.io PR.

[osazos]

Thx for the update.

After reading it again:

• I opened two new threads
• I also missed asking you to move your test file into test/spec/modules/

It should be good after that.

[SamuelAlejandroNT]

@osazos, thanks for the feedback

[osazos]

LGTM