Skip to content

Commit 9ffccd9

Browse files
committed
How the UID2 Token Is Created, minor mods
1 parent 62ac481 commit 9ffccd9

File tree

3 files changed

+8
-6
lines changed

3 files changed

+8
-6
lines changed

docs/ref-info/glossary-uid.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -510,7 +510,7 @@ import Link from '@docusaurus/Link';
510510
<dd>The token value is opaque: No assumptions should be made about the format or about the length of the string.</dd>
511511
<dd>The token has a limited life, but can be refreshed in the background using the <a href="#gl-refresh-token">refresh token</a>.</dd>
512512
<dd>Publishers send UID2 tokens in the bidstream.</dd>
513-
<dd>For details, see <a href="../intro#uid2-identifier-types">UID2 Identifier Types</a> and <a href="ref-tokens#uid2-tokens-key-information">UID2 Tokens: Key Information</a>.</dd>
513+
<dd>For details, see <a href="../intro#uid2-identifier-types">UID2 Identifier Types</a>, <a href="ref-tokens#uid2-tokens-key-information">UID2 Tokens: Key Information</a>, and <a href="ref-how-uid-is-created">How the UID2 Token Is Created</a>.</dd>
514514

515515
<dt><MdxJumpAnchor id="gl-unified-id-20"><a href="#gl-unified-id-20">Unified ID 2.0</a></MdxJumpAnchor></dt>
516516
<dd>The term UID2 can be used to mean the <a href="#gl-uid2-framework">UID2 framework</a>, the <a href="#gl-uid2-service">UID2 service</a>, a <a href="#gl-raw-uid2">raw UID2</a>, or a <a href="#gl-uid2-token">UID2 token</a> (advertising token).</dd>

docs/ref-info/ref-how-uid-is-created.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ import Link from '@docusaurus/Link';
1313
This article describes how the UID2 token that the publisher sends in the bidstream is created. The process is the same for advertisers creating UID2 tokens for conversion pixels. It does not apply to <Link href="../ref-info/glossary-uid#gl-tokenized-sharing">tokenized sharing</Link>, where raw UID2s are encrypted into UID2 tokens before sending to another sharing participant.
1414
:::
1515

16-
When a publisher sends a user's <Link href="../ref-info/glossary-uid#gl-dii">DII</Link>&#8212;<Link href="../ref-info/glossary-uid#gl-hash">hashed</Link> or unhashed email addresses or phone numbers&#8212;to the UID2 Operator, and in return receives a <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 token</Link> to use for targeted advertising, there is a very specific sequence of processing steps that occurs along the way.
16+
When a publisher sends a user's <Link href="../ref-info/glossary-uid#gl-dii">DII</Link>&#8212;<Link href="../ref-info/glossary-uid#gl-hash">hashed</Link> or unhashed email addresses or phone numbers&#8212;to the UID2 <Link href="../ref-info/glossary-uid#gl-operator">Operator</Link>, and in return receives a <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 token</Link> to use for targeted advertising, there is a very specific sequence of processing steps that occurs along the way.
1717

18-
Some preliminary steps are taken by the publisher, but most of the processing steps are done by the UID2 <Link href="../ref-info/glossary-uid#gl-operator">Operator</Link>.
18+
Some preliminary steps are taken by the publisher, but most of the processing steps are done by the UID2 Operator.
1919

2020
It's very important that the publisher steps are performed in the correct sequence:
2121
- When steps are performed in sequence, the resulting value can be recognized as related to other [UID2 identifiers](../intro.md#uid2-identifier-types) generated from online activity by the same individual: the underlying [raw UID2](../ref-info/glossary-uid.md#gl-raw-uid2) matches the raw UID2s generated by other UID2 participants from the same DII, and therefore the token is suitable for targeted advertising.
@@ -41,19 +41,19 @@ For an example with sample values, see [Creating a UID2 Token&#8212;Example](#cr
4141
<tbody>
4242
<tr>
4343
<td>1</td>
44-
<td><Link href="../ref-info/glossary-uid#gl-normalize">Normalization</Link></td>
44+
<td><Link href="../ref-info/glossary-uid#gl-normalize">Normalize.</Link></td>
4545
<td>**Email**: Publisher or UID2 Operator<br/>**Phone number**: Publisher must normalize</td>
4646
<td>[Email Address Normalization](../getting-started/gs-normalization-encoding.md#email-address-normalization)<br/>[Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization)</td>
4747
</tr>
4848
<tr>
4949
<td>2</td>
50-
<td><Link href="../ref-info/glossary-uid#gl-sha-256">SHA-256</Link> hashing of normalized email address</td>
50+
<td>Apply <Link href="../ref-info/glossary-uid#gl-sha-256">SHA-256</Link> hashing to the normalized email address.</td>
5151
<td>Publisher or UID2 Operator</td>
5252
<td>[Email Address Hash Encoding](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding)<br/>[Phone Number Hash Encoding](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding)</td>
5353
</tr>
5454
<tr>
5555
<td>3</td>
56-
<td>Base64 encoding of SHA-256 hash</td>
56+
<td>Apply Base64 encoding to the SHA-256 hash.</td>
5757
<td>Publisher or UID2 Operator</td>
5858
<td>[Email Address Hash Encoding](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding)<br/>[Phone Number Hash Encoding](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding)</td>
5959
</tr>

docs/ref-info/ref-tokens.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ Here are some key points about UID2 tokens:
2828
- Publishers send UID2 tokens in the bidstream.
2929
- Refreshing a UID2 token does not invalidate/expire the original or previous UID2 token. You can still use the earlier token until it expires.
3030

31+
For more information, see [How the UID2 Token Is Created](ref-how-uid-is-created.md).
32+
3133
## Refresh Tokens: Key Information
3234

3335
Here are some key points about refresh tokens:

0 commit comments

Comments
 (0)