From d6f680e52e7373a7759f60f90517010d72d2e7dd Mon Sep 17 00:00:00 2001 From: "v-kristin.vancuyck" Date: Mon, 28 Sep 2026 16:49:07 -0700 Subject: [PATCH 1/6] Review previous changes. Incorp hash to hashing changes. --- docs/getting-started/gs-normalization-encoding.md | 12 ++++++------ ...paring-emails-and-phone-numbers-for-processing.md | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index bf080fb3f..780b12f73 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -1,13 +1,13 @@ --- -title: Normalization and encoding -description: Learn how to normalize and encode information so it's secure and can be decoded. +title: Normalization, hashing, and encoding +description: Instructions for normalizing, hashing, and encoding email addresses and phone numbers. hide_table_of_contents: false displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -# Normalization and encoding +# Normalization, hashing, and encoding This page provides information about normalizing and encoding DII. It's important that, in working with UID2, normalizing and encoding are performed correctly. @@ -53,7 +53,7 @@ Make sure that the normalized email is UTF-8, not another encoding system such a For examples of various scenarios, see [Normalization examples for email](#normalization-examples-for-email). -## Email address hash encoding +## Email address hashing and encoding An email hash is a Base64-encoded SHA-256 hash of a normalized email address. The email address is first normalized, then hashed using the SHA-256 hashing algorithm, and then the resulting bytes of the hash value are encoded using Base64 encoding. Note that the Base64 encoding is applied to the bytes of the hash value, not the hex-encoded string representation. @@ -140,7 +140,7 @@ Here's what you need to know about phone number normalization rules: Make sure that the normalized phone number is UTF-8, not another encoding system such as UTF-16. ::: -## Phone number hash encoding +## Phone number hashing and encoding A phone number hash is a Base64-encoded SHA-256 hash of a normalized phone number. The phone number is first normalized, then hashed using the SHA-256 hashing algorithm, and then the resulting bytes of the hash value are encoded using Base64 encoding. Note that the Base64 encoding is applied to the bytes of the hash value, not the hex-encoded string representation. @@ -213,4 +213,4 @@ If you're having trouble or getting errors, or if you just want to be sure you'r - **Use the Base64-encoded value**: The process includes normalizing, then hashing, then Base64-encoding the bytes of the hash value. When generating UID2s, the input is the Base64-encoded value. Make sure you're using this 44-character string value. -- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email address hash encoding](#email-address-hash-encoding) or [Phone number hash encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). \ No newline at end of file +- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email address hashing and encoding](#email-address-hash-encoding) or [Phone number hashing and encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). \ No newline at end of file diff --git a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md index 5d97fd481..059007f2f 100644 --- a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md +++ b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md @@ -47,7 +47,7 @@ If you're using a UID2 SDK, or other integration solution such as the Prebid.js Phone Number - Must be one of the following: + Must be one of the following: [Phone number normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)
[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding) From e46efc5ac27fad0d72ff73e50709d2134bf5247f Mon Sep 17 00:00:00 2001 From: "v-kristin.vancuyck" Date: Tue, 29 Sep 2026 08:58:59 -0700 Subject: [PATCH 2/6] APIDOCS-3736: Additional hashing copy updates. --- docs/ref-info/updates-doc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ref-info/updates-doc.md b/docs/ref-info/updates-doc.md index 76746b7ec..60c732167 100644 --- a/docs/ref-info/updates-doc.md +++ b/docs/ref-info/updates-doc.md @@ -805,8 +805,8 @@ We clarified the instructions for normalizing and encoding Date: Tue, 29 Sep 2026 09:15:41 -0700 Subject: [PATCH 3/6] APIDOCS-3736: Additional hashing copy updates. --- .../ref-preparing-emails-and-phone-numbers-for-processing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md index 059007f2f..7e7ed982b 100644 --- a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md +++ b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md @@ -48,7 +48,7 @@ If you're using a UID2 SDK, or other integration solution such as the Prebid.js Phone Number Must be one of the following: - [Phone number normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)
[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding) + [Phone number normalization](../getting-started/gs-normalization-encoding#email-address-hashing-and-encoding)
[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding) From c261ac16f165573a8a80c605595f0b7fc514fdbd Mon Sep 17 00:00:00 2001 From: "v-kristin.vancuyck" Date: Tue, 29 Sep 2026 14:16:45 -0700 Subject: [PATCH 4/6] APIDOCS-3736: Fix phone normalization link --- .../ref-preparing-emails-and-phone-numbers-for-processing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md index 7e7ed982b..56a1ca641 100644 --- a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md +++ b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md @@ -48,7 +48,7 @@ If you're using a UID2 SDK, or other integration solution such as the Prebid.js Phone Number Must be one of the following:
  • Normalized raw phone number, including country code
  • Normalized, then hashed, then base64-encoded
- [Phone number normalization](../getting-started/gs-normalization-encoding#email-address-hashing-and-encoding)
[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding) + [Phone number normalization](../getting-started/gs-normalization-encoding#email-address-normalization)
[Phone number hashing and encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding) From b5f90a183d2c8fb3c3124745e808e09cadebf194 Mon Sep 17 00:00:00 2001 From: "v-kristin.vancuyck" Date: Tue, 29 Sep 2026 15:26:36 -0700 Subject: [PATCH 5/6] APIDOCS-3736: Fix phone normalization link --- docs/getting-started/gs-normalization-encoding.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index 780b12f73..af98157d1 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # Normalization, hashing, and encoding -This page provides information about normalizing and encoding DII. It's important that, in working with UID2, normalizing and encoding are performed correctly. +This page provides information about normalizing, hashing, and encoding DII. It's important that, in working with UID2, normalizing and encoding are performed correctly. ## Introduction From 86ca4a221b90df2bac238eec591333cad3476036 Mon Sep 17 00:00:00 2001 From: "v-kristin.vancuyck" Date: Tue, 29 Sep 2026 15:41:50 -0700 Subject: [PATCH 6/6] APIDOCS-3736: Fix has to hashing to opening para. --- docs/getting-started/gs-normalization-encoding.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index af98157d1..642d09aad 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # Normalization, hashing, and encoding -This page provides information about normalizing, hashing, and encoding DII. It's important that, in working with UID2, normalizing and encoding are performed correctly. +This page provides information about normalizing, hashing, and encoding DII. It's important that, in working with UID2, normalizing, hashing, and encoding are performed correctly. ## Introduction