From 27880f8879bb40e3fbcf0fd0af6e469731e24336 Mon Sep 17 00:00:00 2001 From: annavane Date: Wed, 13 Nov 2024 14:49:30 +0100 Subject: [PATCH 1/6] - The Newco TNCID documentation updated --- dev-docs/modules/userId.md | 1 + .../modules/userid-submodules/tncIdSystem.md | 32 +++++++++++++++---- 2 files changed, 26 insertions(+), 7 deletions(-) diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md index 200b39ad95..ed8ef59877 100644 --- a/dev-docs/modules/userId.md +++ b/dev-docs/modules/userId.md @@ -254,6 +254,7 @@ Bidders that want to support the User ID module in Prebid.js need to update thei | Quantcast ID | n/a | quantcastId | quantcast.com | "1111" | | Tapad ID | Tapad | tapadId | tapad.com | "1111" | | Teads ID | Teads | teadsId | teads.com | "1111" | +| TNC ID | The Newco | tncId | thenewco.it | "1111" | | SharedID (PBJS 5.x) | n/a | pubcid | pubcid.org | "1111" | | SharedID (PBJS 4.x)| Prebid | sharedid | sharedid.org | {"id":"01EAJWWN...", "third":"01EAJ..."} | | Unified ID | Trade Desk | tdid | adserver.org | "1111" | diff --git a/dev-docs/modules/userid-submodules/tncIdSystem.md b/dev-docs/modules/userid-submodules/tncIdSystem.md index 6b82fd0250..8529149a65 100644 --- a/dev-docs/modules/userid-submodules/tncIdSystem.md +++ b/dev-docs/modules/userid-submodules/tncIdSystem.md @@ -1,4 +1,12 @@ -# TNCID UserID Module +--- +layout: userid +title: TNCID by The Newco +description: TNCID UserID sub-module +useridmodule: tncIdSystem +--- + +TNCID is a shared persistent identifier that improves user recognition compared to both third-party and first-party cookies. This enhanced identification capability enables publishers and advertisers to consistently recognize their audiences, leading to improved monetization and more precise targeting. The Newco User ID sub-module adds powerful TNCID user identification technology to your Prebid.js bidstream. +For more details, visit our website and contact us to request your publisher-id and the on-page tag. ## Prebid Configuration @@ -8,7 +16,7 @@ First, make sure to add the TNCID submodule to your Prebid.js package with: gulp build --modules=tncIdSystem,userId ``` -## TNCIDIdSystem module Configuration +## TNCIdSystem module Configuration Disclosure: This module loads external script unreviewed by the prebid.js community @@ -20,7 +28,12 @@ pbjs.setConfig({ userIds: [{ name: 'tncId', params: { - url: 'https://js.tncid.app/remote.min.js' //Optional + url: 'https://js.tncid.app/remote.min.js?publisherId=[PUBLISHER_ID]' //Please contact The Newco for your own [PUBLISHER_ID] + }, + storage: { + type: "cookie", + name: "tncid", + expires: 365 // in days } }], syncDelay: 5000 @@ -30,7 +43,12 @@ pbjs.setConfig({ ## Configuration Params -| Param Name | Required | Type | Description | -| --- | --- | --- | --- | -| name | Required | String | ID value for the TNCID module: `"tncId"` | -| params.url | Optional | String | Provide TNC fallback script URL, this script is loaded if there is no TNC script on page | +The following configuration parameters are available: + +{: .table .table-bordered .table-striped } +| Param under userSync.userIds[] | Scope | Type | Description | Example | +| --- | --- | --- | --- | --- | +| name | Required | String | The name of this sub-module | `"tncId"` | +| params ||| Details for the sub-module initialization || +| params.url | Required | String | TNC script fallback URL - This script is loaded if there is no TNC script on page | 'https://js.tncid.app/remote.min.js' | + From d7163bdd337ea4f91b7d26cd999b9975290fee3a Mon Sep 17 00:00:00 2001 From: annavane Date: Wed, 13 Nov 2024 14:54:18 +0100 Subject: [PATCH 2/6] - userId module - name value examples list - fix --- dev-docs/modules/userId.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md index 11e1939c28..1dc5995558 100644 --- a/dev-docs/modules/userId.md +++ b/dev-docs/modules/userId.md @@ -85,7 +85,7 @@ The table below has the options that are common across ID systems. See the secti {: .table .table-bordered .table-striped } | Param under userSync.userIds[] | Scope | Type | Description | Example | | --- | --- | --- | --- | --- | -| name | Required | String | May be any of the following values: {% for page in userid_pages -%}{% if count == 1 %}{{ name_string │ append: ", " -}}{% endif %}{% assign count = 1 %}`"{{ name_string │ append: name_string -}}{{ name_string │ append: page.useridmodule -}}"`{% endfor %} | `"unifiedId"` | +| name | Required | String | May be any of the following values: {% for page in userid_pages -%}{% if count == 1 %}{{ name_string | append: ", " -}}{% endif %}{% assign count = 1 %}`"{{ name_string | append: name_string -}}{{ name_string | append: page.useridmodule -}}"`{% endfor %} | `"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 a cookie, HTML5 storage or both.| | From 8599a3a89648e84f17406c8fce464509c6cc7f45 Mon Sep 17 00:00:00 2001 From: annavane Date: Wed, 13 Nov 2024 15:12:56 +0100 Subject: [PATCH 3/6] Revert "- userId module - name value examples list - fix" This reverts commit d7163bdd337ea4f91b7d26cd999b9975290fee3a. --- dev-docs/modules/userId.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md index 1dc5995558..11e1939c28 100644 --- a/dev-docs/modules/userId.md +++ b/dev-docs/modules/userId.md @@ -85,7 +85,7 @@ The table below has the options that are common across ID systems. See the secti {: .table .table-bordered .table-striped } | Param under userSync.userIds[] | Scope | Type | Description | Example | | --- | --- | --- | --- | --- | -| name | Required | String | May be any of the following values: {% for page in userid_pages -%}{% if count == 1 %}{{ name_string | append: ", " -}}{% endif %}{% assign count = 1 %}`"{{ name_string | append: name_string -}}{{ name_string | append: page.useridmodule -}}"`{% endfor %} | `"unifiedId"` | +| name | Required | String | May be any of the following values: {% for page in userid_pages -%}{% if count == 1 %}{{ name_string │ append: ", " -}}{% endif %}{% assign count = 1 %}`"{{ name_string │ append: name_string -}}{{ name_string │ append: page.useridmodule -}}"`{% endfor %} | `"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 a cookie, HTML5 storage or both.| | From 99168c4b6d751d65e6c6d038acbfeefe10766bdd Mon Sep 17 00:00:00 2001 From: annavane Date: Wed, 13 Nov 2024 15:55:32 +0100 Subject: [PATCH 4/6] - Lint errors fixed --- dev-docs/modules/userid-submodules/tncIdSystem.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/dev-docs/modules/userid-submodules/tncIdSystem.md b/dev-docs/modules/userid-submodules/tncIdSystem.md index 8529149a65..f384fc9622 100644 --- a/dev-docs/modules/userid-submodules/tncIdSystem.md +++ b/dev-docs/modules/userid-submodules/tncIdSystem.md @@ -28,7 +28,7 @@ pbjs.setConfig({ userIds: [{ name: 'tncId', params: { - url: 'https://js.tncid.app/remote.min.js?publisherId=[PUBLISHER_ID]' //Please contact The Newco for your own [PUBLISHER_ID] + url: 'TNC-fallback-script-url' // Fallback url, not required if onpage tag is present (ask TNC for it) }, storage: { type: "cookie", @@ -50,5 +50,4 @@ The following configuration parameters are available: | --- | --- | --- | --- | --- | | name | Required | String | The name of this sub-module | `"tncId"` | | params ||| Details for the sub-module initialization || -| params.url | Required | String | TNC script fallback URL - This script is loaded if there is no TNC script on page | 'https://js.tncid.app/remote.min.js' | - +| params.url | Required | String | TNC script fallback URL - This script is loaded if there is no TNC script on page | `"https://js.tncid.app/remote.min.js"` | From 4931f88dacef211aeadd375a389bc764ab1ef0bc Mon Sep 17 00:00:00 2001 From: annavane <101708287+annavane@users.noreply.github.com> Date: Fri, 15 Nov 2024 11:43:59 +0100 Subject: [PATCH 5/6] Update dev-docs/modules/userid-submodules/tncIdSystem.md TNCID metadata fields Co-authored-by: Muki Seiler --- dev-docs/modules/userid-submodules/tncIdSystem.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/dev-docs/modules/userid-submodules/tncIdSystem.md b/dev-docs/modules/userid-submodules/tncIdSystem.md index f384fc9622..d0c499e719 100644 --- a/dev-docs/modules/userid-submodules/tncIdSystem.md +++ b/dev-docs/modules/userid-submodules/tncIdSystem.md @@ -3,6 +3,9 @@ layout: userid title: TNCID by The Newco description: TNCID UserID sub-module useridmodule: tncIdSystem +bidRequestUserId: tncId +eidsource: thenewco.it +example: '"1111"' --- TNCID is a shared persistent identifier that improves user recognition compared to both third-party and first-party cookies. This enhanced identification capability enables publishers and advertisers to consistently recognize their audiences, leading to improved monetization and more precise targeting. The Newco User ID sub-module adds powerful TNCID user identification technology to your Prebid.js bidstream. From 7b42cb1b6ca69187198868d63b64f2003f2f05d7 Mon Sep 17 00:00:00 2001 From: annavane Date: Fri, 15 Nov 2024 11:48:47 +0100 Subject: [PATCH 6/6] > This is not going be necessary thanks to #5673 , which generates this automatically. --- dev-docs/modules/userId.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md index 11e1939c28..ba4c2c7168 100644 --- a/dev-docs/modules/userId.md +++ b/dev-docs/modules/userId.md @@ -254,7 +254,6 @@ Bidders that want to support the User ID module in Prebid.js need to update thei | Quantcast ID | n/a | quantcastId | quantcast.com | "1111" | | Tapad ID | Tapad | tapadId | tapad.com | "1111" | | Teads ID | Teads | teadsId | teads.com | "1111" | -| TNC ID | The Newco | tncId | thenewco.it | "1111" | | SharedID (PBJS 5.x) | n/a | pubcid | pubcid.org | "1111" | | SharedID (PBJS 4.x)| Prebid | sharedid | sharedid.org | {"id":"01EAJWWN...", "third":"01EAJ..."} | | Unified ID | Trade Desk | tdid | adserver.org | "1111" |