Skip to content

Commit e7f36db

Browse files
gmsdelmundogmsdelmundo
authored
Merge pull request #921 from IABTechLab/gdm-UID2-5576-hotfix
Fixed outdated migration and inconsistent Japanese page
2 parents 90c1f14 + 8291b9f commit e7f36db

File tree

2 files changed

+53
-103
lines changed

2 files changed

+53
-103
lines changed

‎docs/guides/integration-snowflake.md‎

Lines changed: 0 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -668,30 +668,3 @@ After (using refresh timestamp monitoring):
668668
select * from AUDIENCE_WITH_UID2
669669
where REFRESH_FROM <= DATE_PART(epoch_second, CURRENT_TIMESTAMP()) or UID2 IS NULL;
670670
```
671-
672-
#### Example for Token Encryption
673-
674-
Before:
675-
676-
```sql
677-
select UID2_TOKEN, ENCRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_UID2_ENCRYPT('2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU='));
678-
```
679-
680-
After:
681-
682-
```sql
683-
select UID_TOKEN, ENCRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_ENCRYPT('2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU='));
684-
```
685-
686-
#### Example for Token Decryption
687-
688-
Before:
689-
690-
```sql
691-
select UID2, SITE_ID, DECRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_UID2_DECRYPT('A41234<rest of token>'));
692-
```
693-
694-
After:
695-
```sql
696-
select UID, SITE_ID, DECRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_DECRYPT('A41234<rest of token>'));
697-
```

‎i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md‎

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

4848
## Changes from Previous Version
4949

50-
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.
50+
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.
5151

5252
:::note
5353
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).
@@ -106,7 +106,7 @@ You can map DII to UID2s by using the following function:
106106

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

109-
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:
109+
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:
110110

111111
- `FN_T_IDENTITY_MAP` (deprecated)
112112

@@ -204,11 +204,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
204204
Query results for a single email:
205205

206206
```
207-
+----------------------------------------------+----------+--------------+----------+
208-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
209-
+----------------------------------------------+----------+--------------+----------+
210-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
211-
+----------------------------------------------+----------+--------------+----------+
207+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
208+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
209+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
210+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
211+
+----------------------------------------------+--------------------------------------------------+--------------+----------+
212212
```
213213

214214
#### Mapping Request Example - Multiple Unhashed Emails
@@ -225,15 +225,16 @@ Query results for multiple emails:
225225

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

228-
```sh
229-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
230-
| ID | EMAIL | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
231-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
232-
| 1 | [email protected] | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
233-
| 2 | [email protected] | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
234-
| 3 | invalid-email | NULL | NULL | NULL | INVALID IDENTIFIER |
235-
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
236-
+----+----------------------+----------------------------------------------+----------+--------------+--------------------+
228+
```
229+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
230+
| ID | EMAIL | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
231+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
232+
| 1 | [email protected] | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
233+
| 2 | [email protected] | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
234+
| 3 | [email protected] | NULL | NULL | NULL | OPTOUT |
235+
| 4 | invalid-email | NULL | NULL | NULL | INVALID IDENTIFIER |
236+
| 5 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
237+
+----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
237238
```
238239

239240
#### Mapping Request Example - Single Unhashed Phone Number
@@ -273,14 +274,15 @@ Query results for multiple phone numbers:
273274
The following table identifies each item in the response, including `NULL` values for `NULL` or invalid phone numbers.
274275

275276
```
276-
+----+--------------+----------------------------------------------+----------+--------------+--------------------+
277-
| ID | PHONE | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
278-
+----+--------------+----------------------------------------------+----------+--------------+--------------------+
279-
| 1 | +12345678901 | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
280-
| 2 | +61491570006 | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
281-
| 3 | 1234 | NULL | NULL | NULL | INVALID IDENTIFIER |
282-
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
283-
+----+--------------+----------------------------------------------+----------+-------------+--------------------+
277+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
278+
| ID | PHONE | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
279+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
280+
| 1 | +12345678901 | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
281+
| 2 | +61491570006 | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
282+
| 3 | +56789123001 | NULL | NULL | NULL | OPTOUT |
283+
| 4 | 1234 | NULL | NULL | NULL | INVALID IDENTIFIER |
284+
| 5 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
285+
+----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
284286
```
285287

286288
#### Mapping Request Example - Single Hashed Email
@@ -294,11 +296,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
294296
Query results for a single hashed email:
295297

296298
```
297-
+----------------------------------------------+----------+--------------+----------+
298-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
299-
+----------------------------------------------+----------+--------------+----------+
300-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
301-
+----------------------------------------------+----------+--------------+----------+
299+
+----------------------------------------------+----------------------------------------------+--------------+----------+
300+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
301+
+----------------------------------------------+----------------------------------------------+--------------+----------+
302+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
303+
+----------------------------------------------+----------------------------------------------+--------------+----------+
302304
```
303305

