New Adapter: Groupm (Alias Of PubMatic) (prebid#2042)

config/config.go

@@ -826,6 +826,7 @@ func SetupViper(v *viper.Viper, filename string) {
 	v.SetDefault("adapters.gamma.endpoint", "https://hb.gammaplatform.com/adx/request/")
 	v.SetDefault("adapters.gamoshi.endpoint", "https://rtb.gamoshi.io")
 	v.SetDefault("adapters.grid.endpoint", "https://grid.bidswitch.net/sp_bid?sp=prebid")
+	v.SetDefault("adapters.groupm.endpoint", "https://hbopenbid.pubmatic.com/translator?source=prebid-server")
 	v.SetDefault("adapters.gumgum.endpoint", "https://g2.gumgum.com/providers/prbds2s/bid")
 	v.SetDefault("adapters.huaweiads.endpoint", "https://acd.op.hicloud.com/ppsadx/getResult")
 	v.SetDefault("adapters.huaweiads.disabled", true)

exchange/adapter_builders.go

@@ -198,6 +198,7 @@ func newAdapterBuilders() map[openrtb_ext.BidderName]adapters.Builder {
 		openrtb_ext.BidderGamma:             gamma.Builder,
 		openrtb_ext.BidderGamoshi:           gamoshi.Builder,
 		openrtb_ext.BidderGrid:              grid.Builder,
+		openrtb_ext.BidderGroupm:            pubmatic.Builder,
 		openrtb_ext.BidderGumGum:            gumgum.Builder,
 		openrtb_ext.BidderHuaweiAds:         huaweiads.Builder,
 		openrtb_ext.BidderImpactify:         impactify.Builder,

openrtb_ext/bidders.go

@@ -135,6 +135,7 @@ const (
 	BidderGamma             BidderName = "gamma"
 	BidderGamoshi           BidderName = "gamoshi"
 	BidderGrid              BidderName = "grid"
+	BidderGroupm            BidderName = "groupm"
 	BidderGumGum            BidderName = "gumgum"
 	BidderHuaweiAds         BidderName = "huaweiads"
 	BidderImpactify         BidderName = "impactify"
@@ -276,6 +277,7 @@ func CoreBidderNames() []BidderName {
 		BidderGamma,
 		BidderGamoshi,
 		BidderGrid,
+		BidderGroupm,
 		BidderGumGum,
 		BidderHuaweiAds,
 		BidderImpactify,

static/bidder-info/groupm.yaml

@@ -0,0 +1,18 @@
+maintainer:
+  email: "[email protected]"
+gvlVendorID: 98
+capabilities:
+  app:
+    mediaTypes:
+      - banner
+      - video
+  site:
+    mediaTypes:
+      - banner
+      - video
+userSync:
+  iframe:
+    url: "https://ads.pubmatic.com/AdServer/js/user_sync.html?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&predirect={{.RedirectURL}}"
+    userMacro: ""
+    # groupm appends the user id to end of the redirect url and does not utilize a macro
+

static/bidder-params/groupm.json

@@ -0,0 +1,61 @@
+{
+	"$schema": "http://json-schema.org/draft-04/schema#",
+	"title": "Groupm Adapter Params",
+	"description": "A schema which validates params accepted by the Groupm adapter",
+	"type": "object",
+	"properties": {
+		"publisherId": {
+			"type": "string",
+			"description": "An ID which identifies the publisher"
+		},
+		"adSlot": {
+			"type": "string",
+			"description": "An ID which identifies the ad slot"
+		},
+		"pmzoneid": {
+			"type": "string",
+			"description": "Comma separated zone id. Used im deal targeting & site section targeting. e.g drama,sport"
+		},
+		"dctr": {
+			"type": "string",
+			"description": "Deals Custom Targeting, pipe separated key-value pairs e.g key1=V1,V2,V3|key2=v1|key3=v3,v5"
+		},
+		"wrapper": {
+			"type": "object",
+			"description": "Specifies Groupm openwrap configuration for a publisher",
+			"properties": {
+				"profile": {
+					"type": "integer",
+					"description": "An ID which identifies the openwrap profile of publisher"
+				},
+				"version": {
+					"type": "integer",
+					"description": "An ID which identifies version of the openwrap profile"
+				}
+			},
+			"required": ["profile"]
+		},
+		"keywords": {
+			"type": "array",
+			"minItems": 1,
+			"items": {
+			  "type": "object",
+			  "description": "A key with one or more values associated with it. These are used in buy-side segment targeting.",
+			  "properties": {
+				"key": {
+				  "type": "string"
+				},
+				"value": {
+				  "type": "array",
+				  "minItems": 1,
+				  "items": {
+					"type": "string"
+				  }
+				}
+			  },
+			  "required": ["key", "value"]
+			}
+		  }
+	},
+	"required": ["publisherId"]
+}