From 6e19217f4351b6d7a86ec05851942244ea1c7bc7 Mon Sep 17 00:00:00 2001
From: ddantuonobeintoo <58686785+ddantuonobeintoo@users.noreply.github.com>
Date: Thu, 14 May 2020 16:59:44 +0200
Subject: [PATCH] Add Beintoo adapter (#1274)

* Add Beintoo adapter
---
 adapters/beintoo/beintoo.go                   | 222 ++++++++++++++++++
 adapters/beintoo/beintoo_test.go              |  12 +
 .../beintootest/exemplary/minimal-banner.json | 117 +++++++++
 .../beintootest/params/race/banner.json       |   4 +
 .../supplemental/add-bidfloor.json            |  42 ++++
 .../bad-imp-banner-missing-sizes.json         |  32 +++
 .../supplemental/bad-imp-ext-tagid-value.json |  33 +++
 .../supplemental/build-banner-object.json     |  61 +++++
 .../invalid-request-no-banner.json            |  26 ++
 .../invalid-response-no-bids.json             |  45 ++++
 .../invalid-response-unmarshall-error.json    |  63 +++++
 .../supplemental/no-imps-in-request.json      |  18 ++
 .../supplemental/server-error-code.json       |  52 ++++
 .../supplemental/server-no-content.json       |  44 ++++
 .../site-domain-and-url-correctly-parsed.json |  61 +++++
 adapters/beintoo/params_test.go               |  53 +++++
 adapters/beintoo/usersync.go                  |  12 +
 adapters/beintoo/usersync_test.go             |  35 +++
 config/config.go                              |   2 +
 exchange/adapter_map.go                       |   2 +
 openrtb_ext/bidders.go                        |   2 +
 openrtb_ext/imp_beintoo.go                    |   6 +
 static/bidder-info/beintoo.yaml               |   6 +
 static/bidder-params/beintoo.json             |  18 ++
 usersync/usersyncers/syncer.go                |   2 +
 usersync/usersyncers/syncer_test.go           |   1 +
 26 files changed, 971 insertions(+)
 create mode 100644 adapters/beintoo/beintoo.go
 create mode 100644 adapters/beintoo/beintoo_test.go
 create mode 100644 adapters/beintoo/beintootest/exemplary/minimal-banner.json
 create mode 100644 adapters/beintoo/beintootest/params/race/banner.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/add-bidfloor.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/bad-imp-banner-missing-sizes.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/bad-imp-ext-tagid-value.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/build-banner-object.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/invalid-request-no-banner.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/invalid-response-no-bids.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/invalid-response-unmarshall-error.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/no-imps-in-request.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/server-error-code.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/server-no-content.json
 create mode 100644 adapters/beintoo/beintootest/supplemental/site-domain-and-url-correctly-parsed.json
 create mode 100644 adapters/beintoo/params_test.go
 create mode 100644 adapters/beintoo/usersync.go
 create mode 100644 adapters/beintoo/usersync_test.go
 create mode 100644 openrtb_ext/imp_beintoo.go
 create mode 100644 static/bidder-info/beintoo.yaml
 create mode 100644 static/bidder-params/beintoo.json

diff --git a/adapters/beintoo/beintoo.go b/adapters/beintoo/beintoo.go
new file mode 100644
index 00000000000..fb511f12075
--- /dev/null
+++ b/adapters/beintoo/beintoo.go
@@ -0,0 +1,222 @@
+package beintoo
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/url"
+	"strconv"
+
+	"github.com/mxmCherry/openrtb"
+	"github.com/prebid/prebid-server/adapters"
+	"github.com/prebid/prebid-server/errortypes"
+	"github.com/prebid/prebid-server/openrtb_ext"
+)
+
+type BeintooAdapter struct {
+	endpoint string
+}
+
+func (a *BeintooAdapter) MakeRequests(request *openrtb.BidRequest, reqInfo *adapters.ExtraRequestInfo) ([]*adapters.RequestData, []error) {
+	var errors []error
+
+	if len(request.Imp) == 0 {
+		return nil, []error{&errortypes.BadInput{
+			Message: fmt.Sprintf("No Imps in Bid Request"),
+		}}
+	}
+
+	if errors := preprocess(request); errors != nil && len(errors) > 0 {
+		return nil, append(errors, &errortypes.BadInput{
+			Message: fmt.Sprintf("Error in preprocess of Imp, err: %s", errors),
+		})
+	}
+
+	data, err := json.Marshal(request)
+	if err != nil {
+		return nil, []error{&errortypes.BadInput{
+			Message: fmt.Sprintf("Error in packaging request to JSON"),
+		}}
+	}
+
+	headers := http.Header{}
+	headers.Add("Content-Type", "application/json;charset=utf-8")
+	headers.Add("Accept", "application/json")
+
+	if request.Device != nil {
+		addHeaderIfNonEmpty(headers, "User-Agent", request.Device.UA)
+		addHeaderIfNonEmpty(headers, "X-Forwarded-For", request.Device.IP)
+		addHeaderIfNonEmpty(headers, "Accept-Language", request.Device.Language)
+		if request.Device.DNT != nil {
+			addHeaderIfNonEmpty(headers, "DNT", strconv.Itoa(int(*request.Device.DNT)))
+		}
+	}
+	if request.Site != nil {
+		addHeaderIfNonEmpty(headers, "Referer", request.Site.Page)
+	}
+
+	return []*adapters.RequestData{{
+		Method:  "POST",
+		Uri:     a.endpoint,
+		Body:    data,
+		Headers: headers,
+	}}, errors
+}
+
+func unpackImpExt(imp *openrtb.Imp) (*openrtb_ext.ExtImpBeintoo, error) {
+	var bidderExt adapters.ExtImpBidder
+	if err := json.Unmarshal(imp.Ext, &bidderExt); err != nil {
+		return nil, &errortypes.BadInput{
+			Message: err.Error(),
+		}
+	}
+
+	var beintooExt openrtb_ext.ExtImpBeintoo
+	if err := json.Unmarshal(bidderExt.Bidder, &beintooExt); err != nil {
+		return nil, &errortypes.BadInput{
+			Message: fmt.Sprintf("ignoring imp id=%s, invalid ImpExt", imp.ID),
+		}
+	}
+
+	tagIDValidation, err := strconv.ParseInt(beintooExt.TagID, 10, 64)
+	if err != nil || tagIDValidation == 0 {
+		return nil, &errortypes.BadInput{
+			Message: fmt.Sprintf("ignoring imp id=%s, invalid tagid must be a String of numbers", imp.ID),
+		}
+	}
+
+	return &beintooExt, nil
+}
+
+func buildImpBanner(imp *openrtb.Imp) error {
+	imp.Ext = nil
+
+	if imp.Banner == nil {
+		return &errortypes.BadInput{
+			Message: fmt.Sprintf("Request needs to include a Banner object"),
+		}
+	}
+
+	bannerCopy := *imp.Banner
+	banner := &bannerCopy
+
+	if banner.W == nil && banner.H == nil {
+		if len(banner.Format) == 0 {
+			return &errortypes.BadInput{
+				Message: fmt.Sprintf("Need at least one size to build request"),
+			}
+		}
+		format := banner.Format[0]
+		banner.Format = banner.Format[1:]
+		banner.W = &format.W
+		banner.H = &format.H
+		imp.Banner = banner
+	}
+
+	return nil
+}
+
+// Add Beintoo required properties to Imp object
+func addImpProps(imp *openrtb.Imp, secure *int8, BeintooExt *openrtb_ext.ExtImpBeintoo) {
+	imp.TagID = BeintooExt.TagID
+	imp.Secure = secure
+
+	if BeintooExt.BidFloor != "" {
+		bidFloor, err := strconv.ParseFloat(BeintooExt.BidFloor, 64)
+		if err != nil {
+			bidFloor = 0
+		}
+
+		if bidFloor > 0 {
+			imp.BidFloor = bidFloor
+		}
+	}
+
+	return
+}
+
+// Adding header fields to request header
+func addHeaderIfNonEmpty(headers http.Header, headerName string, headerValue string) {
+	if len(headerValue) > 0 {
+		headers.Add(headerName, headerValue)
+	}
+}
+
+// Handle request errors and formatting to be sent to Beintoo
+func preprocess(request *openrtb.BidRequest) []error {
+	errors := make([]error, 0, len(request.Imp))
+	resImps := make([]openrtb.Imp, 0, len(request.Imp))
+	secure := int8(0)
+
+	if request.Site != nil && request.Site.Page != "" {
+		pageURL, err := url.Parse(request.Site.Page)
+		if err == nil && pageURL.Scheme == "https" {
+			secure = int8(1)
+		}
+	}
+
+	for _, imp := range request.Imp {
+		beintooExt, err := unpackImpExt(&imp)
+		if err != nil {
+			errors = append(errors, err)
+			return errors
+		}
+
+		addImpProps(&imp, &secure, beintooExt)
+
+		if err := buildImpBanner(&imp); err != nil {
+			errors = append(errors, err)
+			return errors
+		}
+		resImps = append(resImps, imp)
+	}
+
+	request.Imp = resImps
+
+	return errors
+}
+
+// MakeBids make the bids for the bid response.
+func (a *BeintooAdapter) MakeBids(internalRequest *openrtb.BidRequest, externalRequest *adapters.RequestData, response *adapters.ResponseData) (*adapters.BidderResponse, []error) {
+
+	if response.StatusCode == http.StatusNoContent {
+		// no bid response
+		return nil, nil
+	}
+
+	if response.StatusCode != http.StatusOK {
+		return nil, []error{&errortypes.BadServerResponse{
+			Message: fmt.Sprintf("Invalid Status Returned: %d. Run with request.debug = 1 for more info", response.StatusCode),
+		}}
+	}
+
+	var bidResp openrtb.BidResponse
+
+	if err := json.Unmarshal(response.Body, &bidResp); err != nil {
+		return nil, []error{&errortypes.BadServerResponse{
+			Message: fmt.Sprintf("Unable to unpackage bid response. Error: %s", err.Error()),
+		}}
+	}
+
+	bidResponse := adapters.NewBidderResponseWithBidsCapacity(1)
+
+	for _, sb := range bidResp.SeatBid {
+		for i := range sb.Bid {
+			sb.Bid[i].ImpID = sb.Bid[i].ID
+
+			bidResponse.Bids = append(bidResponse.Bids, &adapters.TypedBid{
+				Bid:     &sb.Bid[i],
+				BidType: "banner",
+			})
+		}
+	}
+
+	return bidResponse, nil
+
+}
+
+func NewBeintooBidder(endpoint string) *BeintooAdapter {
+	return &BeintooAdapter{
+		endpoint: endpoint,
+	}
+}
diff --git a/adapters/beintoo/beintoo_test.go b/adapters/beintoo/beintoo_test.go
new file mode 100644
index 00000000000..863da1513e5
--- /dev/null
+++ b/adapters/beintoo/beintoo_test.go
@@ -0,0 +1,12 @@
+package beintoo
+
+import (
+	"testing"
+
+	"github.com/prebid/prebid-server/adapters/adapterstest"
+)
+
+func TestJsonSamples(t *testing.T) {
+	beintooAdapter := NewBeintooBidder("https://ib.beintoo.com")
+	adapterstest.RunJSONBidderTest(t, "beintootest", beintooAdapter)
+}
diff --git a/adapters/beintoo/beintootest/exemplary/minimal-banner.json b/adapters/beintoo/beintootest/exemplary/minimal-banner.json
new file mode 100644
index 00000000000..60e481c507c
--- /dev/null
+++ b/adapters/beintoo/beintootest/exemplary/minimal-banner.json
@@ -0,0 +1,117 @@
+{
+  "mockBidRequest": {
+    "id": "some_test_auction",
+    "imp": [{
+      "id": "some_test_ad_id",
+      "banner": {
+        "format": [{
+          "w": 300,
+          "h": 250
+        }],
+        "w": 300,
+        "h": 250
+      },
+      "ext": {
+        "bidder": {
+          "tagid": "25251"
+        }
+      }
+    }],
+    "device": {
+      "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.91 Safari/537.36",
+      "ip": "123.123.123.123",
+      "dnt": 1
+    },
+    "site": {
+      "domain": "www.publisher.com",
+      "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+    }
+  },
+
+  "httpCalls": [{
+    "expectedRequest": {
+      "uri": "https://ib.beintoo.com",
+      "headers": {
+        "Accept": [
+          "application/json"
+        ],
+        "Content-Type": [
+          "application/json;charset=utf-8"
+        ],
+        "X-Forwarded-For": [
+          "123.123.123.123"
+        ],
+        "Referer": [
+          "http://www.publisher.com/awesome/site?with=some&parameters=here"
+        ],
+        "Dnt": [
+          "1"
+        ],
+        "User-Agent": [
+          "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.91 Safari/537.36"
+        ]
+      },
+      "body": {
+        "id": "some_test_auction",
+        "imp": [{
+          "id": "some_test_ad_id",
+          "banner": {
+            "format": [{
+              "w": 300,
+              "h": 250
+            }],
+            "w": 300,
+            "h": 250
+          },
+          "tagid": "25251",
+          "secure": 0
+        }],
+        "site": {
+          "domain": "www.publisher.com",
+          "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+        },
+        "device": {
+          "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.91 Safari/537.36",
+          "ip": "123.123.123.123",
+          "dnt": 1
+        }
+      }
+    },
+    "mockResponse": {
+      "status": 200,
+      "body": {
+        "id": "some_test_auction",
+        "seatbid": [{
+            "seat": "12356",
+            "bid": [{
+              "adm": "<div id=\"123456789_ad\"><script>!function(){console.log\"Hello, world.\";}();<\/script><\/div>",
+              "id": "uuid",
+              "impid": "some_test_ad_id",
+              "ttl": 300,
+              "crid": "94395500",
+              "w": 300,
+              "price": 2.942808,
+              "adid": "94395500",
+              "h": 250
+            }]
+        }],
+        "cur": "USD"
+    }
+    }
+  }],
+
+  "expectedBids": [{
+    "bid": {
+      "adm": "<div id=\"123456789_ad\"><script>!function(){console.log\"Hello, world.\";}();<\/script><\/div>",
+      "id": "uuid",
+      "impid": "some_test_ad_id",
+      "ttl": 300,
+      "crid": "94395500",
+      "w": 300,
+      "price": 2.942808,
+      "adid": "94395500",
+      "h": 250
+    },
+    "type": "banner"
+  }]
+}
diff --git a/adapters/beintoo/beintootest/params/race/banner.json b/adapters/beintoo/beintootest/params/race/banner.json
new file mode 100644
index 00000000000..5155c92d11e
--- /dev/null
+++ b/adapters/beintoo/beintootest/params/race/banner.json
@@ -0,0 +1,4 @@
+{
+  "tagid": "25251",
+  "bidfloor": "0.01"
+}
diff --git a/adapters/beintoo/beintootest/supplemental/add-bidfloor.json b/adapters/beintoo/beintootest/supplemental/add-bidfloor.json
new file mode 100644
index 00000000000..be70bd5ba4d
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/add-bidfloor.json
@@ -0,0 +1,42 @@
+{
+    "mockBidRequest": {
+        "id": "some_test_auction",
+        "imp": [{
+            "id": "some_test_ad",
+            "banner": {
+                "h": 728,
+                "w": 90
+            },
+            "ext": {
+                "bidder": {
+                    "tagid": "1234568",
+                    "bidfloor": "1.25"
+                }
+            }
+        }]
+    },
+    "httpCalls": [{
+        "expectedRequest": {
+            "uri": "https://ib.beintoo.com",
+            "body": {
+                "id": "some_test_auction",
+                "imp": [{
+                    "banner": {
+                        "h": 728,
+                        "w": 90
+                    },
+                    "id": "some_test_ad",
+                    "secure": 0,
+                    "tagid": "1234568",
+                    "bidfloor": 1.25
+                }]
+            }
+        },
+        "mockResponse": {
+          "status": 200,
+          "body": {
+
+          }
+        }
+    }]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/bad-imp-banner-missing-sizes.json b/adapters/beintoo/beintootest/supplemental/bad-imp-banner-missing-sizes.json
new file mode 100644
index 00000000000..762864206a7
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/bad-imp-banner-missing-sizes.json
@@ -0,0 +1,32 @@
+
+{
+  "mockBidRequest": {
+    "id": "some_test_auction",
+    "imp": [
+      {
+        "id": "test-imp-id",
+        "banner": {
+        },
+        "ext": {
+          "bidder": {
+            "tagid": "12356"
+          }
+        }
+      }
+    ],
+    "site": {
+      "domain": "www.publisher.com",
+      "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+    }
+  },
+  "expectedMakeRequestsErrors": [
+    {
+      "value": "Need at least one size to build request",
+      "comparison": "literal"
+    },
+    {
+      "value": "Error in preprocess of Imp, err: [Need at least one size to build request]",
+      "comparison": "literal"
+    }
+  ]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/bad-imp-ext-tagid-value.json b/adapters/beintoo/beintootest/supplemental/bad-imp-ext-tagid-value.json
new file mode 100644
index 00000000000..279b007e910
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/bad-imp-ext-tagid-value.json
@@ -0,0 +1,33 @@
+{
+  "mockBidRequest": {
+    "id": "some_test_auction",
+    "imp": [
+      {
+        "id": "test-imp-id",
+        "banner": {
+            "w": 300,
+            "h": 250
+        },
+        "ext": {
+          "bidder": {
+            "tagid": "test_adunit"
+          }
+        }
+      }
+    ],
+    "site": {
+      "domain": "www.publisher.com",
+      "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+    }
+  },
+  "expectedMakeRequestsErrors": [
+    {
+      "value": "ignoring imp id=test-imp-id, invalid tagid must be a String of numbers",
+      "comparison": "literal"
+    },
+    {
+      "value": "Error in preprocess of Imp, err: [ignoring imp id=test-imp-id, invalid tagid must be a String of numbers]",
+      "comparison": "literal"
+    }
+  ]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/build-banner-object.json b/adapters/beintoo/beintootest/supplemental/build-banner-object.json
new file mode 100644
index 00000000000..52e37a7db02
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/build-banner-object.json
@@ -0,0 +1,61 @@
+{
+    "mockBidRequest": {
+        "id": "some_test_auction",
+        "imp": [{
+            "id": "some_test_ad",
+            "banner": {
+             "format": [
+                {
+                  "w": 728,
+                  "h": 90
+                },
+                {
+                    "w": 300,
+                    "h": 600
+                },
+                {
+                    "w": 160,
+                    "h": 600
+                }
+              ]
+            },
+            "ext": {
+                "bidder": {
+                    "tagid": "1234568",
+                    "bidfloor": "1.25"
+                }
+            }
+        }]
+    },
+    "httpCalls": [{
+        "expectedRequest": {
+            "uri": "https://ib.beintoo.com",
+            "body": {
+                "id": "some_test_auction",
+                "imp": [{
+                    "banner": {
+                        "format": [{
+                            "w": 300,
+                            "h": 600
+                        }, {
+                            "w": 160,
+                            "h": 600
+                        }],
+                        "w": 728,
+                        "h": 90
+                    },
+                    "id": "some_test_ad",
+                    "secure": 0,
+                    "tagid": "1234568",
+                    "bidfloor": 1.25
+                }]
+            }
+        },
+        "mockResponse": {
+          "status": 200,
+          "body": {
+
+          }
+        }
+    }]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/invalid-request-no-banner.json b/adapters/beintoo/beintootest/supplemental/invalid-request-no-banner.json
new file mode 100644
index 00000000000..31389388311
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/invalid-request-no-banner.json
@@ -0,0 +1,26 @@
+{
+    "mockBidRequest": {
+      "id": "some_test_auction",
+      "imp": [
+        {
+          "id": "test-imp-id",
+          "ext": {
+            "bidder": {
+              "tagid": "987654"
+            }
+          }
+        }
+      ]
+    },
+
+    "expectedMakeRequestsErrors": [
+      {
+        "value": "Request needs to include a Banner object",
+        "comparison": "literal"
+      },
+      {
+        "value": "Error in preprocess of Imp, err: [Request needs to include a Banner object]",
+        "comparison": "literal"
+      }
+    ]
+  }
diff --git a/adapters/beintoo/beintootest/supplemental/invalid-response-no-bids.json b/adapters/beintoo/beintootest/supplemental/invalid-response-no-bids.json
new file mode 100644
index 00000000000..8f18f9403aa
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/invalid-response-no-bids.json
@@ -0,0 +1,45 @@
+{
+    "mockBidRequest": {
+      "id": "some_test_auction",
+      "imp": [
+        {
+          "id": "test-imp-id",
+          "banner": {
+            "w": 600,
+            "h": 300
+          },
+          "ext": {
+            "bidder": {
+              "tagid": "98765"
+            }
+          }
+        }
+      ]
+    },
+
+    "httpCalls": [
+      {
+        "expectedRequest": {
+          "uri": "https://ib.beintoo.com",
+          "body": {
+            "id": "some_test_auction",
+            "imp": [
+              {
+                "id": "test-imp-id",
+                "banner": {
+                  "w": 600,
+                  "h": 300
+                },
+                "secure": 0,
+                "tagid": "98765"
+              }
+            ]
+          }
+        },
+        "mockResponse": {
+          "status": 204,
+          "body": {}
+        }
+      }
+    ]
+  }
diff --git a/adapters/beintoo/beintootest/supplemental/invalid-response-unmarshall-error.json b/adapters/beintoo/beintootest/supplemental/invalid-response-unmarshall-error.json
new file mode 100644
index 00000000000..5c5462c2990
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/invalid-response-unmarshall-error.json
@@ -0,0 +1,63 @@
+{
+    "mockBidRequest": {
+        "id": "some_test_auction",
+        "imp": [{
+            "id": "some_test_ad",
+            "banner": {
+                "w": 90,
+                "h": 728
+            },
+            "ext": {
+                "bidder": {
+                    "tagid": "654321"
+                }
+            }
+        }]
+    },
+
+    "httpCalls": [{
+        "expectedRequest": {
+            "uri": "https://ib.beintoo.com",
+            "body": {
+                "id": "some_test_auction",
+                "imp": [{
+                    "banner": {
+                        "h": 728,
+                        "w": 90
+                    },
+                    "id": "some_test_ad",
+                    "secure": 0,
+                    "tagid": "654321"
+                }]
+            }
+        },
+        "mockResponse": {
+            "status": 200,
+            "body": {
+              "id": "some_test_auction",
+              "seatbid": [{
+                  "seat": "12356",
+                  "bid": [{
+                    "adm": "<div id=\"123456789_ad\"><script>!function(){console.log\"Hello, world.\";}();<\/script><\/div>",
+                    "id": "uuid",
+                    "impid": "some_test_ad_id",
+                    "ttl": 300,
+                    "crid": "94395500",
+                    "w": "300",
+                    "price": 2.942808,
+                    "adid": "94395500",
+                    "h": 250
+                  }]
+              }],
+              "cur": "USD"
+          }
+          }
+    }],
+
+    "expectedMakeBidsErrors": [
+        {
+            "value": "Unable to unpackage bid response\\. Error: json: cannot unmarshal string into Go struct field (Bid\\.seatbid\\.bid\\.w|Bid\\.w) of type uint64",
+            "comparison": "regex"
+        }
+    ]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/no-imps-in-request.json b/adapters/beintoo/beintootest/supplemental/no-imps-in-request.json
new file mode 100644
index 00000000000..9527e78e144
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/no-imps-in-request.json
@@ -0,0 +1,18 @@
+{
+    "mockBidRequest": {
+        "id": "some_test_auction",
+        "imp": [
+        ],
+        "site": {
+          "domain": "www.publisher.com",
+          "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+        }
+      },
+
+      "expectedMakeRequestsErrors": [
+        {
+          "value": "No Imps in Bid Request",
+          "comparison": "literal"
+        }
+      ]
+}
diff --git a/adapters/beintoo/beintootest/supplemental/server-error-code.json b/adapters/beintoo/beintootest/supplemental/server-error-code.json
new file mode 100644
index 00000000000..2ece4370f95
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/server-error-code.json
@@ -0,0 +1,52 @@
+{
+    "mockBidRequest": {
+      "id": "some_test_auction",
+      "imp": [
+        {
+          "id": "test-imp-id",
+          "banner": {
+            "w": 600,
+            "h": 300
+          },
+          "ext": {
+            "bidder": {
+              "tagid": "1234567"
+            }
+          }
+        }
+      ]
+    },
+
+    "httpCalls": [
+      {
+        "expectedRequest": {
+          "uri": "https://ib.beintoo.com",
+          "body": {
+            "id": "some_test_auction",
+            "imp": [
+              {
+                "id": "test-imp-id",
+                "banner": {
+                  "w": 600,
+                  "h": 300
+                },
+                "secure": 0,
+                "tagid": "1234567"
+              }
+            ]
+          }
+        },
+        "mockResponse": {
+          "status": 500,
+          "body": {}
+        }
+      }
+    ],
+
+    "expectedMakeBidsErrors": [
+      {
+        "value": "Invalid Status Returned: 500. Run with request.debug = 1 for more info",
+        "comparison": "literal"
+      }
+    ]
+  }
diff --git a/adapters/beintoo/beintootest/supplemental/server-no-content.json b/adapters/beintoo/beintootest/supplemental/server-no-content.json
new file mode 100644
index 00000000000..923b1d7170b
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/server-no-content.json
@@ -0,0 +1,44 @@
+{
+    "mockBidRequest": {
+    "id": "some_test_auction",
+    "imp": [
+      {
+        "id": "test-imp-id",
+        "banner": {
+            "w": 300,
+            "h": 250
+        },
+        "ext": {
+          "bidder": {
+            "tagId": "1234567"
+          }
+        }
+      }
+    ]
+  },
+
+    "httpCalls": [
+      {
+        "expectedRequest": {
+          "uri": "https://ib.beintoo.com",
+          "body": {
+            "id": "some_test_auction",
+            "imp": [
+              {
+                "id": "test-imp-id",
+                "banner": {
+                    "w": 300,
+                    "h": 250
+                },
+                "secure": 0,
+                "tagid": "1234567"
+              }
+            ]
+          }
+        },
+        "mockResponse": {
+          "status": 204
+        }
+      }
+    ]
+    }
diff --git a/adapters/beintoo/beintootest/supplemental/site-domain-and-url-correctly-parsed.json b/adapters/beintoo/beintootest/supplemental/site-domain-and-url-correctly-parsed.json
new file mode 100644
index 00000000000..8b50313ef5a
--- /dev/null
+++ b/adapters/beintoo/beintootest/supplemental/site-domain-and-url-correctly-parsed.json
@@ -0,0 +1,61 @@
+{
+    "mockBidRequest": {
+      "id": "some_test_auction",
+      "imp": [
+        {
+          "id": "test-imp-id",
+          "banner": {
+            "format": [{
+              "w": 300,
+              "h": 600
+          }],
+            "w": 300,
+            "h": 600
+          },
+          "ext": {
+            "bidder": {
+              "tagid": "123456"
+            }
+          }
+        }
+      ],
+      "site": {
+        "domain": "www.publisher.com",
+        "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+      }
+    },
+
+    "httpCalls": [
+      {
+        "expectedRequest": {
+          "uri": "https://ib.beintoo.com",
+          "body": {
+            "id": "some_test_auction",
+            "imp": [{
+                "id": "test-imp-id",
+                "banner": {
+                    "format": [{
+                        "w": 300,
+                        "h": 600
+                    }],
+                    "w": 300,
+                    "h": 600
+                },
+                "tagid": "123456",
+                "secure": 0
+            }],
+            "site": {
+                "domain": "www.publisher.com",
+                "page": "http://www.publisher.com/awesome/site?with=some&parameters=here"
+            }
+          }
+        },
+        "mockResponse": {
+          "status": 200,
+          "body": {
+
+          }
+        }
+      }
+    ]
+  }
diff --git a/adapters/beintoo/params_test.go b/adapters/beintoo/params_test.go
new file mode 100644
index 00000000000..b92b2a108dd
--- /dev/null
+++ b/adapters/beintoo/params_test.go
@@ -0,0 +1,53 @@
+package beintoo
+
+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-schemas. %v", err)
+	}
+
+	for _, validParam := range validParams {
+		if err := validator.Validate(openrtb_ext.BidderBeintoo, json.RawMessage(validParam)); err != nil {
+			t.Errorf("Schema rejected beintoo params: %s", validParam)
+		}
+	}
+}
+
+func TestInvalidParams(t *testing.T) {
+	validator, err := openrtb_ext.NewBidderParamsValidator("../../static/bidder-params")
+	if err != nil {
+		t.Fatalf("Failed to fetch the json-schemas. %v", err)
+	}
+
+	for _, invalidParam := range invalidParams {
+		if err := validator.Validate(openrtb_ext.BidderBeintoo, json.RawMessage(invalidParam)); err == nil {
+			t.Errorf("Schema allowed unexpected params: %s", invalidParam)
+		}
+	}
+}
+
+var validParams = []string{
+	`{"tagid": "25251", "bidfloor": "0.01"}`,
+}
+
+var invalidParams = []string{
+	`null`,
+	`nil`,
+	``,
+	`[]`,
+	`true`,
+	`{}`,
+	`{"tagid":12345678}`,
+	`{"tagId":"12345678"}`,
+	`{"tagid":"25251", "bidfloor": 0.01}`,
+	`{"tagId": 12345678}`,
+	`{"placementId": "1"}`,
+	`{"placementId": 1}`,
+}
diff --git a/adapters/beintoo/usersync.go b/adapters/beintoo/usersync.go
new file mode 100644
index 00000000000..a225a2b15da
--- /dev/null
+++ b/adapters/beintoo/usersync.go
@@ -0,0 +1,12 @@
+package beintoo
+
+import (
+	"text/template"
+
+	"github.com/prebid/prebid-server/adapters"
+	"github.com/prebid/prebid-server/usersync"
+)
+
+func NewBeintooSyncer(temp *template.Template) usersync.Usersyncer {
+	return adapters.NewSyncer("Beintoo", 618, temp, adapters.SyncTypeIframe)
+}
diff --git a/adapters/beintoo/usersync_test.go b/adapters/beintoo/usersync_test.go
new file mode 100644
index 00000000000..2cfca010226
--- /dev/null
+++ b/adapters/beintoo/usersync_test.go
@@ -0,0 +1,35 @@
+package beintoo
+
+import (
+	"testing"
+	"text/template"
+
+	"github.com/prebid/prebid-server/privacy"
+	"github.com/prebid/prebid-server/privacy/ccpa"
+	"github.com/prebid/prebid-server/privacy/gdpr"
+	"github.com/stretchr/testify/assert"
+)
+
+func TestBeintooSyncer(t *testing.T) {
+	syncURL := "https://ib.beintoo.com/um?ssp=pbs&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&redirect=localhost%2Fsetuid%3Fbidder%3Dbeintoo%26uid%3D%24UID"
+	syncURLTemplate := template.Must(
+		template.New("sync-template").Parse(syncURL),
+	)
+
+	syncer := NewBeintooSyncer(syncURLTemplate)
+	syncInfo, err := syncer.GetUsersyncInfo(privacy.Policies{
+		GDPR: gdpr.Policy{
+			Signal:  "1",
+			Consent: "BOPVK28OVJoTBABABAENBs-AAAAhuAKAANAAoACwAGgAPAAxAB0AHgAQAAiABOADkA",
+		},
+		CCPA: ccpa.Policy{
+			Value: "1NYN",
+		},
+	})
+
+	assert.NoError(t, err)
+	assert.Equal(t, "https://ib.beintoo.com/um?ssp=pbs&gdpr=1&gdpr_consent=BOPVK28OVJoTBABABAENBs-AAAAhuAKAANAAoACwAGgAPAAxAB0AHgAQAAiABOADkA&us_privacy=1NYN&redirect=localhost%2Fsetuid%3Fbidder%3Dbeintoo%26uid%3D%24UID", syncInfo.URL)
+	assert.Equal(t, "iframe", syncInfo.Type)
+	assert.EqualValues(t, 618, syncer.GDPRVendorID())
+	assert.Equal(t, false, syncInfo.SupportCORS)
+}
diff --git a/config/config.go b/config/config.go
index ccdb5c0625b..d8986c38ebb 100755
--- a/config/config.go
+++ b/config/config.go
@@ -505,6 +505,7 @@ func (cfg *Configuration) setDerivedDefaults() {
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderAJA, "https://ad.as.amanad.adtdp.com/v1/sync/ssp?ssp=4&gdpr={{.GDPR}}&us_privacy={{.USPrivacy}}&redir="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Daja%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D%25s")
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderAppnexus, "https://ib.adnxs.com/getuid?"+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dadnxs%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D%24UID")
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderBeachfront, "https://sync.bfmio.com/sync_s2s?gdpr={{.GDPR}}&us_privacy={{.USPrivacy}}&url="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dbeachfront%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D%5Bio_cid%5D")
+	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderBeintoo, "https://ib.beintoo.com/um?ssp=pbs&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&redirect="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dbeintoo%26uid%3D%24UID")
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderBrightroll, "https://pr-bh.ybp.yahoo.com/sync/appnexusprebidserver/?gdpr={{.GDPR}}&euconsent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&url="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dbrightroll%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D%24UID")
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderConsumable, "https://e.serverbid.com/udb/9969/match?gdpr={{.GDPR}}&euconsent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&redir="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dconsumable%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D")
 	setDefaultUsersync(cfg.Adapters, openrtb_ext.BidderConversant, "https://prebid-match.dotomi.com/match/bounce/current?version=1&networkId=72582&rurl="+url.QueryEscape(externalURL)+"%2Fsetuid%3Fbidder%3Dconversant%26gdpr%3D{{.GDPR}}%26gdpr_consent%3D{{.GDPRConsent}}%26uid%3D")
@@ -705,6 +706,7 @@ func SetupViper(v *viper.Viper, filename string) {
 	v.SetDefault("adapters.appnexus.platform_id", "5")
 	v.SetDefault("adapters.beachfront.endpoint", "https://display.bfmio.com/prebid_display")
 	v.SetDefault("adapters.beachfront.extra_info", "{\"video_endpoint\":\"https://reachms.bfmio.com/bid.json?exchange_id\"}")
+	v.SetDefault("adapters.beintoo.endpoint", "https://ib.beintoo.com/um")
 	v.SetDefault("adapters.brightroll.endpoint", "http://east-bid.ybp.yahoo.com/bid/appnexuspbs")
 	v.SetDefault("adapters.consumable.endpoint", "https://e.serverbid.com/api/v2")
 	v.SetDefault("adapters.conversant.endpoint", "http://api.hb.ad.cpe.dotomi.com/s2s/header/24")
diff --git a/exchange/adapter_map.go b/exchange/adapter_map.go
index 2029d1a7553..ae0726a0b44 100755
--- a/exchange/adapter_map.go
+++ b/exchange/adapter_map.go
@@ -22,6 +22,7 @@ import (
 	"github.com/prebid/prebid-server/adapters/appnexus"
 	"github.com/prebid/prebid-server/adapters/audienceNetwork"
 	"github.com/prebid/prebid-server/adapters/beachfront"
+	"github.com/prebid/prebid-server/adapters/beintoo"
 	"github.com/prebid/prebid-server/adapters/brightroll"
 	"github.com/prebid/prebid-server/adapters/consumable"
 	"github.com/prebid/prebid-server/adapters/conversant"
@@ -96,6 +97,7 @@ func newAdapterMap(client *http.Client, cfg *config.Configuration, infos adapter
 		openrtb_ext.BidderApplogy:      applogy.NewApplogyBidder(cfg.Adapters[string(openrtb_ext.BidderApplogy)].Endpoint),
 		openrtb_ext.BidderAppnexus:     appnexus.NewAppNexusBidder(client, cfg.Adapters[string(openrtb_ext.BidderAppnexus)].Endpoint, cfg.Adapters[string(openrtb_ext.BidderAppnexus)].PlatformID),
 		openrtb_ext.BidderBeachfront:   beachfront.NewBeachfrontBidder(cfg.Adapters[string(openrtb_ext.BidderBeachfront)].Endpoint, cfg.Adapters[string(openrtb_ext.BidderBeachfront)].ExtraAdapterInfo),
+		openrtb_ext.BidderBeintoo:      beintoo.NewBeintooBidder(cfg.Adapters[string(openrtb_ext.BidderBeintoo)].Endpoint),
 		openrtb_ext.BidderBrightroll:   brightroll.NewBrightrollBidder(cfg.Adapters[string(openrtb_ext.BidderBrightroll)].Endpoint),
 		openrtb_ext.BidderConsumable:   consumable.NewConsumableBidder(cfg.Adapters[string(openrtb_ext.BidderConsumable)].Endpoint),
 		openrtb_ext.BidderCpmstar:      cpmstar.NewCpmstarBidder(cfg.Adapters[string(openrtb_ext.BidderCpmstar)].Endpoint),
diff --git a/openrtb_ext/bidders.go b/openrtb_ext/bidders.go
index 01112091cdf..c725d962083 100755
--- a/openrtb_ext/bidders.go
+++ b/openrtb_ext/bidders.go
@@ -39,6 +39,7 @@ const (
 	BidderAppnexus         BidderName = "appnexus"
 	BidderAdoppler         BidderName = "adoppler"
 	BidderBeachfront       BidderName = "beachfront"
+	BidderBeintoo          BidderName = "beintoo"
 	BidderBrightroll       BidderName = "brightroll"
 	BidderConsumable       BidderName = "consumable"
 	BidderConversant       BidderName = "conversant"
@@ -110,6 +111,7 @@ var BidderMap = map[string]BidderName{
 	"appnexus":          BidderAppnexus,
 	"adoppler":          BidderAdoppler,
 	"beachfront":        BidderBeachfront,
+	"beintoo":           BidderBeintoo,
 	"brightroll":        BidderBrightroll,
 	"consumable":        BidderConsumable,
 	"conversant":        BidderConversant,
diff --git a/openrtb_ext/imp_beintoo.go b/openrtb_ext/imp_beintoo.go
new file mode 100644
index 00000000000..fe7599919d8
--- /dev/null
+++ b/openrtb_ext/imp_beintoo.go
@@ -0,0 +1,6 @@
+package openrtb_ext
+
+type ExtImpBeintoo struct {
+	TagID    string `json:"tagid"`
+	BidFloor string `json:"bidfloor,omitempty"`
+}
diff --git a/static/bidder-info/beintoo.yaml b/static/bidder-info/beintoo.yaml
new file mode 100644
index 00000000000..fcca29220cf
--- /dev/null
+++ b/static/bidder-info/beintoo.yaml
@@ -0,0 +1,6 @@
+maintainer:
+  email: "adops@beintoo.com"
+capabilities:
+  site:
+    mediaTypes:
+      - banner
diff --git a/static/bidder-params/beintoo.json b/static/bidder-params/beintoo.json
new file mode 100644
index 00000000000..52bb0351124
--- /dev/null
+++ b/static/bidder-params/beintoo.json
@@ -0,0 +1,18 @@
+{
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "title": "Beintoo Adapter Params",
+    "description": "A schema which validates params accepted by the Beintoo adapter",
+    "type": "object",
+    "properties": {
+      "tagid" : {
+        "type": "string",
+        "description": "The id of an inventory target"
+      },
+      "bidfloor": {
+        "type": "string",
+        "description": "The minimum price acceptable for a bid"
+      }
+    },
+
+    "required": ["tagid"]
+  }
diff --git a/usersync/usersyncers/syncer.go b/usersync/usersyncers/syncer.go
index 42c93d652b3..3f12ee7f728 100755
--- a/usersync/usersyncers/syncer.go
+++ b/usersync/usersyncers/syncer.go
@@ -18,6 +18,7 @@ import (
 	"github.com/prebid/prebid-server/adapters/appnexus"
 	"github.com/prebid/prebid-server/adapters/audienceNetwork"
 	"github.com/prebid/prebid-server/adapters/beachfront"
+	"github.com/prebid/prebid-server/adapters/beintoo"
 	"github.com/prebid/prebid-server/adapters/brightroll"
 	"github.com/prebid/prebid-server/adapters/consumable"
 	"github.com/prebid/prebid-server/adapters/conversant"
@@ -86,6 +87,7 @@ func NewSyncerMap(cfg *config.Configuration) map[openrtb_ext.BidderName]usersync
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderAJA, aja.NewAJASyncer)
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderAppnexus, appnexus.NewAppnexusSyncer)
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderBeachfront, beachfront.NewBeachfrontSyncer)
+	insertIntoMap(cfg, syncers, openrtb_ext.BidderBeintoo, beintoo.NewBeintooSyncer)
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderBrightroll, brightroll.NewBrightrollSyncer)
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderConsumable, consumable.NewConsumableSyncer)
 	insertIntoMap(cfg, syncers, openrtb_ext.BidderConversant, conversant.NewConversantSyncer)
diff --git a/usersync/usersyncers/syncer_test.go b/usersync/usersyncers/syncer_test.go
index 88c1b9467a6..c09dd5c839b 100755
--- a/usersync/usersyncers/syncer_test.go
+++ b/usersync/usersyncers/syncer_test.go
@@ -26,6 +26,7 @@ func TestNewSyncerMap(t *testing.T) {
 			string(openrtb_ext.BidderAJA):              syncConfig,
 			string(openrtb_ext.BidderAppnexus):         syncConfig,
 			string(openrtb_ext.BidderBeachfront):       syncConfig,
+			string(openrtb_ext.BidderBeintoo):          syncConfig,
 			string(openrtb_ext.BidderBrightroll):       syncConfig,
 			string(openrtb_ext.BidderConsumable):       syncConfig,
 			string(openrtb_ext.BidderConversant):       syncConfig,