diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md index 2b4572d3cb..cf763dc00f 100644 --- a/dev-docs/bidders/taboola.md +++ b/dev-docs/bidders/taboola.md @@ -19,6 +19,7 @@ safeframes_ok: true fpd_supported: true ortb_blocking_supported: partial deals_supported: false +userIds: taboolaId pbs_app_supported: true multiformat_supported: will-not-bid sidebarType: 1 diff --git a/dev-docs/modules/userid-submodules/liveintent.md b/dev-docs/modules/userid-submodules/liveintent.md index 842cdb94fb..16696bd312 100644 --- a/dev-docs/modules/userid-submodules/liveintent.md +++ b/dev-docs/modules/userid-submodules/liveintent.md @@ -106,7 +106,7 @@ The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, #### Note * `thetradedesk` will be exposed as `tdid` because of historical reasons. -* In order for `segments` to be present in `ortb2.user.data` of the bid requests, you need to configure the [liveIntentRTDProvider](/dev-docs/modules/liveIntentRtdProvider.html) module. +* In order for `segments` to be present in `ortb2.user.data` of the bid requests, you need to configure the [liveIntentRTDProvider](/dev-docs/modules/liveIntentRtdProvider.html) module. For example, in case `uid2` is configured to be requested in addition to the `nonID`, the `request.userId` object would look like the following: @@ -195,9 +195,6 @@ pbjs.setConfig({ ## LiveIntent ID configuration -{: .alert.alert-info :} -NOTE: For optimal performance, the LiveIntent ID sub-module should be called at every opportunity. It is best not to use `params.storage` with this sub-module as it has its own optimal caching mechanism. - {: .table .table-bordered .table-striped } | Param under userSync.userIds[] | Scope | Type | Description | Example | diff --git a/dev-docs/modules/userid-submodules/taboola.md b/dev-docs/modules/userid-submodules/taboola.md new file mode 100644 index 0000000000..5e6cca82e7 --- /dev/null +++ b/dev-docs/modules/userid-submodules/taboola.md @@ -0,0 +1,60 @@ +--- +layout: userid +title: Taboola ID +description: Taboola ID User ID sub-module +useridmodule: taboolaIdSystem +bidRequestUserId: taboolaId +eidsource: taboola.com +example: '"abc123def456"' +--- + + +Taboola is a global leader in powering recommendations across the open web. The Taboola ID module allows publishers to enable identity support for Taboola demand by leveraging a persistent user ID from Taboola's identity infrastructure. + +This ID helps improve addressability, performance, and monetization opportunities across Taboola-integrated supply paths, particularly in environments where third-party cookies are limited or unavailable. + +The Taboola privacy policy can be found at [www.taboola.com/privacy-policy](https://www.taboola.com/privacy-policy). + +Add it to your Prebid.js package with: + +```bash +gulp build --modules=taboolaIdSystem,userId +``` + +## Taboola ID Configuration + +The Taboola ID module does not require any configuration parameters. If needed, it supports an optional `storage` config to persist the ID locally. + +{: .alert.alert-info :} +NOTE: The Taboola ID module supports both first-party and server-side Prebid identity environments. + +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 | `"taboolaId"` | +| storage ||| | | +| storage.name | Required | String | The name of the cookie or html5 local storage key | `"taboolaId"` (recommended) | +| storage.type | Required | String | This is where the taboola user ID will be stored | `"cookie&html5"` (recommended) or `"html5"` | +| storage.expires | Strongly Recommended | Number | How long (in days) the user ID information will be stored | `365` (recommended) | + +## Taboola ID Example + +```javascript +pbjs.setConfig({ + userSync: { + userIds: [ + { + name: 'taboolaId', + storage: { //Optionally specify where to store the ID, e.g. cookies or localStorage + name: 'taboolaId', + type: 'html5', // or 'html5&cookie' + expires: 365 // days + } + } + ] + } +}); +```