From 6cb2b3efedff5a2d98e76d68c3f1cec77fa520fe Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 10:19:09 +0900 Subject: [PATCH 01/14] UID2 Snowflake doc improvements --- .../current/guides/integration-snowflake.md | 43 +++++++++++++------ 1 file changed, 30 insertions(+), 13 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md index 9856043d4..8ec8bf927 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md @@ -74,26 +74,43 @@ The following table shows the differences between the old and new identity mappi | パートナーとして、データをホストし、UID2 インテグレーションに参加するための Snowflake アカウントをセットアップします。UID2 Share を通じて関数とビューを消費します。 | UID2 インテグレーションは、Snowflake アカウントでホストされ、UID2 関連のタスクを実行するために必要なデータのみを引き出す認可された関数とビューへのアクセスを提供します。プライベートテーブルにはアクセスできません。UID2 Share は、UID2 関連のタスクを実行するために必要な基本的なデータのみを公開します。
**Note**: Salt と暗号化キーはプライベートテーブルに保存されています。DII はどの時点でも保存されません。 | ETL (Extract Transform Load) ジョブは、UID2 Core/Optout Snowflake ストレージを常に更新し、UID2 Operator Web サービスを動かす内部データを提供します。Operator Web サービスで使用されるデータは、UID2 Share を通じても利用可能です。 | | 共有関数とビューを使用すると、トランザクションコンピューティングコストを Snowflake に支払います。 | これらのプライベートテーブルは、UID2 Snowflake アカウントで保護され、UID2 関連のタスクを完了するために使用される内部データを保持する UID2 Core/Optout Snowflake ストレージと自動的に同期します。 | | -## Access the UID2 Share - -UID2 Share へのアクセスは、[Snowflake Data Marketplace](https://www.snowflake.com/data-marketplace/) の以下のリスティングを通じて利用可能です: - -- [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) +## Summary of Integration Steps :::important データのリクエストを行うには、`ACCOUNTADMIN` ロールまたは Snowflake アカウントで `CREATE DATABASE` および `IMPORT SHARE` 権限を持つ他のロールを使用する必要があります。 ::: -UID2 Share へのアクセスをリクエストするには、以下の手順を完了します: +以下のリストは、本番環境での Snowflake における UID2 マッピングのインテグレーション手順をまとめたものです: + +:::note +本番環境を使用する前にインテグレーションを試してみたい場合は、[Testing in the Integ Environment](#testing-in-the-integ-environment)を参照してください。 +::: + +1. UID2 POC が UID2 担当者によって署名されていることを確認してください。担当者がわからない場合は、[Contact Info](../getting-started/gs-account-setup.md#contact-info)を参照してください。 + +1. UID2 Share へのアクセスをリクエストします: + + - [Snowflake Marketplace Listing](#snowflake-marketplace-listing) でアクセスをリクエストします。リクエストには、Snowflake アカウント番号とリージョンを含めてください。 + + - UID2 担当者にアクセスをリクエストしたことを伝えてください。 + +1. UID2 担当者が、UID2 mapping share へのアクセスをあなたの Snowflake アカウントにプロビジョニングします。 + +:::note +初期のテストを行った場合（[Testing in the Integ Environment](#testing-in-the-integ-environment)を参照）、関数を本番の UID2 Share に更新し、関連するテーブル名も更新してください。 +::: + +## Testing in the Integ Environment + +UID2 POC に署名する前に mapping share をテストしたい場合は、UID2 担当者に integ (インテグレーション) 環境の Snowflake シェアへのアクセスをリクエストできます。この環境はテスト専用であり、本番データはありません。リクエストには、アカウント番号とリージョンを必ず含めてください。 + +このシナリオでは、以下の手順が実行されます: + +1. UID2 担当者がSnowflakeプライベートマーケットプレイスにシェアリスティングをプロビジョニングし、このステップが完了したら知らせます。 -1. Snowflake Data Marketplace にログインし、UID2 リスティングを選択します: - - [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) -2. **Personalized Data** セクションで、**Request Data** をクリックします。 -3. 画面の指示に従って、連絡先の詳細やその他の必要な情報を確認して提供します。 -4. The Trade Desk の既存のクライアントである場合は、データリクエストフォームの **Message** フィールドに The Trade Desk によって発行されたパートナーおよび広告主 ID を含めてください。 -5. フォームを送信します。 +2. その後、プライベートマーケットプレイスのリスティングを表示し、integ シェアへのアクセスをリクエストできます。 -リクエストが受信されると、UID2 Administrator が適切なアクセス手順について連絡します。Snowflake でのデータリクエストの管理に関する詳細は、[Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html)を参照してください。 +3. アクセスをリクエストすると、UID2 担当者が integ シェアをあなたのアカウントにプロビジョニングします。 ## Shared Objects From ef41deb7a2fb52b46fc5b54fa03270899ff0cbd9 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 10:42:43 +0900 Subject: [PATCH 02/14] mods to SDK summary, endpoints summary --- .../current/endpoints/summary-endpoints.md | 12 ++ .../current/sdks/summary-sdks.md | 109 ++++++++++++++++-- 2 files changed, 113 insertions(+), 8 deletions(-) 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 b86c28f4e..64a56df99 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 @@ -12,6 +12,18 @@ import Link from '@docusaurus/Link'; すべての UID2 エンドポイントでは、API リクエストの暗号化([POST /token/refresh](post-token-refresh.md) を除く) とレスポンスの復号化にクライアントシークレットが必要です。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 +## UID2 Endpoints by Audience + +以下の表は、UID2 エンドポイントと各エンドポイントの対象ユーザーを示しています。詳細については、該当するセクションをクリックしてください。 + +| Endpoint | Audience | Details | +| :--- | :--- | :--- | +| [POST /token/generate](post-token-generate.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) | +| [POST /token/validate](post-token-validate.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) | +| [POST /token/refresh](post-token-refresh.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) | +| [POST /identity/map](post-identity-map.md) | 広告主、データプロバイダー | [Identity Map](#identity-map) | +| [POST /optout/status](post-optout-status.md) | 広告主、データプロバイダー、DSP、共有者 | [Opt-Out Status](#opt-out-status)| + ## UID2 Tokens 以下のエンドポイントは、UID2 Token (identity tokens, advertising tokens) を取得および管理するためのもので、主にパブリッシャーが使用します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/summary-sdks.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/summary-sdks.md index edaf41fac..c4461e549 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/summary-sdks.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/summary-sdks.md @@ -16,17 +16,110 @@ SDK の機能を確認して使用する SDK を決定し、SDK の表をクリ ## SDK Functionality -次の表は、各 SDK で利用可能な機能をまとめたものです。 +以下の表は、各 SDK で利用可能な機能をまとめたものです。 -| UID2 SDK for... | Client-Side or Server-Side | Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s* | Monitor Rotated Salt Buckets | + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Audience  > > >パブリッシャー広告主 / データプロバイダーDSP
SDK for...Client-Side or Server-SideGenerate UID2 Token from DIIRefresh UID2 TokenMap DII to Raw UID2s*Monitor Rotated Salt Buckets**Encrypt Raw UID2 to UID2 Token for SharingDecrypt UID2 Token to Raw UID2
JavaScriptClient✅✅————
JavaServer✅✅✅—✅✅
PythonServer✅✅✅✅✅✅
C# / .NETServer————✅✅
C++Server————✅✅
AndroidClient (Mobile)✅✅————
iOSClient (Mobile)✅✅————
*DII から raw UID2 を生成する必要がある広告主およびデータプロバイダは Snowflake ([Snowflake Integration Guide](../guides/integration-snowflake.md) を参照) または [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントを使用することができます。 From f0eee6ca30e7a8264717b4cdd9270cc413140809 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 10:58:04 +0900 Subject: [PATCH 03/14] FAQ add re prebid android atype value --- .../current/getting-started/gs-faqs.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) 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 ab06b1be7..58e9dd6db 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 @@ -82,6 +82,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ - [UID2 Token の一意性とローテーションポリシーは何ですか？](#what-is-the-uniqueness-and-rotation-policy-for-uid2-tokens) - [UID2 Token は、ビッドストリームではどのように見えますか？](#what-does-a-uid2-token-look-like-in-the-bidstream) - [UID2 をシングルサインオン (SSO) とインテグレーションすることはできますか？](#can-i-integrate-uid2-with-single-sign-on-sso) +- [Prebid をモバイル SDK と一緒に使用しています—atype 値は何を使用すればよいですか？](#im-using-prebid-with-a-mobile-sdkwhat-atype-value-should-i-use) #### How can I test that the DII sent and the returned token match up? 送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか？ @@ -176,6 +177,17 @@ UID2 をシングルサインオン (SSO) とインテグレーションする はい。Google、Facebook ログイン、Apple ログイン、または OpenPass などの人気のある SSO インテグレーションオプションを使用すると、メールアドレスを取得して UID2 を生成できます。 詳細は、[Publisher Integration with SSO Providers](../ref-info/ref-integration-sso-providers.md) を参照してください。 +#### I'm using Prebid with a Mobile SDK—what atype value should I use? +Prebid をモバイル SDK と一緒に使用しています—atype 値は何を使用すればよいですか？ + +IAB のドキュメントによると、`atype` (エージェントタイプ) 値は、マッチがどのタイプのユーザーエージェントからのものであるかを示します。IAB はこのプロパティを定義することを推奨しています。 + +Prebid を [SDK for Android](../sdks/sdk-ref-android.md) または [SDK for iOS](../sdks/sdk-ref-ios.md) と一緒に使用している場合、`atype` 値として `3` を使用します。これは、個人ベースの ID を示します。 + +詳細は、以下の IAB ドキュメントのセクションを参照してください: +- [Object: Extended Identifier UIDs](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#object_eid_uids) +- [List: Agent Types](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list_agenttypes) + ## FAQs for Advertisers and Data Providers UID2 フレームワークを使用する広告主やデータプロバイダーによくある質問を紹介します。 From 63936f11c79ee046dd1a32691377dcb5de58f7fc Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:03:34 +0900 Subject: [PATCH 04/14] POST /identity/map, update resources section --- .../current/endpoints/post-identity-map.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 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 c68974cb3..fcb490009 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 @@ -290,11 +290,13 @@ remap_identities(to_remap) ``` ### Additional Resources -- [SDK for Java](../sdks/sdk-ref-java.md) Java 実装 (Advertisers/Data Providers section を参照) - +Identity mapping の一般的な情報については、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 - +特定の SDK の移行ガイダンスについては、以下を参照してください: +- SDK for Python Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-python.md#usage-for-advertisersdata-providers) section +- SDK for Java Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) section -ID マッピングの一般的な情報は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 +Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 + + \ No newline at end of file From 3e2084043a6c010bc48ce06ade441e74728a184d Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:05:21 +0900 Subject: [PATCH 05/14] remove comment --- .../current/endpoints/post-identity-map.md | 4 +--- 1 file changed, 1 insertion(+), 3 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 fcb490009..9c6ea512a 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 @@ -297,6 +297,4 @@ Identity mapping の一般的な情報については、[Advertiser/Data Provide - SDK for Python Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-python.md#usage-for-advertisersdata-providers) section - SDK for Java Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) section -Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 - - \ No newline at end of file +Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 \ No newline at end of file From b4a3c828d387aca0eb386f4037a575ae055e8c78 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:10:46 +0900 Subject: [PATCH 06/14] Add intro copy in Java SDK doc section --- .../current/sdks/sdk-ref-java.md | 4 ++++ 1 file changed, 4 insertions(+) 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 3d6283c8e..ceb29477d 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 @@ -309,6 +309,10 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in ## Usage for Advertisers/Data Providers +以下のの手順は、最新バージョンの `POST /identity/map` エンドポイントを使用して DII を raw UID2 にマップする方法の例です。 + +以前のバージョンを使用する場合は、[Previous SDK Version (using POST /identity/map v2)](#previous-sdk-version-using-post-identitymap-v2) を参照してください。最新バージョンへの移行手順については、[Migration From Version Using v2 Identity Map](#migration-from-version-using-v2-identity-map) を参照してください。 + 1. IdentityMapClient のインスタンスをインスタンス変数として作成します: ```java final private IdentityMapV3Client identityMapV3Client = new IdentityMapV3Client(UID2_BASE_URL, UID2_API_KEY, UID2_SECRET_KEY); From e88a64c7e90051f0451e7c16a95ed8c2ec14ed41 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:31:23 +0900 Subject: [PATCH 07/14] Create sample sites reference page --- .../current/guides/summary-guides.md | 2 ++ .../ref-info/integration-sample-sites.md | 30 +++++++++---------- 2 files changed, 17 insertions(+), 15 deletions(-) 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 8473476df..12231cce1 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 @@ -31,6 +31,8 @@ import Link from '@docusaurus/Link'; - [Prebid Integrations](#prebid-integrations) - [Google Ad Manager Integrations](#google-ad-manager-integrations) +ソースコード付きのライブで動作する UID2 実装の例については、[UID2 Integration Samples](../ref-info/integration-sample-sites.md) を参照してください。 + ### Web Integrations パブリッシャーの Web インテグレーションには、以下のドキュメントリソースが利用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 3d20d810a..dd0fd50dd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -1,6 +1,6 @@ --- title: Integration Samples and Tools -description: Overview and reference for all UID2 sample site examples. +description: UID2 のすべてのサンプルサイト例の概要とリファレンス。 hide_table_of_contents: false --- @@ -8,15 +8,15 @@ import Link from '@docusaurus/Link'; # Integration Samples and Tools -This page lists all official UID2 sample implementations highlighting common integration use cases, along with links to live demo sites, source code, and related documentation. Use this page to quickly identify which sample matches your needs and explore working examples. +このページでは、一般的なインテグレーションのユースケースを強調するすべての公式 UID2 サンプル実装のリストと、ライブデモサイト、ソースコード、および関連ドキュメントへのリンクを示します。このページを使用して、ニーズに合ったサンプルを見つけて、動作する例を調べてください。 ## Web Integrations -This section summarizes the sample integrations available for publishers who want to integrate UID2 directly into their websites. For a full summary of integration options for websites, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web). +このセクションでは、UID2 を直接ウェブサイトに統合したいパブリッシャー向けのサンプル統合をまとめています。ウェブサイト向けの統合オプションの完全な概要については、[Publisher Web Integration Overview](../guides/integration-options-publisher-web) を参照してください。 ### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript) to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements. +このサンプルは、[SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript) を使用してブラウザ内で直接トークンを生成および管理する完全なクライアントサイド統合を好むパブリッシャー向けです。このアプローチは、最小限のバックエンド要件で迅速なプロトタイピングに最適です。 - Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://cstg-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) @@ -24,7 +24,7 @@ This sample is for publishers who prefer a fully client-side integration using t ### Client-Server Integration Using UID2 SDK for JavaScript -This sample is for publishers who want more control over UID2 token creation (handled on your servers), while using the SDK for JavaScript on the client side to manage and refresh tokens in the browser. +このサンプルは、UID2 Token の作成をより細かく制御したいパブリッシャー向けです（サーバー側で処理されます）。クライアント側では JavaScript SDK を使用して、ブラウザ内のトークンを管理および更新します。 - Site: [UID2 SDK Integration Example](https://example-jssdk-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) @@ -32,7 +32,7 @@ This sample is for publishers who want more control over UID2 token creation (ha ### UID2 Server-Only (Server-Side) -This sample is for publishers who want all UID2 operations to occur on the server side, offering maximum control, security, and flexibility without relying on a client-side SDK. +このサンプルは、すべての UID2 操作をサーバー側で実行し、クライアント側の SDK に依存せずに最大の制御、セキュリティ、および柔軟性を提供したいパブリッシャー向けです。 - Site: [Server-Only UID2 Integration Example](https://example-srvonly-integ.uidapi.com/login) - Code: [uid2-examples/publisher/server_only](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only) @@ -40,11 +40,11 @@ This sample is for publishers who want all UID2 operations to occur on the serve ## Prebid.js Integrations -This section includes a sample page for generating UID2 tokens to be passed by Prebid.js in the RTB bidstream. For details, see [UID2 Integration Overview for Prebid](../guides/integration-prebid). +このセクションには、RTB ビッドストリームで Prebid.js によって渡される UID2 Token を生成するためのサンプルページが含まれています。詳細については、[UID2 Integration Overview for Prebid](../guides/integration-prebid) を参照してください。 ### Client-Side Integration with Prebid.js -This sample is for publishers who want to generate UID2 tokens on the client side and pass them into header bidding auctions using Prebid.js. +このサンプルは、クライアント側で UID2 Tokenを生成し、Prebid.js を使用してヘッダービディングオークションに渡したいパブリッシャー向けです。 - Site: [UID2 Prebid.js Client-Side Integration Example](https://unifiedid.com/examples/cstg-prebid-example/) - Code: [uid2docs/static/examples/cstg-prebid-example](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example) @@ -52,11 +52,11 @@ This sample is for publishers who want to generate UID2 tokens on the client sid ## Google Secure Signals Integrations -This section includes sample pages for passing UID2 identity data to Google's advertising systems through their Secure Signals feature. For details, see [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss). +このセクションには、Google の広告システムに UID2 アイデンティティデータを Secure Signals 機能を通じて渡すためのサンプルページが含まれています。詳細については、[Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss) を参照してください。 ### Client-Side Secure Signals -This sample is for publishers who want a purely client-side integration with GAM Secure Signals. +このサンプルは、GAM Secure Signals との純粋なクライアントサイド統合を望むパブリッシャー向けです。 - Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK, Secure Signals](https://secure-signals-client-side-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/google-secure-signals-integration/client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/client_side) @@ -64,7 +64,7 @@ This sample is for publishers who want a purely client-side integration with GAM ### React Client-Side Secure Signals -This sample is for publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. +このサンプルは、React アプリを持つパブリッシャー向けで、UID2 と Secure Signals をコンポーネントベースのアーキテクチャに直接統合したい場合のものです。 - Site: [UID2 React Client-Side Integration Example with Google Secure Signals](https://secure-signals-react-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/google-secure-signals-integration/react_client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/react_client_side) @@ -72,7 +72,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur ### Server-Side Secure Signals -This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. +このサンプルは、より良い制御とセキュリティのために、すべての Secure Signals および UID2 ロジックをサーバー側で実行したいパブリッシャー向けです。 - Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-server-side-integ.uidapi.com/login) - Code: [uid2-web-integrations/examples/google-secure-signals-integration/server_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_side) @@ -83,7 +83,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- ### Client-Server Secure Signals -This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. +このサンプルは、トークン生成をサーバー側で行い、Secure Signals のロジックをクライアント側で実行するハイブリッドアプローチを望むパブリッシャー向けです。 - Site: [Example for Client-Server UID2 SDK Integration with Google Secure Signals](https://secure-signals-client-server-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) @@ -94,12 +94,12 @@ This sample is for publishers who want a hybrid approach with token generation o ## UID2 Hashing Tool -This tool is for developers or clients validating data preparation, such as hashing and normalization of emails before token requests. The tool is available at the following links: +このツールは、トークンリクエスト前のメールのハッシュ化や正規化など、データ準備を検証する開発者またはクライアント向けです。ツールは以下のリンクで利用できます： - Site: [UID2 Hashing Tool](https://unifiedid.com/examples/hashing-tool/) - Code: [uid2Docs/static/examples/hashing-tool](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/hashing-tool) - Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding) :::note -The sample sites in this file highlight some common integrations, but do not represent all available UID2 integration options. For a summary of all the integration options available, see [UID2 Integration Guides: Summary](../guides/summary-guides). +このファイルのサンプルサイトは、一般的なインテグレーションのいくつかを強調していますが、利用可能なすべての UID2 インテグレーションオプションを表しているわけではありません。利用可能なすべてのインテグレーションオプションの概要については、[UID2 Integration Guides: Summary](../guides/summary-guides) を参照してください。 ::: From 6382dd26db7d176fe497dbba0eaa057fa9c4932a Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:51:30 +0900 Subject: [PATCH 08/14] Update Python SDK documentation with version-specific Python requirement --- .../current/sdks/sdk-ref-python.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) 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 ec297f81b..80f338c58 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 @@ -38,7 +38,12 @@ DSP の場合は、資格情報を送信します。 ## Version -この SDK には Python 3.6 以降が必要です。 +サポートされる Python の最小バージョンは、[UID2 SDK for Python](https://pypi.org/project/uid2-client/) のバージョンによって異なります。 +version: + +- **v2.8.0+**: Python 3.10 or higher +- **v2.6.0**: Python 3.8 or higher +- **v2.5.0 and below**: Python 3.6 or higher ## GitHub Repository/Package @@ -50,6 +55,11 @@ DSP の場合は、資格情報を送信します。 - [https://pypi.org/project/uid2-client/](https://pypi.org/project/uid2-client/) +## Release Notes + +For detailed information about changes, bug fixes, and new features in each release, see the [release notes on GitHub](https://github.com/IABTechLab/uid2-client-python/releases). +各リリースの変更点、バグ修正、新機能の詳細については、[release notes on GitHub](https://github.com/IABTechLab/uid2-client-python/releases) を参照してください。 + ## Installation SDK をインストールするには、[Pip](https://packaging.python.org/en/latest/guides/tool-recommendations/#installing-packages) パッケージマネージャを使用します。 From eccf8aca18631a90b0c757ff3ef8010471a5b3cd Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 11:56:41 +0900 Subject: [PATCH 09/14] environments, add info re UID2s are different --- .../current/getting-started/gs-environments.md | 1 + 1 file changed, 1 insertion(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md index dedc498e6..07b3e3a16 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md @@ -33,6 +33,7 @@ Notes: - すべての UID2 エンドポイントは同じベース URL を使用します。 - インテグレーション環境と本番環境では、異なる API Key が必要です。各環境用の認証情報の取得方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 - [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントまたは [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントで返される UID2 Token の有効期限は変更される可能性がありますが、常にインテグレーション環境では本番環境よりもはるかに短くなります。 +- インテグレーション環境と本番環境では異なる UID2 値が生成されます。相互に使用することはできません。インテグレーション環境はテスト専用に使用してください。本番稼働の準備ができたら、ビッドストリームで使用する UID2 を生成してください。 ## Getting Credentials for Each Environment From e954a738f5c54c214219f2d123450c44429c0658 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 13:11:18 +0900 Subject: [PATCH 10/14] Private Operator docs, add info re rotating the keys --- .../integration-options-private-operator.md | 5 +++++ .../current/guides/operator-guide-aks-enclave.md | 6 +++++- .../guides/operator-guide-aws-marketplace.md | 4 ++++ .../guides/operator-guide-azure-enclave.md | 8 ++++++-- .../operator-private-gcp-confidential-space.md | 16 ++++++++++------ .../_snpt-private-operator-rotating-the-keys.mdx | 8 ++++++++ 6 files changed, 38 insertions(+), 9 deletions(-) create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-rotating-the-keys.mdx diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md index 9c2b14fb2..11cb1976a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md @@ -7,6 +7,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; +import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; # UID2 Private Operator Integration Overview @@ -93,6 +94,10 @@ Private Operator にはいくつかの制限があります: +## Keeping the Operator Key Secure + + + ## Getting Started Private Operator を開始するには、次の手順に従います: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md index ffa53ab76..eb0581998 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md @@ -10,7 +10,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for AKS Integration Guide @@ -472,3 +472,7 @@ ASK 用の UID2 Private Operator の新しいバージョンがリリースさ ``` kubectl get pods ``` + +## Keeping the Operator Key Secure + + \ 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 654d1b654..bb0a74e7a 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 @@ -11,6 +11,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for AWS Integration Guide @@ -359,6 +360,9 @@ logrotate のドキュメントに従って指示に従ってください: [logr | スケジュールされた間隔を変更することなく、手動で `logrotate` を1回実行します。 | `sudo logrotate -f /etc/logrotate.conf --force` | | `syslog-ng` をリロードします。 | `sudo /usr/sbin/syslog-ng-ctl reload` | +## Keeping the Operator Key Secure + + ## UID2 Operator Error Codes 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 fc9b94fcd..5a9fb2322 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 @@ -10,7 +10,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for Azure Integration Guide @@ -337,6 +337,10 @@ UID2 Azure Confidential Containers の新しいバージョンがリリースさ for i in {0..COUNT}; az container delete --name uid-operator-OLD-VERSION-$i --resource-group {RESOURCE_GROUP} --yes ``` +## Keeping the Operator Key Secure + + + ## UID2 Operator Error Codes 以下の表は、Private Operator 起動シーケンス中に発生する可能性のあるエラーを一覧表示しています。 @@ -352,4 +356,4 @@ Private Operator 起動時のエラーコードは、リリース v5.49.7 以降 | E04 | ConfigurationValueError | 構成値が無効です。構成値が必要な形式と環境に一致していることを確認してください。Note: `debug_mode = true` は `integ` 環境でのみ許可されます。詳細はログを確認してください。 | | E05 | OperatorKeyValidationError | Operator Key が環境に適しており、提供されたものと一致していることを確認してください。 | | E06 | UID2ServicesUnreachableError | UID2 Core および Opt-out サービスの IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスと DNS の詳細は、ログを参照してください。 | -| E08 | OperatorKeyPermissionError | コンテナを起動するマネージド ID (operatorIdentifier パラメータで指定) は、オペレーターキーが格納されているキーボールトへのアクセス権を持っている必要があります。`operatorIdentifier` の値は、すべての構成 JSON ファイルで同じである必要があります。 | \ No newline at end of file +| E08 | OperatorKeyPermissionError | コンテナを起動するマネージド ID (operatorIdentifier パラメータで指定) は、 Operator Key が格納されているキーボールトへのアクセス権を持っている必要があります。`operatorIdentifier` の値は、すべての構成 JSON ファイルで同じである必要があります。 | \ No newline at end of file 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 da8145d70..bfb39532c 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 @@ -10,7 +10,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for GCP Integration Guide @@ -229,7 +229,7 @@ Terraform がインストールされていない場合は、[terraform.io](http | `network_name` | `string` | `uid-operator` | no | VPC リソース名（ルール/インスタンスタグにも使用されます）。 | | `min_replicas` | `number` | `1` | no | デプロイする最小レプリカ数を示します。 | | `max_replicas` | `number` | `5` | no | デプロイする最大レプリカ数を示します。 | - | `uid_operator_key_secret_name` | `string` | `"secret-operator-key"` | no | オペレーターキーのシークレットの名前を指定します。Terraform テンプレートは、GCP Secret Manager に `uid_operator_key` 値を保持するためのシークレットを作成します。名前を定義できます。例: `uid2-operator-operator-key-secret-integ`。 | + | `uid_operator_key_secret_name` | `string` | `"secret-operator-key"` | no | Operator Key のシークレットの名前を指定します。Terraform テンプレートは、GCP Secret Manager に `uid_operator_key` 値を保持するためのシークレットを作成します。名前を定義できます。例: `uid2-operator-operator-key-secret-integ`。 | | `debug_mode` | `bool` | `false` | no | UID2 チームと協力して問題をデバッグする場合を除き、`true` に設定しないでください。それ以外の場合、このフラグを `true` に設定すると、認証が失敗します。 | #### Run Terraform @@ -324,7 +324,7 @@ gcloud CLI を使用して、UID2 Operator Service を実行するためのサ | :--- | :--- | | `confidentialcomputing.workloadUser` | 認証トークンを生成し、VM でワークロードを実行する権限を提供します。 | | `logging.logWriter` | gcloud ロギングでログエントリを書き込む権限を提供します。 | - | `secretmanager.secretAccessor` | GCP Secret Manager で管理されているオペレーターキーにアクセスする権限を提供します。 | + | `secretmanager.secretAccessor` | GCP Secret Manager で管理されている Operator Key にアクセスする権限を提供します。 | `confidentialcomputing.workloadUser` 権限を付与します: @@ -363,7 +363,7 @@ gcloud CLI を使用して、UID2 Operator Service を実行するためのサ #### Create Secret for the Operator Key in Secret Manager -UID2 Operator には、Operator Key が必要です。UID2 アカウントの設定（[UID2 Operator Account Setup](#uid2-operator-account-setup) を参照）の一環として、各環境のオペレーターキーを受け取ります。 +UID2 Operator には、Operator Key が必要です。UID2 アカウントの設定（[UID2 Operator Account Setup](#uid2-operator-account-setup) を参照）の一環として、各環境の Operator Key を受け取ります。 次のステップは、`{OPERATOR_KEY}` 値を GCP Secret Manager に保存し、それに対する完全なシークレット名を取得し、それをデプロイメントスクリプト内の `{OPERATOR_KEY_SECRET_FULL_NAME}` プレースホルダで置き換えることです ([Update the Script with Valid Values](#update-the-script-with-valid-values) を参照)。 @@ -379,7 +379,7 @@ UID2 Operator には、Operator Key が必要です。UID2 アカウントの設 1. 自分の値を使用してスクリプトを準備します: - - `{OPERATOR_KEY}` には、環境のオペレーターキー値を使用します。 + - `{OPERATOR_KEY}` には、環境の Operator Key 値を使用します。 - `{OPERATOR_KEY_SECRET_NAME}` には、この環境の API シークレットの名前を指定します。例: `uid2-operator-operator-key-secret-integ`。 2. スクリプトを実行します。 @@ -533,6 +533,10 @@ gcloud CLI を使用してデプロイした場合、アップグレードする ## Scraping Metrics GCP の Private Operator は、`/metrics` エンドポイントで [Prometheus-formatted metrics](https://prometheus.io/docs/concepts/data_model/) ポート 9080 で公開します。Prometheus 互換のスクレイパーを使用して、これらのメトリクスを収集して集計することができます。 +## Keeping the Operator Key Secure + + + ## UID2 Operator Error Codes 以下の表は、Private Operator 起動シーケンス中に発生する可能性のあるエラーを一覧表示しています。 @@ -548,4 +552,4 @@ Private Operator 起動時のエラーコードは、リリース v5.49.7 以降 | E04 | ConfigurationValueError | 設定値が無効です。設定値が必要な形式と環境に一致していることを確認してください。注意: `debug_mode = true` は `integ` 環境でのみ許可されます。詳細はログを確認してください。 | | E05 | OperatorKeyValidationError | Operator Key が環境に対して正しいことを確認し、提供されたものと一致していることを確認してください。 | | E06 | UID2ServicesUnreachableError | UID2 core および opt-out サービスの IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスと DNS の詳細は、ログを参照してください。 | -| E08 | OperatorKeyPermissionError | Compute Engine インスタンステンプレートにサービスアカウントをアタッチします。UID2 Operator は、GCP Secret Manager からオペレーターキーにアクセスするためにこれらの権限が必要です。 | +| E08 | OperatorKeyPermissionError | Compute Engine インスタンステンプレートにサービスアカウントをアタッチします。UID2 Operator は、GCP Secret Manager から Operator Key にアクセスするためにこれらの権限が必要です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-rotating-the-keys.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-rotating-the-keys.mdx new file mode 100644 index 000000000..ea26b8f25 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-rotating-the-keys.mdx @@ -0,0 +1,8 @@ + + +Operator Key を安全に保つためのガイドラインを以下に示します: + +- Operator Key を受け取ったら、安全な場所に保管してください。 +- キーが使用されているすべての場所を把握しておき、キーをローテーションする必要がある場合に迅速に対応できるようにしてください。 +- キーが漏洩した場合に備えて、既存の値を新しい値に置き換えるプロセスを確立してください。 +- 定期的なサイクル（例えば、毎年）でキーをローテーションし、キーが漏洩するリスクを軽減してください。 From 570efd31b86e7806c4945707aeff8a9f63030c26 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 13:21:01 +0900 Subject: [PATCH 11/14] rename snippets to consistent naming convention --- docs/getting-started/gs-encryption-decryption.md | 4 ++-- .../current/endpoints/post-token-generate.md | 4 ++-- .../current/endpoints/post-token-refresh.md | 4 ++-- .../current/getting-started/gs-encryption-decryption.md | 4 ++-- .../current/getting-started/gs-faqs.md | 4 ++-- .../current/sdks/sdk-ref-java.md | 4 ++-- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/getting-started/gs-encryption-decryption.md b/docs/getting-started/gs-encryption-decryption.md index 0657dcf83..c37b29017 100644 --- a/docs/getting-started/gs-encryption-decryption.md +++ b/docs/getting-started/gs-encryption-decryption.md @@ -9,7 +9,7 @@ displayed_sidebar: docs import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Link from '@docusaurus/Link'; -import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; +import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; # Encrypting Requests and Decrypting Responses @@ -105,7 +105,7 @@ The following table describes the field layout for response decryption code. For example, a decrypted response to the [POST /token/generate](../endpoints/post-token-generate.md) request for an email address might look like this: - + ## Encryption and Decryption Code Examples 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 18d2fd0b9..81c04b2ea 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 @@ -7,7 +7,7 @@ displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; +import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; # POST /token/generate @@ -108,7 +108,7 @@ echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_chec 復号化に成功すると、指定されたメールアドレス、電話番号、またはそれぞれのハッシュに対するユーザーの Advertising Token および Refresh Token が返されます。 - + #### Optout 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 dd681bef4..ee4d155a6 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 @@ -7,7 +7,7 @@ displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; +import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; # POST /token/refresh @@ -69,7 +69,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 すべての値が有効で、ユーザーが Opt-Out していない場合、レスポンスは成功し、新しい UID2 Token が関連する値とともに返されます。以下の例は、トークンを含む成功したレスポンスを復号したものです: - + #### Successful Response With Opt-Out 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 b1756221a..543cd7493 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 @@ -9,7 +9,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; +import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx'; # Encrypting Requests and Decrypting Responses @@ -105,7 +105,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス たとえば、先行例 のメールアドレスに対する [POST /token/generate](../endpoints/post-token-generate.md) リクエストに対する復号されたレスポンスは、次のようになります: - + ## Encryption and Decryption Code Examples 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 58e9dd6db..508936bf4 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 @@ -7,7 +7,7 @@ displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import SnptExampleTokenInBidstream from '../snippets/_snpt-example-token-in-bidstream.mdx'; +import SnptSnptExampleTokenInBidstream from '../snippets/_snpt-example-token-in-bidstream.mdx'; # Frequently Asked Questions @@ -169,7 +169,7 @@ UID2 Token は、ビッドストリームではどのように見えますか？ UID2 実装のアプローチにはさまざまな方法があります。以下は、UID2 Token がビッドストリームでどのように渡されるかを示すコードスニペットの一例です: - + #### Can I integrate UID2 with Single Sign-On (SSO)? UID2 をシングルサインオン (SSO) とインテグレーションすることはできますか？ 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 ceb29477d..5fbb607d4 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 @@ -7,7 +7,7 @@ displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import SnptPOSTIdentityMapImprovements from '../snippets/_snpt-post-identity-map-improvements-v3.mdx'; +import SnptSnptPOSTIdentityMapImprovements from '../snippets/_snpt-post-identity-map-improvements-v3.mdx'; # SDK for Java Reference Guide @@ -401,7 +401,7 @@ IdentityMapV3Response mixedResponse = client.generateIdentityMap(mixedInput); ### Version 3 Improvements - + ### Required Changes From 63c8f18057fdf48ebc561221b7c39044127c71a7 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 14:17:47 +0900 Subject: [PATCH 12/14] Update snippets import path to a consistent naming convention. --- .../current/guides/integration-options-private-operator.md | 2 +- .../current/guides/operator-guide-aks-enclave.md | 3 ++- .../current/guides/operator-guide-aws-marketplace.md | 2 +- .../current/guides/operator-guide-azure-enclave.md | 3 ++- .../current/guides/operator-private-gcp-confidential-space.md | 3 ++- 5 files changed, 8 insertions(+), 5 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md index 11cb1976a..d4f8cedf8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md @@ -7,7 +7,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator Integration Overview diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md index eb0581998..81a85eed1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md @@ -10,7 +10,8 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; +import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for AKS Integration Guide 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 bb0a74e7a..26517cba5 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 @@ -11,7 +11,7 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; -import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for AWS Integration Guide 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 5a9fb2322..355135d58 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 @@ -10,7 +10,8 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; +import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for Azure Integration Guide 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 bfb39532c..086e0930a 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 @@ -10,7 +10,8 @@ displayed_sidebar: docs import Link from '@docusaurus/Link'; import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptRotatingTheKeys from '../snippets/_private-operator-rotating-the-keys.mdx'; +import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for GCP Integration Guide From b4283e456de9686859e6101da347dc16eb0bd7eb Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 14:26:37 +0900 Subject: [PATCH 13/14] Fixed line number check error --- .../current/endpoints/post-identity-map.md | 2 +- .../current/guides/operator-guide-aks-enclave.md | 2 +- .../current/guides/operator-guide-azure-enclave.md | 2 +- .../current/sdks/sdk-ref-python.md | 1 - 4 files changed, 3 insertions(+), 4 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 9c6ea512a..38b400c72 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 @@ -297,4 +297,4 @@ Identity mapping の一般的な情報については、[Advertiser/Data Provide - SDK for Python Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-python.md#usage-for-advertisersdata-providers) section - SDK for Java Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) section -Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 \ No newline at end of file +Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md index 81a85eed1..0c0aa0d36 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md @@ -476,4 +476,4 @@ ASK 用の UID2 Private Operator の新しいバージョンがリリースさ ## Keeping the Operator Key Secure - \ No newline at end of file + 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 355135d58..edc0d1b8c 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 @@ -303,7 +303,7 @@ Microsoft Azure で UID2 Private Operator をホストする Virtual Private Clo HTTP 200 と `OK` という応答本文が表示された場合、正常な状態です。 -import AttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +### Private Operator Attestation Failure 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 80f338c58..f2bc11797 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 @@ -57,7 +57,6 @@ version: ## Release Notes -For detailed information about changes, bug fixes, and new features in each release, see the [release notes on GitHub](https://github.com/IABTechLab/uid2-client-python/releases). 各リリースの変更点、バグ修正、新機能の詳細については、[release notes on GitHub](https://github.com/IABTechLab/uid2-client-python/releases) を参照してください。 ## Installation From 3f3f9f9f6502357cb0cd5deb7d1f3e0924ae3a20 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Tue, 2 Dec 2025 15:06:05 +0900 Subject: [PATCH 14/14] Addressing translation omissions and adjusting terminology. --- .../current/endpoints/post-identity-map.md | 2 +- .../current/endpoints/post-token-validate.md | 4 ++-- .../guides/integration-javascript-client-side.md | 4 ++-- .../current/guides/integration-mobile-client-side.md | 4 ++-- .../current/guides/integration-prebid-client-side.md | 2 +- .../current/ref-info/glossary-uid.md | 2 +- .../current/ref-info/ref-how-uid-is-created.md | 2 +- .../current/ref-info/ref-tokens.md | 4 ++-- .../current/ref-info/uid-components.md | 10 +++++----- .../current/ref-info/uid-identifier-types.md | 8 ++++---- .../current/ref-info/uid-workflows.md | 12 ++++++------ 11 files changed, 27 insertions(+), 27 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 38b400c72..3819b8631 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 @@ -29,7 +29,7 @@ UID2 のオプトアウト手順とユーザーがオプトアウトする方法 - 最大リクエストサイズは 1MB です。 - 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマッピングする場合は、1 バッチあたり最大 5,000 アイテムの *順次* バッチで送信します。 -- プライベートオペレーターを使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化または非ハッシュ化された 直接識別情報 (DII) 値のバッチを連続して送信し、複数の並行接続を作成しないでください。 +- プライベートオペレーターを使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化またはハッシュされていない 直接識別情報 (DII) 値のバッチを連続して送信し、複数の並行接続を作成しないでください。 - メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする際に処理時間が大幅に増加する可能性があります。ただし、実際に更新が必要なマッピングのみを再計算すると、UID2 の約 1/365 が毎日更新されるため、総処理時間が短縮されます。詳細は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 ## Request Format 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 f31113278..3c9fa74e4 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 @@ -10,7 +10,7 @@ import Link from '@docusaurus/Link'; # POST /token/validate -Advertising Token が指定されたハッシュ化された、またはハッシュ化されていないメールアドレスまたは電話番号と一致するかどうかを検証します。 +Advertising Token が指定されたハッシュ化された、またはハッシュされていないメールアドレスまたは電話番号と一致するかどうかを検証します。 Used by: このエンドポイントは、主にパブリッシャーが使用します。 @@ -129,7 +129,7 @@ echo '{"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXl このエンドポイントを使用して、[POST /token/generate](../endpoints/post-token-generate.md) で送信する DII が有効かどうかをテストできます。以下の手順に従ってください。 -1. DII がハッシュ化されたメールアドレスか、ハッシュ化されていないメールアドレスか、電話番号かに応じて、[Unencrypted JSON Body Parameters](#unencrypted-json-body-parameters) の表に記載されている4つの有効なオプションのいずれかを使用して、[POST /token/generate](../endpoints/post-token-generate.md) リクエストを送信します。表に記載されている対応する値 - `email`、`email_hash`、`phone`、`phone_hash` - を使用します。 +1. DII がハッシュ化されたメールアドレスか、ハッシュされていないメールアドレスか、電話番号かに応じて、[Unencrypted JSON Body Parameters](#unencrypted-json-body-parameters) の表に記載されている4つの有効なオプションのいずれかを使用して、[POST /token/generate](../endpoints/post-token-generate.md) リクエストを送信します。表に記載されている対応する値 - `email`、`email_hash`、`phone`、`phone_hash` - を使用します。 2. 返された `advertising_token` の値を次のステップで使用するために保存します。 3. Step 1 で送信した `email`、`email_hash`、`phone`、`phone_hash` の値と、Step 2 で保存した `advertising_token` を `token` プロパティの値として、`POST /token/validate` リクエストを送信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md index ff4c34b1c..dbd5db659 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md @@ -192,9 +192,9 @@ SDK は、特定のユーザーに対して、4 つの DII フォーマットの 以下のセクションでは、UID2 SDK を構成するさまざまな方法を示し、SDK に渡される DII の要件を示します: -- メールアドレス, ハッシュ化されていない +- メールアドレス, ハッシュされていない - メールアドレス, 正規化とハッシュ化 -- 電話番号, ハッシュ化されていない +- 電話番号, ハッシュされていない - 電話番号, 正規化とハッシュ化 SDK が複数回設定された場合、最新の設定値が使用されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md index 7dbe313d4..832ebce97 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md @@ -307,7 +307,7 @@ UID2 は、以下の値を提供します。これらは、UID2 Token を Client これらの値は、アカウントセットアップ時に受け取ります。インテグレーション環境用の 1 つのセットと、本番環境用の別のセットがあります。 -SDK を構成するには、アカウントセットアップ時に受け取った Subscription ID と public key、およびユーザーのハッシュ化またはハッシュ化されていない直接識別情報 (DII) (メールアドレスまたは電話番号) を次のメソッドコールに渡す必要があります: +SDK を構成するには、アカウントセットアップ時に受け取った Subscription ID と public key、およびユーザーのハッシュ化またはハッシュされていない直接識別情報 (DII) (メールアドレスまたは電話番号) を次のメソッドコールに渡す必要があります: @@ -343,7 +343,7 @@ UID2Manager.shared.generateIdentity( - アプリが開いている間、必要に応じてトークンを自動的にリフレッシュします。 :::tip -ユーザーの DII を UID2 mobile SDK に渡す際、ハッシュ化またはハッシュ化されていない DII を渡すことができます。DII をハッシュ化されていない状態で渡す場合、SDK がハッシュ化します。ハッシュ化された DII を SDK に渡す場合、ハッシュ化する前に正規化する必要があります。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 +ユーザーの DII を UID2 mobile SDK に渡す際、ハッシュ化またはハッシュされていない DII を渡すことができます。DII をハッシュされていない状態で渡す場合、SDK がハッシュ化します。ハッシュ化された DII を SDK に渡す場合、ハッシュ化する前に正規化する必要があります。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 ::: ### Format Examples for DII 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 fca5e6de9..46fe51be1 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 @@ -72,7 +72,7 @@ When account setup is complete, you'll receive a client keypair consisting of tw ### Configure the UID2 Module -UID2 module を設定するには、アカウント設定時に受け取った **Public Key** と **Subscription ID**、およびユーザーのハッシュ化された、またはハッシュ化されていないメールアドレスまたは電話番号を含むオブジェクトを使用して `pbjs.setConfig` を呼び出します。 +UID2 module を設定するには、アカウント設定時に受け取った **Public Key** と **Subscription ID**、およびユーザーのハッシュ化された、またはハッシュされていないメールアドレスまたは電話番号を含むオブジェクトを使用して `pbjs.setConfig` を呼び出します。 いったん設定されると、UID2 module はユーザー用の UID2 Token を生成し、それをユーザーのブラウザに保存します。このモジュールは、あなたのサイトがユーザーのブラウザで開かれている限り、必要に応じてトークンを自動的にリフレッシュします。 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 d8972b46e..a384f04fb 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 @@ -519,7 +519,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
UID2 Token (Advertising Token)
Unified ID 2.0 (UID2)Token は Advertising Token とも呼ばれ、raw UID2 を暗号化したものです。
-
UID2 Token は、ハッシュ化された、またはハッシュ化されていないメールアドレスや電話番号から生成され、raw UID2 に変換された後、暗号化されます。UID2 Token は一意な値であり、同じ UID2 TOken は2つとありません。UID2 Token は大文字と小文字を区別します。
+
UID2 Token は、ハッシュ化された、またはハッシュされていないメールアドレスや電話番号から生成され、raw UID2 に変換された後、暗号化されます。UID2 Token は一意な値であり、同じ UID2 TOken は2つとありません。UID2 Token は大文字と小文字を区別します。
トークンの値は不透明です。文字列のフォーマットや長さについて、推測してはなりません。
トークンの寿命は限られていますが、refresh token を使ってバックグラウンドでリフレッシュすることができます。
パブリッシャーは、ビッドストリームに UID2 Token を送信します。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md index e7fb57a21..6fd9c1323 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md @@ -14,7 +14,7 @@ import Link from '@docusaurus/Link'; この記事では、パブリッシャーがビッドストリームで送信する UID2 Token の作成方法について説明します。広告主がコンバージョンピクセルのために UID2 Token を作成する場合も同じプロセスが適用されます。UID2 Token を他の共有参加者に送信する前に、raw UID2 が UID2 Token に暗号化される Tokenized Sharingには適用されません。 ::: -パブリッシャーがユーザーの DII（ハッシュ化されたまたはハッシュ化されていないメールアドレスまたは電話番号）を UID2 Operator に送信し、ターゲティング広告に使用するための UID2 Token を受け取ると、その過程で特定の処理手順が実行されます。 +パブリッシャーがユーザーの DII（ハッシュ化されたまたはハッシュされていないメールアドレスまたは電話番号）を UID2 Operator に送信し、ターゲティング広告に使用するための UID2 Token を受け取ると、その過程で特定の処理手順が実行されます。 パブリッシャーによってはいくつかの事前作業が行われますが、ほとんどの処理ステップは UID2 Operator によって行われます。 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 1c9a54557..349a90894 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 @@ -12,7 +12,7 @@ import TabItem from '@theme/TabItem'; # UID2 Tokens and Refresh Tokens -パブリッシャーがユーザーの DII—ハッシュ化または非ハッシュ化されたメールアドレスまたは電話番号—を UID2 Operator に送信すると、UID2 SDK のいずれかを使用するか、[POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを使用するかに関わらず、UID2 Operator は DII を raw UID2 に変換し、UID2 Token に暗号化して返します。UID2 Token には、Refresh Token を含む関連値が付属しています。パブリッシャーは、UID2 Token をビッドストリームで使用できます。 +パブリッシャーがユーザーの DII—ハッシュ化またはハッシュされていないメールアドレスまたは電話番号—を UID2 Operator に送信すると、UID2 SDK のいずれかを使用するか、[POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを使用するかに関わらず、UID2 Operator は DII を raw UID2 に変換し、UID2 Token に暗号化して返します。UID2 Token には、Refresh Token を含む関連値が付属しています。パブリッシャーは、UID2 Token をビッドストリームで使用できます。 ## UID2 Tokens: Key Information @@ -25,7 +25,7 @@ UID2 Token に関する主なポイントは次のとおりです: - トークン生成時に、UID2 Operator はユーザーのオプトアウトを確認します。ユーザーが UID2 からオプトアウトしている場合、UID2 Token は生成されません。詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 - トークンは有効期限がありますが、Refresh Token を使用してリフレッシュできます。 - 現在の UID2 Token が有効期限切れになる前に、常に現在の Refresh Token をリフレッシュすることで、新しい UID2 Token と対応する新しい Refresh Token を取得するために何度でもリフレッシュできます。 -- トークンが期限切れの場合、または既存のトークンをリフレッシュする代わりに、元のハッシュ化されたまたは非ハッシュ化されたメールアドレスまたは電話番号から新しい UID2 Token を生成することができます。 +- トークンが期限切れの場合、または既存のトークンをリフレッシュする代わりに、元のハッシュ化されたまたはハッシュされていないメールアドレスまたは電話番号から新しい UID2 Token を生成することができます。 - パブリッシャーは、UID2 Token をビッドストリームに送信します。 - UID2 Token をリフレッシュしても、元の UID2 Token は無効になりません。有効期限が切れるまで、以前のトークンを引き続き使用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-components.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-components.md index 5539c73d9..7b6b22c9d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-components.md @@ -10,11 +10,11 @@ import Link from '@docusaurus/Link'; # UID2 Components -The UID2 framework consists of the following components, all of which are currently managed by The Trade Desk. +UID2 フレームワークは以下ののコンポーネントで構成されており、すべて The Trade Desk によって管理されています。 | Component | Description | | :--- | :--- | -| **Core Service** | A centralized service that manages access to salts, encryption keys, and other relevant data in the UID2 ecosystem. | -| **Operator Service** | A service that enables the management and storage of encryption keys and salts from the UID2 Core Service, hashing of users' personal data, encryption of raw UID2s, and decryption of UID2 tokens. There can be multiple instances of the service (public or private) operated by multiple [participants](../overviews/participants-overview.md#uid2-component-services), known as operators.
Public Operators run publicly available instances of the Operator Service and make them available to all relevant UID2 participants. There might also be Private Operators that run private instances of the Operator Service exclusively for their own use. All instances are designed with protections to keep critical UID2 data secure and interoperable, regardless of who operates the service. | -| **Opt-Out Service** | A global service that manages and stores user opt-out requests and disseminates them to publishers, operator service instances, and DSPs. | -| **Transparency and Control Portal** | A user-facing website, [https://www.transparentadvertising.com/](https://www.transparentadvertising.com/), that allows consumers to opt out of UID2 at any time. | +| **Core Service** | UID2 のエコシステムの中で、salt、encryption key、およびその他の関連データへのアクセスを管理する一元的なサービス。 | +| **Operator Service** | UID2 コアサービスからの暗号化キーとソルトの管理と保存、ユーザーの個人に関するデータのハッシュ化、raw UID2 の暗号化、UID2 Token の復号化を可能にするサービス。
複数の [参加者](../overviews/participants-overview.md#uid2-component-services)（オペレーターと呼ばれる）が運営する複数のインスタンス（パブリックまたはプライベート）が存在する可能性があります。
パブリックオペレーター は、オペレーターサービス の公開インスタンスを実行し、すべての関連する UID2 参加者が利用できるようにします。
また、独自の使用専用にオペレーターサービスのプライベートインスタンスを実行する プライベートオペレーター も存在する可能性があります。すべてのインスタンスは、サービスを運営する人に関係なく、重要な UID2 データを安全かつ相互運用可能に保つための保護機能を備えて設計されています。 | +| **Opt-Out Service** | ユーザーのオプトアウト要求を管理および保存し、それらをパブリッシャー、オペレーターサービスのインスタンス、および DSP に配布するグローバルサービス。 | +| **Transparency and Control Portal** | ユーザーがいつでも UID2 のオプトアウトを行うことができる、ユーザー向けのウェブサイト [https://www.transparentadvertising.com/](https://www.transparentadvertising.com/) 。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-identifier-types.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-identifier-types.md index f1a2903c3..0f5a10741 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-identifier-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-identifier-types.md @@ -10,13 +10,13 @@ import Link from '@docusaurus/Link'; # UID2 Identifier Types -UID2 is a deterministic ID that is based on directly identifying information (DII), such as email address or phone number. There are two types of UID2s: raw UID2s and UID2 tokens (also known as advertising tokens). The following table explains each type. +UID2 は、メールアドレスや電話番号などの 直接識別情報 (DII) に基づく決定論的 ID です。UID2 には、Raw UID2 と UID2 Token (Advertiseing Token とも呼ばれます) の 2 種類があります。以下の表では、それぞれのタイプについて説明します。 | ID Type | Shared in Bidstream? | Description | | :--- | :--- | :--- | -| **Raw UID2** | No | An unencrypted alphanumeric identifier created through the UID2 APIs or SDKs with the user's verifiable personal data, such as a hashed or unhashed email address or a phone number, as input.
To avoid revealing the source data, the input value is hashed if it was not already hashed, and then hashed again using a secret salt value to create the raw UID2. The process that creates the raw UID2 is designed to create a secure, opaque value that can be stored by advertisers, third-party data providers, and demand-side platforms (DSPs).
Raw UID2s are case sensitive.
Example: A request for the raw UID2 for the fictitious email address `user@example.com` resulted in this value: `E2dxEv3oMBzNHPw5iUVmwH2Hv+60D4AXYe+2ge9U0No=`. | -| **UID2 Token (Advertising Token)** | Yes | An encrypted form of a raw UID2. UID2 tokens are generated from hashed or unhashed email addresses or phone numbers that are converted to raw UID2s and then encrypted to help ensure protection in the bidstream.
UID2 tokens are designed to be used by publishers or publisher service providers. Supply-side platforms (SSPs) pass UID2 tokens in the bidstream and DSPs decrypt them at bid request time.
UID2 tokens are case sensitive.
Example: A request for a UID2 token for the fictitious email address `user@example.com` resulted in this value: `A4AAAAs6ZBcEbwAPoFhVV7CNW5W-4R-9TKDNL4RS0ctkw1U-IkNOXSnWczvwOMgCQaXHPf3Gd1o1W6IBmlZBFIloM67XOsOgwP5jUrQrclGkq1zBJJUJmOFTe6sJJA7pM1GP9gLd-hz5did6baZvcKd8DXkUYM-WALRZFnzHivu_1YEsC_CeXNdMexKDN7EwSQ6L5eZvOd1F1RkF_nLy_J0twg`. | +| **Raw UID2** | No | ユーザーの検証可能な個人データ (ハッシュ化またはハッシュされていないメールアドレスや電話番号など) を入力として、UID2 API または SDK を使用して作成された暗号化されていない英数字の識別子。
ソースデータの漏洩を避けるために、入力値がすでにハッシュされていない場合はハッシュ化され、その後、秘密の ソルト 値を使用して再度ハッシュ化されて、Raw UID2 が作成されます。Raw UID2 を作成するプロセスは、広告主、サードパーティのデータプロバイダー、およびデマンドサイドプラットフォーム (DSP) が保存できる、安全で不透明な値を作成するように設計されています。
Raw UID2 は大文字と小文字が区別されます。
例: 架空のメールアドレス `user@example.com` の Raw UID2 のリクエストは、この値を生成しました：`E2dxEv3oMBzNHPw5iUVmwH2Hv+60D4AXYe+2ge9U0No=`。 | +| **UID2 Token (Advertising Token)** | Yes | 暗号化された Raw UID2 の形式。UID2 Token は、ハッシュ化またはハッシュされていないたメールアドレスや電話番号から生成され、Raw UID2 に変換されてから暗号化され、ビッドストリームでの保護を確保するのに役立ちます。
UID2 Token は、パブリッシャーまたはパブリッシャーサービスプロバイダーによって使用されるように設計されています。サプライサイドプラットフォーム (SSP) はビッドストリームで UID2 Token を渡し、DSP はビッドリクエスト時にそれらを復号化します。
UID2 Token は大文字と小文字が区別されます。
架空のメールアドレス `user@example.com` に対する UID2 Token のリクエストは、次の値を生成しました：`A4AAAAs6ZBcEbwAPoFhVV7CNW5W-4R-9TKDNL4RS0ctkw1U-IkNOXSnWczvwOMgCQaXHPf3Gd1o1W6IBmlZBFIloM67XOsOgwP5jUrQrclGkq1zBJJUJmOFTe6sJJA7pM1GP9gLd-hz5did6baZvcKd8DXkUYM-WALRZFnzHivu_1YEsC_CeXNdMexKDN7EwSQ6L5eZvOd1F1RkF_nLy_J0twg`。 | :::note -For the fictitious email address `user@example.com` used in these examples, the corresponding refresh token was: `AAAABrexFHvQVhNJqu+y/ua7rsgShF8e9NUXUJOZFmeFRD8TAsJadaLfOlLkwC5iSxcOKWFD9YwMBzbbcPa92CInba+bcPTaAFNmM2ZpIHgGy6lDcNPzvEnPQh/5fyZ3MD44SX/tHyIXa0R2OBAOLBA1A81r3jefhSsxZdyyBF58KtnaX6UbaeOEaguOfMnJdmhaPeWKj33v7vGfROWtxDWmi6wvGL5lHTX9H6iIZ9i1WSsemYPUgmoDOQeT7nzllJK968OECFj5LkCazDN3pCrYSeuJby9o0fMuSZNxzp6EVzi6XVED4ETtzpcaY0AArzzdh0IXV9MgH8jyg7bJSUWXQG+8kMPZzwbs9EB+7ddAUOLZL/GBna8Hm3Im03EjN3sJ`. +これらの例で使用されている架空のメールアドレス `user@example.com` に対応する Refresh Token は次のとおりです：`AAAABrexFHvQVhNJqu+y/ua7rsgShF8e9NUXUJOZFmeFRD8TAsJadaLfOlLkwC5iSxcOKWFD9YwMBzbbcPa92CInba+bcPTaAFNmM2ZpIHgGy6lDcNPzvEnPQh/5fyZ3MD44SX/tHyIXa0R2OBAOLBA1A81r3jefhSsxZdyyBF58KtnaX6UbaeOEaguOfMnJdmhaPeWKj33v7vGfROWtxDWmi6wvGL5lHTX9H6iIZ9i1WSsemYPUgmoDOQeT7nzllJK968OECFj5LkCazDN3pCrYSeuJby9o0fMuSZNxzp6EVzi6XVED4ETtzpcaY0AArzzdh0IXV9MgH8jyg7bJSUWXQG+8kMPZzwbs9EB+7ddAUOLZL/GBna8Hm3Im03EjN3sJ`。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-workflows.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-workflows.md index 7cf0ccf6a..cf978fef5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-workflows.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/uid-workflows.md @@ -10,15 +10,15 @@ import Link from '@docusaurus/Link'; # UID2 Workflows -The following table lists four key workflows in the UID2 framework with links to their high-level overviews. It also provides links to the respective integration guides, which include diagrams, integration steps, FAQs, and other relevant information for each workflow. +以下の表は、UID2 フレームワークの 4 つの主要なワークフローを概要へのリンクとともに示しています。また、それぞれのワークフローに関する図、インテグレーション手順、FAQ、およびその他の関連情報を含むインテグレーションガイドへのリンクも提供しています。 | Workflow | Intended Primary Participants | Integration Guides | | :--- |:--- |:--- | -| [Workflow for DSPs](../overviews/overview-dsps.md#workflow-for-dsps) (Buy-Side) | DSPs who transact on UID2 tokens in the bidstream. | See [DSP Integrations](../guides/summary-guides#dsp-integrations) | -| [Workflow for Advertisers](../overviews/overview-advertisers.md#workflow-for-advertisers) and [Workflow for Data Providers](../overviews/overview-data-providers.md#workflow-for-data-providers) | Organizations that collect user data and push it to DSPs. | See [Advertiser/Data Provider Integrations](../guides/summary-guides#advertiserdata-provider-integrations) | -| [Workflow for Publishers](../overviews/overview-publishers.md#workflow-for-publishers) | Organizations that propagate UID2 tokens to the bidstream via SSPs.
NOTE: Publishers can choose to integrate using Prebid, leverage the SDK for JavaScript, or complete their own server-side integration without using an SDK. | See [Publisher Integrations](../guides/summary-guides#publisher-integrations) | -| [Opt-Out Workflow](../getting-started/gs-opt-out.md#opt-out-workflow) | Consumers who engage with publishers or their SSO providers and other identity providers. | N/A | +| [Workflow for DSPs](../overviews/overview-dsps.md#workflow-for-dsps) (Buy-Side) | ビッドストリームで UID2 Token 取引を行う DSP。 | [DSP Integrations](../guides/summary-guides#dsp-integrations) を参照 | +| [Workflow for Advertisers](../overviews/overview-advertisers.md#workflow-for-advertisers) and [Workflow for Data Providers](../overviews/overview-data-providers.md#workflow-for-data-providers) | ユーザーデータを収集し、DSPに提供する組織。 | [Advertiser/Data Provider Integrations](../guides/summary-guides#advertiserdata-provider-integrations)　を参照 | +| [Workflow for Publishers](../overviews/overview-publishers.md#workflow-for-publishers) | SSP を介して UID2 Token をビッドストリームに送るする組織。
注意: パブリッシャーは、Prebid を使用した統合、JavaScript 用 SDK の活用、または SDK を使用しない独自のサーバーサイドインテグレーションを選択できます。 | [Publisher Integrations](../guides/summary-guides#publisher-integrations) を参照 | +| [Opt-Out Workflow](../getting-started/gs-opt-out.md#opt-out-workflow) | パブリッシャーやそのSSOプロバイダー、その他のアイデンティティプロバイダーと関わる消費者。 | N/A | -The following diagram summarizes all four workflows. For each workflow, the [external participants](../overviews/participants-overview.md#uid2-external-participants), [components](../ref-info/uid-components.md), [UID2 identifier types](../ref-info/uid-identifier-types.md), and numbered steps are color-coded. +以下の図は、4 つのワークフローすべてをまとめたものです。各ワークフローについて、[外部参加者](../overviews/participants-overview.md#uid2-external-participants)、[コンポーネント](../ref-info/uid-components.md)、[UID2 識別子タイプ](../ref-info/uid-identifier-types.md)、および番号付きのステップが色分けされています。 ![The UID2 Ecosystem](images/UID2Workflows.svg)