Merge branch 'main' into gwh-APIDOCS-2486-sso-doc

Author: genwhittTTD

docs/guides/integration-mobile-client-server.md

@@ -242,7 +242,7 @@ If the `getAdvertisingToken()` method call returns `null`, there was no identity
     - **Android Java**: `UID2Manager.getInstance().getCurrentIdentityStatus()` 
     - **Android Kotlin**: `UID2Manager.getInstance().currentIdentityStatus()` 
     - **iOS**: `UID2Manager.shared.identityStatus`
-- You could enable logging to get more information: see [Enable Logging](#enable-logging).
+- You could enable logging (set `isLoggingEnabled` to `true`) to get more information: see [Enable Logging](#enable-logging).
 - The advertising token inside the UID2 identity has expired, and the refresh token has also expired, so the SDK cannot refresh the token.
 
 If there is no identity, follow the instructions in [Implement Server-Side Token Generation](#implement-server-side-token-generation) again, generate a new identity, and pass the result into your mobile app's UID2Manager again.

docs/guides/integration-mobile-client-side.md

@@ -594,7 +594,7 @@ Some possible reasons for this, and some things you could do to troubleshoot, ar
     - **iOS**: `UID2Manager.shared.identityStatus`
 
     It's possible that the DII has been opted out of UID2: for details, see [When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk).
-- You could enable logging to get more information: see [Enable Logging](#enable-logging).
+- You could enable logging (set `isLoggingEnabled` to `true`) to get more information: see [Enable Logging](#enable-logging).
 - The advertising token inside the UID2 identity has expired, and the refresh token has also expired, so the SDK cannot refresh the token.
 
 If there is no identity, you'll need to call the `generateIdentity` method again: see [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk).

docs/guides/integration-prebid-client-server.md

@@ -2,7 +2,7 @@
 title: UID2 Client-Server Integration Guide for Prebid.js
 sidebar_label: Client-Server Integration for Prebid.js
 pagination_label: UID2 Client-Server Integration for Prebid.js
-description: Information about setting up a server-side Prebid.js integration.
+description: Information about setting up a client-server Prebid.js integration.
 hide_table_of_contents: false
 sidebar_position: 04
 ---

docs/guides/operator-guide-aws-marketplace.md

@@ -350,23 +350,6 @@ The following table includes some additional commands that might help you manage
 | Runs one iteration of `logrotate` manually, without changing the scheduled interval. | `sudo logrotate -f /etc/logrotate.conf --force` |
 | Reloads `syslog-ng`. | `sudo /usr/sbin/syslog-ng-ctl reload` |
 
-## UID2 Operator Error Codes
-
-The following table lists errors that might occur during a Private Operator's startup sequence.
-
-:::note
-Error codes for Private Operator startup issues apply only to versions released in Q2 2024 and later.
-:::
-
-| Error Code | Issue | Steps to Resolve |
-| :--- | :--- | :--- |
-| E01 | MissingInstanceProfile |  Attach an IAM instance profile to the EC2 instance with the required permissions. The UID2 Operator needs these permissions to access configurations from AWS Secrets Manager. |
-| E02 | ConfigNotFound | Make sure that the secret referenced by the Private Operator exists in AWS Secrets Manager in the same region as the operator, and that the IAM instance profile has permission to access the secret. If needed, you can check the logs for the specific secret name and region. |
-| E03 | MissingConfig | Required attributes are missing in the configuration. Refer to the logs for details and update the missing attributes in Secrets Manager. |
-| E04 | InvalidConfigValue | A configuration value is invalid. Verify that the configuration values in the AWS Secrets Manager align with the required format and environment. Note `debug = true` is allowed only in the `integ` environment. Check the logs for more details. |
-| E05 | InvalidOperatorKey | Ensure the operator key is correct for the environment and matches the one provided to you. |
-| E06 | UID2ServicesUnreachable | Allow UID2 core and opt-out service IP addresses in the egress firewall. For IP addresses and DNS details, refer to the logs.  |
-
 ## Technical Support
 
 If you have trouble subscribing to the product, or deploying, [contact us](mailto:[email protected]).

i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md

@@ -24,10 +24,10 @@ Used by: このエンドポイントは、主にパブリッシャーが使用
 
 ## Request Format 
 
-認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。
-
 `POST '{environment}/v2/token/generate'`
 
+認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。
+
 このエンドポイントリクエストについて知っておくべきことは、以下のとおりです:
 - サービスにアクセスする際に使用する <Link href="../ref-info/glossary-uid#gl-api-key">API key</Link> を秘密にするため、 UID2 Token は認証後に Server-Side でのみ生成する必要があります。
 - すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は [リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。

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

@@ -121,24 +121,28 @@ Refresh Token のワークフローをテストするにはどうすればよい
 
 `[email protected]` のメールアドレスまたは `+00000000002` の電話番号を使用して、トークンリフレッシュのワークフローをテストすることができます。どちらかのパラメータ値をリクエストに使用すると、常に `refresh_token` を含む identity レスポンスが生成され、ログアウトレスポンスが返されます。
 
+:::tip
+メールアドレスの正規化、ハッシュ化、Base64　エンコードされたハッシュ値、または、電話番号のハッシュ化、Base64 エンコードされたハッシュ値を取得するには、ハッシングツールを使用できます。詳細は、[UID2 Hashing Tool](gs-normalization-encoding.md#uid2-hashing-tool) を参照してください。
+:::
+
 SDKを使うかどうかで手順は少し異なります。
 
 ##### With SDK:
 
 1. DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して [POST /token/generate](../endpoints/post-token-generate.md) リクエストを送信します:
-   - `email` の値として `[email protected]` を指定します。
-   - ``[email protected]` のハッシュを `email_hash` 値として指定します。
-   - `phone` の値として `+00000000002` を指定します。
-   - `phone_hash` 値として `+00000000002` のハッシュを指定します。
+   - `email` の値: `[email protected]`.
+   - `email_hash` の値: `[email protected]` をハッシュ化し Base64 エンコードした値は `NaNI8RU0bL1Jpp1jJLC5aJO/lchc6gGhgXQIAwJ7cV4=` です。
+   - `phone` の値: `+00000000002`.
+   - `phone_hash` `+00000000002` をハッシュ化し Base64 エンコードした値は `0VoxsIuk88qt7TnZaTC//C9Vur3pR1zBMIr1cJe7xjE=` です。
 2. SDK の [background auto-refresh](../sdks/sdk-ref-javascript.md#background-token-auto-refresh) が Advertising Token のリフレッシュを試み(これには数時間かかることがあります)、リフレッシュの試みが `OPTOUT` ステータスで失敗するのを観察するまで待ちます。この時点で SDK はファーストパーティクッキーもクリアします。
 
 ##### Without SDK:
 
 1. DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して [POST /token/generate](../endpoints/post-token-generate.md) リクエストを送信します:
-   - `email` の値として `[email protected]` を指定します。
-   - `[email protected]` のハッシュを `email_hash` 値として指定します。
-   - `phone` の値として `+00000000002` を指定します。
-   - `phone_hash` 値として `+00000000002` のハッシュを指定します。
+   - `email` の値: `[email protected]`.
+   - `email_hash` の値: `[email protected]` をハッシュ化し Base64 エンコードした値は `NaNI8RU0bL1Jpp1jJLC5aJO/lchc6gGhgXQIAwJ7cV4=` です。
+   - `phone` の値: `+00000000002`.
+   - `phone_hash` `+00000000002` をハッシュ化し Base64 エンコードした値は `0VoxsIuk88qt7TnZaTC//C9Vur3pR1zBMIr1cJe7xjE=` です。
 
 2. 返された `refresh_token` を次のステップで使用するために保存します。
 

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

@@ -13,7 +13,7 @@ import Link from '@docusaurus/Link';
 
 ## Introduction
 
-メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。情報を正規化する必要があろうがなかろうが、ハッシュ化する必要があろうがなかろうが、手順には正確に従ってください。そうすることで、作成した UID2 の値を、同じユーザーによる他のオンライン行動の事例と安全かつ匿名で照合できるようになります。
+メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。メールアドレスを正規化するか否か、メールアドレスや電話番号をハッシュ化するか否かに関わらず、手順を正確に実行してください。そうすることで、作成した UID2 値を、同じユーザーによる他のオンライン行動と安全かつ匿名で照合できるようになります。
 
 :::important
 - Raw UID2 とそれに関連する UID2 Token は、大文字と小文字を区別します。UID2 を扱う際には、大文字小文字を変えずにすべての ID とトークンを渡すことが重要です。ID が不一致の場合、ID の解析やトークンの復号化でエラーが発生する可能性があります。
@@ -72,7 +72,7 @@ Base64 エンコードを適用する場合、ハッシュの Raw バイトを
 ## Phone Number Normalization
 
 :::important
-ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。
+UID2 Operator Service にリクエストを送信する前に、電話番号を正規化する **必要** があります。ハッシュ化とエンコードを適用するかどうかに関わらず、電話番号を正規化する必要があります。
 :::
 
 ここでは、電話番号の正規化ルールについて説明します:

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

@@ -9,7 +9,7 @@ import Link from '@docusaurus/Link';
 
 # UID2 Sharing
 
-UID2 において共有 (Sharing) とは、UID2 参加者間で [UID2](../ref-info/glossary-uid.md#gl-raw-uid2) を直接または [UID2 Token](../ref-info/glossary-uid.md#gl-raw-uid2) に暗号化して配布するプロセスです。
+UID2 において共有 (Sharing) とは、UID2 参加者間で [UID2](../ref-info/glossary-uid.md#gl-raw-uid2) を直接または [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) に暗号化して配布するプロセスです。
 
 Raw UID2 または UID2 Token が他の参加者と共有される場合はすべて、共有の定義に該当します。すべての共有参加者は、以下のセクション [Legal Requirements for UID2 Sharing](#legal-requirements-for-uid2-sharing) で指定された法的要件を満たす必要があります。
 

i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md

@@ -12,7 +12,7 @@ import Link from '@docusaurus/Link';
 
 このガイドは、<Link href="../ref-info/glossary-uid#gl-bidstream">ビッドストリーム</Link>で UID2 の取引を行う DSP を対象としています。
 
-DSP はビッドリクエストで UID2 Token を受け取り、この機能をサポートする Server-Side SDK のいずれかを使用して UID2 Token を復号化し、入札に使用できる raw UID2 を取得します。
+DSP はビッドリクエストで UID2 Token を受け取り、この機能をサポートする Server-Side SDK のいずれかを使用して [UID2 tokens](../ref-info/glossary-uid.md#gl-uid2-token) を復号化し、入札に使用できる [raw UID2s](../ref-info/glossary-uid.md#gl-raw-uid2) を取得します。
 
 利用可能な Server-Side SDK の概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。
 

i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md

@@ -1,6 +1,6 @@
 ---
 title: Client-Server Integration Guide for JavaScript
-sidebar_label: Server-Side Integration for JavaScript
+sidebar_label: Client-Server Integration for JavaScript
 pagination_label: Client-Server Integration Guide for JavaScript
 description: SDK for JavaScript を使用し、Server-Side でトークンを生成してパブリッシャーの Web ページに渡す必要がある標準的な Web インテグレーションシナリオをカバーするパブリッシャー向けの情報。
 hide_table_of_contents: false
@@ -22,7 +22,7 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re
 
 ## Sample Implementation
 
-アプリケーションの例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
+実装例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
 - コードとドキュメント: [UID2 SDK Secure Signals Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
 - ランニングサイト: [Client-Server UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/)