Missena Adapter: Add formats and settings params

AntoxaAntoxic · AntoxaAntoxic · commit f88ce6f7a4b9 · 2025-05-21T12:58:51.000+02:00
diff --git a/src/main/java/org/prebid/server/bidder/missena/MissenaAdRequest.java b/src/main/java/org/prebid/server/bidder/missena/MissenaAdRequest.java
@@ -1,25 +1,59 @@
 package org.prebid.server.bidder.missena;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.iab.openrtb.request.Eid;
+import com.iab.openrtb.request.SupplyChain;
 import lombok.Builder;
 import lombok.Value;
 
-@Builder(toBuilder = true)
+import java.math.BigDecimal;
+import java.util.List;
+
 @Value
+@Builder(toBuilder = true)
 public class MissenaAdRequest {
 
-    String requestId;
+    @JsonProperty("adunit")
+    String adUnit;
+
+    @JsonProperty("buyeruid")
+    String buyerUid;
+
+    Integer coppa;
+
+    String currency;
+
+    @JsonProperty("userEids")
+    List<Eid> userEids;
 
-    int timeout;
+    BigDecimal floor;
+
+    String floorCurrency;
+
+    @JsonProperty("consent_required")
+    Boolean gdpr;
+
+    @JsonProperty("consent_string")
+    String gdprConsent;
+
+    @JsonProperty("ik")
+    String idempotencyKey;
 
     String referer;
 
     String refererCanonical;
 
-    String consentString;
+    String requestId;
+
+    SupplyChain schain;
+
+    Long timeout;
+
+    String url;
 
-    boolean consentRequired;
+    MissenaUserParams params;
 
-    String placement;
+    String usPrivacy;
 
-    String test;
+    String version;
 }
diff --git a/src/main/java/org/prebid/server/bidder/missena/MissenaBidder.java b/src/main/java/org/prebid/server/bidder/missena/MissenaBidder.java
@@ -6,6 +6,7 @@
 import com.iab.openrtb.request.Imp;
 import com.iab.openrtb.request.Regs;
 import com.iab.openrtb.request.Site;
+import com.iab.openrtb.request.Source;
 import com.iab.openrtb.request.User;
 import com.iab.openrtb.response.Bid;
 import io.vertx.core.MultiMap;
@@ -16,7 +17,9 @@
 import org.prebid.server.bidder.model.BidderCall;
 import org.prebid.server.bidder.model.BidderError;
 import org.prebid.server.bidder.model.HttpRequest;
+import org.prebid.server.bidder.model.Price;
 import org.prebid.server.bidder.model.Result;
+import org.prebid.server.currency.CurrencyConversionService;
 import org.prebid.server.exception.PreBidException;
 import org.prebid.server.json.DecodeException;
 import org.prebid.server.json.JacksonMapper;
@@ -25,8 +28,13 @@
 import org.prebid.server.proto.openrtb.ext.request.ExtUser;
 import org.prebid.server.proto.openrtb.ext.request.missena.ExtImpMissena;
 import org.prebid.server.proto.openrtb.ext.response.BidType;
+import org.prebid.server.util.BidderUtil;
 import org.prebid.server.util.HttpUtil;
+import org.prebid.server.version.PrebidVersionProvider;
 