304306
#### Mapping Request Example - Multiple Hashed Emails
@@ -316,13 +318,14 @@ Query results for multiple hashed emails:
316318
The following table identifies each item in the response, including `NULL` values for `NULL` hashes.
317319

318320
```
319-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
320-
| ID | EMAIL_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
321-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
322-
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
323-
| 2 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
324-
| 3 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
325-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
321+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
322+
| ID | EMAIL_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
323+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
324+
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
325+
| 2 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
326+
| 2 | UebesrNN0bQkm/QR7Jx7eav+UDXN5Gbq3zs1fLBMRy0= | NULL | NULL | 1735689600 | OPTOUT |
327+
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
328+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
326329
```
327330

328331
#### Mapping Request Example - Single Hashed Phone Number
@@ -336,11 +339,11 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_
336339
Query results for a single hashed phone number:
337340

338341
```
339-
+----------------------------------------------+----------+--------------+----------+
340-
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
341-
+----------------------------------------------+----------+--------------+----------+
342-
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
343-
+----------------------------------------------+----------+--------------+----------+
342+
+----------------------------------------------+----------------------------------------------+--------------+----------+
343+
| UID | PREV_UID | REFRESH_FROM | UNMAPPED |
344+
+----------------------------------------------+----------------------------------------------+--------------+----------+
345+
| 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
346+
+----------------------------------------------+----------------------------------------------+--------------+----------+
344347
```
345348

346349
#### Mapping Request Example - Multiple Hashed Phone Numbers
@@ -358,13 +361,14 @@ Query results for multiple hashed phone numbers:
358361
The following table identifies each item in the response, including `NULL` values for `NULL` hashes.
359362

360363
```
361-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
362-
| ID | PHONE_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
363-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
364-
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | NULL | 1735689600 | NULL |
365-
| 2 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
366-
| 3 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
367-
+----+----------------------------------------------+----------------------------------------------+----------+--------------+--------------------+
364+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
365+
| ID | PHONE_HASH | UID | PREV_UID | REFRESH_FROM | UNMAPPED |
366+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
367+
| 1 | LdhtUlMQ58ZZy5YUqGPRQw5xUMS5dXG5ocJHYJHbAKI= | 2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU= | vP9zK2mL7fR4tY8qN3wE6xB0dH5jA1sC+nI/oGuMeVa= | 1735689600 | NULL |
368+
| 2 | /XJSTajB68SCUyuc3ePyxSLNhxrMKvJcjndq8TuwW5g= | IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ= | NULL | 1735689600 | NULL |
369+
| 2 | UebesrNN0bQkm/QR7Jx7eav+UDXN5Gbq3zs1fLBMRy0= | NULL | NULL | 1735689600 | OPTOUT |
370+
| 4 | NULL | NULL | NULL | NULL | INVALID IDENTIFIER |
371+
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+
368372
```
369373

370374
### Monitor Raw UID2 Refresh and Regenerate Raw UID2s
@@ -651,7 +655,7 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table({DATABASE_NAME}.{SCHEMA_
651655

652656
#### Example for Monitoring UID2 Refresh and Regenerating Raw UID2s
653657

654-
The V3 function provides refresh timestamps directly, eliminating the need to monitor salt buckets. Instead of joining with salt bucket views, you can compare the current timestamp against the `REFRESH_FROM` timestamp returned by the function.
658+
The v3 function provides refresh timestamps directly, eliminating the need to monitor salt buckets. Instead of joining with salt bucket views, you can compare the current timestamp against the `REFRESH_FROM` timestamp returned by the function.
655659

656660
Before (using salt bucket monitoring):
657661

@@ -668,30 +672,3 @@ After (using refresh timestamp monitoring):
668672
select * from AUDIENCE_WITH_UID2
669673
where REFRESH_FROM <= DATE_PART(epoch_second, CURRENT_TIMESTAMP()) or UID2 IS NULL;
670674
```
671-
672-
#### Example for Token Encryption
673-
674-
Before:
675-
676-
```sql
677-
select UID2_TOKEN, ENCRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_UID2_ENCRYPT('2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU='));
678-
```
679-
680-
After:
681-
682-
```sql
683-
select UID_TOKEN, ENCRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_ENCRYPT('2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU='));
684-
```
685-
686-
#### Example for Token Decryption
687-
688-
Before:
689-
690-
```sql
691-
select UID2, SITE_ID, DECRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_UID2_DECRYPT('A41234<rest of token>'));
692-
```
693-
694-
After:
695-
```sql
696-
select UID, SITE_ID, DECRYPTION_STATUS from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_DECRYPT('A41234<rest of token>'));
697-
```

0 commit comments

Comments
 (0)