github.com/prebid/prebid-server@v0.275.0/adapters/ninthdecimal/ninthdecimal.go (about)

     1  package ninthdecimal
     2  
     3  import (
     4  	"encoding/json"
     5  	"fmt"
     6  	"net/http"
     7  	"text/template"
     8  
     9  	"github.com/prebid/openrtb/v19/openrtb2"
    10  	"github.com/prebid/prebid-server/adapters"
    11  	"github.com/prebid/prebid-server/config"
    12  	"github.com/prebid/prebid-server/errortypes"
    13  	"github.com/prebid/prebid-server/macros"
    14  	"github.com/prebid/prebid-server/openrtb_ext"
    15  )
    16  
    17  type NinthDecimalAdapter struct {
    18  	EndpointTemplate *template.Template
    19  }
    20  
    21  // MakeRequests prepares request information for prebid-server core
    22  func (adapter *NinthDecimalAdapter) MakeRequests(request *openrtb2.BidRequest, reqInfo *adapters.ExtraRequestInfo) ([]*adapters.RequestData, []error) {
    23  	errs := make([]error, 0, len(request.Imp))
    24  	if len(request.Imp) == 0 {
    25  		errs = append(errs, &errortypes.BadInput{Message: "No impression in the bid request"})
    26  		return nil, errs
    27  	}
    28  	pub2impressions, imps, err := getImpressionsInfo(request.Imp)
    29  	if len(imps) == 0 {
    30  		return nil, err
    31  	}
    32  	errs = append(errs, err...)
    33  
    34  	if len(pub2impressions) == 0 {
    35  		return nil, errs
    36  	}
    37  
    38  	result := make([]*adapters.RequestData, 0, len(pub2impressions))
    39  	for k, imps := range pub2impressions {
    40  		bidRequest, err := adapter.buildAdapterRequest(request, &k, imps)
    41  		if err != nil {
    42  			errs = append(errs, err)
    43  			return nil, errs
    44  		} else {
    45  			result = append(result, bidRequest)
    46  		}
    47  	}
    48  	return result, errs
    49  }
    50  
    51  // getImpressionsInfo checks each impression for validity and returns impressions copy with corresponding exts
    52  func getImpressionsInfo(imps []openrtb2.Imp) (map[openrtb_ext.ExtImpNinthDecimal][]openrtb2.Imp, []openrtb2.Imp, []error) {
    53  	errors := make([]error, 0, len(imps))
    54  	resImps := make([]openrtb2.Imp, 0, len(imps))
    55  	res := make(map[openrtb_ext.ExtImpNinthDecimal][]openrtb2.Imp)
    56  
    57  	for _, imp := range imps {
    58  		impExt, err := getImpressionExt(&imp)
    59  		if err != nil {
    60  			errors = append(errors, err)
    61  			continue
    62  		}
    63  		if err := validateImpression(impExt); err != nil {
    64  			errors = append(errors, err)
    65  			continue
    66  		}
    67  		//dispatchImpressions
    68  		//Group impressions by NinthDecimal-specific parameters `pubid
    69  		if err := compatImpression(&imp); err != nil {
    70  			errors = append(errors, err)
    71  			continue
    72  		}
    73  		if res[*impExt] == nil {
    74  			res[*impExt] = make([]openrtb2.Imp, 0)
    75  		}
    76  		res[*impExt] = append(res[*impExt], imp)
    77  		resImps = append(resImps, imp)
    78  	}
    79  	return res, resImps, errors
    80  }
    81  
    82  func validateImpression(impExt *openrtb_ext.ExtImpNinthDecimal) error {
    83  	if impExt.PublisherID == "" {
    84  		return &errortypes.BadInput{Message: "No pubid value provided"}
    85  	}
    86  	return nil
    87  }
    88  
    89  // Alter impression info to comply with NinthDecimal platform requirements
    90  func compatImpression(imp *openrtb2.Imp) error {
    91  	imp.Ext = nil //do not forward ext to NinthDecimal platform
    92  	if imp.Banner != nil {
    93  		return compatBannerImpression(imp)
    94  	}
    95  	return nil
    96  }
    97  
    98  func compatBannerImpression(imp *openrtb2.Imp) error {
    99  	// Create a copy of the banner, since imp is a shallow copy of the original.
   100  
   101  	bannerCopy := *imp.Banner
   102  	banner := &bannerCopy
   103  	//As banner.w/h are required fields for NinthDecimal platform - take the first format entry
   104  	if banner.W == nil || banner.H == nil {
   105  		if len(banner.Format) == 0 {
   106  			return &errortypes.BadInput{Message: "Expected at least one banner.format entry or explicit w/h"}
   107  		}
   108  		format := banner.Format[0]
   109  		banner.Format = banner.Format[1:]
   110  		banner.W = &format.W
   111  		banner.H = &format.H
   112  		imp.Banner = banner
   113  	}
   114  	return nil
   115  }
   116  
   117  func getImpressionExt(imp *openrtb2.Imp) (*openrtb_ext.ExtImpNinthDecimal, error) {
   118  	var bidderExt adapters.ExtImpBidder
   119  	if err := json.Unmarshal(imp.Ext, &bidderExt); err != nil {
   120  		return nil, &errortypes.BadInput{
   121  			Message: err.Error(),
   122  		}
   123  	}
   124  	var NinthDecimalExt openrtb_ext.ExtImpNinthDecimal
   125  	if err := json.Unmarshal(bidderExt.Bidder, &NinthDecimalExt); err != nil {
   126  		return nil, &errortypes.BadInput{
   127  			Message: err.Error(),
   128  		}
   129  	}
   130  	return &NinthDecimalExt, nil
   131  }
   132  
   133  func (adapter *NinthDecimalAdapter) buildAdapterRequest(prebidBidRequest *openrtb2.BidRequest, params *openrtb_ext.ExtImpNinthDecimal, imps []openrtb2.Imp) (*adapters.RequestData, error) {
   134  	newBidRequest := createBidRequest(prebidBidRequest, params, imps)
   135  	reqJSON, err := json.Marshal(newBidRequest)
   136  	if err != nil {
   137  		return nil, err
   138  	}
   139  
   140  	headers := http.Header{}
   141  	headers.Add("Content-Type", "application/json;charset=utf-8")
   142  	headers.Add("Accept", "application/json")
   143  	headers.Add("x-openrtb-version", "2.5")
   144  
   145  	url, err := adapter.buildEndpointURL(params)
   146  	if err != nil {
   147  		return nil, err
   148  	}
   149  
   150  	return &adapters.RequestData{
   151  		Method:  "POST",
   152  		Uri:     url,
   153  		Body:    reqJSON,
   154  		Headers: headers}, nil
   155  }
   156  
   157  func createBidRequest(prebidBidRequest *openrtb2.BidRequest, params *openrtb_ext.ExtImpNinthDecimal, imps []openrtb2.Imp) *openrtb2.BidRequest {
   158  	bidRequest := *prebidBidRequest
   159  	bidRequest.Imp = imps
   160  	for idx := range bidRequest.Imp {
   161  		imp := &bidRequest.Imp[idx]
   162  		imp.TagID = params.Placement
   163  	}
   164  	if bidRequest.Site != nil {
   165  		// Need to copy Site as Request is a shallow copy
   166  		siteCopy := *bidRequest.Site
   167  		bidRequest.Site = &siteCopy
   168  		bidRequest.Site.Publisher = nil
   169  		bidRequest.Site.Domain = ""
   170  	}
   171  	if bidRequest.App != nil {
   172  		// Need to copy App as Request is a shallow copy
   173  		appCopy := *bidRequest.App
   174  		bidRequest.App = &appCopy
   175  		bidRequest.App.Publisher = nil
   176  	}
   177  	return &bidRequest
   178  }
   179  
   180  // Builds enpoint url based on adapter-specific pub settings from imp.ext
   181  func (adapter *NinthDecimalAdapter) buildEndpointURL(params *openrtb_ext.ExtImpNinthDecimal) (string, error) {
   182  	endpointParams := macros.EndpointTemplateParams{PublisherID: params.PublisherID}
   183  	return macros.ResolveMacros(adapter.EndpointTemplate, endpointParams)
   184  }
   185  
   186  // MakeBids translates NinthDecimal bid response to prebid-server specific format
   187  func (adapter *NinthDecimalAdapter) MakeBids(internalRequest *openrtb2.BidRequest, externalRequest *adapters.RequestData, response *adapters.ResponseData) (*adapters.BidderResponse, []error) {
   188  	var msg = ""
   189  	if response.StatusCode == http.StatusNoContent {
   190  		return nil, nil
   191  	}
   192  	if response.StatusCode != http.StatusOK {
   193  		msg = fmt.Sprintf("Unexpected http status code: %d", response.StatusCode)
   194  		return nil, []error{&errortypes.BadServerResponse{Message: msg}}
   195  
   196  	}
   197  	var bidResp openrtb2.BidResponse
   198  	if err := json.Unmarshal(response.Body, &bidResp); err != nil {
   199  		msg = fmt.Sprintf("Bad server response: %d", err)
   200  		return nil, []error{&errortypes.BadServerResponse{Message: msg}}
   201  	}
   202  	if len(bidResp.SeatBid) != 1 {
   203  		var msg = fmt.Sprintf("Invalid SeatBids count: %d", len(bidResp.SeatBid))
   204  		return nil, []error{&errortypes.BadServerResponse{Message: msg}}
   205  	}
   206  
   207  	seatBid := bidResp.SeatBid[0]
   208  	bidResponse := adapters.NewBidderResponseWithBidsCapacity(len(bidResp.SeatBid[0].Bid))
   209  
   210  	for i := 0; i < len(seatBid.Bid); i++ {
   211  		bid := seatBid.Bid[i]
   212  		bidResponse.Bids = append(bidResponse.Bids, &adapters.TypedBid{
   213  			Bid:     &bid,
   214  			BidType: getMediaTypeForImpID(bid.ImpID, internalRequest.Imp),
   215  		})
   216  	}
   217  	return bidResponse, nil
   218  }
   219  
   220  // getMediaTypeForImp figures out which media type this bid is for
   221  func getMediaTypeForImpID(impID string, imps []openrtb2.Imp) openrtb_ext.BidType {
   222  	for _, imp := range imps {
   223  		if imp.ID == impID && imp.Video != nil {
   224  			return openrtb_ext.BidTypeVideo
   225  		}
   226  	}
   227  	return openrtb_ext.BidTypeBanner
   228  }
   229  
   230  // Builder builds a new instance of the NinthDecimal adapter for the given bidder with the given config.
   231  func Builder(bidderName openrtb_ext.BidderName, config config.Adapter, server config.Server) (adapters.Bidder, error) {
   232  	template, err := template.New("endpointTemplate").Parse(config.Endpoint)
   233  	if err != nil {
   234  		return nil, fmt.Errorf("unable to parse endpoint url template: %v", err)
   235  	}
   236  
   237  	bidder := &NinthDecimalAdapter{
   238  		EndpointTemplate: template,
   239  	}
   240  	return bidder, nil
   241  }