+import java.math.BigDecimal;
+import java.net.MalformedURLException;
+import java.net.URL;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
@@ -37,31 +45,40 @@ public class MissenaBidder implements Bidder<MissenaAdRequest> {
 
     private static final TypeReference<ExtPrebid<?, ExtImpMissena>> TYPE_REFERENCE = new TypeReference<>() {
     };
-    private static final int AD_REQUEST_DEFAULT_TIMEOUT = 2000;
+    private static final String USD_CURRENCY = "USD";
+    private static final String EUR_CURRENCY = "EUR";
+    private static final String PUBLISHER_ID_MACRO = "{{PublisherID}}";
 
     private final String endpointUrl;
     private final JacksonMapper mapper;
+    private final CurrencyConversionService currencyConversionService;
+    private final PrebidVersionProvider prebidVersionProvider;
+
+    public MissenaBidder(String endpointUrl,
+                         JacksonMapper mapper,
+                         CurrencyConversionService currencyConversionService,
+                         PrebidVersionProvider prebidVersionProvider) {
 
-    public MissenaBidder(String endpointUrl, JacksonMapper mapper) {
         this.endpointUrl = HttpUtil.validateUrl(Objects.requireNonNull(endpointUrl));
         this.mapper = Objects.requireNonNull(mapper);
+        this.currencyConversionService = Objects.requireNonNull(currencyConversionService);
+        this.prebidVersionProvider = Objects.requireNonNull(prebidVersionProvider);
     }
 
     @Override
     public Result<List<HttpRequest<MissenaAdRequest>>> makeHttpRequests(BidRequest request) {
-        final List<HttpRequest<MissenaAdRequest>> requests = new ArrayList<>();
         final List<BidderError> errors = new ArrayList<>();
 
         for (Imp imp : request.getImp()) {
             try {
                 final ExtImpMissena extImp = parseImpExt(imp);
-                requests.add(makeHttpRequest(request, imp.getId(), extImp));
+                final HttpRequest<MissenaAdRequest> httpRequest = makeHttpRequest(request, imp, extImp);
+                return Result.of(Collections.singletonList(httpRequest), errors);
             } catch (PreBidException e) {
                 errors.add(BidderError.badInput(e.getMessage()));
             }
         }
-
-        return Result.of(requests, errors);
+        return Result.withErrors(errors);
     }
 
     private ExtImpMissena parseImpExt(Imp imp) {
@@ -72,30 +89,95 @@ private ExtImpMissena parseImpExt(Imp imp) {
         }
     }
 
-    private HttpRequest<MissenaAdRequest> makeHttpRequest(BidRequest request, String impId, ExtImpMissena extImp) {
+    private HttpRequest<MissenaAdRequest> makeHttpRequest(BidRequest request, Imp imp, ExtImpMissena extImp) {
         final Site site = request.getSite();
+        final String pageUrl = site != null ? site.getPage() : null;
+        final User user = request.getUser();
+        final Regs regs = request.getRegs();
+        final Device device = request.getDevice();
+        final Source source = request.getSource();
+
+        final String requestCurrency = resolveCurrency(request.getCur());
+        final Price floorInfo = resolveBidFloor(imp, request, requestCurrency);
+
+        final MissenaUserParams userParams = MissenaUserParams.builder()
+                .formats(extImp.getFormats())
+                .placement(extImp.getPlacement())
+                .testMode(extImp.getTestMode())
+                .settings(extImp.getSettings())
+                .build();
 
         final MissenaAdRequest missenaAdRequest = MissenaAdRequest.builder()
+                .adUnit(imp.getId())
+                .buyerUid(user != null ? user.getBuyeruid() : null)
+                .coppa(regs != null ? regs.getCoppa() : null)
+                .currency(requestCurrency)
+                .userEids(user != null ? user.getEids() : null)
+                .floor(floorInfo.getValue())
+                .floorCurrency(floorInfo.getCurrency())
+                .gdpr(isGdpr(regs))
+                .gdprConsent(getUserConsent(user))
+                .idempotencyKey(request.getId())
+                .referer(pageUrl)
+                .refererCanonical(site != null ? site.getDomain() : null)
                 .requestId(request.getId())
-                .timeout(AD_REQUEST_DEFAULT_TIMEOUT)
-                .referer(site == null ? null : site.getPage())
-                .refererCanonical(site == null ? null : site.getDomain())
-                .consentString(getUserConsent(request.getUser()))
-                .consentRequired(isGdpr(request.getRegs()))
-                .placement(extImp.getPlacement())
-                .test(extImp.getTestMode())
+                .schain(source != null ? source.getSchain() : null)
+                .timeout(request.getTmax())
+                .params(userParams)
+                .version(prebidVersionProvider.getNameVersionRecord())
                 .build();
 
         return HttpRequest.<MissenaAdRequest>builder()
                 .method(HttpMethod.POST)
-                .uri(makeUrl(extImp.getApiKey()))
-                .headers(makeHeaders(request.getDevice(), site))
-                .impIds(Collections.singleton(impId))
+                .uri(resolveEndpointUrl(extImp.getApiKey()))
+                .headers(makeHeaders(device, site))
+                .impIds(Collections.singleton(imp.getId()))
                 .body(mapper.encodeToBytes(missenaAdRequest))
                 .payload(missenaAdRequest)
                 .build();
     }
 
+    private Price resolveBidFloor(Imp imp, BidRequest bidRequest, String targetCurrency) {
+        final Price initialBidFloorPrice = Price.of(imp.getBidfloorcur(), imp.getBidfloor());
+        return BidderUtil.isValidPrice(initialBidFloorPrice)
+                ? convertBidFloor(initialBidFloorPrice, imp.getId(), bidRequest, targetCurrency)
+                : initialBidFloorPrice;
+    }
+
+    private Price convertBidFloor(Price bidFloorPrice, String impId, BidRequest bidRequest, String targetCurrency) {
+        final String bidFloorCur = bidFloorPrice.getCurrency();
+
+        if (targetCurrency.equalsIgnoreCase(bidFloorCur)) {
+            return bidFloorPrice;
+        }
+
+        try {
+            final BigDecimal convertedPrice = currencyConversionService
+                    .convertCurrency(bidFloorPrice.getValue(), bidRequest, bidFloorCur, targetCurrency);
+
+            return Price.of(targetCurrency, convertedPrice);
+        } catch (PreBidException e) {
+            throw new PreBidException("Unable to convert provided bid floor currency from %s to %s for imp `%s`"
+                    .formatted(bidFloorCur, targetCurrency, impId));
+        }
+    }
+
+    private String resolveCurrency(List<String> requestCurrencies) {
+        for (String currency : requestCurrencies) {
+            if (USD_CURRENCY.equalsIgnoreCase(currency)) {
+                return USD_CURRENCY;
+            }
+        }
+
+        for (String currency : requestCurrencies) {
+            if (EUR_CURRENCY.equalsIgnoreCase(currency)) {
+                return EUR_CURRENCY;
+            }
+        }
+
+        return USD_CURRENCY;
+    }
+
     private MultiMap makeHeaders(Device device, Site site) {
         final MultiMap headers = HttpUtil.headers();
 
@@ -105,15 +187,21 @@ private MultiMap makeHeaders(Device device, Site site) {
             HttpUtil.addHeaderIfValueIsNotEmpty(headers, HttpUtil.X_FORWARDED_FOR_HEADER, device.getIpv6());
         }
 
-        if (site != null) {
+        if (site != null && StringUtils.isNotBlank(site.getPage())) {
             HttpUtil.addHeaderIfValueIsNotEmpty(headers, HttpUtil.REFERER_HEADER, site.getPage());
+            try {
+                final URL url = new URL(site.getPage());
+                final String origin = url.getProtocol() + "://" + url.getHost();
+                HttpUtil.addHeaderIfValueIsNotEmpty(headers, HttpUtil.ORIGIN_HEADER, origin);
+            } catch (MalformedURLException e) {
+                // do nothing
+            }
         }
-
         return headers;
     }
 
-    private String makeUrl(String apiKey) {
-        return endpointUrl + "?t=%s".formatted(apiKey);
+    private String resolveEndpointUrl(String apiKey) {
+        return endpointUrl.replace(PUBLISHER_ID_MACRO, HttpUtil.encodeUrl(apiKey));
     }
 
     private static boolean isGdpr(Regs regs) {
@@ -128,7 +216,8 @@ private static String getUserConsent(User user) {
         return Optional.ofNullable(user)
                 .map(User::getExt)
                 .map(ExtUser::getConsent)
-                .orElse(StringUtils.EMPTY);
+                .filter(StringUtils::isNotBlank)
+                .orElse(null);
     }
 
     @Override
diff --git a/src/main/java/org/prebid/server/bidder/missena/MissenaUserParams.java b/src/main/java/org/prebid/server/bidder/missena/MissenaUserParams.java
@@ -0,0 +1,24 @@
+package org.prebid.server.bidder.missena;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.node.ObjectNode; // Changed import
+import lombok.Builder;
+import lombok.Value;
+
+import java.util.List;
+
+@Builder
+@Value
+public class MissenaUserParams {
+
+    List<String> formats;
+
+    String placement;
+
+    @JsonProperty("test")
+    String testMode;
+
+    ObjectNode settings;
+
+}
+
diff --git a/src/main/java/org/prebid/server/proto/openrtb/ext/request/missena/ExtImpMissena.java b/src/main/java/org/prebid/server/proto/openrtb/ext/request/missena/ExtImpMissena.java
@@ -1,16 +1,25 @@
 package org.prebid.server.proto.openrtb.ext.request.missena;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import lombok.Builder;
 import lombok.Value;
 
-@Value(staticConstructor = "of")
+import java.util.List;
+
+@Value
+@Builder(toBuilder = true)
 public class ExtImpMissena {
 
     @JsonProperty("apiKey")
     String apiKey;
 
+    List<String> formats;
+
     String placement;
 
     @JsonProperty("test")
     String testMode;
+
+    ObjectNode settings;
 }
diff --git a/src/main/java/org/prebid/server/spring/config/bidder/MissenaConfiguration.java b/src/main/java/org/prebid/server/spring/config/bidder/MissenaConfiguration.java
@@ -2,11 +2,13 @@
 
 import org.prebid.server.bidder.BidderDeps;
 import org.prebid.server.bidder.missena.MissenaBidder;
+import org.prebid.server.currency.CurrencyConversionService;
 import org.prebid.server.json.JacksonMapper;
 import org.prebid.server.spring.config.bidder.model.BidderConfigurationProperties;
 import org.prebid.server.spring.config.bidder.util.BidderDepsAssembler;
 import org.prebid.server.spring.config.bidder.util.UsersyncerCreator;
 import org.prebid.server.spring.env.YamlPropertySourceFactory;
+import org.prebid.server.version.PrebidVersionProvider;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.context.annotation.Bean;
@@ -30,12 +32,15 @@ BidderConfigurationProperties configurationProperties() {
     @Bean
     BidderDeps missenaBidderDeps(BidderConfigurationProperties missenaConfigurationProperties,
                                  @NotBlank @Value("${external-url}") String externalUrl,
+                                 CurrencyConversionService currencyConversionService,
+                                 PrebidVersionProvider prebidVersionProvider,
                                  JacksonMapper mapper) {
 
         return BidderDepsAssembler.forBidder(BIDDER_NAME)
                 .withConfig(missenaConfigurationProperties)
                 .usersyncerCreator(UsersyncerCreator.create(externalUrl))
-                .bidderCreator(config -> new MissenaBidder(config.getEndpoint(), mapper))
+                .bidderCreator(config -> new MissenaBidder(
+                        config.getEndpoint(), mapper, currencyConversionService, prebidVersionProvider))
                 .assemble();
     }
 }
diff --git a/src/main/resources/bidder-config/missena.yaml b/src/main/resources/bidder-config/missena.yaml
@@ -1,6 +1,6 @@
 adapters:
   missena:
-    endpoint: https://bid.missena.io/
+    endpoint: https://bid.missena.io/?t={{PublisherID}}
     meta-info:
       maintainer-email: prebid@missena.com
       modifying-vast-xml-allowed: true
diff --git a/src/main/resources/static/bidder-params/missena.json b/src/main/resources/static/bidder-params/missena.json
@@ -16,6 +16,17 @@
     "test": {
       "type": "string",
       "description": "Test Mode"
+    },
+    "formats": {
+      "type": "array",
+      "description": "An array of formats to request (banner, native, or video)",
+      "items": {
+        "type": "string"
+      }
+    },
+    "settings": {
+      "type": "object",
+      "description": "An object containing extra settings for the Missena adapter"
     }
   },
   "required": [
diff --git a/src/test/java/org/prebid/server/bidder/missena/MissenaBidderTest.java b/src/test/java/org/prebid/server/bidder/missena/MissenaBidderTest.java
diff --git a/src/test/java/org/prebid/server/it/MissenaTest.java b/src/test/java/org/prebid/server/it/MissenaTest.java
diff --git a/src/test/resources/org/prebid/server/it/openrtb2/missena/test-missena-bid-request.json b/src/test/resources/org/prebid/server/it/openrtb2/missena/test-missena-bid-request.json
