Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 18 additions & 12 deletions dev-docs/modules/userid-submodules/utiqMtp.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,10 @@ If you are interested in using Utiq on your website, please contact Utiq on <htt

{: .table .table-bordered .table-striped }

| Param under userSync.userIds[] | Scope | Type | Description | Example |
| --- | --- | --- | --- | --- |
| name | Required | String | The name of the module | `"utiqMtpId"` |
| Param under userSync.userIds[] | Scope | Type | Description | Example |
| ------------------------------ | -------- | ------ | --------------------------- | ----------------------------- |
| name | Required | String | The name of the module | `"utiqMtpId"` |
| bidders | Required | Array | SSPs to send martechpass to | `["bidder1", "bidder2", ...]` |

Configuration example:

Expand All @@ -44,6 +45,8 @@ pbjs.setConfig({
})
```

You may like to consider limiting the SSPs that receive the martechpass by **adding the bidders array**, to make sure they are not forwarding this first party ID to DSPs. We are working with SSPs to blacklist the above source from being sent to DSPs, please reach out to <csm@utiq.com> to verify which are these SSPs.

## TCF Activity Integration

If you use the Prebid.js [TCF Control Module](/dev-docs/modules/tcfControl), which prevents access to local storage for non consented vendors, you may need to add a vendor exception for the Utiq user id module to work, as Utiq is not a TCF vendor and will be automatically blocked by Prebid when TCF Control is enabled. Utiq performs its own consent check, outside TCF, to ensure that there is no device storage access in the absence of consent.
Expand All @@ -54,15 +57,18 @@ To do that, you can use below configuration:
pbjs.setConfig({
consentManagement: {
gdpr: {
cmpApi: 'iab',
rules: [{ // these are the default values
purpose: "storage",
enforcePurpose: true, // block localStorage based on purpose 1 of TCF
enforceVendor: true, // block localStorage for non consented / non TCF vendors
vendorExceptions: ["utiqMtpId"] // configuration line to add to make utiq exception
}]
}
}
cmpApi: "iab",
rules: [
{
// these are the default values
purpose: "storage",
enforcePurpose: true, // block localStorage based on purpose 1 of TCF
enforceVendor: true, // block localStorage for non consented / non TCF vendors
vendorExceptions: ["utiqMtpId"], // configuration line to add to make utiq exception
},
],
},
},
});
```

Expand Down