From e4449962eb740658d450ff79130a7dcc11c4006f Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Wed, 11 Dec 2024 14:39:48 +0900 Subject: [PATCH 01/20] LiveRamp integration tips. (new doc page) --- .../current/guides/integration-liveramp-tips.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md index c4e7723f4..21600aabc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md @@ -2,7 +2,7 @@ title: LiveRamp Integration Tips sidebar_label: LiveRamp Integration Tips pagination_label: LiveRamp Integration Tips -description: Tips for integrating with UID2 with LiveRamp. +description: LiveRamp と UID2 をインテグレーションするためのヒント。 hide_table_of_contents: false sidebar_position: 04 --- @@ -11,9 +11,9 @@ import Link from '@docusaurus/Link'; # LiveRamp Integration Tips -Publishers already using LiveRamp Authenticated Traffic Solution (ATS) can leverage their integration to generate a UID2 token to be passed in the bid request. +LiveRamp Authenticated Traffic Solution (ATS) をすでに使用しているパブリッシャーは、そのインテグレーションを活用して、ビッドリクエストに渡す UID2 Token を生成できます。 -If you want to generate UID2 tokens using LiveRamp ATS, reach out to your LiveRamp representative and also make sure you've addressed the following integration points: +LiveRamp ATS を使用して、UID2 Token を生成するには、LiveRamp の担当者に連絡し、以下のインテグレーションポイントを確認してください: - [Enable RideAlong](#enable-ridealong) - [Implement the Correct Hashing Methodology](#implement-the-correct-hashing-methodology) @@ -21,20 +21,21 @@ If you want to generate UID2 tokens using LiveRamp ATS, reach out to your LiveRa ## Enable RideAlong -In your LiveRamp configuration, you must make sure that RideAlong is enabled. RideAlong is a LiveRamp feature that enables other identity solutions, such as UID2, to embed their identifiers in ATS envelopes. If RideAlong is not enabled, UID2 tokens will not be appended to the envelope. +LiveRamp の設定では、RideAlong が有効になっていることを確認する必要があります。RideAlong は、UID2 などの他の ID ソリューションが ATS エンベロープに識別子を埋め込むことを可能にする LiveRamp の機能です。RideAlong が有効になっていない場合、UID2 Token はエンベロープに追加されません。 -To complete this step, contact your LiveRamp representative. +この手順を完了するには、LiveRamp の担当者に連絡してください。 ## Implement the Correct Hashing Methodology -The hashing methodology used by the UID2 service is very specific. If you use a different hashing algorithm, or miss any of the steps, your UID2s will not be correctly generated. +UID2 Service で使用されているハッシュ化の方法はとても特殊です。異なるハッシュ化アルゴリズムを使用したり、ステップを逃したりすると、UID2 が正しく生成されません。 -For information about the required hashing methodology, see [Normalization and Encoding](../getting-started/gs-normalization-encoding.md). +必要なハッシュ化方法については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 ## Set Envelope Refresh to 1800 Seconds When enabling `ATS.js` within `Prebid.js`, make sure that `storage.refreshInSeconds` is set to **1800 seconds** (30 minutes). +`Prebid.js` 内で `ATS.js` を有効にする場合は、`storage.refreshInSeconds` を **1800 秒** (30 分) に設定してください。 ## Troubleshooting Assistance -For more information, or LiveRamp troubleshooting assistance, check the [LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) for help resources or contact your LiveRamp representative. +詳細情報や LiveRamp のトラブルシューティング支援については、[LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) を参照してください。ヘルプリソースを確認するか、LiveRamp の担当者に連絡してください。 From 5b06904b0030dce0df12a2ef4549db11c77a32e1 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 13:08:25 +0900 Subject: [PATCH 02/20] Copy updates re recommended period for token refresh. --- .../current/ref-info/ref-tokens.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md index f0f8abf78..be97e0536 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md @@ -47,9 +47,18 @@ Refresh Token に関する主なポイントは次のとおりです: ### Recommended Token Refresh Frequency -推奨されるリフレッシュ間隔は、1 時間です。 +現在、推奨されているリフレッシュ間隔は 1 時間です。1 時間ごとの間隔にすることで、トークンが期限切れになるのを避け、ビッドストリームに送信できるようになります。また、新しいトークンが生成される前にユーザーのオプトアウトが確認されるため、ユーザーのオプトアウト設定が迅速に反映されるようになります。 -リフレッシュのタイミングを決定するには、[POST /token/generate](../endpoints/post-token-generate.md) エンドポイントのレスポンス ([Successful Response](../endpoints/post-token-generate.md#successful-response)) または [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントのレスポンス ([Successful Response With Tokens](../endpoints/post-token-refresh.md#successful-response-with-tokens) を参照してください) の `refresh_from` フィールドのタイムスタンプを使用できます。このフィールドの値は、ミリ秒単位で表された Unix 時間のタイムスタンプです。 +リフレッシュのタイミングを決定するには、以下の UID2 API エンドポイントのいずれかを呼び出した際のレスポンスの `refresh_from` フィールドのタイムスタンプを使用できます: + +- [POST /token/generate](../endpoints/post-token-generate.md) endpoint (see [Successful Response](../endpoints/post-token-generate.md#successful-response)) +- [POST /token/refresh](../endpoints/post-token-refresh.md) endpoint (see [Successful Response With Tokens](../endpoints/post-token-refresh.md#successful-response-with-tokens)) + +`refresh_from` フィールドは Unix タイムスタンプで、トークンが生成された時間から 1 時間後の値をミリ秒で表します。 + +:::tip +推奨されるリフレッシュ間隔は将来変更される可能性があります。固定値を使用する代わりに、`refresh_from` 値に基づいて計算することが最善です。 +::: ### Managing Token Refresh with an SDK From e7292935ae68a826aa0b64567098762129f20fc5 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 13:19:43 +0900 Subject: [PATCH 03/20] Minor edits to mobile docs. (mods to 2 files) --- .../current/sdks/sdk-ref-ios.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md index 84a2af087..1e2c51771 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md @@ -58,6 +58,8 @@ SDKが提供する特定の機能を使用する許可が与えられ、その - Xcode バージョン: 15.0+ - iOS 最低対象バージョン: 13.0+ + - すべての機能を使用するには: 13.0+ + - 一部の機能を使用するには: 12.0+。SDK を統インテグレーションしたアプリはすべてのデバイスにインストールできますが、iOS バージョンが 13.0 未満のデバイスでは、クライアント側で UID2 Token を生成または取得することはできません。 - tvOS 最低対象バージョン: 13.0+ - Swift バージョン: 5.0+ @@ -189,5 +191,4 @@ Identity 変数は、SDK によって管理されている現在の UID2Identity #### identityStatus -identityStatus変数は、SDKが管理している現在のUID2 Identityのステータスを格納し、返します。 - +identityStatus変数は、SDKが管理している現在のUID2 Identityのステータスを格納し、返します。 \ No newline at end of file From 92f073241acafab2c795eab3ae85fbc287665295 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 13:36:14 +0900 Subject: [PATCH 04/20] Minor edits. (mods to 16 files) --- .../current/endpoints/post-token-generate.md | 2 +- .../getting-started/gs-normalization-encoding.md | 2 +- .../current/guides/integration-mobile-overview.md | 2 +- .../current/guides/summary-guides.md | 10 +++++----- .../current/ref-info/glossary-uid.md | 4 +--- 5 files changed, 9 insertions(+), 11 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md index 260601213..b79957192 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md @@ -53,7 +53,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 ### Request Examples :::important -サービスにアクセスするために使用される API Key を確実に秘密にするために、API Key を使用する必要のない [POST /token/refresh](post-token-refresh.md) と異なり、`POST /token/generate` エンドポイントを Server-Side から呼び出す必要があります。 +サービスへのアクセスに使用する API キーを秘密にしておくため、[POST /token/generate](post-token-generate.md) エンドポイントは、[POST /token/refresh](post-token-refresh.md) とは異なり、Server-Side から呼び出す必要があります。Client-Side でトークンを生成する場合は、[Client-Side Integration Options](../guides/integration-options-publisher-web.md#client-side-integration-options) (Web ベースの実装) または [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 ::: 以下は、各パラメータの暗号化されていない JSON リクエストボディの例で、このうちの 1 つはトークン生成リクエストに含める必要があります: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md index 6737080f6..6be4684e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md @@ -55,7 +55,7 @@ UID2 Operator Service< ## Email Address Hash Encoding -メールアドれづハッシュは、正規化されたメールアドレスの SHA-256 ハッシュを Base64 エンコードしたものです。メールアドレスはまず正規化され、次に SHA-256 ハッシュアルゴリズムを使ってハッシュ化され、その結果のハッシュ値のバイトが Base64 エンコーディングを使ってエンコードされます。Base64 エンコーディングはハッシュ値のバイトに適用されるのであって、16 進エンコーディングされた文字列表現には適用されないことに注意してください。 +メールアドレスハッシュは、正規化されたメールアドレスの SHA-256 ハッシュを Base64 エンコードしたものです。メールアドレスはまず正規化され、次に SHA-256 ハッシュアルゴリズムを使ってハッシュ化され、その結果のハッシュ値のバイトが Base64 エンコーディングを使ってエンコードされます。Base64 エンコーディングはハッシュ値のバイトに適用されるのであって、16 進エンコーディングされた文字列表現には適用されないことに注意してください。 | Type | Example | Comments and Usage | | :--- | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md index 4deb720ef..bcd781f67 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md @@ -98,7 +98,7 @@ UID2 Token をビッドストリームに送信する方法はいくつかあり すべてのオプションは、Client-Side または Server-Side インテグレーションをサポートしています。 | Implementation Option | Generate Token from DII | Refresh Token | Android/iOS? | Send Token to Bidstream | -| :--- | :--- | :--- | :--- | :--- | +| :--- | :--- | :--- | :--- | :--- | | UID2 SDK for Android | ✅ | ✅ | Android | * | | UID2 SDK for iOS | ✅| ✅ | iOS | * | | GMA Plugin for Android
(Requires UID2 SDK for Android) | — | — | Android | ✅** | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index 1ebe06f55..f5ebcd545 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -54,11 +54,11 @@ Web インテグレーションオプションの詳細は [Web Integration Over Android または iOS デバイスとインテグレーションするパブリッシャーは、以下のリソースを利用できます。 -| Integration Type| Documentation | Content Description | -| :--- | :--- | :--- | -| Android/iOS (Overview) | [Mobile Integration Overview for Android and iOS](integration-mobile-overview.md) | SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのオプションの概要です。 | -| Android/iOS, Client-Side Integration | [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | モバイルアプリ内のみの変更で UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けの統合ガイドです (Server-Side の変更はありません)。 | -| Android/iOS, Client-Server Integration | [Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) | UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです:
  1. UID2 Token を Server-Side で生成するには、PublicまたはPrivate Operatorを使用します。
  2. その結果、identities をモバイルアプリに渡し、ビッドストリームに渡します。
| +| Integration Guide | Content Description | +| :--- | :--- | +| [Mobile Integration Overview for Android and iOS](integration-mobile-overview.md) | SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのオプションの概要です。 | +| [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | モバイルアプリ内のみの変更で UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けの統合ガイドです (Server-Side の変更はありません)。 | +| [Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) | UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです:
  1. UID2 Token を Server-Side で生成するには、PublicまたはPrivate Operatorを使用します。
  2. その結果、identities をモバイルアプリに渡し、ビッドストリームに渡します。
| ### CTV Integrations diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md index ab1ef671b..005c1c50e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md @@ -386,12 +386,10 @@ import Link from '@docusaurus/Link';
Salt bucket
ソルトバケットは、Secret salt の値を長期間管理するために使用されます。各バケットには、約1年間有効な現在のソルト値が含まれており、新しい値にローテーションされる前に更新されます。バケットは互いに独立して更新できます。
-
ソルトバケットは、100万以上あり、各メールアドレスまたは電話番号は、特定のバケットに決定論的に割り当てられます。ただし、この割り当ては永続的ではなく、バケットの現在のシークレットソルトが新しい値にローテーションされると変更される可能性があります。
Salt bucket ID
ソルトバケット ID は、特定の ソルトバケット を識別する一意の文字列です。ソルトバケット ID を使用すると、最近ソルト値が更新されたソルトバケットを確認し、どのメールアドレスまたは電話番号が raw UID2 値を再生成する必要があるかを確認できます。
-
ソルトバケット ID の例については、`POST /identity/buckets` エンドポイントのレスポンスを参照してください: Decrypted JSON Response Format。
Salted hash
@@ -412,7 +410,7 @@ import Link from '@docusaurus/Link';
パブリッシャーサーバーサイドの統合に関するドキュメントの例は、Publisher Integration Guide, Server-Side です。
SHA-256
-
SHA-256 は、UID2 が使用する安全なハッシュアルゴリズムです。
+
SHA-256 (SHA256 とも呼ばれます) は、UID2 が使用する安全なハッシュアルゴリズムです。
SHA-256 は、米国国立標準技術研究所 (NIST) と国家安全保障局 (NSA) が SHA-1 の後継として開発した SHA-2 アルゴリズムファミリーの一部です。各アルゴリズムは出力のビット数によって名前が付けられており、SHA-256 は 256 ビットです。
詳細は https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf (specification) を参照してください。
From d6dc1d29d485df7a171330776d6ad54f32e05cf9 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 13:53:20 +0900 Subject: [PATCH 05/20] minor copy mods, mostly Prebid doc title change. (mods to 13 files) --- .../guides/integration-javascript-client-server.md | 2 +- .../guides/integration-prebid-mobile-summary.md | 4 ++-- .../current/guides/integration-prebid.md | 2 ++ .../current/guides/summary-guides.md | 14 +++++++------- 4 files changed, 12 insertions(+), 10 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md index e38f9f82c..0fbc33c96 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md @@ -121,7 +121,7 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー ``` :::info -返された Advertising Token をどのように SSP に渡すかを検討する必要があります。`Prebid.js`([UID2 Integration Overview for Prebid](integration-prebid.md) を参照) や Google Ad Manager Secure Signals([Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) を参照) を使用するなど、Client-Side で UID2 を実装する他のいくつかのアプローチでは、実装に、返された Advertising Token の受け渡しを管理する関数が含まれています。SDK for JavaScriptを使用している場合は、これを自分で管理する必要があります。 +返された Advertising Token をどのように SSP に渡すかを検討する必要があります。`Prebid.js`([UID2 Integration Overview for Prebid](integration-prebid.md) を参照してください) や Google Ad Manager Secure Signals([Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) を参照してください) を使用するなど、Client-Side で UID2 を実装する他のいくつかのアプローチでは、実装に、返された Advertising Token の受け渡しを管理する関数が含まれています。SDK for JavaScriptを使用している場合は、これを自分で管理する必要があります。 ::: :::tip diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md index baf85bcd5..a3d9e9d52 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md @@ -15,5 +15,5 @@ Prebid Mobile SDK Android モバイルデバイスでの UID2 インテグレー 詳細は以下のモバイルインテグレーションガイドのセクションを参照してください: -- [UID2 Client-Side Integration Guide for Mobile: Prebid Integration](../guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) -- [UID2 Client-Server Integration Guide for Mobile: Prebid Integration](../guides/integration-mobile-client-server#optional-uid2-prebid-mobile-sdk-integration) +- [UID2 Client-Side Integration Guide for Mobile: Prebid Integration](integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) +- [UID2 Client-Server Integration Guide for Mobile: Prebid Integration](integration-mobile-client-server#optional-uid2-prebid-mobile-sdk-integration) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md index b6d1cf3da..1ba764db3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md @@ -30,6 +30,8 @@ UID2 は、以下をサポートする Prebid.js module を提供しています UID2 は GDPR が適用される場所では使用しないように設計されています。このモジュールは渡された同意データをチェックし、`gdprApplies` フラグが `true` に設定されている場合は動作しません。 ::: + + ### Generating the UID2 Token DII へのアクセスに応じて、Prebid.js で使用する UID2 Token を生成する方法は次の表のように 2 種類あります 。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index f5ebcd545..941d15b5d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -41,7 +41,7 @@ Web インテグレーションオプションの詳細は [Web Integration Over | Integration Guide | Content Description | | :--- | :--- | -| [UID2 Integration Overview for Prebid](integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobie SDK から渡される UID2 Token を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | +| [UID2 Integration Overview for Prebid](integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobie SDK から渡される UID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | | [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md) | UID2とインテグレーションし、トークンの生成とトークンの自動更新を Prebid.js に管理させ、トークンを RTB ビッドストリームに渡したいパブリッシャー向けのインテグレーションガイドです。このガイドは、Client-Side で UID2 Token をリクエストしたいパブリッシャー向けのもので、最も簡単な実装方法です。 | | [UID2 Client-Server Integration Guide for Prebid.js](integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid から渡される ID トークンを生成したいパブリッシャー向けのインテグレーションガイドです。このガイドは、Private Operator を使用しているか、Server-Side でトークンを生成したいパブリッシャー向けです。 | | [UID2 Integration Overview for JavaScript](integration-javascript.md) | JavaScript SDK を使って UID2 とインテグレーションしたいパブリッシャー向けのオプションの概要です。 | @@ -58,7 +58,7 @@ Android または iOS デバイスとインテグレーションするパブリ | :--- | :--- | | [Mobile Integration Overview for Android and iOS](integration-mobile-overview.md) | SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのオプションの概要です。 | | [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | モバイルアプリ内のみの変更で UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けの統合ガイドです (Server-Side の変更はありません)。 | -| [Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) | UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです:
  1. UID2 Token を Server-Side で生成するには、PublicまたはPrivate Operatorを使用します。
  2. その結果、identities をモバイルアプリに渡し、ビッドストリームに渡します。
| +| [Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) | UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです:
  1. UID2 Token を Server-Side で生成するには、PublicまたはPrivate Operatorを使用します。
  2. その結果、identities をモバイルアプリに渡し、ビッドストリームに渡します。
| ### CTV Integrations @@ -66,7 +66,7 @@ CTV とインテグレーションするパブリッシャー向けには、以 | Integration Guide | Content Description | | :--- | :--- | -| [CTV Integration Guide](../guides/integration-ctv-guide.md) | CTV インテグレーションオプションの概要と、追加情報および手順へのリンク。 | +| [CTV Integration Guide](integration-ctv-guide.md) | CTV インテグレーションオプションの概要と、追加情報および手順へのリンク。 | ### Prebid Integrations @@ -74,8 +74,8 @@ CTV とインテグレーションするパブリッシャー向けには、以 | Integration Guide | Content Description | | :--- | :--- | -| [UID2 Integration Overview for Prebid](integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | -| [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md) | UID2とインテグレーションし、トークンの生成とトークンの自動更新を Prebid.js に管理させ、トークンを RTB ビッドストリームに渡したいパブリッシャー向けのインテグレーションガイドです。このガイドは、Client-Side で UID2 Token をリクエストしたいパブリッシャー向けのもので、最も簡単な実装方法です。 | +| [UID2 Integration Overview for Prebid](integration-prebid.md) | UID2 とインテグレーションし、Prebid.js または Prebid Mobile SDK が RTB ビッドストリームで発行する UID2 Token を生成したいパブリッシャー向けのオプションの概要です。 | +| [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md) | UID2 とインテグレーションし、トークンの生成とトークンの自動更新を Prebid.js に管理させ、トークンを RTB ビッドストリームに渡したいパブリッシャー向けのインテグレーションガイドです。このガイドは、Client-Side で UID2 Token をリクエストしたいパブリッシャー向けのもので、最も簡単な実装方法です。 | | [UID2 Client-Server Integration Guide for Prebid.js](integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid から渡される ID トークンを生成したいパブリッシャー向けのインテグレーションガイドです。このガイドは、Private Operator を使用しているパブリッシャー、または Server-Side でトークンを生成したいパブリッシャー向けです。 | | [UID2 Mobile Integration for Prebid.js](integration-prebid-mobile-summary.md) | モバイルデバイス上の Prebid.js と UID2 のインテグレーションに関する情報リソースのまとめです。 | @@ -108,8 +108,8 @@ DSP とインテグレーションする DSP は、以下のリソースを利 | Integration Guide | Content Description | | :--- | :--- | -| [DSP Integration Guide](../guides/dsp-guide.md) | この DSP 向けのインテグレーションガイドでは、入札およびユーザーオプトアウトの処理に関する UID2 の取り扱いについて説明しています。 | -| [DSP Direct Integration Instructions](../guides/integration-dsp-no-sdk.md) | SDK を使用せずにインテグレーションを希望する DSP 向けの手順です。 | +| [DSP Integration Guide](dsp-guide.md) | この DSP 向けのインテグレーションガイドでは、入札およびユーザーオプトアウトの処理に関する UID2 の取り扱いについて説明しています。 | +| [DSP Direct Integration Instructions](integration-dsp-no-sdk.md) | SDK を使用せずにインテグレーションを希望する DSP 向けの手順です。 | ## Private Operator Service Integrations From c0063b4e217eb1da25d349795c5fb12f4b94e3bb Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 14:00:48 +0900 Subject: [PATCH 06/20] participant switcher, audit trail, doc mods --- .../current/portal/sharing-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md index 225c3bce4..52e2de55a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # Sharing Permissions -Sharing permissions (共有権限) を設定することで、他の UID2 参加者と UID2 を共有できるようになります。 +共有権限を設定することで、他の UID2 共有参加者 と UID2 を共有できるようになります。 適切な共有関係を作成するのに役立つ多くのオプションがあります: From ac2e19b740fef6de26264c709883756fcc67f3c8 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 14:04:45 +0900 Subject: [PATCH 07/20] Announcement re LiveRamp doc --- .../current/ref-info/updates-doc.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md index da802f8af..0b1142884 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md @@ -11,6 +11,17 @@ import Link from '@docusaurus/Link'; UID2 ドキュメンテーションリソースの最新アップデートを確認してください。 +### New: LiveRamp Integration Tips + +November 14, 2024 + +We've added a new reference page with tips for publishers who are using LiveRamp's Authenticated Traffic Solution (ATS) to generate UID2 tokens to be passed in the bid request. +LiveRamp の Authenticated Traffic Solution (ATS) を使用して UID2 Token を生成し、ビッドリクエストで渡すパブリッシャー向けの新しいリファレンスページを追加しました。 + +詳細は、[LiveRamp Integration Tips](../guides/integration-liveramp-tips.md) を参照してください。 + + + ### New: Tokens Page September 10, 2024 From 6abc66afe024d4ab0a1482dea1f7157c7744ac07 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 15:12:51 +0900 Subject: [PATCH 08/20] Minor mods arising from parity checks (except guides). Minor copy edit for UID2 Portal metadata. (mods to 19 files) --- .../gs-encryption-decryption.md | 4 +- .../current/getting-started/gs-faqs.md | 2 + .../current/overviews/overview-publishers.md | 4 +- .../ref-server-side-token-generation.md | 28 ++++++------ .../current/sdks/sdk-ref-android.md | 2 +- .../current/sdks/sdk-ref-csharp-dotnet.md | 7 +-- .../current/sdks/sdk-ref-ios.md | 12 ++--- .../current/sdks/sdk-ref-java.md | 9 +--- .../current/sdks/sdk-ref-javascript.md | 45 ++++++++----------- .../current/sdks/sdk-ref-python.md | 31 ++++++------- 10 files changed, 65 insertions(+), 79 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md index 4425f6fb7..2fde7c176 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md @@ -13,7 +13,7 @@ import IdentityGenerateResponse from '/docs/snippets/_example-identity-generate- # Encrypting Requests and Decrypting Responses :::note -パブリッシャーで、クライアント側にUID2を実装している場合、暗号化と復号化は、Prebid.js ([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください) や JavaScript SDK ([Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照してください) などの実装によって自動的に管理されます。 +パブリッシャーで、Client-Side に UID2 を実装している場合、暗号化と復号化は、Prebid.js ([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください) や JavaScript SDK ([Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照してください) などの実装によって自動的に管理されます。 ::: ほとんどすべての UID2 [endpoints](../endpoints/summary-endpoints.md) では、エンドポイントに送られるリクエストは [encrypted](#encrypting-requests) され、エンドポイントからのレスポンスは [decrypted](#decrypting-responses) する必要があります。 @@ -355,7 +355,7 @@ public class Uid2Request { + "java -jar Uid2Request-jar-with-dependencies.jar " + "\n\n" + "Example:" + "\n " - + "echo '{\"email\": \"test@example.com\"}' | java -jar Uid2Request-jar-with-dependencies.jar https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=" + "\n\n\n" + + "echo '{\"email\": \"test@example.com\"}' | java -jar Uid2Request-jar-with-dependencies.jar https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=" + "\n\n\n" + "Refresh Token Usage:" + "\n " + "java -jar Uid2Request-jar-with-dependencies.jar --refresh-token " + "\n\n" diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md index 2a889c473..c4565f838 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md @@ -139,7 +139,9 @@ SDKを使うかどうかで手順は少し異なります。 - `refresh-optout@example.com` のハッシュを `email_hash` 値として指定します。 - `phone` の値として `+00000000002` を指定します。 - `phone_hash` 値として `+00000000002` のハッシュを指定します。 + 2. 返された `refresh_token` を次のステップで使用するために保存します。 + 3. [POST /token/refresh](../endpoints/post-token-refresh.md) リクエストを `refresh_token` (Step 2 で保存) を `token` 値として送信します。
ボディのレスポンスは空でなければならず、`refresh-optout@example.com` のメールアドレスと `+00000000002` の電話番号は常にログアウトしたユーザになるので、`status` の値は `optout` でなければなりません。 #### What is the uniqueness and rotation policy for UID2 tokens? diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md index 9b9155233..4f05bbd6a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md @@ -104,7 +104,7 @@ Web インテグレーションオプションの詳細は [Web Integration Over | Integration Type| Documentation | Content Description | | :--- | :--- | :--- | -| Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡されるUID2 Token を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | +| Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡される UID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | | Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法であるClient-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークンの生成と Token Refresh。
  • トークンを RTB ビッドストリームに渡す。
| | Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operator を利用しているパブリッシャーなど。 | | JavaScript (Overview) | [UID2 Integration Overview for JavaScript](../guides/integration-javascript.md) | JavaScript SDK を使って UID2 とインテグレーションしたいパブリッシャー向けのオプションの概要です。 | @@ -139,7 +139,7 @@ Prebid とインテグレーションするパブリッシャーには、以下 | Integration Type| Documentation | Content Description | | :--- | :--- | :--- | -| Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡される UID2 Token を生成したいパブリッシャー向けのインテグレーションオプションの概要。 | +| Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡される UID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要。 | | Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法である Client-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークン生成とトークンリフレッシュ。
  • トークンを RTB ビッドストリームに渡す。
| | Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operatorを使用しているパブリッシャーなどです。 | | Prebid.js on Mobile | [UID2 Mobile Integration for Prebid.js](../guides/integration-prebid-mobile-summary.md) | モバイルデバイス上の Prebid.js と UID2 のインテグレーションに関する情報リソースのまとめです。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md index a977842ad..086a9e755 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md @@ -1,6 +1,6 @@ --- title: Server-Side Token Generation -description: Information for publishers about generating the token on the server side. +description: パブリッシャー向けのサーバーサイドでのトークン生成に関する情報。 hide_table_of_contents: false sidebar_position: 06 --- @@ -11,18 +11,18 @@ import Link from '@docusaurus/Link'; # Server-Side Token Generation -If you're a publisher setting up a client-server or server-side UID2 integration, the first step is to generate the UID2 token on your server. Then, you can keep the token refreshed either on the client side or server side, and pass the token to the client side for sending to the RTB bidstream. +パブリッシャーが Client-Server または Server-Side UID2 インテグレーションを設定する場合、最初のステップはサーバーで UID2 Token を生成することです。その後、トークンを Client-Side または Server-Side でリフレッシュし、RTB ビッドストリームに送信するためにトークンを Client-Side に渡すことができます。 -There are two approaches for publishers generating UID2 tokens on the server side by providing directly identifying information (DII) (email address or phone number): +パブリッシャーが Server-Side で直接識別情報 (DII) (メールアドレスまたは電話番号) を提供して UID2 Token を生成するための 2 つのアプローチがあります: -- Integration with an SDK -- Direct integration to API endpoints +- SDK のインテグレーション +- API エンドポイントへのダイレクトインテグレーション :::warning -For security reasons, the API key and secret used in token generation *must* be called on the server side. Do not store these values on the client side, whether on a web page, in a mobile app, or in Prebid. For details, see [Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret). +セキュリティ上の理由により、トークン生成に使用される API キーとシークレットは Server-Side で呼び出す必要があります。これらの値を Web ページ、モバイルアプリ、または Prebid に保存しないでください。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: -Options are summarized in the following table. +オプションは次の表にまとめられています。 | Integration Solution | Generate Token | Refresh Token | | :--- | :--- | :--- | @@ -30,16 +30,16 @@ Options are summarized in the following table. | [SDK for Python](../sdks/sdk-ref-python.md) | ✅ | ✅ | | [Direct integration (API endpoints with custom code)](../endpoints/post-token-generate.md) | ✅ | ✅ | -Whatever integration option you choose to generate the identity (UID2 token and associated values), you'll need to implement one of the following: +Identity (UID2 Token と関連する値) を生成するために選択したインテグレーションオプションに関係なく、次のいずれかを実装する必要があります: -- **SDK**: Use one of the Publisher Client classes, in one of the UID2 server-side SDKs. These classes simplify the request into a single method call. +- **SDK**: UID2 Server-Side SDK を使用して、Publisher Client クラスのいずれかを使用します。これらのクラスは、リクエストを 1 つのメソッド呼び出しに簡素化します。 - For instructions, see one of the following: + 手順については、次のいずれかを参照してください: - [SDK for Java, Usage for Publishers, Basic Usage](../sdks/sdk-ref-java.md#basic-usage) - [SDK for Python, Usage for Publishers](../sdks/sdk-ref-python.md#usage-for-publishers) - If you're using an SDK option, the `Identity` response that you need for the rest of this guide is the output of the applicable method, as follows: + SDK オプションを使用している場合、このガイドの残りの部分で必要な `Identity` レスポンスは、次のいずれかのメソッドの出力です: @@ -58,10 +58,10 @@ Whatever integration option you choose to generate the DII you are generating the token for has been opted out of UID2. If this happens, save the information and do not call the token generation endpoint for the same DII again.  +トークンを生成する DII が UID2 からオプトアウトされている場合、エンドポイントと SDK API はオプトアウトステータスを返します。この場合、情報を保存し、同じ DII に対してトークン生成エンドポイントを呼び出さないでください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md index b02555dbb..b5f5993b2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md @@ -171,7 +171,7 @@ UID2Manager API の一部として利用可能な関数は次のとおりです: #### generateIdentity() -Directly identifying information (DII) を使用して UID2 Identity を生成します。手順については、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 +D直接識別情報 (DII) を使用して UID2 Identity を生成します。手順については、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 #### setIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md index f5848c66c..91c154cb2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md @@ -9,10 +9,11 @@ import Link from '@docusaurus/Link'; # SDK for C# / .NET Reference Guide -Server-Side で SDK for C# / .NET を使用すると、以下を簡単に行うことができます: +Server-Side では、C# / .NET SDK を使用して、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token を復号して raw UID2 にアクセスすることができます。 -- raw UID2 を暗号化して、共有用の UID2 Token を作成。 -- raw UID2 にアクセスするための UID2 Token の復号化。 +## Overview + +ここで説明する機能は、ライブラリの設定に必要な情報を定義するか、取得できる情報を定義します。以下で定義されているパラメータとプロパティ名は疑似コードです。実際のパラメータとプロパティ名は言語によって異なりますが、ここで説明されている情報に類似しています。 ## Functionality diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md index 1e2c51771..6ae5486e7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md @@ -58,8 +58,8 @@ SDKが提供する特定の機能を使用する許可が与えられ、その - Xcode バージョン: 15.0+ - iOS 最低対象バージョン: 13.0+ - - すべての機能を使用するには: 13.0+ - - 一部の機能を使用するには: 12.0+。SDK を統インテグレーションしたアプリはすべてのデバイスにインストールできますが、iOS バージョンが 13.0 未満のデバイスでは、クライアント側で UID2 Token を生成または取得することはできません。 + - すべての機能を使用するには: 13.0+ + - 一部の機能を使用するには: 12.0+。SDK を統インテグレーションしたアプリはすべてのデバイスにインストールできますが、iOS バージョンが 13.0 未満のデバイスでは、Client-Side で UID2 Token を生成または取得することはできません。 - tvOS 最低対象バージョン: 13.0+ - Swift バージョン: 5.0+ @@ -88,7 +88,7 @@ dependencies: [ アプリの Package Dependencies に次のエントリを追加します: | Name | Location | Dependency Rule | -| :--- | :--- | :--- | +| :--- | :--- | :--- | | uid2-ios-sdk | `git@github.com:IABTechLab/uid2-ios-sdk.git` | Up to next major version: 1.7.0 < 2.0.0 | ### Installing with CocoaPods @@ -116,9 +116,9 @@ UID2 Mobile SDK は、UID2 identifier が確立された後に UID2 identities ## Code Samples -The following code samples provide examples of performing specific activities relating to managing UID2 with the SDK for iOS. +以下のコードサンプルは、iOS SDK を使用して UID2 を管理する特定のアクティビティを実行する例を示します。 -Generate an initial UID2 Identity (for instructions, see [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side#configure-the-uid2-mobile-sdk)): +初期の UID2 Identity を生成します (手順については、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side#configure-the-uid2-mobile-sdk) を参照してください): ```js UID2Manager.shared.generateIdentity( @@ -156,7 +156,7 @@ UID2Manager API の一部として利用可能な関数は次のとおりです: #### generateIdentity() -Directly identifying information (DII) を使用して UID2 Identity を生成します。手順については、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 +直接識別情報 (DII) を使用して UID2 Identity を生成します。詳細については、*Client-Side Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 #### setIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md index 23bcdda20..833f24d31 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md @@ -9,13 +9,7 @@ import Link from '@docusaurus/Link'; # SDK for Java Reference Guide -SDK for Java を使用すると、以下が容易になります: - -- UID2 Advertising Token の生成 -- UID2 Advertising Token の更新 -- Raw UID2 を暗号化して共有用の UID2 Token を作成する -- UID2 Token を復号化して raw UID2 にアクセスする -- DII から raw UID2 への変換 +Server-Side で Java SDK を使用すると、UID2 を使用してクライアント ID を生成または確立し、ビッドストリームで使用する Advertising Token を取得し、UID2 Token を自動的にリフレッシュするプロセスを簡素化できます。適用可能な権限がある場合、共有のために暗号化および復号化し、DII を raw UID2 にマップすることもできます。 ## Functionality @@ -301,6 +295,7 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in ユーザーがオプトアウトした場合、このメソッドは `null` を返し、ユーザーの ID をセッションから削除する必要があることを示します。オプトアウトを確認するには、`tokenRefreshResponse.isOptout()` 関数を使用します。 ## Usage for Advertisers/Data Providers + 1. IdentityMapClient のインスタンスをインスタンス変数として作成します。 ```java final private IdentityMapClient identityMapClient = new IdentityMapClient(UID2_BASE_URL, UID2_API_KEY, UID2_SECRET_KEY); diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index e8d65938d..95bb9d46d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -11,36 +11,26 @@ import Link from '@docusaurus/Link'; import ExampleUid2Cookie from '/docs/snippets/_example-uid2-cookie.mdx'; import ExampleJavaScriptInit from '/docs/snippets/_example-javascript-init.mdx'; +# SDK for JavaScript Reference Guide + export const New = () => ( NEW IN V3 ); -# SDK for JavaScript Reference Guide +この SDK を使用して、UID2 を使用したクライアント ID の生成または確立、ターゲティング広告用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。 -この SDK を使用すると、UID2 を使用してクライアントの ID を確立し、Advertising Token を取得するプロセスが容易になります。以下のセクションでは、UID2 ID を確立するための [workflow](#workflow-overview) について説明し、SDK の [API reference](#api-reference) を提供し、UID2の[storage format](#uid2-storage-format)について説明します。 +以下のセクションでは、UID2 ID の確立のための高レベルな [ワークフロー](#workflow-overview)、SDK [API リファレンス](#api-reference)、および UID2 [ストレージフォーマット](#uid2-storage-format) を説明します。 :::tip -Prebid.js を UID2 ID モジュールと一緒に使用しているや、UID2 をサポートしている他の製品と一緒に使用している場合、おそらく SDK を使用する必要はないでしょう。Prebid.js モジュールがすべてを管理します。詳細は [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください。 +UID2 Identify Module、または UID2 サポートのある他の製品と Prebid.js を使用している場合、SDK を使用する必要はありません。Prebid.js モジュールがすべてを管理します。詳細については、[UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください。 ::: -このページでは、SDK for JavaScript version 3 について説明します。以前のバージョンを使用してインテグレーションを管理している場合は、以下のいずれかを行ってください: -- [migration guide](#migration-guide) を使用して、インテグレーションをアップグレードします。(推奨) -- [earlier versions of the SDK](./sdk-ref-javascript-v2.md) のドキュメントを参照します。 +このページでは、SDK のバージョン 3 について説明します。以前のバージョンを使用している場合は、[移行ガイド](#migration-guide) を使用してインテグレーションをアップグレードすることをお勧めします。必要に応じて、[SDK の以前のバージョン](./sdk-ref-javascript-v2.md) のドキュメントも利用できます。 -関連情報: - -コンテンツパブリッシャーのインテグレーションステップについては、以下を参照してください: +コンテンツパブリッシャー向けのインテグレーション手順は、以下のガイドを参照してください: - [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) - [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) -## Sample Implementation - -アプリケーションのサンプルと関連文書については、以下を参照してください: - - SDK v3を使用したUID2 Google Secure Signals のサンプル: - - [Code and docs](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) - - Running site: [Client-Side UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/) - - JavaScript Client-Side インテグレーションの例: [Code](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)、Running site ([Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)). - ## Functionality この SDK は、独自にカスタマイズした UID2 インテグレーションを行いたいパブリッシャーの開発を簡素化します。次の表は、SDK がサポートする機能を示しています。 @@ -49,6 +39,14 @@ Prebid.js を UID2 ID モジュールと一緒に使用しているや、UID2 | :--- | :--- | :--- | :--- | :--- | :--- | | — | — | ✅ | ✅ | — | — | +## Sample Implementation Website + +サンプルアプリケーションと関連するドキュメントは以下を参照してください: + - The UID2 Google Secure Signals with SDK v3 example: + - [Code and docs](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) + - Running site: [Client-Side UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/) + - The example of JavaScript client-side integration: [Code](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) and running site ([Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)). + ## API Permissions この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 @@ -72,13 +70,10 @@ SDK が提供する特定の機能の使用許可が与えられ、そのアク この SDK は、以下のロケーションに公開されています: + - This is the easiest way to include the SDK in your own build. Use this if you want to bundle the SDK along with your other JavaScript or TypeScript files. + - You can also use this for TypeScript type information and still load the script via the CDN. If you do this, ensure that the version of NPM package you have installed matches the version in the CDN url. LP_TODO: Looking at the NPM package, I don't believe it's ready for use - it just includes the source and doesn't seem to include a ready-to-deploy build. LP 12 Sep 2023 --> - CDN: `https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js` - - + この文書の最新更新時点での最新バージョンは [3.4.5](https://cdn.prod.uidapi.com/uid2-sdk-3.4.5.js) です。[the list of available versions](https://cdn.prod.uidapi.com/) も参照してください。 - CDN (Integration): `https://cdn.integ.uidapi.com/uid2-sdk-${VERSION_ID}.js` @@ -335,11 +330,9 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 2. 移行、渡されたコールバック関数のすべてに対し、[Array Push Pattern](#array-push-pattern) を使用して既存のコールバック配列に関数が追加されます。 :::note - `useCookie` が更新されると、identity の場所が変わります。例えば、値が `true` から `false` に更新されると、ファーストパーティクッキーが削除され、identity がローカルストレージに追加されます。 ::: - ### Init Config `init()` を呼び出すと、初期設定がファーストパーティクッキーまたはローカルストレージに保存されます。この設定には、`baseUrl`、`useCookie`、`refreshRetryPeriod`、`cookiePath`、`cookieDomain` が含まれる場合があります。この設定は [bootstrap init](#self-bootstrap) に使用され、その後のページロードでの読み込み時間を短縮します。`init()` に対する後続の呼び出しは、最新のパラメータで設定を更新します。 @@ -605,4 +598,4 @@ window.__uid2.callbacks.push((eventType) => { `async` または `defer` スクリプトローディングを使用する場合は、SDK をロードするスクリプトタグをドキュメントヘッダに移動し、適切なキーワードを追加してください。 -`async` または `defer` スクリプトローディングを使用するかどうかは、個々のウェブサイトに依存するため、UID2 チームがアドバイスを提供できるものではありません。よくわからない場合は、この変更を無視して script タグを変更しないままにしておくのが安全です。 +`async` または `defer` スクリプトローディングを使用するかどうかは、個々のウェブサイトに依存するため、UID2 チームがアドバイスを提供できるものではありません。よくわからない場合は、この変更を無視して script タグを変更しないままにしておくのが安全です。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md index 58f29b60d..b7e14efd7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md @@ -9,12 +9,7 @@ import Link from '@docusaurus/Link'; # SDK for Python Reference Guide -UID2 Server-Side SDK を使用することで、以下が容易になります: - -- UID2 Advertising Token の生成 -- UID2 Advertising Token の更新 -- raw UID2 を暗号化して UID2 Token を作成する -- UID2 Advertising Token を復号化して raw UID2 にアクセスする +Server-Side で Python SDK を使用すると、UID2 を使用してクライアント ID を生成または確立するプロセス、ビッドストリームでの Advertising Token の取得、UID2 Token の自動リフレッシュを容易にすることができます。適用可能な権限がある場合、共有のために暗号化および復号化、DII を raw UID2 にマッピング、およびローテーションされたソルトバケットの監視も行うことができます。 ## Functionality @@ -58,22 +53,22 @@ pip install uid2-client 初期化ステップは、次の表に示すように役割によって異なります。 -| Role | Create Instance of Class | Link to Instructions | -|:-------------------------|:--------------------------|:-----------------------------------------------------------------------------| -| Publisher | `Uid2PublisherClient` | [Usage for Publishers](#usage-for-publishers) | -| Advertiser/Data Provider | `IdentityMapClient` | [Usage for Advertisers/Data Providers](#usage-for-advertisersdata-providers) | -| DSP | `BidstreamClient` | [Usage for DSPs](#usage-for-dsps) | -| Sharer | `SharingClient` | [Usage for Sharers](#usage-for-uid2-sharers) | +| Role | Create Instance of Class | Link to Instructions | +| :--- | :--- | :---| +| Publisher | `Uid2PublisherClient` | [Usage for Publishers](#usage-for-publishers) | +| Advertiser/Data Provider | `IdentityMapClient` | [Usage for Advertisers/Data Providers](#usage-for-advertisersdata-providers) | +| DSP | `BidstreamClient` | [Usage for DSPs](#usage-for-dsps) | +| Sharer | `SharingClient` | [Usage for Sharers](#usage-for-uid2-sharers) | SDK が　UID2 Service と通信するために必要な値を提供する必要があります。 -| Parameter | Description | -|:-------------|:-------------------------------------------------------------------------------------------| -| `base_url` | The endpoint for the UID2 service. See [Environments](../getting-started/gs-environments). | -| `auth_key` | The API key. See [UID2 Credentials](../getting-started/gs-credentials). | -| `secret_key` | The client secret. See [UID2 Credentials](../getting-started/gs-credentials). | +| Parameter | Description | +| :--- | :--- | +| `base_url` | UID2 Service のエンドポイント。[Environments](../getting-started/gs-environments) を参照してください。 | +| `auth_key` | API Key。[UID2 Credentials](../getting-started/gs-credentials) を参照してください。 | +| `secret_key` | Cient　Secret。[UID2 Credentials](../getting-started/gs-credentials) を参照してください。 | ## Interface @@ -386,4 +381,4 @@ python3 -m unittest discover -s ./tests/ ## FAQs -DSP に関するよくある質問については、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 +DSP に関するよくある質問については、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 \ No newline at end of file From 695540821eac4f476f635ca9c80ab9fc59d35861 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Thu, 12 Dec 2024 15:20:47 +0900 Subject: [PATCH 09/20] UID2 minor back-edits from parity check on Guides docs (17 files) --- .../current/guides/integration-prebid-client-side.md | 2 ++ .../current/guides/mobile-plugin-gma-android.md | 3 +-- .../current/guides/mobile-plugin-gma-ios.md | 2 +- .../current/guides/mobile-plugin-ima-android.md | 2 +- .../current/guides/operator-guide-aws-marketplace.md | 7 ++++--- .../current/guides/summary-guides.md | 2 +- 6 files changed, 10 insertions(+), 8 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md index 86e14ec3d..b78e90d2b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md @@ -21,6 +21,8 @@ Prebid.js を使って UID2 とインテグレーションするには、サイ この実装には Prebid.js version 8.21.0 以降が必要です。バージョン情報については、[https://github.com/prebid/Prebid.js/releases](https://github.com/prebid/Prebid.js/releases) を参照してください。 + + 以前のバージョンの Prebid.js を使用する必要がある場合は、代わりに [UID2 Client-Server Integration Guide for Prebid.js](integration-prebid-client-server.md) で説明している実装ソリューションを使用してください。 ## Integration Example diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md index cf01f369a..b5686f9ed 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md @@ -73,5 +73,4 @@ Maven でインストールするには、`pom.xml` ファイルに依存関係 R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。 -ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 - +ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md index 33f2bc11d..558f35c70 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md @@ -66,7 +66,7 @@ dependencies: [ XCode ユーザーインターフェースで、パッケージ依存関係の下に、次のエントリを追加します: | Name | Location | Dependency Rule | -| :--- | :--- | :--- | +| :--- | :--- | :--- | | uid2-ios-plugin-google-gma | `git@github.com:IABTechLab/uid2-ios-plugin-google-gma.git` | Exact Version: 1.0.0 | ### Installing with CocoaPods diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md index 61b660d26..f6f085531 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md @@ -74,4 +74,4 @@ Maven でインストールするには、`pom.xml` ファイルに依存関係 R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。 -ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 +ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index 0d8712b5e..da69fae78 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -132,9 +132,9 @@ AWS で 1 つまたは複数の UID2 Operator をサブスクライブしてデ | Port Number | Direction | Protocol | Description | | ----------- | --------- | -------- | ------ | -| 80 | Inbound | HTTP | Healthcheck エンドポイント `/ops/healthcheck` を含むすべての UID2 API を提供します。
すべてが稼働している場合、エンドポイントは HTTP 200 を返し、レスポンスボディは `OK` となります。詳しくは、[Checking UID2 Operator Status](#checking-uid2-operator-status) を参照してください。 | -| 9080 | Inbound | HTTP | Prometheus metrics サービス (`/metrics`)。 | -| 443 | Outbound | HTTPS | UID2 Core Service を呼び出し、オプトアウトデータとキーストアを更新します。 | +| 80 | Inbound | HTTP | Healthcheck エンドポイント `/ops/healthcheck` を含むすべての UID2 API を提供します。
すべてが稼働している場合、エンドポイントは HTTP 200 を返し、レスポンスボディは `OK` となります。詳しくは、[Checking UID2 Operator Status](#checking-uid2-operator-status) を参照してください。 | +| 9080 | Inbound | HTTP | Prometheus metrics サービス (`/metrics`)。 | +| 443 | Outbound | HTTPS | UID2 Core Service を呼び出し、オプトアウトデータとキーストアを更新します。 | ### VPC Chart @@ -280,6 +280,7 @@ Operator インスタンスがデプロイされると、デフォルトのロ #### Log Rotation Default Settings 以下はデフォルトの logrotete の設定です。`/etc/logrotate.d/operator-logrotate.conf` に定義されています: + ``` /var/log/operator.log* { diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index 941d15b5d..c930e508a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -47,7 +47,7 @@ Web インテグレーションオプションの詳細は [Web Integration Over | [UID2 Integration Overview for JavaScript](integration-javascript.md) | JavaScript SDK を使って UID2 とインテグレーションしたいパブリッシャー向けのオプションの概要です。 | | [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) | 最も簡単な実装方法で、Clent-Side の JavaScript の変更だけで UID2 とインテグレーションしたいパブリッシャー向けのインテグレーションガイドです。SDK for JavaScriptは、トークンの生成と更新を自動的に管理します。 | | [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md) | パブリッシャー向けのこのインテグレーションガイドでは、SDK for JavaScript を使用する標準的なウェブインテグレーションシナリオについて説明し、トークンを Server-Side で生成し、パブリッシャーのウェブページに渡す必要があります。 | -| [Publisher Integration Guide, Server-Side](integration-publisher-server-side.md) | このインテグレーションガイドは、SDK for JavaScript を使用していないパブリッシャー向けです。 | +| [Publisher Integration Guide, Server-Side](integration-publisher-server-side.md) | このインテグレーションガイドは、[SDK for JavaScript](../sdks/sdk-ref-javascript.md) を使用していないパブリッシャー向けです。 | | [Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) | このインテグレーションガイドでは、UID2 を Google Ad Manager のセキュアシグナル機能(旧称: Encrypted Signals for Publishers、ESP) で使用するパブリッシャーに必要な追加手順について説明します。 | ### Mobile Integrations From ca7c93bbbeef3f56e72489a8ea2dd685b79accea Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 13:46:33 +0900 Subject: [PATCH 10/20] UID2 minor docs mods resulting from queries (mods to 6 files) --- .../current/endpoints/post-identity-map.md | 2 +- .../guides/operator-guide-aws-marketplace.md | 2 ++ .../current/sdks/sdk-ref-javascript.md | 17 +++++++++-------- .../_private-operator-attest-failure.mdx | 3 +-- 4 files changed, 13 insertions(+), 11 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md index d1ef25a40..cb0756e8c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md @@ -93,7 +93,7 @@ Used by: このエンドポイントは、主に広告主やデータプロバ 以下は、メールアドレスハッシュに対する暗号化された ID マッピングリクエストの例です: ```sh -echo '{"phone": ["+12345678901", "+441234567890"]}' | python3 uid2_request.py https://prod.uidapi.com/v2/identity/map YourTokenBV3tua4BXNw+HVUFpxLlGy8nWN6mtgMlIk= DELPabG/hsJsZk4Xm9Xr10Wb8qoKarg4ochUdY9e+Ow= +echo '{"phone": ["+12345678901", "+441234567890"]}' | python3 uid2_request.py https://prod.uidapi.com/v2/identity/map [Your-Client-API-Key] [Your-Client-Secret] ``` 詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index da69fae78..89bb6868a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -239,6 +239,8 @@ UID2 Operator を AWS Marketplace にデプロイするには、以下の手順 1. **EC2 > Load balancers** で、ロードバランサーの **DNS name** 列を見て、ロードバランサーの DNS 名を特定します。 2. ブラウザで、`https://{dns-name-of-your-load-balancer}/ops/healthcheck` にアクセスします。`OK` のレスポンスであれば、Operator のステータスは良好です。 +### Private Operator Attestation Failure + ## Upgrading the UID2 Operator diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 95bb9d46d..230868cc6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -69,18 +69,19 @@ SDK が提供する特定の機能の使用許可が与えられ、そのアク この SDK は、以下のロケーションに公開されています: - +- NPM: [https://www.npmjs.com/package/@uid2/uid2-sdk](https://www.npmjs.com/package/@uid2/uid2-sdk) + + これは、SDK を自分のビルドに含める最も簡単な方法です。他の JavaScript または TypeScript ファイルと一緒に SDK をバンドルしたい場合に使用します。 + + また、TypeScript の型情報を使用して、スクリプトを CDN 経由でロードすることもできます。この場合、インストールした NPM パッケージのバージョンが CDN URL のバージョンと一致していることを確認してください。 - CDN: `https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js` - - この文書の最新更新時点での最新バージョンは [3.4.5](https://cdn.prod.uidapi.com/uid2-sdk-3.4.5.js) です。[the list of available versions](https://cdn.prod.uidapi.com/) も参照してください。 -- CDN (Integration): `https://cdn.integ.uidapi.com/uid2-sdk-${VERSION_ID}.js` + これは、ビルドパイプラインを使用して JavaScript をバンドルしていない場合に、サイトに SDK を含める最も簡単な方法です。 - このインテグレーション URL には最小化されていないコードが含まれており、テストのみを目的としています。この URL を本番サイトに使用しないでください。 + 本ドキュメントの最新の更新時点で、最新のバージョンは [3.4.5](https://cdn.prod.uidapi.com/uid2-sdk-3.4.5.js) です。利用可能なバージョンの一覧は [the list of available versions](https://cdn.prod.uidapi.com/) を参照してください。 +- CDN (Integration): `https://cdn.integ.uidapi.com/uid2-sdk-${VERSION_ID}.js` - このドキュメントの最新更新時点での最新バージョンは [3.4.5](https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js) です。[the list of available versions](https://cdn.integ.uidapi.com/) も参照してください。 + このインテグレーション URL には minified されていないコードが含まれており、テスト目的でのみ使用することができます。本番サイトにはこの URL を使用しないでください。 ## Terminology diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx index 837d74c9d..1172c7749 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx @@ -1,8 +1,7 @@ -## Private Operator Attestation Failure Private Operator が Core Service の認証に失敗した場合、次のいずれかのアクションが発生します: - HTTP 401 レスポンス。Private Operator は直ちに終了します。 - 起こりうる原因: API Keyが取り消されたか、間違っている。 - その他の 200 以外のレスポンスコード。Private Operator は 12 時間続行されます。この時間内に問題が解決されない場合、Private Operator は終了します。 - 起こりうる原因: Core Service の問題、ネットワークの問題。 -Private Operator ホストは、エラーが発生した場合にアラートを処理し、オペレーターを再起動するためのインフラを備えている必要があります。 +Private Operator ホストは、エラーが発生した場合にアラートを処理し、オペレーターを再起動するためのインフラを備えている必要があります。 \ No newline at end of file From 54b006865ce666cf2ea38ad9bcb519f219ba103b Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 13:52:50 +0900 Subject: [PATCH 11/20] AWS doc edit from TM, other minor typographical edits (2 files) --- .../current/guides/operator-guide-aws-marketplace.md | 1 + .../current/sdks/sdk-ref-csharp-dotnet.md | 1 - 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index 89bb6868a..2ffe5a5a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -329,6 +329,7 @@ MAILTO=root - コマンドは `/var/lib/logrotate/logrotate.status` を参照してログのステータスをチェックし、ログがローテーション条件に達したかどうかを確認して、`logrotate` が毎分実行されたときにも余分なローテーションが行われないようにします。 ### Changing the Log Rotation Schedule + ログローテーションスケジュールを変更するには、`/etc/logrotate.d/uid2operator.conf` ファイルを更新します。 logrotate のドキュメントに従って指示に従ってください: [logrotate(8) - Linux man](https://linux.die.net/man/8/logrotate) ぺージを参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md index 91c154cb2..65b15bb7a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md @@ -37,7 +37,6 @@ SDK が提供する特定の機能の使用許可が与えられ、そのアク ## GitHub Repository/Binary - この SDK は以下のオープンソースの GitHub リポジトリにあります: - [SDK for .NET](https://github.com/IABTechLab/uid2-client-net/blob/master/README.md) From 0120b1106dd67cf6ac2e5d44fdbe8d0129711891 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 14:01:52 +0900 Subject: [PATCH 12/20] add info re system-required password change (3 files) --- .../current/portal/portal-getting-started.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md index 95685dfb8..fa3c5a781 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md @@ -25,10 +25,6 @@ UID2 Portal アカウントをリクエストする際には、自分自身と UID2 の連絡先にアカウントのリクエストを行う際には、情報を提供いただく必要があります。次の表に示す詳細情報を含めてください。 -:::note -UID2 の連絡先をまだお持ちでない場合は、[Request Access to UID2](/request-access) ページに移動し、フォームに記入してください。 -::: - | Item | Details | | :--- | :--- | | Information about yourself | 次の情報を提供してください。
- 名
- 姓
- メールアドレス
- 職務 | @@ -73,7 +69,7 @@ UID2 Service を使用するには、キーのセットが必要です。Client- ## Change Your Password -**Accept Invitation** リンクをクリックすると、**Update Password** ページに移動します。 +**Accept Invitation** リンクをクリックすると、**Set Password** ページに移動します。 :::tip アカウントが漏洩した可能性があるためにパスワードを変更する場合は、**Sign out from other devices** チェックボックスがチェックされていることを確認してください。 @@ -147,4 +143,4 @@ UID2 Service を使用するには、キーのセットが必要です。Client- 現在のパスワード要件がページに表示されます。新しいパスワードを選択し、確認のためにもう一度入力し、保存してください。 -必ず覚えやすいパスワードを選択してください。 +必ず覚えやすいパスワードを選択してください。 \ No newline at end of file From bdd1365cb1694dcfbc9109855ee5751670f13504 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 14:03:52 +0900 Subject: [PATCH 13/20] In Portal doc, add link to Request Access to UID2 page --- .../current/portal/portal-getting-started.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md index fa3c5a781..e375c64fb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md @@ -25,6 +25,10 @@ UID2 Portal アカウントをリクエストする際には、自分自身と UID2 の連絡先にアカウントのリクエストを行う際には、情報を提供いただく必要があります。次の表に示す詳細情報を含めてください。 +:::note +UID2 の連絡先がまだない場合は、[Request Access to UID2](/request-access) ページに移動し、フォームに記入してください。 +::: + | Item | Details | | :--- | :--- | | Information about yourself | 次の情報を提供してください。
- 名
- 姓
- メールアドレス
- 職務 | From b34d643e206a3e61acc34cddb9b4d41b37da3100 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 14:12:31 +0900 Subject: [PATCH 14/20] Minor edits from follow-up compare of Endpoint docs, couple of other minor edits. (9 files) --- .../current/endpoints/post-identity-buckets.md | 2 +- .../current/endpoints/post-identity-map.md | 2 +- .../current/endpoints/post-optout-status.md | 2 +- .../current/endpoints/post-token-generate.md | 16 ++++++++-------- .../current/endpoints/post-token-refresh.md | 2 +- .../current/endpoints/post-token-validate.md | 2 +- .../getting-started/gs-normalization-encoding.md | 2 +- .../current/sdks/sdk-ref-javascript.md | 4 ++-- 8 files changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md index 129ad700f..fd301850c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md @@ -25,7 +25,7 @@ Used by: このエンドポイントは、主に広告主とデータプロバ | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note インテグレーション環境と本番環境では、異なる API Key が必要です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md index cb0756e8c..2a0ec36a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md @@ -34,7 +34,7 @@ Used by: このエンドポイントは、主に広告主やデータプロバ | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note インテグレーション環境と本番環境では、異なる API Key が必要です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md index 03a7478b3..2011bf2ce 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md @@ -38,7 +38,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note インテグレーション環境と本番環境では、異なる API Key が必要です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md index b79957192..be8478514 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md @@ -145,11 +145,11 @@ echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_chec ## Test Identities -| Type | Identity | Purpose | Next Endpoint | -| :---- | :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------- | -| Email | `validate@example.com` | キャッシュした `advertising_token` が、指定したメールアドレスの `advertising_token` と一致するかテストします。 | [POST /token/validate](post-token-validate.md) | -| Email | `optout@example.com` | このメールアドレスをリクエストに使用すると、常に `optout` レスポンスが生成されます | [POST /token/generate](post-token-generate.md) | -| Email | `refresh-optout@example.com` | このメールアドレスをリクエストに使用すると、常に `refresh_token` による ID レスポンスが生成され、その結果 `optout` レスポンスが生成されます。 | [POST /token/refresh](post-token-refresh.md) | -| Phone | `+12345678901` | キャッシュした `advertising_token` が、指定した電話番号の `advertising_token` と一致するかテストします。 | [POST /token/validate](post-token-validate.md) | -| Phone | `+00000000002` | この電話番号をリクエストに使用すると、常に `optout` レスポンスが生成されます。 | [POST /token/generate](post-token-generate.md) | -| Phone | `+00000000000` | この電話番号をリクエストに使用すると、常に `refresh_token` による ID レスポンスが生成され、その結果`optout`レスポンスが生成されます。 | [POST /token/refresh](post-token-refresh.md) | +| Type | Identity | Purpose | Next Endpoint | +| :--- | :--- | :--- | :--- | +| Email | `validate@example.com` | キャッシュした `advertising_token` が、指定したメールアドレスの `advertising_token` と一致するかテストします。 | [POST /token/validate](post-token-validate.md) | +| Email | `optout@example.com` | このメールアドレスをリクエストに使用すると、常に `optout` レスポンスが生成されます。 | [POST /token/generate](post-token-generate.md) | +| Email | `refresh-optout@example.com` | このメールアドレスをリクエストに使用すると、常に `refresh_token` による ID レスポンスが生成され、その結果 `optout` レスポンスが生成されます。 | [POST /token/refresh](post-token-refresh.md) | +| Phone | `+12345678901` | キャッシュした `advertising_token` が、指定した電話番号の `advertising_token` と一致するかテストします。 | [POST /token/validate](post-token-validate.md) | +| Phone | `+00000000002` | この電話番号をリクエストに使用すると、常に `optout` レスポンスが生成されます。 | [POST /token/generate](post-token-generate.md) | +| Phone | `+00000000000` | この電話番号をリクエストに使用すると、常に `refresh_token` による ID レスポンスが生成され、その結果`optout`レスポンスが生成されます。 | [POST /token/refresh](post-token-refresh.md) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md index ff87dd956..40e846b16 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md @@ -37,7 +37,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは、[Environments](../getting-started/gs-environments.md) を参照してください。
Notes:
  • `integ` 環境と `prod` 環境は異なる API keys を必要とします。
  • トークンの有効期限は変更される可能性がありますが、`integ` 環境では常に `prod` 環境よりも大幅に短くなります。
| +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは、[Environments](../getting-started/gs-environments.md) を参照してください。
Notes:
  • `integ` 環境と `prod` 環境は異なる API keys を必要とします。
  • トークンの有効期限は変更される可能性がありますが、`integ` 環境では常に `prod` 環境よりも大幅に短くなります。
| #### Testing Notes diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md index b9b0de81d..a1e65bb91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md @@ -29,7 +29,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note インテグレーション環境と本番環境では、異なる API Key が必要です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md index 6be4684e9..8b32ec17f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md @@ -131,7 +131,7 @@ JavaScript でメールアドレスと電話のハッシュを生成する方法 正規化、ハッシュ化、エンコードが正しく行われているかチェックするには、[UID2 hashing tool](https://unifiedid.com/examples/hashing-tool/) を使ってテストすることができます。 -Email または Phone Number を選択し、値を入力またはペーストして、Enter をクリックします。 +Email または Phone Number を選択し、値を入力またはペーストして、**Enter** をクリックします。 このツールは以下を行います: - Email: 以下の３つの値を表示します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 230868cc6..31d228935 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -11,12 +11,12 @@ import Link from '@docusaurus/Link'; import ExampleUid2Cookie from '/docs/snippets/_example-uid2-cookie.mdx'; import ExampleJavaScriptInit from '/docs/snippets/_example-javascript-init.mdx'; -# SDK for JavaScript Reference Guide - export const New = () => ( NEW IN V3 ); +# SDK for JavaScript Reference Guide + この SDK を使用して、UID2 を使用したクライアント ID の生成または確立、ターゲティング広告用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。 以下のセクションでは、UID2 ID の確立のための高レベルな [ワークフロー](#workflow-overview)、SDK [API リファレンス](#api-reference)、および UID2 [ストレージフォーマット](#uid2-storage-format) を説明します。 From 4f97935bd913f06cade36db3ce8eeba5c00485da Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 16:20:35 +0900 Subject: [PATCH 15/20] Checks for translation omissions --- .../current/endpoints/post-identity-buckets.md | 2 ++ .../current/endpoints/post-identity-map.md | 4 ++++ .../current/endpoints/post-optout-status.md | 2 ++ .../current/endpoints/post-token-generate.md | 2 ++ .../current/endpoints/post-token-validate.md | 2 ++ .../current/endpoints/summary-endpoints.md | 2 ++ .../current/getting-started/gs-credentials.md | 1 + .../getting-started/gs-encryption-decryption.md | 2 +- .../getting-started/gs-normalization-encoding.md | 4 +--- .../current/guides/advertiser-dataprovider-guide.md | 2 ++ .../current/guides/dsp-guide.md | 2 ++ .../guides/integration-javascript-client-server.md | 2 ++ .../current/guides/integration-liveramp-tips.md | 11 ++++++----- .../guides/integration-mobile-client-server.md | 2 +- .../current/guides/integration-mobile-overview.md | 5 ++++- .../guides/integration-prebid-client-server.md | 2 ++ .../guides/integration-publisher-server-side.md | 2 ++ .../current/guides/mobile-plugin-gma-android.md | 2 +- .../current/guides/operator-guide-aws-marketplace.md | 2 ++ .../current/guides/operator-guide-azure-enclave.md | 2 ++ .../guides/operator-private-gcp-confidential-space.md | 2 ++ .../current/portal/api-keys.md | 8 +++++++- .../current/portal/client-side-integration.md | 8 ++++++++ .../current/portal/portal-getting-started.md | 2 +- .../current/portal/sharing-permissions.md | 7 +++++-- .../current/ref-info/glossary-uid.md | 2 ++ .../current/sdks/sdk-ref-ios.md | 2 +- .../current/sdks/sdk-ref-javascript.md | 4 ++-- .../current/sdks/sdk-ref-python.md | 2 +- 29 files changed, 72 insertions(+), 20 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md index fd301850c..633bacf23 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md @@ -17,6 +17,8 @@ Used by: このエンドポイントは、主に広告主とデータプロバ `POST '{environment}/v2/identity/buckets'` +認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 + :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md index 2a0ec36a2..ff5949ef8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md @@ -13,6 +13,8 @@ import Link from '@docusaurus/Link'; Used by: このエンドポイントは、主に広告主やデータプロバイダーが使用します。詳細は [Advertiser/Data Provider Integration Guide](../guides/advertiser-dataprovider-guide.md) を参照してください。 +UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + ## Batch Size and Request Parallelization Requirements 知っておくべきことは以下のとおりです: @@ -26,6 +28,8 @@ Used by: このエンドポイントは、主に広告主やデータプロバ `POST '{environment}/v2/identity/map'` +認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 + :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md index 2011bf2ce..01999c6f1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md @@ -30,6 +30,8 @@ Used by: このエンドポイントは、主に広告主、データプロバ `POST '{environment}/v2/optout/status'` +認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 + :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md index be8478514..ab79334a6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md @@ -24,6 +24,8 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 ## Request Format +認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 + `POST '{environment}/v2/token/generate'` このエンドポイントリクエストについて知っておくべきことは、以下のとおりです: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md index a1e65bb91..00a138c69 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md @@ -21,6 +21,8 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 `POST '{environment}/v2/token/validate'` +認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 + :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md index b4823d585..dc1074625 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md @@ -35,6 +35,8 @@ import Link from '@docusaurus/Link'; 以下のエンドポイントは、広告主、サードパーティのデータプロバイダー、DSP、共有者が使用できます。パブリッシャーは、このエンドポイントを使用する必要はありません。 +UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + | Endpoint | Description | Request Encryption | Response Decryption | | :--- | :--- | :--- | :--- | | [POST /optout/status](post-optout-status.md) | raw UID2 のオプトアウトステータスをチェックします。このエンドポイントは raw UID2 のリストを入力として受け取り、オプトアウトした raw UID2 と、オプトアウトが行われた時刻を返します。 | 必須 | 必須 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md index f9ff84df8..3ec473075 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md @@ -42,6 +42,7 @@ Notes: Client-Side または Server-Side の実装を使用している場合([UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) または [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) を参照してください)、API Key とクライアントシークレットを使用して、Operator Service に接続し、API エンドポイントを呼び出すことができます。これらの値は、サービスの参加者を識別します。 以下は API Key とクライアントシークレットに関する情報です: +- これらの値を安全に保管しなければなりません。詳細は、[Security of API Key and Client Secret](#security-of-api-key-and-client-secret) を参照してください。 - UID2 参加者は、複数のキーを持つことができます。 - 各キーには、それを使用できるエンドポイントを決定する [Permissions](gs-permissions.md) のセットがあります。 - 各キーには対応するクライアントシークレットがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md index 2fde7c176..4fe7a6033 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md @@ -821,4 +821,4 @@ Refresh Token Usage example: ``` - \ No newline at end of file + diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md index 8b32ec17f..d648c1b07 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md @@ -71,8 +71,6 @@ Base64 エンコードを適用する場合、ハッシュの Raw バイトを ## Phone Number Normalization -ハッシュ化されていない電話番号を UID2 Operator Service に送信すると、同サービスは電話番号を正規化した後、ハッシュ化します。電話番号を送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に電話番号を正規化する必要があります。 - :::important ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。 ::: @@ -143,7 +141,7 @@ Email または Phone Number を選択し、値を入力またはペーストし - Hashed value (ハッシュした値) - Base64-encoded value (Base64 エンコードした値) - :::note + :::important 電話番号の場合は、まずデータを正規化する必要があります。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md index 51a8d96c2..abab25412 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md @@ -106,6 +106,8 @@ UID2 ベースのオーディエンス情報を正確かつ最新の状態に保 - 広告主やデータプロバイダーは、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、生の UID2 のオプトアウトステータスを確認できます。 +UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + ## FAQs UID2 フレームワークを使用する広告主およびデータプロバイダー向けのよくある質問は、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md index c2ec3477d..09dc8f2b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md @@ -38,6 +38,8 @@ DSP はビッドリクエストで UID2 Token を受け取り、この機能を - [POST /optout/status Endpoint](#post-optoutstatus-endpoint) - [Bidding Opt-Out Logic](#bidding-opt-out-logic) +UID2 の Opt-out ワークフローとユーザーがどのように Opt-out できるかの詳細については、[ユーザーオプトアウト](../getting-started/gs-opt-out.md) を参照してください。 + #### Opt-Out Webhook UID2 Service からユーザーオプトアウトを受け取り、それを受け入れるために DSP が事前に設定されたインターフェース (オプトアウト Webhook/API エンドポイント) を確立し、オンボーディング中に UID2 Service に提供します。ユーザーがオプトアウトすると、UID2 Service はユーザーの raw UID2 と対応するオプトアウトタイムスタンプを事前に設定されたインターフェースに送信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md index 0fbc33c96..57f51967c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md @@ -32,6 +32,8 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re ワークフロー図は、[Integration Steps](#integration-steps) を参照してください。また、[FAQ](#faqs) も参照してください。 +UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + UID2 を使用してクライアントの ID を確立し、Advertising Token を取得するプロセスを容易にするために、このガイドで提供する Web インテグレーション手順は、JavaScript 用の UID2 SDK に依存しています。このガイドに記載されているインテグレーションステップと SDK の使用方法(現在はメールアドレスのみ) を示す [example application](https://example-jssdk-integ.uidapi.com/) を以下に示します。アプリケーションのドキュメントについては、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/standard/README.md) を参照してください。 :::tip diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md index 21600aabc..b91a5ff79 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md @@ -19,21 +19,22 @@ LiveRamp ATS を使用して、UID2 Token を生成するには、LiveRamp の - [Implement the Correct Hashing Methodology](#implement-the-correct-hashing-methodology) - [Set Envelope Refresh to 1800 Seconds](#set-envelope-refresh-to-1800-seconds) -## Enable RideAlong +## Enable UID2 as an Interoperable ID LiveRamp の設定では、RideAlong が有効になっていることを確認する必要があります。RideAlong は、UID2 などの他の ID ソリューションが ATS エンベロープに識別子を埋め込むことを可能にする LiveRamp の機能です。RideAlong が有効になっていない場合、UID2 Token はエンベロープに追加されません。 この手順を完了するには、LiveRamp の担当者に連絡してください。 -## Implement the Correct Hashing Methodology +## Implement the UID2 Hashing Methodology -UID2 Service で使用されているハッシュ化の方法はとても特殊です。異なるハッシュ化アルゴリズムを使用したり、ステップを逃したりすると、UID2 が正しく生成されません。 +有効な UID2 Token を ATS エンベロープに追加するには、パブリッシャーは平文のメールアドレスを提供し、SHA-256 ハッシング方法論を示すか、メールアドレスの SHA-256 ハッシュバージョンを直接 LiveRamp ライブラリに提供する必要があります。 -必要なハッシュ化方法については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 +UID2 と LiveRamp の両方でサポートされている SHA-256 ハッシング方法論を使用する必要があります。他のハッシング方法論を使用したり、ステップを逃したりすると、ATS エンベロープに UID2 Token が追加されないか、無効なトークンが追加されます。 + +For details, see [Normalization and Encoding](../getting-started/gs-normalization-encoding.md). ## Set Envelope Refresh to 1800 Seconds -When enabling `ATS.js` within `Prebid.js`, make sure that `storage.refreshInSeconds` is set to **1800 seconds** (30 minutes). `Prebid.js` 内で `ATS.js` を有効にする場合は、`storage.refreshInSeconds` を **1800 秒** (30 分) に設定してください。 ## Troubleshooting Assistance diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md index 97e98270b..0b6525469 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md @@ -312,4 +312,4 @@ UID2Manager.shared.automaticRefreshEnabled = false ## Error Response States - \ No newline at end of file + diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md index bcd781f67..8f6742407 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md @@ -63,6 +63,8 @@ UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレ UID2 mobile SDK を使用して UID2 とインテグレーションするためのオプションは、次の表にまとめられています。最適な Integration approach を選択してください。 +詳細は、[Integration Approaches](../ref-info/ref-integration-approaches.md) を参照してください。 + | Scenario | Option | Integration Guide | | :--- | :--- | :--- | | モバイルアプリ内のクライアントサイドで DII (メールアドレスまたは電話番号) にアクセスでき、変更をアプリ内にのみ保持したい場合。 | Client-Side インテグレーション | [UID2 Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | @@ -143,6 +145,7 @@ Podspec は、CocoaPods 内のファイル名で、アプリにインテグレ ::: ## Troubleshooting Tips for Mobile Integrations + UID2 モバイルインテグレーションのトラブルシューティングに役立つ追加情報です: - [Android SDK が本番環境に接続できない](#android-sdk-cannot-connect-in-production-environment) @@ -166,4 +169,4 @@ https://prod.uidapi.com/ops/healthcheck SDK はバックグラウンドで UID2 Token をリフレッシュしようとします。IOException などのエラーが発生した場合、SDK は複数回リトライします。リトライが成功しない場合、この例外が表示されます。 -ログを有効にすると、別のトラブルシューティングステップが可能になります。詳細については、[Enable Logging](integration-mobile-client-side.md#enable-logging) を参照してください。 \ No newline at end of file +ログを有効にすると、別のトラブルシューティングステップが可能になります。詳細については、[Enable Logging](integration-mobile-client-side.md#enable-logging) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md index 1a8c7d2c2..edfea8f3d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md @@ -26,6 +26,8 @@ Prebid.js を使って UID2 とインテグレーションするには、以下 この実装には、Prebid.js version 7.53.0 以降が必要です。バージョン情報については、[https://github.com/prebid/Prebid.js/releases](https://github.com/prebid/Prebid.js/releases) を参照してください。 + + ## UID2 Prebid Module Page Prebid と UID2 のインテグレーション方法に関する情報は、以下の場所にもあります: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md index 535a19d99..3c02d887d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md @@ -86,6 +86,8 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー `POST /token/refresh` エンドポイントを使用して、常に有効で最新の UID2 Token を持つようにします。UID2 ローテーションと同期させるには、UID2 Token をリフレッシュする必要があります。さらに、トークンリフレッシュプロセスではユーザーのオプトアウトステータスをチェックし、ユーザーがオプトアウトしている場合は新しいトークンを送信しません。これによりトークンリフレッシュチェーンが終了します。その UID2 Token を二度と使用してはなりません。 +UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + | Step | Endpoint | Description | | :--- | :--- | :--- | | 3-a | N/A | ユーザーがアセットに戻り、再びアクティブになったとき、UID2 Token をリフレッシュしてから、SSP に送信します。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md index b5686f9ed..c42ca5fc4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md @@ -73,4 +73,4 @@ Maven でインストールするには、`pom.xml` ファイルに依存関係 R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。 -ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 \ No newline at end of file +ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index 2ffe5a5a2..6625aef6b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -15,6 +15,8 @@ import AttestFailure from '/docs/snippets/_private-operator-attest-failure.mdx'; UID2 Operator は、UID2 エコシステムにおける API サーバーです。AWS Marketplace で稼働する Private Operator Service の場合、UID2 Operator ソリューションは [AWS Nitro](https://aws.amazon.com/ec2/nitro/) Enclave テクノロジーで強化されています。これは、UID2 情報を不正なアクセスから保護するための追加のセキュリティ対策です。 +AWS Marketplace で稼働する Private Operator Service の場合、UID2 Operator ソリューションは [AWS Nitro](https://aws.amazon.com/ec2/nitro/) Enclave テクノロジーで強化されています。これは、UID2 情報を不正なアクセスから保護するための追加のセキュリティ対策です。 + ## UID2 Private Operator for AWS :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md index 42bbcff3c..78098309a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md @@ -18,6 +18,8 @@ UID2 Operator Confidential Containers インスタンスの Docker コンテナ 認証が成功すると、UID2 Core Service は UID2 Operator を安全な UID2 Operator Confidential Containers インスタンスにブートストラップするためのソルトやキーなどのシード情報を提供します。 +認証が成功すると、UID2 Core Service は UID2 Operator を安全な UID2 Operator Confidential Containers インスタンスにブートストラップするためのソルトやキーなどのシード情報を提供します。 + :::caution UID2 Private Operator for Azure は、次の地域ではサポートされていません: ヨーロッパ、中国。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md index 72aa0f78d..323a497c4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md @@ -12,6 +12,8 @@ import ReleaseMatrix from '/docs/snippets/_private-operator-release-matrix.mdx'; # UID2 Private Operator for GCP Integration Guide +UID2 Operator は、UID2 エコシステムの API サーバーです。詳細については、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 + このガイドでは、Google Cloud Platform（GCP）の機密コンピューティングオプションである [Confidential Space](https://cloud.google.com/confidential-computing#confidential-space) で　Private Operator　として UID2 Operator Service を設定する情報を提供します。Confidential Spaceは、Trusted Execution Environment（TEE）として知られるセキュアなクラウドベースのエンクレーブ環境で実行される、安全なクラウドベースのエンクレーブ環境です。 :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md index 4986c755f..dda6731d7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md @@ -9,6 +9,10 @@ import Link from '@docusaurus/Link'; # API Keys +:::note +いずれも、Client-Server または Server-Side の実装についての手順です。UID2 の実装が Client-Side であるか、一般に公開される場合は、異なる値を設定する必要があります。詳細については、[Client-Side Integration](client-side-integration.md) を参照してください。 +::: + UID2 Portal の **API Keys** ページでは、UID2 アカウントの API Key を管理するためのすべての操作を実行できます: - [Adding an API Key](#adding-an-api-key) @@ -20,7 +24,9 @@ UID2 Portal の **API Keys** ページでは、UID2 アカウントの API Key API Key とクライアント シークレットを使用すると、UID2 Operator Service に接続して API エンドポイントを呼び出すことができます。これらの値は、サービスに対してあなたを識別します。 -UID2 Portal で API Key を追加するときは、キーとそれに対応するシークレットを安全に保存し、これらの値が漏洩しないようにするために必要なすべての措置を講じることが重要です。詳細は [API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 +:::important +UID2 Portal で API Key を追加するときは、キーとそれに対応するシークレットを安全に保存し、これらの値が漏洩しないようにするために必要な措置をすべて講じる必要があります。詳細については、[API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 +::: 各 API Keyは、1 年ごとにローテーションすることを勧めます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md index d62357a67..6c76a58ba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md @@ -7,6 +7,10 @@ sidebar_position: 09 # Client-Side Integration +:::note +これらの手順は Client-Side の実装向けです。UID2 の実装が Client-Server または Server-Side である場合は、異なる値を設定する必要があります。詳細については、[API Keys](api-keys.md) を参照してください。 +::: + UID2 Portal では、Client-Side でトークンを生成する実装オプションを使用する場合、実装タイプに該当する以下の値を定義する必要があります: | Value | Implementation Type | Details | Documentation Link | @@ -40,6 +44,10 @@ Client-Side の実装オプションは、次の表に示すとおりです。 ## Adding and Managing Key Pairs +:::note +このキーペアによって UID2 Service に識別されますが、その値は秘密ではありません。このキーペアは安全に保管する必要はなく、共有することも可能です。これは Client-Side での実装での使用を目的としているためです。 +::: + Client-Side インテグレーションページでは、キーペアを設定および管理するための次のアクティビティを実行できます: - [Adding a Key Pair](#adding-a-key-pair) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md index e375c64fb..71874d859 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md @@ -147,4 +147,4 @@ UID2 Service を使用するには、キーのセットが必要です。Client- 現在のパスワード要件がページに表示されます。新しいパスワードを選択し、確認のためにもう一度入力し、保存してください。 -必ず覚えやすいパスワードを選択してください。 \ No newline at end of file +必ず覚えやすいパスワードを選択してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md index 52e2de55a..7dcccc5f8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md @@ -11,6 +11,10 @@ import Link from '@docusaurus/Link'; 共有権限を設定することで、他の UID2 共有参加者 と UID2 を共有できるようになります。 +:::tip +UID Portal での共有権限の設定は、tokenized sharing のためであり、raw UID2 の共有ではありません。詳細については、[UID2 Sharing Approaches](../sharing/sharing-overview.md#uid2-sharing-approaches) を参照してください。 +::: + 適切な共有関係を作成するのに役立つ多くのオプションがあります: - **Recommendations**: 1つ以上のカテゴリ (パブリッシャー、広告主、DSP、またはデータプロバイダー) の現在および将来の参加者全員と共有するための推奨を、ワンクリックで受け入れることができます。 [Add Sharing Permissions—Bulk](#add-sharing-permissionsbulk) を参照してください。 @@ -109,11 +113,10 @@ UID2 Portal で共有許可を与えるだけでなく、SDK または Snowflake - **Bulk sharing permissions**: 以前に DSP やデータプロバイダーなどの特定の参加者グループと共有することを選択した場合、そのグループとの共有許可を削除できます。 ページの **Add Permissions—Bulk** セクションで、共有を解除したい参加者グループのチェックボックスをクリアし、**Save Permissions** をクリックします。 - - **Individual sharing permissions**: ページの **Your Sharing Permissions** セクションで、共有を解除したい参加者を見つけ、Actions 列で ![the Delete icon](images/icon-trash-can-solid.png) (削除アイコン) をクリックします。 この操作は、以前に作成した個別の共有許可にのみ適用されます。一括共有を介して共有許可を追加した場合、個別の共有許可を削除することはできません。共有許可を削除するには、追加した方法と同じ方法で削除する必要があります。 :::note 共有許可を削除すると、次回参加者が復号鍵を更新すると、その参加者との共有が解除されます。即時ではありませんが、迅速に行われます。詳細については、[Decryption Key Refresh Cadence for Sharing](../sharing/sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) を参照してください。 -::: \ No newline at end of file +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md index 005c1c50e..10b95c2ac 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md @@ -355,6 +355,7 @@ import Link from '@docusaurus/Link';
Public key
Client-Side のパブリッシャーインテグレーションでは、パブリッシャーに発行される2つの値のうちの1つがアカウントを一意に識別する公開鍵です。d詳細は Subscription ID and Public Key を参照してください。
+
UID2 のインテグレーションでは、この値はしばしば serverPublicKey として表されます。たとえば、UID2 Client-Side Integration Guide for Prebid.js、Client-Side Integration Guide for JavaScript、UID2 Client-Side Integration Guide for Mobile など。
Public Operator
Public Operator は、UID2 Operator Service のパブリックインスタンスを実行する組織です。たとえば、The Trade Desk は現在、UID2 フレームワークの Public Operator として機能しており、すべての参加者が利用できます。
@@ -374,6 +375,7 @@ import Link from '@docusaurus/Link';
Refresh tokenは、UID2 Tokenとともに発行される不透明な文字列です。UID2 token の有効期限を更新するために使用されます。
UID2 Server は、新しい UID2 Token のリクエストとともに Refresh Token を受け取ると、ユーザーの Opt-Out をチェックします。ユーザーが UID2 を Opt-Out している場合、新しい UID2 Token は生成されません。
新しい UID2 Token が生成されて返されると、新しい Refresh Token も一緒に返されます。ただし、ユーザーが長期間活動していない場合は、Refresh Token は期限切れとなります。
+
詳細は、UID2 Tokens and Refresh Tokens を参照してください。
### S diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md index 6ae5486e7..2c14047ed 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md @@ -191,4 +191,4 @@ Identity 変数は、SDK によって管理されている現在の UID2Identity #### identityStatus -identityStatus変数は、SDKが管理している現在のUID2 Identityのステータスを格納し、返します。 \ No newline at end of file +identityStatus変数は、SDKが管理している現在のUID2 Identityのステータスを格納し、返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 31d228935..9909e231b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -39,7 +39,7 @@ UID2 Identify Module、または UID2 サポートのある他の製品と Prebi | :--- | :--- | :--- | :--- | :--- | :--- | | — | — | ✅ | ✅ | — | — | -## Sample Implementation Website +## Sample Implementation サンプルアプリケーションと関連するドキュメントは以下を参照してください: - The UID2 Google Secure Signals with SDK v3 example: @@ -599,4 +599,4 @@ window.__uid2.callbacks.push((eventType) => { `async` または `defer` スクリプトローディングを使用する場合は、SDK をロードするスクリプトタグをドキュメントヘッダに移動し、適切なキーワードを追加してください。 -`async` または `defer` スクリプトローディングを使用するかどうかは、個々のウェブサイトに依存するため、UID2 チームがアドバイスを提供できるものではありません。よくわからない場合は、この変更を無視して script タグを変更しないままにしておくのが安全です。 \ No newline at end of file +`async` または `defer` スクリプトローディングを使用するかどうかは、個々のウェブサイトに依存するため、UID2 チームがアドバイスを提供できるものではありません。よくわからない場合は、この変更を無視して script タグを変更しないままにしておくのが安全です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md index b7e14efd7..341403ad9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md @@ -381,4 +381,4 @@ python3 -m unittest discover -s ./tests/ ## FAQs -DSP に関するよくある質問については、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 \ No newline at end of file +DSP に関するよくある質問については、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 From e82dea2e465a441d11a13823a2d1a23ae750ed68 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 17 Dec 2024 16:35:31 +0900 Subject: [PATCH 16/20] Checks for translation omissions --- .../current/sdks/sdk-ref-javascript-v2.md | 2 +- .../current/sdks/sdk-ref-javascript.md | 38 +++++++++++++++++-- 2 files changed, 36 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md index 992bd5eec..2e956b7bc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md @@ -336,4 +336,4 @@ UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-g :::important `private` オブジェクトの内容は明示的に指定されておらず、SDK が解釈するようになっています。このオブジェクトの構造、セマンティクス、互換性について、いかなる仮定もしないでください。クッキーの更新はその構造を保持しなければなりません。 -::: +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 9909e231b..816b0ac0e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -15,6 +15,14 @@ export const New = () => ( NEW IN V3 ); +export const New3100 = () => ( + New in version 3.10.0 +); + +export const Deprecated3100 = () => ( + Deprecated in version 3.10.0 +); + # SDK for JavaScript Reference Guide この SDK を使用して、UID2 を使用したクライアント ID の生成または確立、ターゲティング広告用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。 @@ -261,6 +269,7 @@ SDK for JavaScript とのすべてのインストラクションは、グロー - [getAdvertisingToken()](#getadvertisingtoken-string) - [getAdvertisingTokenAsync()](#getadvertisingtokenasync-promise) - [isLoginRequired()](#isloginrequired-boolean) +- [isIdentityAvailable()](#isidentityavailable-boolean) - [disconnect()](#disconnect-void) - [abort()](#abort-void) - [callbacks](#callbacks) @@ -422,7 +431,26 @@ UID2 ログイン [POST /token/generate](../endpoints/post-token-generate. | :--- | :--- | | `true` | ID が利用できません。この値は以下のいずれかを示します:
  • ユーザーがオプトアウトした。
  • Refresh token の有効期限が切れた。
  • ファーストパーティクッキーは利用できず、サーバーで生成した ID も提供されていません。
| | `false` | この値は以下のいずれかを示します:
  • ID が存在し、有効。
  • ID の有効期限が切れており、断続的なエラーによりトークンがリフレッシュされなかった。
  • ID の有効期限が切れており、断続的なエラーによりトークンがリフレッシュされなかった。
| -| `undefined` | SDK の初期化はまだ完了していません。 | + +### isIdentityAvailable(): boolean + + + +Identity が利用可能かどうかを判断します。たとえば、ローカルストレージまたはクッキーに有効な ID があるか、またはすでに ID がリクエストされているかどうかを判断します。 + +もし false であれば、UID2 [POST /token/generate](../endpoints/post-token-generate.md) 呼び出しが必要です。 + +```html + +``` +#### Return Values + +| Value | Description | +| :--- | :--- | +| `true` | この値は、以下のいずれかを示します:
  • ファーストパーティクッキーまたはローカルストレージに ID が存在し、有効です。
  • ID の有効期限が切れており、断続的なエラーによりトークンがリフレッシュされませんでした。成功した自動リフレッシュ試行の後、ID が復元される可能性があります。
| +| `false` | この値は、以下のいずれかを示します:
  • ユーザーがオプトアウトしています。
  • ID が存在しますが、リフレッシュトークンが期限切れです。
  • ID が期限切れで、リフレッシュトークンが有効でもリフレッシュされませんでした。
  • ファーストパーティクッキーが利用できず、サーバーで生成された ID も提供されていません。
| ### disconnect(): void @@ -444,9 +472,13 @@ SDK が正しいクッキーにアクセスするために `cookieDomain` また ### abort(): void -バックグラウンドのタイマーやリクエストを終了します。UID2 オブジェクトは指定されていない状態のままで、これ以上使用することはできません。 + + +この機能は非推奨であり、2025 年 6 月に完全に削除されます。代わりに、`abort()` と同じ機能を持つ [disconnect()](#disconnect-void) を使用してください。また、より徹底的な切断ロジックも含まれています。 + +バックグラウンドタイマーやリクエストを終了します。UID2 オブジェクトは未指定の状態になり、もはや使用できません。 -この関数は、既存の UID2 オブジェクトを新しいインスタンスで置き換えるような高度なシナリオで使用するためのものです。 +この機能は、既存の UID2 オブジェクトを新しいインスタンスで置き換えたい場合など、高度なシナリオで使用することを意図しています。 ### callbacks From 2dd29f1218c9d7d60ad298dfb4cf7ece59f379b5 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Wed, 18 Dec 2024 06:30:32 +0900 Subject: [PATCH 17/20] fix: brocken link --- .../current/guides/integration-liveramp-tips.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md index b91a5ff79..c5c3a91e3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md @@ -15,8 +15,8 @@ LiveRamp Authenticated Traffic Solution (ATS) をすでに使用しているパ LiveRamp ATS を使用して、UID2 Token を生成するには、LiveRamp の担当者に連絡し、以下のインテグレーションポイントを確認してください: -- [Enable RideAlong](#enable-ridealong) -- [Implement the Correct Hashing Methodology](#implement-the-correct-hashing-methodology) +- [Enable RideAlong](#enable-uid2-as-an-interoperable-id) +- [Implement the Correct Hashing Methodology](#implement-the-uid2-hashing-methodology) - [Set Envelope Refresh to 1800 Seconds](#set-envelope-refresh-to-1800-seconds) ## Enable UID2 as an Interoperable ID From b136855a6bdbb8a5e0d9a42f3d9621e78677437c Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Wed, 18 Dec 2024 06:37:52 +0900 Subject: [PATCH 18/20] Minor mod --- .../current/getting-started/gs-faqs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md index c4565f838..bbce339c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md @@ -164,7 +164,7 @@ UID2 フレームワークを使用する広告主やデータプロバイダー - [更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？](#do-refreshed-emails-get-assigned-to-the-same-bucket-with-which-they-were-previously-associated) - [インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか？](#how-often-should-uid2s-be-refreshed-for-incremental-updates) - [マッピング用の DII の SHA-256 はどのように生成すればよいですか？](#how-should-i-generate-the-sha-256-of-dii-for-mapping) -- [大量のメールアドレスや電話番号やそれらのハッシュマッピングを保存すべきか？](#should-i-store-mapping-of-email-addresses-phone-numbers-or-corresponding-hashes-to-raw-uid2s-in-my-own-datasets) +- [メールアドレス、電話番号、または対応するハッシュと raw UID2 のマッピングを、自身のデータセットに保存すべきでしょうか？](#should-i-store-mapping-of-email-addresses-phone-numbers-or-corresponding-hashes-to-raw-uid2s-in-my-own-datasets) - [ユーザーのオプトアウトはどのように処理すればよいですか？](#how-should-i-handle-user-opt-outs) - [同じ DII は常に同じ生UID2になりますか？](#does-the-same-dii-always-result-in-the-same-raw-uid2) - [2 つの Operator が同じ DII を処理した場合、結果は同じになりますか？](#if-two-operators-process-the-same-dii-are-the-results-the-same) @@ -200,7 +200,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 システムは[メールアドレス正規化ルール](../getting-started/gs-normalization-encoding#email-address-normalization)に従って、salt せずにハッシュ化する必要があります。 #### Should I store mapping of email addresses, phone numbers, or corresponding hashes to raw UID2s in my own datasets? -大量のメールアドレスや電話番号やそれらのハッシュマッピングを保存すべきか？ +メールアドレス、電話番号、または対応するハッシュと raw UID2 のマッピングを、自身のデータセットに保存すべきでしょうか？ はい。何百万ものメールアドレスや電話番号をマッピングする必要がある場合、マッピングを保存しないことで処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングだけを再計算すると、毎日更新する必要があるのは UID2 の約 365 分の 1 なので、総処理時間が短縮されます。 From 58c3891ca17d5b862ecfcfe908a1cc032aafe0d1 Mon Sep 17 00:00:00 2001 From: genwhittTTD Date: Tue, 17 Dec 2024 17:13:46 -0500 Subject: [PATCH 19/20] resolve merge conflicts --- .../current/guides/integration-prebid-mobile-summary.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md index 6e333d0fb..21823c419 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-mobile-summary.md @@ -15,5 +15,5 @@ Prebid Mobile SDK Android モバイルデバイスでの UID2 インテグレー 詳細は以下のモバイルインテグレーションガイドのセクションを参照してください: -- [UID2 Client-Side Integration Guide for Mobile: Prebid Integration](integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) -- [UID2 Client-Server Integration Guide for Mobile: Prebid Integration](integration-mobile-client-server#optional-uid2-prebid-mobile-sdk-integration) +- [UID2 Client-Side Integration Guide for Mobile: Prebid Integration](integration-mobile-client-side#optional-uid2-integration-with-prebid-mobile-sdk) +- [UID2 Client-Server Integration Guide for Mobile: Prebid Integration](integration-mobile-client-server#optional-uid2-integration-with-prebid-mobile-sdk) \ No newline at end of file From 0e11c2ac75abca2b3144450d893bc0d8cb8b2844 Mon Sep 17 00:00:00 2001 From: genwhittTTD Date: Tue, 17 Dec 2024 17:27:20 -0500 Subject: [PATCH 20/20] fix link issue in an English file --- docs/getting-started/gs-credentials.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/gs-credentials.md b/docs/getting-started/gs-credentials.md index 330861399..ec19025d4 100644 --- a/docs/getting-started/gs-credentials.md +++ b/docs/getting-started/gs-credentials.md @@ -42,7 +42,7 @@ Notes: If you're using a client-server or server-side implementation (see [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) or [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md)), the API key and client secret allow you to connect to the Operator Service and call API endpoints. These values identify you to the service. Here is some information about API keys and client secrets: -- You must keep these values secure. For details, see [Security of API Key and Client Secret] +- You must keep these values secure. For details, see [Security of API Key and Client Secret](#security-of-api-key-and-client-secret). - One UID2 participant can have multiple keys. - Each key has a set of [permissions](gs-permissions.md) that determine the endpoints you can use it on. - Each key has a corresponding client secret.