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/endpoints/post-identity-map-v2.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ For details about the UID2 opt-out workflow and how users can opt out, see [User
20
20
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).
21
21
22
22
:::note
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). For deprecation information, see [Deprecation Schedule: Endpoint Versions](../ref-info/deprecation-schedule.md#endpoint-versions).
23
+
If you're using an earlier 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). For deprecation information, see [Deprecation Schedule: Endpoint Versions](../ref-info/deprecation-schedule.md#endpoint-versions).
24
24
:::
25
25
26
26
## Batch Size and Request Parallelization Requirements
Copy file name to clipboardExpand all lines: docs/guides/integration-snowflake-before-february-2025.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Snowflake Integration (Before February 2025)
3
-
sidebar_label: Snowflake (Before February 2025)
2
+
title: Snowflake Integration (Before Feb 2025)
3
+
sidebar_label: Snowflake (Before Feb 2025)
4
4
pagination_label: Snowflake Integration
5
5
description: Information about integrating with UID2 through the UID2 Share in Snowflake (earlier listings, separate for Advertiser and Data Provider).
6
6
hide_table_of_contents: false
@@ -10,17 +10,17 @@ displayed_sidebar: docs
10
10
11
11
import Link from '@docusaurus/Link';
12
12
13
-
# Snowflake Integration Guide (Version Prior to February 2025)
13
+
# Snowflake Integration Guide (Pre-Feb 2025)
14
14
15
15
[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 <Linkhref="../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.
16
16
17
17
:::important
18
-
This document is for anyone using the separate advertiser and data provider Snowflake marketplace listings published prior to February 2025. For documentation on the newer, combined listing published in February 2025, see [Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.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-before-july-2025.md#migration-guide).
18
+
This document is for anyone using the separate advertiser and data provider Snowflake marketplace listings published prior to February 2025. For documentation on the latest version, see [Snowflake Integration Guide)](integration-snowflake.md). If you're using any earlier implementation, we recommend that you migrate to the latest version to take advantage of the updates and enhancements. For migration information, see [Migration Guide](integration-snowflake-before-july-2025.md#migration-guide).
19
19
:::
20
20
21
21
The Snowflake marketplace listings for this implementation were separate for advertisers and for data providers. Those listings were removed following the publication of the updated version in February 2025.
22
22
23
-
If you have a working implementation, you can use this documentation to maintain it; however, we recommend upgrading to the latest version. See [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-july-2025.md).
23
+
If you have a working implementation, you can use this documentation to maintain it; however, we recommend upgrading to the latest version. See [Snowflake Integration (Before Feb 2025)](integration-snowflake-before-july-2025.md).
24
24
25
25
:::tip
26
26
For a summary of all integration options and steps for advertisers and data providers, see [Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md).
Copy file name to clipboardExpand all lines: docs/guides/integration-snowflake-before-july-2025.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ displayed_sidebar: docs
10
10
11
11
import Link from '@docusaurus/Link';
12
12
13
-
# Snowflake Integration Guide (Version Prior to July 2025)
13
+
# Snowflake Integration Guide (Pre-July 2025)
14
14
15
15
[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 <Linkhref="../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.
16
16
@@ -46,7 +46,7 @@ If you're a publisher who is sharing UID2 tokens in the <Link href="../ref-info/
46
46
The February 2025 update to the UID2 Snowflake Marketplace integration includes updates and enhancements. One key change is that it includes a single listing and data share that combines the capabilities of the two previous data shares, one for Advertisers and one for Data Providers. This simplifies the integration for all participants.
47
47
48
48
:::note
49
-
These changes assume that your code integration uses the version of Snowflake functions published before February 2025: see [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-february-2025.md). If you're using an even earlier version, that uses the `FN_T_UID2_IDENTITY_MAP_EMAIL` and `FN_T_UID2_IDENTITY_MAP_EMAIL_HASH` functions, you could follow the instructions in the [Migration Guide section in the earlier guide](integration-snowflake-before-february-2025.md#migration-guide), and then upgrade again to the current version. However, in this scenario we recommend that you just follow the instructions in this guide and upgrade in one step. For details, see [Migration Guide](#migration-guide).
49
+
These changes assume that your code integration uses the version of Snowflake functions published before February 2025: see [Snowflake Integration (Before Feb 2025)](integration-snowflake-before-february-2025.md). If you're using an even earlier version, that uses the `FN_T_UID2_IDENTITY_MAP_EMAIL` and `FN_T_UID2_IDENTITY_MAP_EMAIL_HASH` functions, you could follow the instructions in the [Migration Guide section in the earlier guide](integration-snowflake-before-february-2025.md#migration-guide), and then upgrade again to the current version. However, in this scenario we recommend that you follow the instructions in this guide and upgrade in one step. For details, see [Migration Guide](#migration-guide).
50
50
:::
51
51
52
52
The following table shows details of the changes to the Snowflake functions, from the previous version.
@@ -102,7 +102,7 @@ You can map DII to UID2s by using the following function:
102
102
103
103
-`FN_T_IDENTITY_MAP` (for details, see [Map DII](#map-dii))
104
104
105
-
The following function is deprecated in favor of `FN_T_IDENTITY_MAP`. You can still use it if you are on the previous Snowflake version (see [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-february-2025.md)), but we recommend upgrading as soon as possible:
105
+
The following function is deprecated in favor of `FN_T_IDENTITY_MAP`. You can still use it if you are on the previous Snowflake version (see [Snowflake Integration (Before Feb 2025)](integration-snowflake-before-february-2025.md)), but we recommend upgrading as soon as possible:
Copy file name to clipboardExpand all lines: docs/guides/integration-snowflake.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ import Link from '@docusaurus/Link';
15
15
[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 <Linkhref="../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.
16
16
17
17
:::important
18
-
This document is for those using the combined advertiser and data provider Snowflake marketplace listing published in February 2025. If you're using one of the earlier listings, which were separate for advertiser and data provider (that is, you subscribed prior to February 2025), see [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-february-2025.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 details, see [Changes from Previous Version](#changes-from-previous-version). For migration information, see [Migration Guide](#migration-guide).
18
+
This document is for those using the combined advertiser and data provider Snowflake marketplace listing published in February 2025. If you're using one of the earlier listings, which were separate for advertiser and data provider (that is, you subscribed prior to February 2025), see [Snowflake Integration (Before Feb 2025)](integration-snowflake-before-february-2025.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 details, see [Changes from Previous Version](#changes-from-previous-version). For migration information, see [Migration Guide](#migration-guide).
19
19
:::
20
20
21
21
## Snowflake Marketplace Listing
@@ -46,14 +46,14 @@ If you're a publisher who is sharing UID2 tokens in the <Link href="../ref-info/
46
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.
47
47
48
48
:::note
49
-
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).
49
+
These changes assume that your code integration uses the version of Snowflake functions published before July 2025: see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-before-july-2025.md). For details on migrating to this version, see [Migration Guide](#migration-guide).
50
50
:::
51
51
52
52
The following table shows the differences between the old and new identity mapping functions.
53
53
54
54
| Function | Version | Return Fields | Key Differences | Comments |
55
55
| :-- | :-- | :-- | :-- | :-- |
56
-
|`FN_T_IDENTITY_MAP`| Previous |`UID`, `BUCKET_ID`, `UNMAPPED`| Basic identity mapping with salt bucket tracking | Legacy function using salt bucket monitoring for refresh management. For details, see [Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.md).|
56
+
|`FN_T_IDENTITY_MAP`| Previous |`UID`, `BUCKET_ID`, `UNMAPPED`| Basic identity mapping with salt bucket tracking | Legacy function using salt bucket monitoring for refresh management. For details, see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-before-july-2025.md).|
57
57
|`FN_T_IDENTITY_MAP_V3`| Current |`UID`, `PREV_UID`, `REFRESH_FROM`, `UNMAPPED`| Enhanced with previous UID2 access and refresh timestamps | Returns previous UID2 for 90 days after rotation and uses refresh timestamps instead of salt bucket monitoring. For details, see [Map DII](#map-dii).|
58
58
59
59
### Key Benefits
@@ -102,7 +102,7 @@ You can map DII to UID2s by using the following function:
102
102
103
103
-`FN_T_IDENTITY_MAP_V3` (for details, see [Map DII](#map-dii))
104
104
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:
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 (Pre-July 2025)](integration-snowflake-before-july-2025.md)), but we recommend upgrading as soon as possible:
106
106
107
107
-`FN_T_IDENTITY_MAP` (deprecated)
108
108
@@ -616,10 +616,13 @@ To help prevent UID2 tokens from expiring, decrypt the UID2 tokens as soon as th
616
616
617
617
This section provides information to help you upgrade from the previous version to the new UID2 Snowflake functionality with v3 functions.
618
618
619
+
:::note
620
+
If you're upgrading from a version earlier than February 2025, see [Migration Guide](integration-snowflake-before-july-2025.md#migration-guide) in the documentation for the February 2025 update.
621
+
:::
622
+
619
623
### Changing Existing Code
620
624
621
-
For a summary of changes, see [Changes from Previous Version](#changes-from-previous-version). The code snippets in this section are before/after examples of how the earlier functions might be implemented, and how
622
-
you could update to use the new function. The key change is migrating from`FN_T_IDENTITY_MAP` to `FN_T_IDENTITY_MAP_V3`, which provides refresh timestamps instead of salt bucket IDs and includes previous UID2 access.
625
+
For a summary of changes, see [Changes from Previous Version](#changes-from-previous-version). The code snippets in this section are before/after examples of how the earlier functions might be implemented, and how you could update to use the new function. The key change is migrating from `FN_T_IDENTITY_MAP` to `FN_T_IDENTITY_MAP_V3`, which provides refresh timestamps instead of salt bucket IDs and includes previous UID2 access.
実装したものがある場合は、このドキュメントを使用してメンテナンスすることができますが、最新バージョンにアップグレードすることを勧めます。[Snowflake Integration Guide (Version Prior to July 2025)](integration-snowflake-before-july-2025.md) を参照してください。
0 commit comments