From 34f268f4099861e412800df90b2c1f78d9e2ffea Mon Sep 17 00:00:00 2001 From: Galphimbl Date: Thu, 8 Apr 2021 00:12:08 +0300 Subject: [PATCH] Add UserId Submodule AdmixerId (#2666) * add gdpr and usp * admixer id system * admixer id system * admixer id system download.md * admixer id system * merge and update descr * admixer id system --- dev-docs/modules/userId.md | 50 +++++++++++++++++++++++++++++++++++++- download.md | 3 +++ 2 files changed, 52 insertions(+), 1 deletion(-) diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md index e800aa45b7..52dd6815e5 100644 --- a/dev-docs/modules/userId.md +++ b/dev-docs/modules/userId.md @@ -68,7 +68,7 @@ of sub-objects. The table below has the options that are common across ID system {: .table .table-bordered .table-striped } | Param under userSync.userIds[] | Scope | Type | Description | Example | | --- | --- | --- | --- | --- | -| name | Required | String | May be: `"britepoolId"`, `"criteo"`, `"fabrickId"`, `"haloId"`, `"id5id"`, `identityLink`, `"idx"`, `"intentIqId"`, `"liveIntentId"`, `"lotamePanoramaId"`, `"merkleId"`, `"netId"`, `"novatiqId"`, `"parrableId"`, `"quantcastId"`, `"pubCommonId"`, `"pubProvidedId"`, `"sharedId"`, `"tapadId"`, `"unifiedId"`,`"uid2"`, `"verizonMediaId"`, `"zeotapIdPlus"` | `"unifiedId"` +| name | Required | String | May be: `"admixerId"`, `"britepoolId"`, `"criteo"`, `"fabrickId"`, `"haloId"`, `"id5id"`, `identityLink`, `"idx"`, `"intentIqId"`, `"liveIntentId"`, `"lotamePanoramaId"`, `"merkleId"`, `"netId"`, `"novatiqId"`, `"parrableId"`, `"quantcastId"`, `"pubCommonId"`, `"pubProvidedId"`, `"sharedId"`, `"tapadId"`, `"unifiedId"`,`"uid2"`, `"verizonMediaId"`, `"zeotapIdPlus"` | `"unifiedId"` | params | Based on User ID sub-module | Object | | | | bidders | Optional | Array of Strings | An array of bidder codes to which this user ID may be sent. | `['bidderA', 'bidderB']` | | storage | Optional | Object | The publisher can specify some kind of local storage in which to store the results of the call to get the user ID. This can be either cookie or HTML5 storage. This is not needed when `value` is specified or the ID system is managing its own storage | | @@ -135,6 +135,53 @@ The Rubicon bid adapter would then receive } ``` +### AdmixerID + +Admixer ID, provided by [Admixer] (https://admixer.com/), is a universal ID solution that doesn't rely on 3rd party cookies and helps publishers and advertisers to recognize users across various browsers and environments. Our sub adapter takes deterministic signals like email and phone as input and returns an anonymous id that unlocks access to a wide range of Admixer's demand sources, amplifying audience segmentation, targeting and measurement. + +The Admixer privacy policy is at https://admixer.com/privacy/ + +Add Admixer ID module to your Prebid.js package with: + +{: .alert.alert-info :} +gulp build --modules=admixerIdSystem + +#### AdmixerID Configuration + +{: .table .table-bordered .table-striped } +| Param under userSync.userIds[] | Scope | Type | Description | Example | +| --- | --- | --- | --- | --- | +| name | Required | String | `"admixerId"` | `"admixerId"` | +| params | Required | Object | Details for admixer initialization. | | +| params.pid | Required | String | id provided by admixer | "458frgde-djd7-3ert-gyhu-12fghy76dnmko" | +| params.e | Optional | String | The hashed email address of a user. We can accept the hashes, which use the following hashing algorithms: md5, sha1, sha256. | "3d400b57e069c993babea0bd9efa79e5dc698e16c042686569faae20391fd7ea" | +| params.p | Optional | String | The hashed phone number of a user. We can accept the hashes, which use the following hashing algorithms: md5, sha1, sha256. | "05de6c07eb3ea4bce45adca4e0182e771d80fbb99e12401416ca84ddf94c3eb9" | + +#### AdmixerID Examples + +1) Individual params may be set for the Admixer ID Submodule. + +{% highlight javascript %} + pbjs.setConfig({ + userSync: { + userIds: [{ + name: "admixerId", + storage: { + name: "admixerId", + type: "cookie", + expires: 30 + }, + params: { + pid: "4D393FAC-B6BB-4E19-8396-0A4813607316", // example id + e: "3d400b57e069c993babea0bd9efa79e5dc698e16c042686569faae20391fd7ea", // example hashed email (sha256) + p: "05de6c07eb3ea4bce45adca4e0182e771d80fbb99e12401416ca84ddf94c3eb9" //example hashed phone (sha256) + } + }], + syncDelay: 3000 // 3 seconds after the first auction + } + }); +{% endhighlight %} + ### BritePool The [BritePool]((https://britepool.com)) ID is a persistent identifier that enables identity resolution for people-based marketing in the cookieless world. Every BritePool ID is associated with a real identity. As a result, publishers, SSPs and DSPs that integrate with BritePool, or automated @@ -1460,6 +1507,7 @@ Bidders that want to support the User ID module in Prebid.js, need to update the
| ID System Name | ID System Host | Prebid.js Attr | Example Value | | --- | --- | --- | --- | --- | --- | +| Admixer ID | Admixer | bidRequest.userId.admixerId | `"1111"` | | BritePool ID | BritePool | bidRequest.userId.britepoolid | `"1111"` | | CriteoID | Criteo | bidRequest.userId.criteoId | `"1111"` | | Halo ID | Audigent | bidRequest.userId.haloId | `{"haloId":"user-halo-id", "auSeg":["segment1","segment2"]}` | diff --git a/download.md b/download.md index c9683a5669..c3ce4b9c93 100644 --- a/download.md +++ b/download.md @@ -215,6 +215,9 @@ Prebid.js is open source software that is offered for free as a convenience. Whi

User ID Modules

+ +
+