Skip to content

Commit f01c25a

Browse files
Merge pull request #920 from IABTechLab/staging-phase-2-identity-map-v3
Staging phase 2 identity map v3
2 parents a616a3f + b7e7c4f commit f01c25a

16 files changed

+2038
-504
lines changed

.idea/.gitignore

Lines changed: 8 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ For details about the UID2 opt-out workflow and how users can opt out, see [User
1919

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

22-
:::important
23-
If you're using the v2 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).
22+
:::note
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).
2424
:::
2525

2626
## Batch Size and Request Parallelization Requirements

docs/endpoints/post-identity-map.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ The following sections provide general information and guidance for migrating to
213213

214214
The following table shows key differences between the versions.
215215

216-
| Feature | V2 Implementation | V3 Implementation |
216+
| Feature | v2 Implementation | v3 Implementation |
217217
|:-------------------------------|:--------------------------------------------|:-------------------------------------------|
218218
| Endpoints Required | `/v2/identity/map` + `/v2/identity/buckets` | `/v3/identity/map` only |
219219
| Identity Types per Request | Single identity type only | Multiple identity types |
@@ -225,7 +225,7 @@ The following table shows key differences between the versions.
225225
To upgrade from an earlier version to version 3, follow these steps:
226226

227227
1. [Update Endpoint URL](#1-update-endpoint-url)
228-
2. [Update V3 Response Parsing Logic](#2-update-v3-response-parsing-logic)
228+
2. [Update v3 Response Parsing Logic](#2-update-v3-response-parsing-logic)
229229
3. [Replace Salt Bucket Monitoring with Refresh Timestamp Logic](#3-replace-salt-bucket-monitoring-with-refresh-timestamp-logic)
230230

231231
#### 1. Update Endpoint URL
@@ -244,7 +244,7 @@ url = '/v3/identity/map'
244244

245245
Update the logic for parsing the response, as shown in the following example.
246246

247-
V2 Response Parsing:
247+
v2 Response Parsing:
248248
```python
249249
# v2: Process mapped/unmapped objects with identifier lookup
250250
for item in response['body']['mapped']:
@@ -255,7 +255,7 @@ for item in response['body']['mapped']:
255255
store_mapping(original_identifier, raw_uid, bucket_id)
256256
```
257257

258-
V3 Response Parsing:
258+
v3 Response Parsing:
259259
```python
260260
# v3: Process array-indexed responses
261261
for index, item in enumerate(response['body']['email']):

docs/guides/integration-advertiser-dataprovider-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -191,7 +191,7 @@ For instructions for monitoring for salt bucket rotations, refer to one of the f
191191

192192
- Python SDK: [Monitor Rotated Salt Buckets](../sdks/sdk-ref-python.md#monitor-rotated-salt-buckets).
193193

194-
- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake.md#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s).
194+
- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake-before-july-2025.md#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s).
195195

196196
- HTTP endpoints: [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s (v2)](integration-advertiser-dataprovider-endpoints.md#monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s-v2).
197197

docs/guides/integration-snowflake-previous.md renamed to docs/guides/integration-snowflake-before-february-2025.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Snowflake Integration (Earlier Listings)
3-
sidebar_label: Snowflake (earlier version)
2+
title: Snowflake Integration (Pre-Feb 2025)
3+
sidebar_label: Snowflake (Before Feb 2025)
44
pagination_label: Snowflake Integration
55
description: Information about integrating with UID2 through the UID2 Share in Snowflake (earlier listings, separate for Advertiser and Data Provider).
66
hide_table_of_contents: false
@@ -10,12 +10,12 @@ displayed_sidebar: docs
1010

1111
import Link from '@docusaurus/Link';
1212

13-
# Snowflake Integration Guide (Version Prior to February 2025)
13+
# Snowflake Integration Guide (Pre-Feb 2025)
1414

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 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](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 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).
1919
:::
2020

2121
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.
@@ -509,7 +509,7 @@ After:
509509
FN_T_UID2_IDENTITY_MAP(EMAIL, 'email')
510510
```
511511

512-
#### Example for mapping unhashed emails
512+
#### Example for mapping hashed emails
513513

514514
Before:
515515

0 commit comments

Comments
 (0)