Skip to content

Commit 44c1b8e

Browse files
authored
Implement initial proposal for new userId module meta fields - prebid#5060 (prebid#5673)
* Implement initial proposal for new userId module meta fields * Fix linting errors in sharedid md * Migrate all meta data to userId files * Fix linting issues in hadron.md * fix table in mediawallah * Fix dmd table * Fix novatiq id table * fix publisherlink table * Fix liveramp table * Fix trustpid table * Fix yahoo table * Fix yahoo table * Remove empty line * Remove empty line #2
1 parent 8b6c2cd commit 44c1b8e

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+326
-141
lines changed

_layouts/userid.html

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,24 @@
3030
<p><a href="/dev-docs/modules/userId.html#user-id-sub-modules">Back to User ID Module</a></p>
3131

3232
<h2>{{ page.title }}</h2>
33+
<table class="table table-bordered table-striped">
34+
<tr>
35+
<th class="pbTh">Module</th>
36+
<td class="pbTd">{{ page.useridmodule }}</td>
37+
</tr>
38+
<tr>
39+
<th class="pbTh">EID Source</th>
40+
<td class="pbTd">{{ page.eidsource }}</td>
41+
</tr>
42+
<tr>
43+
<th class="pbTh">bidRequest.userId</th>
44+
<td class="pbTd">{{ page.bidRequestUserId }}</td>
45+
</tr>
46+
<tr>
47+
<th class="pbTh">Example</th>
48+
<td class="pbTd"><code>{{ page.example }}</code></td>
49+
</tr>
50+
</table>
3351

3452
{{content}}
3553

dev-docs/modules/idLibrary.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,9 @@ The module attempts to extract a persistant identifier in the following ways:
2626

2727
To get started, add the module to your Prebid.js wrapper. From the command line:
2828

29-
{: .alert.alert-info :}
29+
```bash
3030
gulp build --modules=idImportLibrary
31+
```
3132

3233
## Application Flow
3334

@@ -45,6 +46,7 @@ In the idLibrary module, the persistant id is fetched from the page and synced w
4546
## Configuration
4647

4748
{: .table .table-bordered .table-striped }
49+
4850
| Param | Required | Description |
4951
| --- | --- | --- |
5052
| url | yes | The url endpoint is used to post the MD5 hasheds|

dev-docs/modules/userId.md

Lines changed: 14 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -204,9 +204,22 @@ The corresponding user id object and the eids array will look like this:
204204

205205
{% assign userid_pages = site.pages | where: "layout", "userid" | sort_natural: "title" %}
206206

207+
<table class="table table-bordered table-striped">
208+
<tr>
209+
<th>ID System Name</th>
210+
<th>Prebid.js Attr: bidRequest.userId</th>
211+
<th>EID Source</th>
212+
<th>Example</th>
213+
</tr>
207214
{% for page in userid_pages %}
208-
<li><a href="/{{ page.path | replace: '.md', '.html'}}">{{page.title}}</a></li>
215+
<tr>
216+
<td><a href="/{{ page.path | replace: '.md', '.html'}}">{{page.title}}</a></td>
217+
<td>{{page.bidRequestUserId}}</td>
218+
<td>{{page.eidsource}}</td>
219+
<td>{{page.example}}</td>
220+
</tr>
209221
{% endfor %}
222+
</table>
210223

211224
## Bidder Adapter Implementation
212225

@@ -218,53 +231,6 @@ To add a custom data type for the response of `pbjs.getUserIdsAsEids()`, see oth
218231

219232
Bidders that want to support the User ID module in Prebid.js need to update their bidder adapter to read the indicated bidRequest attributes and pass them to their endpoint.
220233

