Merge branch 'main' into gwh-APIDOCS-2943-uid2-snowflake-improvements

Author: genwhittTTD

docs/endpoints/summary-endpoints.md

@@ -12,6 +12,18 @@ import Link from '@docusaurus/Link';
 
 All UID2 endpoints require a client secret for encrypting API requests (except [POST /token/refresh](post-token-refresh.md) requests) and decrypting responses. For details, and code examples in different programming languages, see [Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md).
 
+## UID2 Endpoints by Audience
+
+The following table shows the UID2 endpoints, with the audience for each. For details, click through to the applicable sections.
+
+| Endpoint | Audience | Details |
+| :--- | :--- | :--- |
+| [POST /token/generate](post-token-generate.md) | Publishers | [UID2 Tokens](#uid2-tokens) |
+| [POST /token/validate](post-token-validate.md) | Publishers | [UID2 Tokens](#uid2-tokens) |
+| [POST /token/refresh](post-token-refresh.md) | Publishers | [UID2 Tokens](#uid2-tokens) |
+| [POST /identity/map](post-identity-map.md) | Advertisers, data providers | [Identity Map](#identity-map) |
+| [POST /optout/status](post-optout-status.md)  | Advertisers, data providers, DSPs, sharers | [Opt-Out Status](#opt-out-status)|
+
 ## UID2 Tokens
 
 The following endpoints are for retrieving and managing UID2 tokens (identity tokens, advertising tokens), and are used mainly by publishers.

docs/sdks/summary-sdks.md

@@ -18,15 +18,108 @@ Review the SDK functionality to determine which SDK or SDKs you want to use, the
 
 The following table summarizes the functionality available with each SDK.
 
-| UID2 SDK for... | Client-Side or Server-Side | Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s* | Monitor Rotated Salt Buckets** |
+<!-- | UID2 SDK for... | Client-Side or Server-Side | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s&ast; | Monitor Rotated Salt Buckets&ast;&ast; | Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 |
 | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
-|JavaScript | Client | &#8212; | &#8212; | &#9989; | &#9989; | &#8212; | &#8212; |
-|Java | Server | &#9989; | &#9989; | &#9989; | &#9989; | &#9989; | &#8212; |
+|JavaScript | Client | &#9989; | &#9989; | &#8212; | &#8212; | &#8212; | &#8212; |
+|Java | Server | &#9989; | &#9989; | &#9989; | &#8212; | &#9989; | &#9989; |
 |Python | Server | &#9989; | &#9989; | &#9989; | &#9989; | &#9989; | &#9989; |
-|C# / .NET | Server | &#9989; | &#9989; | &#8212; | &#8212; | &#8212; | &#8212; |
-|C++ | Server | &#9989; | &#9989; | &#8212; | &#8212; | &#8212; | &#8212; |
-|Android | Client&nbsp;(Mobile) | &#8212; | &#8212; | &#9989; | &#9989; | &#8212; | &#8212; |
-|iOS | Client (Mobile) | &#8212; | &#8212; | &#9989;| &#9989; |&#8212; | &#8212; |
+|C# / .NET | Server | &#8212; | &#8212; | &#8212; | &#8212; | &#9989; | &#9989; |
+|C++ | Server | &#8212; | &#8212; | &#8212; | &#8212; | &#9989; | &#9989; |
+|Android | Client&nbsp;(Mobile) | &#9989; | &#9989; | &#8212; | &#8212; | &#8212; | &#8212; |
+|iOS | Client (Mobile) | &#9989;| &#9989; |&#8212; | &#8212; | &#8212; | &#8212; | -->
+
+<table>
+  <thead>
+    <tr>
+      <th colspan="2">Audience&nbsp;&nbsp;&gt;&nbsp;&gt;&nbsp;&gt;</th>
+      <th colspan="2">Publisher</th>
+      <th colspan="2">Advertiser&nbsp;/ Data Provider</th>
+      <th colspan="2">DSP</th>
+    </tr>
+    <tr>
+      <th> SDK for...</th>
+      <th>Client-Side or Server-Side</th>
+      <th>Generate UID2 Token from DII</th>
+      <th>Refresh UID2 Token</th>
+      <th>Map DII to Raw UID2s&ast;</th>
+      <th>Monitor Rotated Salt Buckets&ast;&ast;</th>
+      <th>Encrypt Raw UID2 to UID2 Token for Sharing</th>
+      <th>Decrypt UID2 Token to Raw UID2</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>JavaScript</td>
+      <td>Client</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+    </tr>
+    <tr>
+      <td>Java</td>
+      <td>Server</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#8212;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+    </tr>
+    <tr>
+      <td>Python</td>
+      <td>Server</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+    </tr>
+    <tr>
+      <td>C# / .NET</td>
+      <td>Server</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+    </tr>
+    <tr>
+      <td>C++</td>
+      <td>Server</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+    </tr>
+    <tr>
+      <td>Android</td>
+      <td>Client&nbsp;(Mobile)</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+    </tr>
+    <tr>
+      <td>iOS</td>
+      <td>Client&nbsp;(Mobile)</td>
+      <td>&#9989;</td>
+      <td>&#9989;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+      <td>&#8212;</td>
+    </tr>
+  </tbody>
+</table>
 
 &ast; Advertisers and Data Providers who need to generate raw UID2s from DII can also do this via Snowflake (see [Snowflake Integration Guide](../guides/integration-snowflake.md)) or by using the [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) endpoint.
 

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

@@ -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

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

@@ -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
@@ -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 は有効であることが保証されています。 |
 
 マッピングできなかった入力値に対しては、マッピングされたオブジェクトに以下の表に示すプロパティが含まれます。
@@ -213,7 +213,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ
 
 以下の表は、バージョン間の主な違いを示しています。
 
-| Feature | V2 Implementation | V3 Implementation |
+| Feature | v2 Implementation | v3 Implementation |
 | :--- | :--- | :--- |
 | 必要なエンドポイント | `/v2/identity/map` + `/v2/identity/buckets` | `/v3/identity/map` のみ |
 | リクエストごとのアイデンティティタイプ | 単一のアイデンティティタイプのみ | 複数のアイデンティティタイプ |
@@ -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
@@ -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']:
@@ -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']):

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md

@@ -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 /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 はどのように生成すればよいですか？
@@ -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 回のチェックを推奨します。
@@ -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)
@@ -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 がローテーションしたか、またローテーション時期を確認するには？
@@ -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) を参照してください。
 

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md

@@ -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> |