Skip to content

Commit 3a4c6ef

Browse files
committed
add snippet for identity map v3 improvements
1 parent 5ac385a commit 3a4c6ef

File tree

6 files changed

+26
-28
lines changed

6 files changed

+26
-28
lines changed

docs/endpoints/post-identity-map.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ displayed_sidebar: docs
77
---
88

99
import Link from '@docusaurus/Link';
10+
import POSTIdentityMapImprovements from '../snippets/_post-identity-map-improvements-v3.mdx';
1011

1112
# POST /identity/map
1213

@@ -206,13 +207,7 @@ The following sections provide general information and guidance for migrating to
206207

207208
### Version 3 Improvements
208209

209-
The v3 Identity Map API provides the following improvements over v2:
210-
211-
- **Simplified Refresh Management**: You can monitor for UID2s reaching `refresh_from` timestamps instead of polling <Link href="../ref-info/glossary-uid#gl-salt-bucket-id">salt buckets</Link> for rotation.
212-
- **Previous UID2 Access**: You have access to previous raw UID2s for 90 days after rotation for campaign measurement.
213-
- **Single Endpoint**: You use only one endpoint, `/v3/identity/map`, instead of both `/v2/identity/map` and `/v2/identity/buckets`.
214-
- **Multiple Identity Types in One Request**: You can process both emails and phone numbers in a single request.
215-
- **Improved Performance**: The updated version uses significantly less bandwidth to process the same amount of DII.
210+
<POSTIdentityMapImprovements />
216211

217212
### Key Differences Between v2 and v3
218213

docs/getting-started/gs-faqs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,7 @@ Here are some frequently asked questions for advertisers and data providers usin
175175
- [Does the same DII always result in the same raw UID2?](#does-the-same-dii-always-result-in-the-same-raw-uid2)
176176
- [If two operators process the same DII, are the results the same?](#if-two-operators-process-the-same-dii-are-the-results-the-same)
177177
- [How do I know when to refresh the UID2 due to salt bucket rotation?](#how-do-i-know-when-to-refresh-the-uid2-due-to-salt-bucket-rotation)
178-
- [Do refreshed emails get assigned to the same bucket with which they were previously associated?](#do-refreshed-emails-get-assigned-to-the-same-bucket-with-which-they-were-previously-associated)
178+
- [Do refreshed emails get assigned to the same bucket that they were previously associated with?](#do-refreshed-emails-get-assigned-to-the-same-bucket-that-they-were-previously-associated-with)
179179

180180
#### How do I know when to refresh a raw UID2?
181181

@@ -246,7 +246,7 @@ Metadata supplied with the UID2 generation request indicates the <Link href="../
246246
We do not make any promises about when the rotation takes place. To stay as up-to-date as possible, we recommend doing the checks once per hour.
247247
:::
248248

249-
#### Do refreshed emails get assigned to the same bucket with which they were previously associated?
249+
#### Do refreshed emails get assigned to the same bucket that they were previously associated with?
250250

251251
Not necessarily. After you remap emails associated with a particular bucket ID, the emails might be assigned to a different bucket ID. To check the bucket ID, see [Generate Raw UID2s from DII](../guides/integration-advertiser-dataprovider-overview.md#1-generate-raw-uid2s-from-dii) and save the returned raw UID2 and bucket ID again.
252252

docs/sdks/sdk-ref-java.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ displayed_sidebar: docs
77
---
88

99
import Link from '@docusaurus/Link';
10+
import POSTIdentityMapImprovements from '../snippets/_post-identity-map-improvements-v3.mdx';
1011

1112
# SDK for Java Reference Guide
1213

@@ -396,12 +397,7 @@ The following sections provide general information and guidance for migrating to
396397

397398
### Version 3 Improvements
398399

399-
Version 3 of the `POST /identity/map` endpoint includes the following improvements:
400-
401-
- **Support for multiple identity types**: You can process both email addresses and phone numbers in a single request.
402-
- **Simpler refresh management**: You can just re-map any raw UID2 when it reaches the refresh timestamp, rather than monitoring salt buckets, which is a separate API call.
403-
- **Availability of previous raw UID2**: You can see the previous UID2 for 90 days after rotation.
404-
- **Improved performance**: The new API version uses significantly less bandwidth for the same amount of DII.
400+
<POSTIdentityMapImprovements />
405401

406402
### Required Changes
407403

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<!-- Used by: endpoints/post-identity-map.md, sdks/sdk-ref-java.md -->
2+
3+
Version 3 of the `POST /identity/map` endpoint provides the following improvements over v2:
4+
5+
- **Support for multiple identity types**: You can process both email addresses and phone numbers in a single request.
6+
- **Simpler refresh management**: You can just re-map any raw UID2 when it reaches the refresh timestamp, rather than monitoring salt buckets, which is a separate API call.
7+
- **Availability of previous raw UID2**: You can see the previous UID2 for 90 days after rotation.
8+
- **Improved performance**: The new API version uses significantly less bandwidth for the same amount of personal data.

i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,13 @@
11
---
22
title: POST /identity/map
3-
description: DII raw UID2 とソルトバケット ID にマッピング。
3+
description: Maps DII to raw UID2s.
44
hide_table_of_contents: false
55
sidebar_position: 08
6-
displayed_sidebar: docs
6+
displayed_sidebar: docs
77
---
88

99
import Link from '@docusaurus/Link';
10-
11-
:::note
12-
このページには、近日中に翻訳される新しいコンテンツが含まれています。
13-
:::
10+
import POSTIdentityMapImprovements from '../snippets/_post-identity-map-improvements-v3.mdx';
1411

1512
# POST /identity/map
1613

@@ -210,13 +207,7 @@ The following sections provide general information and guidance for migrating to
210207

211208
### Version 3 Improvements
212209

213-
The v3 Identity Map API provides the following improvements over v2:
214-
215-
- **Simplified Refresh Management**: You can monitor for UID2s reaching `refresh_from` timestamps instead of polling <Link href="../ref-info/glossary-uid#gl-salt-bucket-id">salt buckets</Link> for rotation.
216-
- **Previous UID2 Access**: You have access to previous raw UID2s for 90 days after rotation for campaign measurement.
217-
- **Single Endpoint**: You use only one endpoint, `/v3/identity/map`, instead of both `/v2/identity/map` and `/v2/identity/buckets`.
218-
- **Multiple Identity Types in One Request**: You can process both emails and phone numbers in a single request.
219-
- **Improved Performance**: The updated version uses significantly less bandwidth to process the same amount of DII.
210+
<POSTIdentityMapImprovements />
220211

221212
### Key Differences Between v2 and v3
222213

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<!-- Used by: endpoints/post-identity-map.md, sdks/sdk-ref-java.md -->
2+
3+
Version 3 of the `POST /identity/map` endpoint provides the following improvements over v2:
4+
5+
- **Support for multiple identity types**: You can process both email addresses and phone numbers in a single request.
6+
- **Simpler refresh management**: You can just re-map any raw UID2 when it reaches the refresh timestamp, rather than monitoring salt buckets, which is a separate API call.
7+
- **Availability of previous raw UID2**: You can see the previous UID2 for 90 days after rotation.
8+
- **Improved performance**: The new API version uses significantly less bandwidth for the same amount of personal data.

0 commit comments

Comments
 (0)