Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳
このドキュメントは、このエンドポイントのバージョン 2 のものであり、最新バージョンではありません。最新バージョン v3 の詳細は、[POST /identity/map](post-identity-map.md) を参照してください。

:::note
v2 バージョンを使用している場合は、改善点を活用するためにできるだけ早くアップグレードすることを推奨します。移行ガイダンスは、[Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map) を参照してください。
以前のバージョンを使用している場合は、改善点を活用するためにできるだけ早くアップグレードすることを推奨します。移行ガイダンスは、[Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map) を参照してください。廃止に関する情報は、[Deprecation Schedule: Endpoint Versions](../ref-info/deprecation-schedule.md#endpoint-versions) を参照してください。
:::

## Batch Size and Request Parallelization Requirements
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: POST /identity/map
description: Maps DII to raw UID2s.
description: DII raw UID2 にマップします。
hide_table_of_contents: false
sidebar_position: 08
displayed_sidebar: docs
Expand Down Expand Up @@ -175,7 +175,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ
| Property | Data Type | Description |
| :--- | :--- | :--- |
| `u` | string | リクエストで提供されたメールアドレスまたは電話番号に対応する raw UID2。 |
| `p` | string | 以下のいずれか:<ul><li>現在の raw UID2 が過去 90 日以内にローテーションされた場合: 前の値。</li><li>現在の raw UID2 が 90 日以上前のものである場合: `null`。</li></ul> |
| `p` | string | 以下のいずれか:<ul><li>現在の raw UID2 が過去 90 日以内にローテーションされた場合: 以前の raw UID2。</li><li>それ以外の場合: `null`。</li></ul> |
| `r` | number | Unix タイムスタンプ(ミリ秒単位)で、raw UID2 がリフレッシュされる可能性のある時刻を示します。このタイムスタンプまで、raw UID2 は有効であることが保証されています。 |

マッピングできなかった入力値に対しては、マッピングされたオブジェクトに以下の表に示すプロパティが含まれます。
Expand Down Expand Up @@ -213,7 +213,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ

以下の表は、バージョン間の主な違いを示しています。

| Feature | V2 Implementation | V3 Implementation |
| Feature | v2 Implementation | v3 Implementation |
| :--- | :--- | :--- |
| 必要なエンドポイント | `/v2/identity/map` + `/v2/identity/buckets` | `/v3/identity/map` のみ |
| リクエストごとのアイデンティティタイプ | 単一のアイデンティティタイプのみ | 複数のアイデンティティタイプ |
Expand All @@ -225,7 +225,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ
以前のバージョンからバージョン 3 へのアップグレードは、以下の手順に従ってください。

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

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

以下の例に従って、レスポンスの解析ロジックを更新してください。

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

V3 Response Parsing:
v3 Response Parsing:
```python
# v3: Process array-indexed responses
for index, item in enumerate(response['body']['email']):
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@ A raw UID2 for a specific user changes roughly once per year. The latest version

For implementations that reference earlier versions of this endpoint (see [POST&nbsp;/identity/map v2](../endpoints/post-identity-map-v2.md)):

Even though each <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> is updated roughly once a year, individual bucket updates are spread over the year. This means that about 1/365th of all buckets are rotated daily. If fidelity is critical, consider calling the [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) endpoint more frequently; for example, hourly.
Even though each <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> is updated roughly once a year, individual bucket updates are spread over the year. This means that about 1/365th of all buckets are rotated daily. If fidelity is critical, consider calling the [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) endpoint more frequently: for example, hourly.

#### How should I generate the SHA-256 of DII for mapping?
マッピング用の DII の SHA-256 はどのように生成すればよいですか?
Expand Down Expand Up @@ -261,7 +261,7 @@ Even though each <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucke
#### How do I know when to refresh the UID2 due to salt bucket rotation?
ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには?

UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用される <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> が含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎となる DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。
UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用される <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> が含まれます。ソルトバケットは持続し、raw UID2 の生成に使用された基礎となる DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。

:::note
ローテーションがいつ行われるかは、いかなる約束もいたしません。可能な限り最新の状態を保つため、1 時間に 1 回のチェックを推奨します。
Expand All @@ -284,8 +284,9 @@ demand-side platform (DSP) に関するよくある質問を紹介します。
- [復号キーはどこで入手できますか?](#where-do-i-get-the-decryption-keys)
- [メモリ上に存在する復号鍵の数は?](#how-many-decryption-keys-may-be-present-in-memory-at-any-point)
- [マップされた raw UID2 を更新するタイミングを知るには?](#how-do-i-know-when-to-refresh-mapped-raw-uid2s)
- [raw UID2 がローテーションしたか、またローテーション時期を確認するには?](#how-do-i-know-ifwhen-the-raw-uid2-has-rotated)
- [DSP はレイテンシーを気にすべきでしょうか?](#should-the-dsp-be-concerned-with-latency)
- [UID2 で DSP はどのように適切なフリクエンシーキャッピング周波数キャッピングを維持すべきでしょうか?](#how-should-the-dsp-maintain-proper-frequency-capping-with-uid2)
- [UID2 で DSP はどのように適切なフリクエンシーキャッピングを維持すべきでしょうか?](#how-should-the-dsp-maintain-proper-frequency-capping-with-uid2)
- [ユーザーのオプトアウトトラフィックはすべて DSP に送られますか?](#will-all-user-opt-out-traffic-be-sent-to-the-dsp)
- [DSP は、すでに保存している UID2 についてのみオプトアウトシグナルを処理することを期待されているのか?](#is-the-dsp-expected-to-handle-opt-out-signals-only-for-the-uid2s-that-they-already-store)
- [DSP はオプトアウトリストをどれくらいの期間保管すべきですか?](#how-long-should-the-dsp-keep-the-opt-out-list)
Expand Down Expand Up @@ -313,7 +314,7 @@ Server-Side SDK のいずれか([SDK](../sdks/summary-sdks.md) を参照) を使
#### How do I know when to refresh mapped raw UID2s?
マップされた raw UID2 を更新するタイミングを知るには?

[Advertisers and Data Providers section](#how-do-i-know-when-to-refresh-a-raw-uid2) を参照して下さい。
See [How do I know when to refresh a raw UID2?](#how-do-i-know-when-to-refresh-a-raw-uid2) in the FAQs for Advertisers and Data Providers.

#### How do I know if/when the raw UID2 has rotated?
raw UID2 がローテーションしたか、またローテーション時期を確認するには?
Expand All @@ -326,7 +327,7 @@ DSP はレイテンシーを気にすべきでしょうか?
UID2 Service は、入札プロセスに遅延を生じさせることはありません。発生した遅延は、UID2 Service ではなく、ネットワークに起因すると考えられます

#### How should the DSP maintain proper frequency capping with UID2?
UID2 で DSP はどのように適切なフリクエンシーキャッピング周波数キャッピングを維持すべきでしょうか
UID2 で DSP はどのように適切なフリクエンシーキャッピングを維持すべきでしょうか

UID2 は、クッキーと同じように古くなる可能性があります。したがって、DSP は、クッキーまたは Device ID ベースのフリークエンシーキャッピングに現在使用されているものと同じインフラを UID2 に適応させることができます。詳細は [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) を参照してください。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,5 +26,5 @@ UID2 エコシステムには、特定のアクティビティを完了するた
| :--- | :--- | :--- |
| Generator | Publishers | Permission to call the [POST&nbsp;/token/generate](../endpoints/post-token-generate.md), [POST&nbsp;/token/validate](../endpoints/post-token-validate.md), and [POST&nbsp;/token/refresh](../endpoints/post-token-refresh.md) の各エンドポイントを呼び出して、<Link href="../ref-info/glossary-uid#gl-dii">DII</Link> から UID2 Token を生成/リフレッシュする権限:<ul><li>Prebid インテグレーション</li><li>The SDK for JavaScript</li><li>UID2 Token の取得と管理のために、該当する API エンドポイントを直接呼び出すインテグレーション</li></ul> |
| Bidder | DSPs | パブリッシャーからの<Link href="../ref-info/glossary-uid#gl-bidstream">ビッドストリーム</Link>から送られてくる UID2 Token を、入札目的で raw UID2 に復号化する権限。 |
| Sharer | UID2 sharing に参加するすべての参加者タイプ。詳細は [UID2 Sharing: Overview](../sharing/sharing-overview.md) を参照してください。 | 以下両方の権限:<ul><li>UID2 SDK または Snowflake を使用して、raw UID2 を UID2 Token に暗号化し、許可された別の共有参加者と共有します。</li><li>他の許可された共有参加者から受け取った UID2 Token を raw UID2 に復号します。</li></ul> |
| Mapper | Advertisers<br/>Data Providers | 複数のメールアドレス、電話番号、またはそのハッシュを、raw UID2、以前の raw UID2、および リフレッシュタイムスタンプにマッピングするために、以下のエンドポイントを呼び出すパーミッション:<ul><li>[POST&nbsp;/identity/map](../endpoints/post-identity-map.md) (最新バージョン)</li><li>以前の v2 identity mapping エンドポイント: [POST&nbsp;/identity/map (v2)](../endpoints/post-identity-map-v2.md) および [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md).</li></ul> |
| Sharer | UID2 sharing に参加するすべての参加者タイプ。<br/>詳細は [UID2 Sharing: Overview](../sharing/sharing-overview.md) を参照してください。 | 以下両方の権限:<ul><li>UID2 SDK または Snowflake を使用して、raw UID2 を UID2 Token に暗号化し、許可された別の共有参加者と共有します。</li><li>他の許可された共有参加者から受け取った UID2 Token を raw UID2 に復号します。</li></ul> |
| Mapper | Advertisers<br/>Data Providers | 複数のメールアドレス、電話番号、またはそのハッシュを、raw UID2、以前の raw UID2、および リフレッシュタイムスタンプにマッピングするために、以下のエンドポイントを呼び出すパーミッション:<ul><li>[POST&nbsp;/identity/map](../endpoints/post-identity-map.md) (最新バージョン)</li><li>以前の v2 identity mapping エンドポイント: [POST&nbsp;/identity/map (v2)](../endpoints/post-identity-map-v2.md) および [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md)</li></ul> |
Original file line number Diff line number Diff line change
Expand Up @@ -189,11 +189,11 @@ raw UID2 は特定の時点でのユーザーの識別子です。特定のユ

ソルトバケットのローテーションを監視する手順は、以下のいずれかを参照してください:

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

- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake-previous#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s).
- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake-previous#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s)

- 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).
- 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)

<!-- GWH_Note 8/4/25 I took the .md out of the Snowflake link line 194 because Docu would not build it correctly... broken link in output. Do not know why, though. Same thing on 2 links -->

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -327,6 +327,8 @@ UID2Manager.shared.automaticRefreshEnabled = false

:::important
UID2 Prebid Mobile SDK インテグレーションは、UID2 SDK for Android version 1.6.0 または UID2 SDK for iOS version 1.7.0 が必要です。

Prebid Mobile SDK v3 を使用している場合は、UID2 SDK for Android または iOS のバージョン 2.0.0 が必要です。
:::

<PrebidMobileSDK />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -738,6 +738,8 @@ If the response status indicates that the DII has been opted out of UID2, you mi

:::important
UID2 Prebid Mobile SDK インテグレーションは、UID2 SDK for Android version 1.6.0 または UID2 SDK for iOS version 1.7.0 が必要です。

Prebid Mobile SDK v3 を使用している場合は、UID2 SDK for Android または iOS のバージョン 2.0.0 が必要です。
:::

<PrebidMobileSDK />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,6 @@ UID2 Share へのアクセスを要求するには、次の手順を実行しま

リクエストを受け取った後、UID2 Administrator が適切なアクセス方法をご連絡します。Snowflake でのデータリクエストの管理についての詳細は [Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html) を参照してください。


## Shared Objects

選択した UID2 ソリューションに関係なく、以下の関数を使って、DII を UID2 にマッピングできます:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Snowflake Integration Guide (Pre-July 2025)
sidebar_label: Snowflake (previous version)
pagination_label: Snowflake Integration
description: UID2 Share in Snowflakeを通じたUID2とのインテグレーションに関する情報
description: UID2 Share in Snowflake (旧バージョン) による UID2 とのインテグレーションに関する情報
hide_table_of_contents: false
sidebar_position: 04
displayed_sidebar: docs
Expand Down Expand Up @@ -80,7 +80,6 @@ UID2 Share へのアクセスは、[Snowflake Data Marketplace](https://www.snow

- [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution)


:::important
データをリクエストするには、Snowflakeアカウントで `ACCOUNTADMIN` ロールまたは `CREATE DATABASE` および `IMPORT SHARE` 権限を持つ別のロールを使用する必要があります。
:::
Expand Down
Loading