221-
{: .table .table-bordered .table-striped }
222-
| ID System Name | ID System Host | Prebid.js Attr: bidRequest.userId. | EID Source | Example Value |
223-
| --- | --- | --- | --- | --- | --- |
224-
| 33Across ID | 33Across | 33acrossId | 33across.com | "1111" |
225-
| Admixer ID | Admixer | admixerId | admixer.net | "1111" |
226-
| adQuery QiD | adQuery | qid | adquery.io | "p9v2dpnuckkzhuc..." |
227-
| Adriver ID | Adriver | adriverId | adriver.ru | "1111" |
228-
| Adtelligent ID | Adtelligent | adtelligentId | adtelligent.com | `"1111"` |
229-
| AMX ID | AMX | amxId | amxdt.net | "3ca11058-..." |
230-
| BritePool ID | BritePool | britepoolid | britepool.com | "1111" |
231-
| AudienceOne ID | DAC | dacId | dac.co.jp | {"id": "1111"} |
232-
| DeepIntent ID | Deep Intent | deepintentId | deepintent.com | "1111" |
233-
| DMD ID | DMD | dmdId | hcn.health | "1111" |
234-
| ceeId | ceeId | ceeId | ceeid.eu | "111111" |
235-
| Czech Ad ID | czechAdId | czechAdId | czechadid.cz | "1111" |
236-
| CriteoID | Criteo | criteoId | criteo.com | "1111" |
237-
| Fabrick ID | Neustar | fabrickId | neustar.biz | "1111" |
238-
| FLoC ID | n/a | flocId | | |
239-
| GrowthCode ID | GrowthCode | growthCodeId | growthcode.io | "1111" |
240-
| Hadron ID | Audigent | hadronId | audigent.com | {"hadronId":"user-hadron-id", "auSeg":["segment1", "segment2"]} |
241-
| ID+ | Zeotap | IDP | zeotap.com | "1111" |
242-
| ID5 ID | ID5 | id5id | id5-sync.com | {uid: "1111", ext: { linkType: 2, abTestingControlGroup: false } } |
243-
| IdentityLink | LiveRamp | idl_env | liveramp.com | "1111" |
244-
| Intent IQ ID | Intent IQ | intentiqid | intentiq.com | "1111" |
245-
| Kinesso ID | Kinesso | kpuid | kpuid.com | "1111" |
246-
| LiveIntent ID | Live Intent | lipb.lipbid | liveintent.com | "1111" |
247-
| Lotame Panorama ID | Lotame | lotamePanoramaId | crwdcntrl.net | "e4b9..." |
248-
| MediaWallah OpenLink ID | MediaWallah | mwOpenLinkId | mediawallahscript.com | "1111" |
249-
| merkleID | Merkle | merkleId | merkleinc.com | "1111" |
250-
| naveggId | Navegg | naveggId | navegg.com | "1111" |
251-
| netID | netID | netId | netid.de | "fH5A..." |
252-
| Novatiq ID | Novatiq | novatiqId | novatiq.com | "1111" |
253-
| Parrable ID | Parrable | parrableId | parrable.com | {"eid":"01.15946..."} |
254-
| Publisher Link ID | n/a | publinkId | epsilon.com | |
255-
| PubProvided ID | n/a | pubProvidedId | publisher domain | "1111" |
256-
| Quantcast ID | n/a | quantcastId | quantcast.com | "1111" |
257-
| Rewarded Interest ID | Rewarded Interest | rewardedInterestId | rewardedinterest.com | "1111" |
258-
| Tapad ID | Tapad | tapadId | tapad.com | "1111" |
259-
| Teads ID | Teads | teadsId | teads.com | "1111" |
260-
| SharedID (PBJS 5.x) | n/a | pubcid | pubcid.org | "1111" |
261-
| SharedID (PBJS 4.x)| Prebid | sharedid | sharedid.org | {"id":"01EAJWWN...", "third":"01EAJ..."} |
262-
| Unified ID | Trade Desk | tdid | adserver.org | "1111" |
263-
| ConnectID | Yahoo | connectId | yahoo.com | {"connectId": "72d04af6..."} |
264-
| FreePass ID | FreePass | freepassId | | "1111" |
265-
| UtiqMtp ID | Utiq | utiqMtpId | utiq-mtp.com | "1111" |
266-
| Yandex ID | Yandex | yandexId | yandex.com | "11111111111111111" |
267-
268234
For example, the adapter code might do something like:
269235

270236
```javascript
@@ -355,8 +321,6 @@ If you're an ID provider that wants to get on this page:
355321
* Add a new row to `/dev-docs/modules/userId.md#prebidjs-adapters`
356322
* Submit a documentation Pull Request
357323

358-
<a name="getUserIds"></a>
359-
360324
## ESP Configurations
361325

362326
Google now supports Encrypted Signals for Publishers(ESP), a program that allows publishers can explicitly share encrypted signals on bid requests with third-party bidders. User ID modules now support code which will register the signal sources and encrypted signals are created and are sent to GAM request in a3p parameter. 'encryptedSignal' configuration under userSync Module will help to configure signal sources.

