-
Notifications
You must be signed in to change notification settings - Fork 750
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
relevantBidAdapter: add new bid adapter
- Loading branch information
Hugo Lindström
committed
Oct 19, 2023
1 parent
34ddf1a
commit 82302e8
Showing
9 changed files
with
590 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
package relevantdigital | ||
|
||
import ( | ||
"encoding/json" | ||
"testing" | ||
|
||
"github.com/prebid/prebid-server/openrtb_ext" | ||
) | ||
|
||
func TestValidParams(t *testing.T) { | ||
validator, err := openrtb_ext.NewBidderParamsValidator("../../static/bidder-params") | ||
if err != nil { | ||
t.Fatalf("Failed to fetch the json schema. %v", err) | ||
} | ||
|
||
for _, p := range validParams { | ||
if err := validator.Validate(openrtb_ext.BidderRelevantDigital, json.RawMessage(p)); err != nil { | ||
t.Errorf("Schema rejected valid params: %s", p) | ||
} | ||
} | ||
} | ||
|
||
func TestInvalidParams(t *testing.T) { | ||
validator, err := openrtb_ext.NewBidderParamsValidator("../../static/bidder-params") | ||
if err != nil { | ||
t.Fatalf("Failed to fetch the json schema. %v", err) | ||
} | ||
|
||
for _, p := range invalidParams { | ||
if err := validator.Validate(openrtb_ext.BidderRelevantDigital, json.RawMessage(p)); err == nil { | ||
t.Errorf("Schema allowed invalid params: %s", p) | ||
} | ||
} | ||
} | ||
|
||
var validParams = []string{ | ||
`{"accountId": "5fcf49f83a64ba6602b5be7e", "placementId" : "63b68275b4f35962c8eec9b1_5fcf49f83a64ba6602b5be9a", "pbsHost" : "some-host" }`, | ||
} | ||
|
||
var invalidParams = []string{ | ||
`{"accountId": 123, "placementId" : 123, "pbsHost" : ""}`, | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,265 @@ | ||
package relevantdigital | ||
|
||
import ( | ||
"encoding/json" | ||
"fmt" | ||
"math" | ||
"net/http" | ||
"strings" | ||
"text/template" | ||
|
||
"github.com/buger/jsonparser" | ||
"github.com/prebid/openrtb/v19/openrtb2" | ||
"github.com/prebid/prebid-server/adapters" | ||
"github.com/prebid/prebid-server/config" | ||
"github.com/prebid/prebid-server/errortypes" | ||
"github.com/prebid/prebid-server/macros" | ||
"github.com/prebid/prebid-server/openrtb_ext" | ||
) | ||
|
||
type adapter struct { | ||
endpoint *template.Template | ||
name string | ||
} | ||
|
||
const RELEVANT_DOMAIN = ".relevant-digital.com" | ||
const DEFAULT_TIMEOUT = 1000 | ||
const DEFAULT_BUFFER_MS = 250 | ||
const STORED_REQUEST_EXT = "{\"prebid\":{\"debug\":%t,\"storedrequest\":{\"id\":\"%s\"}},\"relevant\":{\"count\":%d,\"adapterType\":\"server\"}}" | ||
const STORED_IMP_EXT = "{\"prebid\":{\"storedrequest\":{\"id\":\"%s\"}}}" | ||
|
||
func Builder(bidderName openrtb_ext.BidderName, config config.Adapter, server config.Server) (adapters.Bidder, error) { | ||
template, err := template.New("endpointTemplate").Parse(config.Endpoint) | ||
if err != nil { | ||
return nil, fmt.Errorf("unable to parse endpoint url template: %v", err) | ||
} | ||
return &adapter{ | ||
endpoint: template, | ||
name: bidderName.String(), | ||
}, nil | ||
} | ||
|
||
func patchBidRequestExt(prebidBidRequest *openrtb2.BidRequest, id string) error { | ||
count, cerr := jsonparser.GetInt(prebidBidRequest.Ext, "relevant", "count") | ||
if cerr != nil { | ||
count = 0 | ||
} | ||
|
||
if count >= 5 { | ||
return &errortypes.FailedToRequestBids{ | ||
Message: "too many requests", | ||
} | ||
} else { | ||
count = count + 1 | ||
} | ||
|
||
debug, derr := jsonparser.GetBoolean(prebidBidRequest.Ext, "prebid", "debug") | ||
if derr != nil { | ||
debug = false | ||
} | ||
|
||
prebidBidRequest.Ext = []byte(fmt.Sprintf(STORED_REQUEST_EXT, debug, id, count)) | ||
return nil | ||
} | ||
|
||
func patchBidImpExt(imp *openrtb2.Imp, id string) { | ||
imp.Ext = []byte(fmt.Sprintf(STORED_IMP_EXT, id)) | ||
if imp.Banner != nil { | ||
imp.Banner.Ext = nil | ||
} | ||
if imp.Video != nil { | ||
imp.Video.Ext = nil | ||
} | ||
if imp.Native != nil { | ||
imp.Native.Ext = nil | ||
} | ||
if imp.Audio != nil { | ||
imp.Audio.Ext = nil | ||
} | ||
} | ||
|
||
func setTMax(prebidBidRequest *openrtb2.BidRequest, pbsBufferMs int) { | ||
timeout := float64(prebidBidRequest.TMax) | ||
if timeout <= 0 { | ||
timeout = DEFAULT_TIMEOUT | ||
} | ||
buffer := float64(pbsBufferMs) | ||
prebidBidRequest.TMax = int64(math.Min(math.Max(timeout-buffer, buffer), timeout)) | ||
} | ||
|
||
func cloneBidRequest(prebidBidRequest *openrtb2.BidRequest) (*openrtb2.BidRequest, error) { | ||
jsonRes, err := json.Marshal(prebidBidRequest) | ||
if err != nil { | ||
return nil, err | ||
} | ||
var copy openrtb2.BidRequest | ||
err = json.Unmarshal(jsonRes, ©) | ||
return ©, err | ||
} | ||
|
||
func (a *adapter) createBidRequest(prebidBidRequest *openrtb2.BidRequest, params []*openrtb_ext.ExtRelevantDigital) (*openrtb2.BidRequest, error) { | ||
bidRequestCopy, err := cloneBidRequest(prebidBidRequest) | ||
if err != nil { | ||
return nil, err | ||
} | ||
|
||
err = patchBidRequestExt(bidRequestCopy, params[0].AccountId) | ||
if err != nil { | ||
return nil, &errortypes.BadInput{ | ||
Message: fmt.Sprintf("failed to create bidRequest, error: %s", err), | ||
} | ||
} | ||
|
||
setTMax(bidRequestCopy, params[0].PbsBufferMs) | ||
|
||
for idx := range bidRequestCopy.Imp { | ||
patchBidImpExt(&bidRequestCopy.Imp[idx], params[idx].PlacementId) | ||
} | ||
return bidRequestCopy, err | ||
} | ||
|
||
func (a *adapter) getImpressionExt(imp *openrtb2.Imp) (*openrtb_ext.ExtRelevantDigital, error) { | ||
var bidderExt adapters.ExtImpBidder | ||
if err := json.Unmarshal(imp.Ext, &bidderExt); err != nil { | ||
return nil, &errortypes.BadInput{ | ||
Message: "imp.ext not provided", | ||
} | ||
} | ||
relevantExt := openrtb_ext.ExtRelevantDigital{PbsBufferMs: DEFAULT_BUFFER_MS} | ||
if err := json.Unmarshal(bidderExt.Bidder, &relevantExt); err != nil { | ||
return nil, &errortypes.BadInput{ | ||
Message: "ext.bidder not provided", | ||
} | ||
} | ||
return &relevantExt, nil | ||
} | ||
|
||
func (a *adapter) buildEndpointURL(params *openrtb_ext.ExtRelevantDigital) (string, error) { | ||
params.Host = strings.ReplaceAll(params.Host, "http://", "") | ||
params.Host = strings.ReplaceAll(params.Host, "https://", "") | ||
params.Host = strings.ReplaceAll(params.Host, RELEVANT_DOMAIN, "") | ||
|
||
endpointParams := macros.EndpointTemplateParams{Host: params.Host} | ||
return macros.ResolveMacros(a.endpoint, endpointParams) | ||
} | ||
|
||
func (adapter *adapter) buildAdapterRequest(prebidBidRequest *openrtb2.BidRequest, params []*openrtb_ext.ExtRelevantDigital) (*adapters.RequestData, error) { | ||
newBidRequest, err := adapter.createBidRequest(prebidBidRequest, params) | ||
|
||
if err != nil { | ||
return nil, err | ||
} | ||
|
||
reqJSON, err := json.Marshal(newBidRequest) | ||
if err != nil { | ||
return nil, err | ||
} | ||
|
||
url, err := adapter.buildEndpointURL(params[0]) | ||
if err != nil { | ||
return nil, err | ||
} | ||
|
||
return &adapters.RequestData{ | ||
Method: "POST", | ||
Uri: url, | ||
Body: reqJSON, | ||
Headers: getHeaders(prebidBidRequest), | ||
}, nil | ||
} | ||
|
||
func (adapter *adapter) MakeRequests(request *openrtb2.BidRequest, reqInfo *adapters.ExtraRequestInfo) ([]*adapters.RequestData, []error) { | ||
impParams, errs := adapter.getImpressionsInfo(request.Imp) | ||
if len(errs) > 0 { | ||
return nil, errs | ||
} | ||
|
||
bidRequest, err := adapter.buildAdapterRequest(request, impParams) | ||
if err != nil { | ||
errs = []error{err} | ||
} | ||
|
||
if bidRequest != nil { | ||
return []*adapters.RequestData{bidRequest}, errs | ||
} | ||
return nil, errs | ||
} | ||
|
||
func (adapter *adapter) getImpressionsInfo(imps []openrtb2.Imp) (resImps []*openrtb_ext.ExtRelevantDigital, errors []error) { | ||
for _, imp := range imps { | ||
impExt, err := adapter.getImpressionExt(&imp) | ||
if err != nil { | ||
errors = append(errors, err) | ||
continue | ||
} | ||
resImps = append(resImps, impExt) | ||
} | ||
return | ||
} | ||
|
||
func getHeaders(request *openrtb2.BidRequest) http.Header { | ||
headers := http.Header{} | ||
headers.Add("Content-Type", "application/json;charset=utf-8") | ||
headers.Add("Accept", "application/json") | ||
headers.Add("X-Openrtb-Version", "2.5") | ||
|
||
if request.Device != nil { | ||
if len(request.Device.UA) > 0 { | ||
headers.Add("User-Agent", request.Device.UA) | ||
} | ||
if len(request.Device.IPv6) > 0 { | ||
headers.Add("X-Forwarded-For", request.Device.IPv6) | ||
} | ||
if len(request.Device.IP) > 0 { | ||
headers.Add("X-Forwarded-For", request.Device.IP) | ||
} | ||
} | ||
return headers | ||
} | ||
|
||
func getMediaTypeForBid(bid openrtb2.Bid) (openrtb_ext.BidType, error) { | ||
switch bid.MType { | ||
case openrtb2.MarkupBanner: | ||
return openrtb_ext.BidTypeBanner, nil | ||
case openrtb2.MarkupVideo: | ||
return openrtb_ext.BidTypeVideo, nil | ||
case openrtb2.MarkupAudio: | ||
return openrtb_ext.BidTypeAudio, nil | ||
case openrtb2.MarkupNative: | ||
return openrtb_ext.BidTypeNative, nil | ||
default: | ||
return "", fmt.Errorf("unable to fetch mediaType in multi-format: %s", bid.ImpID) | ||
} | ||
} | ||
|
||
func (a *adapter) MakeBids(request *openrtb2.BidRequest, requestData *adapters.RequestData, responseData *adapters.ResponseData) (*adapters.BidderResponse, []error) { | ||
if responseData.StatusCode != http.StatusOK { | ||
return nil, []error{&errortypes.BadInput{ | ||
Message: fmt.Sprintf("Unexpected status code: %d. Bad request from publisher. Run with request.debug = 1 for more info.", responseData.StatusCode), | ||
}} | ||
} | ||
|
||
var response openrtb2.BidResponse | ||
if err := json.Unmarshal(responseData.Body, &response); err != nil { | ||
return nil, []error{err} | ||
} | ||
|
||
bidResponse := adapters.NewBidderResponseWithBidsCapacity(len(response.SeatBid)) | ||
bidResponse.Currency = response.Cur | ||
var errs []error | ||
for _, seatBid := range response.SeatBid { | ||
for i, bid := range seatBid.Bid { | ||
bidType, err := getMediaTypeForBid(bid) | ||
if err != nil { | ||
errs = append(errs, err) | ||
} else { | ||
b := &adapters.TypedBid{ | ||
Bid: &seatBid.Bid[i], | ||
BidType: bidType, | ||
} | ||
bidResponse.Bids = append(bidResponse.Bids, b) | ||
} | ||
} | ||
} | ||
return bidResponse, errs | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
package relevantdigital | ||
|
||
import ( | ||
"testing" | ||
|
||
"github.com/prebid/prebid-server/adapters/adapterstest" | ||
"github.com/prebid/prebid-server/config" | ||
"github.com/prebid/prebid-server/openrtb_ext" | ||
"github.com/stretchr/testify/assert" | ||
) | ||
|
||
func TestJsonSamples(t *testing.T) { | ||
bidder, buildErr := Builder(openrtb_ext.BidderRelevantDigital, config.Adapter{ | ||
Endpoint: "https://{{.Host}}.relevant-digital.com/openrtb2/auction"}, config.Server{ExternalUrl: "http://hosturl.com", GvlID: 1, DataCenter: "2"}) | ||
|
||
if buildErr != nil { | ||
t.Fatalf("Builder returned unexpected error %v", buildErr) | ||
} | ||
|
||
adapterstest.RunJSONBidderTest(t, "relevantdigitaltest", bidder) | ||
} | ||
|
||
func TestEndpointTemplateMalformed(t *testing.T) { | ||
_, buildErr := Builder(openrtb_ext.BidderAceex, config.Adapter{ | ||
Endpoint: "{{Malformed}}"}, config.Server{ExternalUrl: "http://hosturl.com", GvlID: 1, DataCenter: "2"}) | ||
|
||
assert.Error(t, buildErr) | ||
} |
Oops, something went wrong.