You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: dev-docs/modules/consentManagementUsp.md
+15-4Lines changed: 15 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,11 +38,19 @@ Here's a summary of the interaction process:
38
38
2. Incorporate this data into the auction objects for adapters to collect.
39
39
3. Proceed with the auction.
40
40
41
-
In the the case of a new user, the USP-API will generally respond only after there is notice and opt-out status information available (i.e., the user has made their choices).
42
-
Making these selections can take some time for the average user, so the module provides timeout settings.
41
+
The IAB USP-API will respond immediately if it is available. The module timeout settings are not related to user selection, but only to API availability.
43
42
43
+
If the timeout period expires or an error from the USP-API is thrown, the auction proceeds without a US Privacy string attached.
44
44
45
-
If the timeout period expires or an error from the USP-API is thrown, the auction proceeds without the user's notice and opt-out status information.
45
+
The string has four characters:
46
+
47
+
{: .table .table-bordered .table-striped }
48
+
| String Component | Values |
49
+
| --- | --- |
50
+
| 1) Specification Version| 1|
51
+
| 2) Explicit Notice/Opportunity to Opt Out| (N = No,Y = Yes,– = Not Applicable)|
52
+
| 3) Has user opted-out of the sale of his or her personal information?| (N = No,Y = Yes,– = Not Applicable)|
53
+
| 4) Publisher is a signatory to the IAB Limited Service Provider Agreement| (N = No,Y = Yes,– = Not Applicable)|
46
54
47
55
## Page Integration
48
56
@@ -60,13 +68,16 @@ Here are the parameters supported in the `consentManagement` object:
60
68
| --- | --- | --- | --- |
61
69
| usp |`Object`|||
62
70
| usp.cmpApi |`string`| The USP-API interface that is in use. Supported values are **'iab'** or **'static'**. Static allows integrations where IAB-formatted strings are provided in a non-standard way. Default is `'iab'`. |`'iab'`|
63
-
| usp.timeout |`integer`| Length of time (in milliseconds) to allow the USP-API to obtain the CCPA string. Default is `10000`. |`10000`|
71
+
| usp.timeout |`integer`| Length of time (in milliseconds) to allow the USP-API to obtain the CCPA string. Default is `50`. |`50`|
64
72
| usp.consentData |`Object`| An object representing the CCPA notice and opt-out status data being passed directly; only used when cmpApi is 'static'. Default is `undefined`. ||
65
73
66
74
{: .alert.alert-info :}
67
75
Note that the term 'CMP' (Consent Management Platform) was chosen in Prebid to keep the interface similar
68
76
to the GDPR implementation, though US-Privacy doesn't specifically use that term.
0 commit comments