Skip to content

Commit 706d532

Browse files
gmsdelmundogmsdelmundo
committed
Addressed Aleks feedback
1 parent 3156611 commit 706d532

File tree

3 files changed

+54
-50
lines changed

3 files changed

+54
-50
lines changed

‎docs/endpoints/post-identity-map-v2.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ For details about the UID2 opt-out workflow and how users can opt out, see [User
2020
This documentation is for version 2 of this endpoint, which is not the latest version. For the latest version, v3, see [POST /identity/map](post-identity-map.md).
2121

2222
:::note
23-
If you're using version 2, we recommend that you upgrade as soon as possible, to take advantage of improvements. For migration guidance, see [Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map).
23+
If you're using the previous version, we recommend that you upgrade as soon as possible, to take advantage of improvements. For migration guidance, see [Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map).
2424
:::
2525

2626
## Batch Size and Request Parallelization Requirements

‎docs/guides/integration-snowflake-before-july-2025.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ import Link from '@docusaurus/Link';
1515
[Snowflake](https://www.snowflake.com/) is a cloud data warehousing solution, where you as a partner can store your data and integrate with the UID2 framework. Using Snowflake, UID2 enables you to securely share consumer identifier data without exposing sensitive <Link href="../ref-info/glossary-uid#gl-dii">directly identifying information (DII)</Link>. Even though you have the option to query the Operator Web Services directly for the consumer identifier data, the Snowflake UID2 integration offers a more seamless experience.
1616

1717
:::important
18-
This document is for anyone using the Snowflake marketplace listing published prior to July 2025. For documentation on the newer version with v3 functions published in July 2025, see [Snowflake Integration Guide](integration-snowflake.md). If you're using the earlier implementation, we recommend that you migrate to the newer version to take advantage of the updates and enhancements. For migration information, see [Migration Guide](integration-snowflake.md#migration-guide).
18+
This document is for anyone using the Snowflake marketplace listing published prior to July 2025. For documentation on the newer version of identity map published in July 2025, see [Snowflake Integration Guide](integration-snowflake.md). If you're using the earlier implementation, we recommend that you upgrade as soon as possible, to take advantage of improvements. For migration information, see [Migration Guide](integration-snowflake.md#migration-guide).
1919
:::
2020

2121
## Snowflake Marketplace Listing

‎docs/guides/integration-snowflake.md‎

Lines changed: 52 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ If you're a publisher who is sharing UID2 tokens in the <Link href="../ref-info/
4343

4444
## Changes from Previous Version
4545

46-
The July 2025 update to the UID2 Snowflake Marketplace integration introduces a new identity mapping function that simplifies UID2 refresh management and accessing previous raw UID2s for 90 days after rotation.
46+
The July 2025 update to the UID2 Snowflake Marketplace integration introduces a new identity mapping function that simplifies UID2 refresh management and allows accessing previous raw UID2s for 90 days after rotation.
4747

4848
:::note
4949
These changes assume that your code integration uses the version of Snowflake functions published before July 2025: see [Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.md). For details on migrating to this version, see [Migration Guide](#migration-guide).
@@ -102,7 +102,7 @@ You can map DII to UID2s by using the following function:
102102

103103
- `FN_T_IDENTITY_MAP_V3` (for details, see [Map DII](#map-dii))
104104

105-
The following functions are deprecated in favor of `FN_T_IDENTITY_MAP_V3`. You can still use them if you are on the previous Snowflake version (see [Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.md)), but we recommend upgrading as soon as possible:
105+
The following function is deprecated in favor of `FN_T_IDENTITY_MAP_V3`. You can still use it if you are on the previous Snowflake version (see [Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.md)), but we recommend upgrading as soon as possible:
106106

107107
- `FN_T_IDENTITY_MAP` (deprecated)
108108

@@ -200,11 +200,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
200200
Query results for a single email:
201201

202202
```
203-
+----------------------------------------------+----------+--------------+----------+
204-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
205-
+----------------------------------------------+----------+--------------+----------+
206-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
207-
+----------------------------------------------+----------+--------------+----------+
203+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
204+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
205+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
206+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
207+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
208208
```
209209

210210
#### Mapping Request Example - Multiple Unhashed Emails
@@ -221,15 +221,16 @@ Query results for multiple emails:
221221

222222
The following table identifies each item in the response, including `NULL` values for `NULL` or improperly formatted emails.
223223

224-
```sh
225-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
226-
| ID | EMAIL | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
227-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
228-
| 1 | [email protected] | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
229-
| 2 | [email protected] | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
230-
| 3 | invalid-email | NULL | NULL | NULL | INVALID IDENTIFIER |
231-
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
232-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
224+
```
225+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
226+
| ID | EMAIL | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
227+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
228+
| 1 | [email protected] | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
229+
| 2 | [email protected] | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
230+
| 3 | [email protected] | NULL | NULL | NULL | OPTOUT |
231+
| 4 | invalid-email | NULL | NULL | NULL | INVALID IDENTIFIER |
232+
| 5 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
233+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
233234
```
234235

235236
#### Mapping Request Example - Single Unhashed Phone Number
@@ -269,14 +270,15 @@ Query results for multiple phone numbers:
269270
The following table identifies each item in the response, including `NULL` values for `NULL` or invalid phone numbers.
270271

271272
```
272-
+----+--------------+----------------------------------------------+----------+--------------+--------------------+
273-
| ID | PHONE | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
274-
+----+--------------+----------------------------------------------+----------+--------------+--------------------+
275-
| 1 | +12345678901 | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
276-
| 2 | +61491570006 | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
277-
| 3 | 1234 | NULL | NULL | NULL | INVALID IDENTIFIER |
278-
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
279-
+----+--------------+----------------------------------------------+----------+-------------+--------------------+
273+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
274+
| ID | PHONE | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
275+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
276+
| 1 | +12345678901 | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
277+
| 2 | +61491570006 | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
278+
| 3 | +56789123001 | NULL | NULL | NULL | OPTOUT |
279+
| 4 | 1234 | NULL | NULL | NULL | INVALID IDENTIFIER |
280+
| 5 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
281+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
280282
```
281283

282284
#### Mapping Request Example - Single Hashed Email
@@ -290,11 +292,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
290292
Query results for a single hashed email:
291293

292294
```
293-
+----------------------------------------------+----------+--------------+----------+
294-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
295-
+----------------------------------------------+----------+--------------+----------+
296-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
297-
+----------------------------------------------+----------+--------------+----------+
295+
+----------------------------------------------+----------------------------------------------+--------------+----------+
296+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
297+
+----------------------------------------------+----------------------------------------------+--------------+----------+
298+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
299+
+----------------------------------------------+----------------------------------------------+--------------+----------+
298300
```
299301

300302
#### Mapping Request Example - Multiple Hashed Emails
@@ -312,13 +314,14 @@ Query results for multiple hashed emails:
312314
The following table identifies each item in the response, including `NULL` values for `NULL` hashes.
313315

314316
```
315-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
316-
| ID | EMAIL_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
317-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
318-
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
319-
| 2 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
320-
| 3 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
321-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
317+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
318+
| ID | EMAIL_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
319+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
320+
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
321+
| 2 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
322+
| 2 | UebesrNN0bQkm/QR7Jx7eav+UDXN5Gbq3zs1fLBMRy0= | NULL | NULL | 1735689600 | OPTOUT |
323+
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
324+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
322325
```
323326

324327
#### Mapping Request Example - Single Hashed Phone Number
@@ -332,11 +335,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
332335
Query results for a single hashed phone number:
333336

334337
```
335-
+----------------------------------------------+----------+--------------+----------+
336-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
337-
+----------------------------------------------+----------+--------------+----------+
338-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
339-
+----------------------------------------------+----------+--------------+----------+
338+
+----------------------------------------------+----------------------------------------------+--------------+----------+
339+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
340+
+----------------------------------------------+----------------------------------------------+--------------+----------+
341+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
342+
+----------------------------------------------+----------------------------------------------+--------------+----------+
340343
```
341344

342345
#### Mapping Request Example - Multiple Hashed Phone Numbers
@@ -354,13 +357,14 @@ Query results for multiple hashed phone numbers:
354357
The following table identifies each item in the response, including `NULL` values for `NULL` hashes.
355358

356359
```
357-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
358-
| ID | PHONE_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
359-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
360-
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
361-
| 2 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
362-
| 3 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
363-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
360+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
361+
| ID | PHONE_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
362+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
363+
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
364+
| 2 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
365+
| 2 | UebesrNN0bQkm/QR7Jx7eav+UDXN5Gbq3zs1fLBMRy0= | NULL | NULL | 1735689600 | OPTOUT |
366+
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
367+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
364368
```
365369

366370
### Monitor Raw UID2 Refresh and Regenerate Raw UID2s

0 commit comments

Comments
 (0)