dev-docs/modules/userid-submodules/33across.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: 33Across ID
44
description: 33Across ID User ID sub-module
55
useridmodule: 33acrossIdSystem
6+
bidRequestUserId: 33acrossId
7+
eidsource: 33across.com
8+
example: '"1111"'
69
---
710

811

@@ -21,6 +24,7 @@ gulp build --modules=33acrossIdSystem,userId
2124
The following configuration parameters are available:
2225

2326
{: .table .table-bordered .table-striped }
27+
2428
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2529
| --- | --- | --- | --- | --- |
2630
| name | Required | String | The name of this sub-module | `"33acrossId"` |

dev-docs/modules/userid-submodules/admixer.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: AdmixerID
44
description: AdmixerID User ID sub-module
55
useridmodule: admixerIdSystem
6+
bidRequestUserId: admixerId
7+
eidsource: admixer.net
8+
example: '"1111"'
69
---
710

811

@@ -12,12 +15,14 @@ The Admixer privacy policy is at <https://admixer.com/privacy/>
1215

1316
Add Admixer ID module to your Prebid.js package with:
1417

15-
{: .alert.alert-info :}
18+
```bash
1619
gulp build --modules=admixerIdSystem
20+
```
1721

1822
## AdmixerID Configuration
1923

2024
{: .table .table-bordered .table-striped }
25+
2126
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2227
| --- | --- | --- | --- | --- |
2328
| name | Required | String | `"admixerId"` | `"admixerId"` |

dev-docs/modules/userid-submodules/adquery.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: adQuery QiD
44
description: adQuery QiD User ID sub-module
55
useridmodule: adqueryIdSystem
6+
bidRequestUserId: qid
7+
eidsource: adquery.io
8+
example: '"p9v2dpnuckkzhuc"'
69
---
710

811

dev-docs/modules/userid-submodules/adriver.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,15 @@ layout: userid
33
title: Adriver ID
44
description: Adriver ID User ID sub-module
55
useridmodule: adriverId
6+
bidRequestUserId: adriverId
7+
eidsource: adriver.ru
8+
example: '"1111"'
69
---
710

811
## Adriver ID Configuration
912

1013
{: .table .table-bordered .table-striped }
14+
1115
| Param under userSync.userIds[] | Scope | Type | Description | Example |
1216
| --- | --- | --- | --- | --- |
1317
| name | Required | String | The name of this module: `"adriverId"` | `"adriverId"` |

dev-docs/modules/userid-submodules/adtelligent.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,19 @@ layout: userid
33
title: Adtelligent
44
description: Adtelligent User ID sub-module
55
useridmodule: adtelligentIdSystem
6+
bidRequestUserId: adtelligentId
7+
eidsource: adtelligent.com
8+
example: '"1111"'
69
---
710

811

