From 21413c896339649c66559c854cf3bc2a73b7e8a5 Mon Sep 17 00:00:00 2001 From: Scott Kay Date: Mon, 8 Mar 2021 02:26:35 -0500 Subject: [PATCH 1/3] Update For GDPR Vendor ID Changes --- prebid-server/developers/add-new-bidder-go.md | 23 +++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md index ad44820b27..f10d62b967 100644 --- a/prebid-server/developers/add-new-bidder-go.md +++ b/prebid-server/developers/add-new-bidder-go.md @@ -71,13 +71,14 @@ Please do not ignore errors from method calls made in your bid adapter code. Eve ### Bidder Info -Let's begin with your adapter's bidder information YAML file. This file is required and contains your maintainer email address, specifies the ad formats your adapter will accept, and allows you to opt-in to video impression tracking. +Let's begin with your adapter's bidder information YAML file. This file is required and contains your maintainer email address, your [GDPR Global Vendor List (GVL) id](https://iabeurope.eu/vendor-list-tcf-v2-0/), specifies the ad formats your adapter will accept, and allows you to opt-in to video impression tracking. Create a file with the path `static/bidder-info/{bidder}.yaml` and begin with the following template: ```yaml maintainer: email: prebid-maintainer@example.com +gvlVendorID: 42 modifyingVastXmlAllowed: false capabilities: app: @@ -96,12 +97,27 @@ capabilities: Modify this template for your bid adapter: - Change the maintainer email address to a group distribution list on your ad server's domain. A distribution list is preferred over an individual mailbox to allow for robustness, as roles and team members naturally change. +- Change the `gvlVendorID` from the sample value of `108` to the id of your bidding server as registered with the [GDPR Global Vendor List (GVL)](https://iabeurope.eu/vendor-list-tcf-v2-0/), or remove this line entirely if your bidding server is not registered with IAB Europe. - Change the `modifyingVastXmlAllowed` value to `true` if you'd like to opt-in for [video impression tracking](https://github.com/prebid/prebid-server/issues/1015), or remove this line entirely if your adapter doesn't support VAST video ads. - Remove the `capabilities` (app/site) and `mediaTypes` (banner/video/audio/native) combinations which your adapter does not support.
Example: Website with banner ads only. +```yaml +maintainer: + email: foo@foo.com +gvlVendorID: 42 +capabilities: + site: + mediaTypes: + - banner +``` +
+ +
+ Example: Website with banner ads only not registered with IAB Europe. + ```yaml maintainer: email: foo@foo.com @@ -118,6 +134,7 @@ capabilities: ```yaml maintainer: email: foo@foo.com +gvlVendorID: 42 modifyingVastXmlAllowed: true capabilities: app: @@ -682,7 +699,7 @@ import ( ) func NewSyncer(template *template.Template) usersync.Usersyncer { - return adapters.NewSyncer("{bidder}", 0, template, adapters.SyncTypeRedirect) + return adapters.NewSyncer("{bidder}", template, adapters.SyncTypeRedirect) } ``` @@ -692,7 +709,6 @@ The heavy lifting is handled by the `adapters.NewSyncer` method. You just need t | Argument | Description | - | - | `familyName` | Name used for storing your user sync id within the federated cookie. Please keep this the same as your bidder name. -| `vendorID` | Id for your bidding server as registered with the [GDPR Global Vendor List (GVL)](https://iabeurope.eu/vendor-list-tcf-v2-0/). Leave this as `0` if you are not registered with IAB Europe. | `urlTemplate` | Pass through the `template` argument. | `syncType` | Type of user sync supported by your bidding server. The valid options are `SyncTypeRedirect` and `SyncTypeIframe`. @@ -1090,7 +1106,6 @@ func TestSyncer(t *testing.T) { assert.NoError(t, err) assert.Equal(t, "", syncInfo.URL) assert.Equal(t, "redirect", syncInfo.Type) - assert.Equal(t, 0, syncer.GDPRVendorID()) } ``` From fd7acbb5e5e43e94cb8183ac95e7fc46aa1c7f6c Mon Sep 17 00:00:00 2001 From: Scott Kay Date: Mon, 8 Mar 2021 11:03:49 -0500 Subject: [PATCH 2/3] Errata --- prebid-server/developers/add-new-bidder-go.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md index f10d62b967..99ae12e0e1 100644 --- a/prebid-server/developers/add-new-bidder-go.md +++ b/prebid-server/developers/add-new-bidder-go.md @@ -97,7 +97,7 @@ capabilities: Modify this template for your bid adapter: - Change the maintainer email address to a group distribution list on your ad server's domain. A distribution list is preferred over an individual mailbox to allow for robustness, as roles and team members naturally change. -- Change the `gvlVendorID` from the sample value of `108` to the id of your bidding server as registered with the [GDPR Global Vendor List (GVL)](https://iabeurope.eu/vendor-list-tcf-v2-0/), or remove this line entirely if your bidding server is not registered with IAB Europe. +- Change the `gvlVendorID` from the sample value of `42` to the id of your bidding server as registered with the [GDPR Global Vendor List (GVL)](https://iabeurope.eu/vendor-list-tcf-v2-0/), or remove this line entirely if your bidding server is not registered with IAB Europe. - Change the `modifyingVastXmlAllowed` value to `true` if you'd like to opt-in for [video impression tracking](https://github.com/prebid/prebid-server/issues/1015), or remove this line entirely if your adapter doesn't support VAST video ads. - Remove the `capabilities` (app/site) and `mediaTypes` (banner/video/audio/native) combinations which your adapter does not support. From 827982728406fb091ebb20e01db4e489529ad8eb Mon Sep 17 00:00:00 2001 From: Scott Kay Date: Mon, 8 Mar 2021 16:37:23 -0500 Subject: [PATCH 3/3] Video Tracking Feedback --- prebid-server/developers/add-new-bidder-go.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md index 99ae12e0e1..c1b7de1aa9 100644 --- a/prebid-server/developers/add-new-bidder-go.md +++ b/prebid-server/developers/add-new-bidder-go.md @@ -71,7 +71,7 @@ Please do not ignore errors from method calls made in your bid adapter code. Eve ### Bidder Info -Let's begin with your adapter's bidder information YAML file. This file is required and contains your maintainer email address, your [GDPR Global Vendor List (GVL) id](https://iabeurope.eu/vendor-list-tcf-v2-0/), specifies the ad formats your adapter will accept, and allows you to opt-in to video impression tracking. +Let's begin with your adapter's bidder information YAML file. This file is required and contains your maintainer email address, your [GDPR Global Vendor List (GVL) id](https://iabeurope.eu/vendor-list-tcf-v2-0/), specifies the ad formats your adapter will accept, and allows you to opt-out of video impression tracking. Create a file with the path `static/bidder-info/{bidder}.yaml` and begin with the following template: @@ -79,7 +79,7 @@ Create a file with the path `static/bidder-info/{bidder}.yaml` and begin with th maintainer: email: prebid-maintainer@example.com gvlVendorID: 42 -modifyingVastXmlAllowed: false +modifyingVastXmlAllowed: true capabilities: app: mediaTypes: @@ -98,7 +98,7 @@ capabilities: Modify this template for your bid adapter: - Change the maintainer email address to a group distribution list on your ad server's domain. A distribution list is preferred over an individual mailbox to allow for robustness, as roles and team members naturally change. - Change the `gvlVendorID` from the sample value of `42` to the id of your bidding server as registered with the [GDPR Global Vendor List (GVL)](https://iabeurope.eu/vendor-list-tcf-v2-0/), or remove this line entirely if your bidding server is not registered with IAB Europe. -- Change the `modifyingVastXmlAllowed` value to `true` if you'd like to opt-in for [video impression tracking](https://github.com/prebid/prebid-server/issues/1015), or remove this line entirely if your adapter doesn't support VAST video ads. +- Change the `modifyingVastXmlAllowed` value to `false` if you'd like to opt-out of [video impression tracking](https://github.com/prebid/prebid-server/issues/1015), or remove this line entirely if your adapter doesn't support VAST video ads. - Remove the `capabilities` (app/site) and `mediaTypes` (banner/video/audio/native) combinations which your adapter does not support.
@@ -116,7 +116,7 @@ capabilities:
- Example: Website with banner ads only not registered with IAB Europe. + Example: Website with banner ads only and not registered with IAB Europe. ```yaml maintainer: