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: docs/portal/sharing-permissions.md
+38-13Lines changed: 38 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,18 +9,18 @@ import Link from '@docusaurus/Link';
9
9
10
10
# Sharing Permissions
11
11
12
-
Configuring your sharing permissions opens the door to you being able to share UID2s with other UID2 <Linkhref="../ref-info/glossary-uid#gl-sharing-participant">sharing participants</Link>.
12
+
Configuring your sharing permissions opens the door to you being able to share UID2s with other UID2 <Linkhref="../ref-info/glossary-uid#gl-sharing-participant">sharing participants</Link>: adding a sharing permission allows the participant you’re sharing with to decrypt your UID2 tokens.
13
13
14
14
:::tip
15
15
Configuring sharing permissions in the UID2 Portal is for <Linkhref="../ref-info/glossary-uid#gl-tokenized-sharing">tokenized sharing</Link>, not for sharing raw UID2s. For details, see [UID2 Sharing Approaches](../sharing/sharing-overview.md#uid2-sharing-approaches).
16
16
:::
17
17
18
18
There are many options to help you create the exact sharing relationships that you want:
19
19
20
-
-**Recommendations**: You can accept recommendations, with one click, to share with all current and future participants in one or more categories (Publishers, Advertisers, DSPs, or Data Providers). See [Add Sharing Permissions—Bulk](#add-sharing-permissionsbulk).
20
+
-**Bulk Recommendations**: You can accept recommendations, with one click, to share with all current and future participants in one or more categories (Publisher, Advertiser, DSP, or Data Provider). For details, see [Add Sharing Permissions—Bulk](#add-permissionsbulk).
21
21
22
-
Recommendations are based on the participant type specified in your account setup.
23
-
-**Sharing Categories**: You can share with all current and future participants in one or more specific categories that you configure (Publishers, Advertisers, DSPs, or Data Providers).
22
+
Recommendations are based on the participant type specified in your account setup. For details, see [Participant Information](participant-info.md)
23
+
-**Sharing Categories**: You can adjust the bulk recommendations and choose to share with all current and future participants in one or more specific categories that you configure (Publisher, Advertiser, DSP, or Data Provider).
24
24
-**Individual Sharing Relationships**: You can create a sharing relationship with one or more current participants. With this option, you must manually add any future sharing permissions.
25
25
26
26
:::note
@@ -43,19 +43,20 @@ The following sharing options are available via the UID2 Portal. These options a
43
43
44
44
- You can automatically grant permission to all participants of a specific type, such as all publishers, advertisers, DSPs, or data providers. For example, we recommend that publishers grant sharing permission to all DSPs.
45
45
46
-
If you choose this option, all new participants of the selected participant type will automatically have permission to decrypt any data that you send to them. See [Add Sharing Permissions—Bulk](#add-sharing-permissionsbulk).
46
+
If you choose this option, all new participants of the selected participant type automatically gets permission to decrypt any data that you send to them. See [Add Sharing Permissions—Bulk](#add-permissionsbulk).
47
47
48
-
- You can grant permission to one or more specific participants. See [Using Search to Add Sharing Relationships](#using-search-to-add-sharing-relationships).
48
+
- You can grant permission to one or more specific participants. See [Add Permissions—Individual](#add-permissionsindividual).
49
49
50
-
You can update your sharing permission in the UID2 Portal at any point.
50
+
You can update your sharing permissions in the UID2 Portal at any point.
51
51
52
-
## Add Sharing Permissions—Bulk
52
+
## Add Permissions—Bulk
53
53
54
54
The UID2 Portal makes the following recommendations based on your role:
55
55
56
+
- Publishers: share with DSPs
56
57
- Advertisers: share with DSPs and Data Providers
58
+
- DSPs: share with Advertisers and Data Providers
57
59
- Data Providers: share with Publishers, Advertisers, and DSPs
58
-
- Publishers: share with DSPs
59
60
60
61
<!-- The UID2 Portal makes recommendations based on your role. For example:
61
62
- If you're a publisher, you could share with all DSPs (current and future).
@@ -69,11 +70,11 @@ The following illustration shows the recommendations for an advertiser.
69
70
70
71
Accepting the recommendations is the fastest and easiest way to configure your sharing options.
71
72
72
-
For example, let's say you choose to share with all of 20 existing DSPs. The next day, when DSP 21 signs up for sharing, DSP 21 will automatically have permission to decrypt data that you send. To share with DSP 21, just send one or more UID2 tokens, and DSP 21 will be able to decrypt the tokens into raw UID2s. Because you chose automatic sharing, you do not need to log in to explicitly update your sharing permissions to include DSP 21, or any future DSPs that sign up for the UID2 ecosystem.
73
+
For example, let's say you choose to share with all of 20 existing DSPs. The next day, when DSP 21 signs up for sharing, DSP 21 automatically gets permission to decrypt data that you send. To share with DSP 21, just send one or more UID2 tokens, and DSP 21 can decrypt the tokens into raw UID2s. Because you chose automatic sharing, you do not need to log in to explicitly update your sharing permissions to include DSP 21, or any future DSPs that sign up for the UID2 ecosystem.
73
74
74
75
If you prefer, you can set up individual sharing relationships with one or more sharing participants.
75
76
76
-
## Using Search to Add Sharing Relationships
77
+
## Add Permissions—Individual
77
78
78
79
If you prefer to create specific sharing relationships, click **Add Permissions—Individual** to find sharing participants and add them.
79
80
@@ -90,7 +91,7 @@ When you manually create your sharing relationships using the search feature, yo
90
91
## Steps for Granting Sharing Permission
91
92
92
93
:::note
93
-
As well as granting sharing permission in the UID2 Portal, you'll also need to integrate an SDK, or Snowflake functionality, into your code. See [Tokenized Sharing Overview](../sharing/sharing-tokenized-overview.md).
94
+
As well as granting sharing permission in the UID2 Portal, to take part in UID2 sharing you'll also need to integrate an SDK, or Snowflake functionality, into your code. See [Tokenized Sharing Overview](../sharing/sharing-tokenized-overview.md).
94
95
:::
95
96
96
97
Enabling sharing permissions includes the following steps.
@@ -105,9 +106,33 @@ Enabling sharing permissions includes the following steps.
105
106
106
107
If you accept a participant category, such as Advertisers or DSPs, sharing is enabled for current participants of that type, and also future participants of that type that join the UID2 ecosystem.
107
108
108
-
-**Add Permissions—Individual**: If you prefer, you can search for individual participants to share with. For details, see [Using Search to Add Sharing Relationships](#using-search-to-add-sharing-relationships).
109
+
-**Add Permissions—Individual**: If you prefer, you can search for individual participants to share with. For details, see [Add Permissions—Individual](#add-permissionsindividual).
109
110
1. Save changes.
110
111
112
+
---------------- update, draft, begin -----------------------
113
+
114
+
1. Log in to your UID2 Portal account.
115
+
1. Click **Sharing Permissions**.
116
+
1. In the **Add Permissions—Bulk** section, determine whether you want to accept the defaults. If you want to share with the default groups, with no exclusions, just click **Save Permissions** and you're done.
117
+
118
+
To view the list of participants that you'd be sharing with, click **View Participants**.
119
+
120
+
1. In the **Add Permissions—Bulk** section, if you want to adjust the defaults, add or remove groups from the recommendations, and then click **Save Permissions**. Again, if needed, click **View Participants** to see the list.
121
+
122
+
1.**UPTOHERE 3/6/25 NEED INPUT FROM AS RE SHARING PERMISSIONS.**
123
+
124
+
125
+
126
+
127
+
128
+
-**Add Permissions—Individual**: If you prefer, you can search for individual participants to share with. For details, see [Add Permissions—Individual](#add-permissionsindividual).
129
+
1. Save changes.
130
+
131
+
132
+
---------------- update end -----------------------
133
+
134
+
135
+
111
136
:::note
112
137
When you enable sharing permission, this allows the selected sharing participants to access your decryption keys. Each participant that you enable for sharing can use your keys, via a UID2 SDK or Snowflake integration, to decrypt a UID2 token into a raw UID2. However, granting permission is just the first step. In order for sharing to occur, you must send the tokens to the participant. The UID2 Portal enables the permissions. It does not send any data—that is up to you.
0 commit comments