912
The [Adtelligent](https://adtelligent.com) ID system is a unique per-session user identifier for providing high quality DMP data for advertisers
1013

1114
Add it to your Prebid.js package with:
1215

13-
{: .alert.alert-info :}
16+
```bash
1417
gulp build --modules=userId,adtelligentIdSystem
18+
```
1519

1620
## Adtelligent Configuration
1721

dev-docs/modules/userid-submodules/amxrtb.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: AMX ID
44
description: AMX ID User ID sub-module
55
useridmodule: amxIdSystem
6+
bidRequestUserId: amxId
7+
eidsource: amxdt.net
8+
example: '"3ca11058-..."'
69
---
710

811

dev-docs/modules/userid-submodules/audienceone.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: AudienceOne ID by DAC
44
description: AudienceOne ID by DAC User ID sub-module
55
useridmodule: dacIdSystem
6+
bidRequestUserId: dacId
7+
eidsource: dac.co.jp
8+
example: {"id": "1111"}
69
---
710

811

@@ -11,12 +14,14 @@ Please visit [solutions.dac.co.jp/audienceone](https://solutions.dac.co.jp/audie
1114

1215
Add the AudienceOne ID to your Prebid.js Package with:
1316

14-
{: .alert.alert-info :}
17+
```bash
1518
gulp build --modules=dacIdSystem
19+
```
1620

1721
## AudienceOne ID Configuration
1822

1923
{: .table .table-bordered .table-striped }
24+
2025
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2126
| --- | --- | --- | --- | --- |
2227
| name | Required | String | The name of this module | `"dacId"` |

dev-docs/modules/userid-submodules/britepool.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ title: BritePool
44
description: BritePool User ID sub-module
55
useridmodule: britepoolIdSystem
66
enable_download: false
7+
bidRequestUserId: britepoolid
8+
eidsource: britepool.com
9+
example: '"1111"'
710
---
811

912
{: .alert.alert-warning :}
@@ -14,8 +17,9 @@ integration partners (such as PubMatic), are able to maximize revenues without c
1417

1518
Add it to your Prebid.js package with:
1619

17-
{: .alert.alert-info :}
20+
```bash
1821
gulp build --modules=britepoolIdSystem
22+
```
1923

2024
## BritePool Registration
2125

@@ -24,6 +28,7 @@ Please reach out to [[email protected]](mailto:[email protected]) and requ
2428
## BritePool Configuration
2529

2630
{: .table .table-bordered .table-striped }
31+
2732
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2833
| --- | --- | --- | --- | --- |
2934
| name | Required | String | `"britepoolId"` | `"britepoolId"` |

dev-docs/modules/userid-submodules/ceeIdSystem.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: CEEIdSystem
44
description: CEEID User ID sub-module
55
useridmodule: ceeIdSystem
6+
bidRequestUserId: ceeId
7+
eidsource: ceeid.eu
8+
example: '"1111"'
69
---
710

811
## Prebid Configuration
@@ -16,6 +19,7 @@ gulp build --modules=ceeIdSystem
1619
## CEEID Configuration
1720

1821
{: .table .table-bordered .table-striped }
22+
1923
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2024
| --- | --- | --- | --- | --- |
2125
| name | Required | String | The name of CEEID user ID module. | `"ceeId"` |

dev-docs/modules/userid-submodules/cpexid.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,21 @@ layout: userid
33
title: Czech Ad ID (czechAdId)
44
description: Czech Ad ID (czechAdId) User ID sub-module
55
useridmodule: czechAdIdSystem
6+
bidRequestUserId: czechAdId
7+
eidsource: czechadid.cz
8+
example: '"1111"'
69
---
710

811
Czech Ad ID is a joint project of publishers of the [CPEx alliance](https://www.cpex.cz/) and [Seznam.cz](https://www.seznam.cz). It is a deterministic user ID that offers cross-domain and cross-device identification. For more information see [czechadid.cz](https://www.czechadid.cz)).
912

10-
{: .alert.alert-info :}
13+
```bash
1114
gulp build --modules=czechAdIdSystem
15+
```
1216

1317
## czechAdId Configuration
1418

1519
{: .table .table-bordered .table-striped }
20+
1621
| Param under userSync.userIds[] | Scope | Type | Description | Example |
1722
| --- | --- | --- | --- | --- |
1823
| name | Required | String | The name of this module | `"czechAdId"` |

dev-docs/modules/userid-submodules/criteo.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: Criteo ID for Exchanges
44
description: Criteo ID for Exchanges User ID sub-module
55
useridmodule: criteoIdSystem
6+
bidRequestUserId: criteoId
7+
eidsource: criteo.com
8+
example: '"1111"'
69
---
710

811

@@ -13,8 +16,9 @@ The Criteo privacy policy is at [www.criteo.com/privacy/](https://www.criteo.com
1316

1417
Add it to your Prebid.js package with:
1518

16-
{: .alert.alert-info :}
19+
```bash
1720
gulp build --modules=criteoIdSystem
21+
```
1822

1923
## Criteo ID Configuration
2024

dev-docs/modules/userid-submodules/deepintent.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ layout: userid
33
title: Deepintent
44
description: Deepintent User ID sub-module
55
useridmodule: deepintentDpesIdSystem
6+
bidRequestUserId: deepintentId
7+
eidsource: deepintent.com
8+
example: '"1111"'
69
---
710

811

@@ -17,6 +20,7 @@ DPES ID is free to use and requires a simple registration with DeepIntent. Pleas
1720
## Deepintent DPES ID Configuration
1821

1922
{: .table .table-bordered .table-striped }
23+
2024
| Param under userSync.userIds[] | Scope | Type | Description | Example |
2125
| --- | --- | --- | --- | --- |
2226
| name | Required | String | The name of this module: `"deepintentId"` | `"deepintentId"` |

0 commit comments

Comments
 (0)