|
本番環境だけでなくインテグレーション環境も使用している場合は、それぞれの環境用に別々の認証情報を取得します。
+## Subscription ID and Public Key
+
+Client-Side の実装([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) または [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照) を使用している場合は、以下の認証情報を受け取ります:
+- **Subscription ID**: UID2 Service に対してサイトを識別する値です。
+- **Public key**: この値は暗号化に使用されます。
+
+**Client keypair** は、これら2つの値を使用してアカウントを一意に定義するために使用されます。これらの値は、Client-Side でトークンを生成する実装を使用しているアカウントを識別するために使用されます。
+
+UID2 を Client-Side で実装する場合、UID2 JavaScript SDK、Client-Side Integration for Mobile、または Prebid.js を使用している場合は、設定の一部として SDK または Prebid.js に値を提供してください。
+
+Notes:
+
+- API Key とクライアントシークレットとは異なり、Subscription ID と Public key は安全に保管する必要はありません。
+
+- これらの値は特定の [Environment](gs-environments.md) に対して有効です。インテグレーション環境と本番環境の両方を使用している場合、それぞれの環境用の認証情報のセットを取得します。
+
+- Subscription ID と Public Key の認証情報は、Client-Side トークンの生成にのみ使用できます。追加のロールが必要な場合は ([API Permissions](gs-permissions.md) を参照してください)、そのロールの API Key と Client Secret をリクエストしてください。
+
## API Key and Client Secret
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 エンドポイントを呼び出すことができます。これらの値は、サービスの参加者を識別します。
@@ -30,7 +49,7 @@ Client-Side または Server-Side の実装を使用している場合([UID2 Cli
- 本番環境だけでなくインテグレーション環境も利用する場合は、それぞれの環境で別々の API Key が必要になります。
- クライアントシークレットは特定の [Environment](gs-environments.md) で有効です。インテグレーション環境と本番環境の両方を使っている場合、それぞれの環境用のクライアントシークレットを取得します。
-UID2 アカウントのセットアップの一環として、1つ以上の API Key が発行され、それぞれに対応するクライアントシークレットが割り当てられます。相談相手の詳細については、[Contact Info](gs-account-setup.md#contact-info) を参照してください。
+UID2 アカウントのセットアップの一環として、1つ以上の API Key が発行され、それぞれに対応するクライアントシークレットが割り当てられます。相談相手の詳細は [Contact Info](gs-account-setup.md#contact-info) を参照してください。
### Security of API Key and Client Secret
@@ -42,22 +61,6 @@ UID2 アカウントのセットアップの一環として、1つ以上の API
API Key とクライアントシークレットは、認証情報が漏洩するリスクを減らすために、定期的に(例えば1年ごとに)更新するのがベストです。
-## Subscription ID and Public Key
-
-Client-Side の実装([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) または [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照) を使用している場合は、以下の認証情報を受け取ります:
-- **Subscription ID**: UID2 Service に対してサイトを識別する値です。
-- **Public key**: この値は暗号化に使用されます。
-
-UID2 JavaScript SDK または Prebid を使用して、Client-Side で UID2 を実装する場合、設定の一部として SDK または Prebid に値を提供します。
-
-Notes:
-
-- API Key とクライアントシークレットとは異なり、Subscription ID と Public key は安全に保管する必要はありません。
-
-- これらの値は特定の [Environment](gs-environments.md) に対して有効です。インテグレーション環境と本番環境の両方を使用している場合、それぞれの環境用の認証情報のセットを取得します。
-
-- Subscription ID と Public Key の認証情報は、Client-Side トークンの生成にのみ使用できます。追加のロールが必要な場合は ([API Permissions](gs-permissions.md) を参照してください)、そのロールの API Key と Client Secret をリクエストしてください。
-
## Refreshing Credentials
新しいクレデンシャルをリクエストするには、いつでも UID2 の連絡先に連絡してください。
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 111e4b615..653309189 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
@@ -104,7 +104,20 @@ UID2 API のリクエストレスポンスワークフローは、以下のス
例えば、先行例 のメールアドレスに対する [POST /token/generate](../endpoints/post-token-generate.md) リクエストに対する復号されたレスポンスは、次のようになります:
-
+```json
+{
+ "body": {
+ "advertising_token": "AgAAAQFt3aNLXKXEyWS8Tpezcymk1Acv3n+ClOHLdAgqR0kt0Y+pQWSOVaW0tsKZI4FOv9K/rZH9+c4lpm2DBpmFJqjdF6FAaAzva5vxDIX/67UOspsYtiwxH73zU7Fj8PhVf1JcpsxUHRHzuk3vHF+ODrM13A8NAVlO1p0Wkb+cccIIhQ==",
+ "user_token": "AgAAAPpTqz7/Z+40Ue5G3XOM2RiyU6RS9Q5yj1n7Tlg7PN1K1LZWejvo8Er7A+Q8KxdXdj0OrKRf/XEGWsyUJscRNu1bg/MK+5AozvoJKUca8b10eQdYU86ZOHPH7pFnFhD5WHs=",
+ "refresh_token": "AAAAAQLMcnV+YE6/xoPDZBJvJtWyPyhF9QTV4242kFdT+DE/OfKsQ3IEkgCqD5jmP9HuR4O3PNSVnCnzYq2BiDDz8SLsKOo6wZsoMIn95jVWBaA6oLq7uUGY5/g9SUOfFmX5uDXUvO0w2UCKi+j9OQhlMfxTsyUQUzC1VQOx6ed/gZjqH/Sw6Kyk0XH7AlziqSyyXA438JHqyJphGVwsPl2LGCH1K2MPxkLmyzMZ2ghTzrr0IgIOXPsL4lXqSPkl/UJqnO3iqbihd66eLeYNmyd1Xblr3DwYnwWdAUXEufLoJbbxifGYc+fPF+8DpykpyL9neq3oquxQWpyHsftnwYaZT5EBZHQJqAttHUZ4yQ==",
+ "identity_expires": 1654623500142,
+ "refresh_expires": 1657214600142,
+ "refresh_from": 1654622900142,
+ "refresh_response_key": "wR5t6HKMfJ2r4J7fEGX9Gw=="
+ },
+ "status": "success"
+}
+```
## Encryption and Decryption Code Examples
@@ -155,7 +168,7 @@ Maven を使用している場合は、以下の最小限の `pom.xml` を使用
org.exampleUid2Request1.0
-
+
1111
@@ -194,7 +207,7 @@ Maven を使用している場合は、以下の最小限の `pom.xml` を使用
- ${artifactId}
+ ${artifactId}
```
@@ -223,7 +236,7 @@ Usage:
Example:
echo '{"email": "test@example.com"}' | python3 uid2_request.py https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=
-
+
Refresh Token Usage:
python3 uid2_request.py --refresh-token
@@ -286,7 +299,7 @@ else:
envelope += bytearray(tag)
base64Envelope = base64.b64encode(bytes(envelope)).decode()
-
+
http_response = requests.post(url, base64Envelope, headers={"Authorization": "Bearer " + api_key})
# Decryption
@@ -299,7 +312,7 @@ else:
iv = resp_bytes[:12]
data = resp_bytes[12:len(resp_bytes) - 16]
tag = resp_bytes[len(resp_bytes) - 16:]
-
+
cipher = AES.new(secret, AES.MODE_GCM, nonce=iv)
decrypted = cipher.decrypt_and_verify(data, tag)
@@ -349,13 +362,13 @@ public class Uid2Request {
System.out.println(
"Usage:" + "\n "
+ "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"
-
+
+ "Refresh Token Usage:" + "\n "
+ "java -jar Uid2Request-jar-with-dependencies.jar --refresh-token " + "\n\n"
-
+
+ "Refresh Token Example:" + "\n "
+ "java -jar Uid2Request-jar-with-dependencies.jar https://prod.uidapi.com/v2/token/refresh --refresh-token AAAAAxxJ...(truncated, total 388 chars) v2ixfQv8eaYNBpDsk5ktJ1yT4445eT47iKC66YJfb1s=" + "\n"
);
@@ -463,7 +476,7 @@ Usage:
Example:
echo '{"email": "test@example.com"}' | .\uid2_request https://prod.uidapi.com/v2/token/generate UID2-C-L-999-fCXrMM.fsR3mDqAXELtWWMS+xG1s7RdgRTMqdOH2qaAo= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=
-
+
Refresh Token Usage:
.\uid2_request --refresh-token
@@ -571,7 +584,7 @@ else
var json = Encoding.UTF8.GetString(unencryptedResponseDataEnvelope, offset, unencryptedResponseDataEnvelope.Length - offset);
Console.WriteLine("Response JSON:");
-
+
using var jDoc = JsonDocument.Parse(json);
Console.WriteLine(JsonSerializer.Serialize(jDoc, new JsonSerializerOptions { WriteIndented = true }));
}
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 6ead9e4eb..ba558a6af 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
@@ -12,13 +12,6 @@ import ExampleUid2InBidstream from '/docs/snippets/_example-uid2-in-bidstream.md
UID2 に関するよくある質問は、以下のカテゴリーに分かれています:
-
-
## FAQs—General
UID2 フレームワークに関するよくある質問を紹介します。
@@ -28,6 +21,10 @@ UID2 フレームワークに関するよくある質問を紹介します。
- [UID2 に DII を送信すると、UID2 はその情報を保存しますか?](#when-i-send-dii-to-uid2-does-uid2-store-the-information)
- [UID2 は HIPAA で規制されているデータの処理を許可しますか?](#does-uid2-allow-the-processing-of-hipaa-regulated-data)
+:::note
+モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。
+:::
+
#### Will all integration partners in the EUID infrastructure (SSPs, third-party data providers, measurement providers) be automatically integrated with UID2?
EUID インフラのすべてのインテグレーションパートナー(SSP、サードパーティデータプロバイダー、測定プロバイダー)は、自動的に UID2 にインテグレーションされますか?
@@ -57,7 +54,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ
- [送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか?](#how-can-i-test-that-the-dii-sent-and-the-returned-token-match-up)
- [トークンを復号化する必要がありますか?](#do-i-need-to-decrypt-tokens)
- [ユーザーのオプトアウトはどのように通知されますか?](#how-will-i-be-notified-of-user-opt-out)
- - [トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか?](#where-should-i-make-token-generation-callsfrom-the-server-or-client-side)
+ - [トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか?](#where-should-i-make-token-generation-callsfrom-the-server-side-or-the-client-side)
- [Client-Side からトークンのリフレッシュを呼び出すことはできますか?](#can-i-make-token-refresh-calls-from-the-client-side)
- [Refresh Token のワークフローをテストするにはどうすればよいですか?](#how-can-i-test-the-refresh-token-workflow)
- [UID2 Token の一意性とローテーションポリシーは何ですか?](#what-is-the-uniqueness-and-rotation-policy-for-uid2-tokens)
@@ -82,7 +79,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ
- 直接または UID2 SDK のいずれかで [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを呼び出し、UID2 Token を生成する場合、必須の `optout_check` パラメータに `1` を指定します。
- 直接または UID2 SDK のいずれかで [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出し、UID2 Token をリフレッシュした場合。
-#### Where should I make token generation calls—from the server or client side?
+#### Where should I make token generation calls—from the server side or the client side?
トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか?
UID2 Token は、Client-Side、Server-Sideのどちらでも生成できます。詳細については、以下を参照してください:
@@ -144,6 +141,7 @@ UID2 フレームワークを使用する広告主やデータプロバイダー
- [大量のメールアドレスや電話番号やそれらのハッシュマッピングを保存すべきか?](#should-i-store-large-volumes-of-email-address-phone-number-or-their-hash-mappings)
- [ユーザーのオプトアウトはどのように処理すればよいですか?](#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)
#### How do I know when to refresh the UID2 due to salt bucket rotation?
ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには?
@@ -175,7 +173,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生
システムは[メールアドレス正規化ルール](../getting-started/gs-normalization-encoding#email-address-normalization)に従って、salt せずにハッシュ化する必要があります。
-#### Should I store large volumes of email address, phone number, or their hash mappings?
+#### Should I store large volumes of email address, phone number, or their hash mappings?
大量のメールアドレスや電話番号やそれらのハッシュマッピングを保存すべきか?
はい。何百万ものメールアドレスや電話番号をマッピングする必要がある場合、マッピングを保存しないことで処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングだけを再計算すると、毎日更新する必要があるのは UID2 の約 365 分の 1 なので、総処理時間が短縮されます。
@@ -194,14 +192,26 @@ Private Operator を使用している場合を除き、メールアドレス、
ウェブサイトを通じてユーザーがオプトアウトした場合、オプトアウトを処理するための内部手順に従ってください。たとえば、そのユーザーの UID2 を生成しないことを選択することもできます。
#### Does the same DII always result in the same raw UID2?
-同じ DII は常に同じ生UID2になりますか?
+同じ DII は常に同じ raw UID2 になりますか?
一般的にその通りです。DII から raw UID2 を生成するプロセスは同じであり、誰がリクエストを送信したかに関係なく、結果は同じ値になります。 2 人の UID2 参加者が同じメールアドレスを [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントに同時に送信した場合、応答として両方とも同じ raw UID2 を取得します。
-ただし、raw UID2 の生成に使用される [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細については、[How often should UID2s be refreshed for incremental updates?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)) を参照してください)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。
+ただし、raw UID2 の生成に使用される [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細は [How often should UID2s be refreshed for incremental updates?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)) を参照してください)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。
詳細については、*Advertiser/Data Provider Integration Guide*の [Monitor for salt bucket rotations related to your stored raw UID2s](../guides/advertiser-dataprovider-guide.md#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s) を参照してください。
+#### If two operators process the same DII, are the results the same?
+2 つの Operator が同じ DII を処理した場合、結果は同じになりますか?
+
+はい、リクエストが raw UID2 に対するものである場合は、同じです。前の FAQ で説明したように、[同じ DII は常に同じ raw UID2 になりますか?](#does-the-same-dii-always-result-in-the-same-raw-uid2)、広告主やデータプロバイダーが同時に同じ DII を UID2 Operator に送信する場合、SDK または [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを使用して、同じ raw UID2 が生成されます。
+
+Operator に関係なく、また、Private Operator と Public Operator のどちらであっても、結果は同じです。
+
+タイミングが重要なのは、ソルトバケットのローテーションのためです。リクエスト間でソルト値が変化すると、結果は異なる raw UID2 になります。
+
+
+しかし、パブリッシャーが [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイント経由、または SDK 経由で UID2 Token のリクエストに DII を送信した場合、生成される UID2 Token には同じ暗号化された raw UID が含まれます。ただし、トークン自体は常に一意です。
+
## FAQs for DSPs
demand-side platform (DSP) に関するよくある質問を紹介します。
@@ -277,14 +287,14 @@ DSP はオプトアウトリストをどれくらいの期間保管すべきで
ユーザーがオプトアウトした場合、UID2 Operator は raw UID2 を URL エンコードされたクエリパラメータとして返します。
-DSP のオプトアウトプロセスの詳細については、[Honor User Opt-Outs](../guides/dsp-guide.md#honor-user-opt-outs) を参照してください。
+DSP のオプトアウトプロセスの詳細は [Honor User Opt-Outs](../guides/dsp-guide.md#honor-user-opt-outs) を参照してください。
-#### What request type do opt-outs use?
+#### What request type do opt-outs use?
オプトアウトはどのリクエストタイプを使いますか?
一般的には GET リクエストですが、DSP によって異なるタイプを使用することがあります。
-#### How strict are the requirements for honoring opt-outs?
+#### How strict are the requirements for honoring opt-outs?
オプトアウトに応じるための条件はどの程度厳しいのですか?
オプトアウトは常に受け入れなければなりません。オプトアウトリクエストがシステムを通じて伝播するまでに時間がかかる場合があり、その間に一部の入札がオプトアウトを受け入れないことがあります。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md
index 80f912c86..409c8fe83 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md
@@ -48,7 +48,7 @@ UID2 エコシステムには、2 種類のオプトアウトがあります:
| Participant | Distribution Method |
| :--- | :--- |
| Publishers | [POST /token/generate](../endpoints/post-token-generate.md) を必須パラメータ `optout_check` を `1` に設定して呼び出したパブリッシャー、または [POST /token/refresh](../endpoints/post-token-refresh.md) を呼び出したパブリッシャーは、UID2 Token の代わりにオプトアウトレスポンスを受け取ります。|
- | DSPs | UID2 Operator Service は、DSP に対して、その目的のために提供された Webhook を介して、オプトアウトしたすべてのユーザーの情報を配布します。詳細については、[Honor User Opt-Outs](../guides/dsp-guide#honor-user-opt-outs) を参照してください。 DSP は、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、生の UID2 のオプトアウトステータスを確認することもできます。 |
+ | DSPs | UID2 Operator Service は、DSP に対して、その目的のために提供された Webhook を介して、オプトアウトしたすべてのユーザーの情報を配布します。詳細は [Honor User Opt-Outs](../guides/dsp-guide#honor-user-opt-outs) を参照してください。 DSP は、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、生の UID2 のオプトアウトステータスを確認することもできます。 |
| 広告主とデータプロバイダー | UID2 Operator Service は、[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを介して、広告主とデータプロバイダーにオプトアウト情報を配布します。別のオプションとして、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認することもできます。 |
| Sharers | UID2 Sharer は、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認することができます。 |
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md
index 15d40e1ae..256475808 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md
@@ -14,7 +14,7 @@ UID2 エコシステムには、特定のアクティビティを完了するた
各 UID2 参加者は、パーミッションが参加者の API クレデンシャルにリンクされています([Account Setup](gs-account-setup.md) と [UID2 Credentials](gs-credentials.md) を参照してください)。
:::note
-パブリッシャーで、Client-Side に UID2 を実装している場合、API パーミッションは適用されません。代わりに、Client-Side のトークンリクエストを生成するための別の認証情報を受け取ることになります。詳細については、[Subscription ID and Public Key](gs-credentials.md#subscription-id-and-public-key) を参照してください。
+パブリッシャーで、Client-Side に UID2 を実装している場合、API パーミッションは適用されません。代わりに、Client-Side のトークンリクエストを生成するための別の認証情報を受け取ることになります。詳細は [Subscription ID and Public Key](gs-credentials.md#subscription-id-and-public-key) を参照してください。
:::
参加者は、関連するパーミッションを持つ API クレデンシャルのセットを 1 つ以上持つことができます。複数の API パーミッションを持つ場合、それぞれのパーミッションに対して個別のクレデンシャルセットを持つか、すべてのパーミッションに対して単一のクレデンシャルセットを持つかのオプションがあります。各パーミッションに対して別々のクレデンシャルセットを持つことを推奨します。
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 2e8b84e35..a41c382ed 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
@@ -23,7 +23,7 @@ DII とは、正規化されたメールアドレスや電話番号、あるい
![Advertiser Flow](images/advertiser-flow-mermaid.png)
-
+
図の各部の詳細については、以下のセクションを参照してください:
1. [Retrieve a raw UID2 for DII using the identity map endpoints](#1-retrieve-a-raw-uid2-for-dii-using-the-identity-map-endpoint)
@@ -35,7 +35,7 @@ DII とは、正規化されたメールアドレスや電話番号、あるい
| Step | Endpoint | Description |
| --- | --- | --- |
| 1-a | [POST /identity/map](../endpoints/post-identity-map.md)リクエスト | DII を含むリクエストを ID マッピングエンドポイントに送信します。 |
-| 1-b | [POST /identity/map](../endpoints/post-identity-map.md) レスポンス | レスポンスで返される `advertising_id` (raw UID2) は、関連する DSP でオーディエンスをターゲティングするために使用できます。 このレスポンスは、ユーザーの raw UID2 と、ソルトバケットに対応する `bucket_id` を返します。バケットに割り当てられたソルトは毎年ローテーションされ、生成される raw UID2 に影響を与えます。ソルトバケットのローテーションをチェックする方法の詳細については、[3: Monitor for salt bucket rotations](#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s) を参照してください。 メンテナンスを簡単にするために、ユーザの raw UID2 と `bucket_id` をマッピングテーブルに格納することを推奨します。インクリメンタルな更新に関するガイダンスについては、[Use an incremental process to continuous-update raw UID2s](#use-an-incremental-process-to-continuously-update-raw-uid2s) を参照してください。|
+| 1-b | [POST /identity/map](../endpoints/post-identity-map.md) レスポンス | レスポンスで返される `advertising_id` (raw UID2) は、関連する DSP でオーディエンスをターゲティングするために使用できます。 このレスポンスは、ユーザーの raw UID2 と、ソルトバケットに対応する `bucket_id` を返します。バケットに割り当てられたソルトは毎年ローテーションされ、生成される raw UID2 に影響を与えます。ソルトバケットのローテーションをチェックする方法の詳細は [3: Monitor for salt bucket rotations](#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s) を参照してください。 メンテナンスを簡単にするために、ユーザの raw UID2 と `bucket_id` をマッピングテーブルに格納することを推奨します。インクリメンタルな更新に関するガイダンスについては、[Use an incremental process to continuous-update raw UID2s](#use-an-incremental-process-to-continuously-update-raw-uid2s) を参照してください。|
### 2: Send stored raw UID2s to DSPs to create audiences
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 b560fd34c..c2ec3477d 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
@@ -26,7 +26,9 @@ DSP はビッドリクエストで UID2 Token を受け取り、この機能を
1. [Honor user opt-outs](#honor-user-opt-outs)
2. [Decrypt UID2 tokens for RTB use](#decrypt-uid2-tokens-for-rtb-use)
-![](images/dsp-guide-flow-mermaid.png)
+![DSP Flow](images/dsp-guide-flow-mermaid.png)
+
+
### Honor User Opt-Outs
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/google-ss-integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/google-ss-integration.md
index c487807dd..454526337 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/google-ss-integration.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/google-ss-integration.md
@@ -78,13 +78,17 @@ SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID
詳しくは [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) を参照してください。
-
+SDK for JavaScript を使用したインテグレーションのためのサンプルアプリケーションも用意されています。[Sample Applications](#sample-applications) を参照してください。
## Sample Applications
Google Ad Manager のセキュアシグナル機能との連携方法については、以下のサンプルアプリケーションを参照してください:
-- [Server-Only UID2 Integration Example](https://secure-signals-srvonly-integ.uidapi.com/)
-- [Client-Server UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/)
+- Server-Side UID2 Integration Example:
+ - [Sample application](https://secure-signals-srvonly-integ.uidapi.com/)
+ - [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_only)
+- Client-Server UID2 SDK Integration Example:
+ - [Sample application](https://secure-signals-jssdk-integ.uidapi.com/)
+ - [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
各サンプルアプリケーションには独自のインストラクションがあります。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png
index 0fd2b6e29..1be8cab62 100644
Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png differ
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/dsp-guide-flow-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/dsp-guide-flow-mermaid.png
index a8274238e..fec02fd8b 100644
Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/dsp-guide-flow-mermaid.png and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/dsp-guide-flow-mermaid.png differ
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/integration-publisher-server-side-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/integration-publisher-server-side-mermaid.png
index 2b5a9025d..3bf5f6f2a 100644
Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/integration-publisher-server-side-mermaid.png and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/integration-publisher-server-side-mermaid.png differ
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk
index d59073917..177702568 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk
@@ -1,17 +1,35 @@
+
+
+
+
+
+
sequenceDiagram
- participant DP as Data Provider
- participant UID2 as UID2 Service
- participant DSP
- loop 1. IDマップエンドポイントを使用して、DIIのUID2を取得します。
- DP->>UID2: 1-a. DIIを含むリクエストをIDマッピングエンドポイントに送信します。
- UID2->>DP: 1-b. ID マッピングサービスから返された raw UID2 とソルトバケットを格納します。
- end
- DP-->>DSP: 2. 蓄積したraw UID2をDSPに送信し、オーディエンスを作成します。
- loop 3. 蓄積されているUID2に関連するソルトバケットのローテーションを監視します。
- DP->>UID2: 3-a. バケットサービスを利用して、ソルトバケットのローテーションを返します。
- UID2->>DP: 3-b. 指定されたタイムスタンプ以降にローテーションしたソルトバケットを返します。
- DP->>UID2: 3-c. ローテーションしたソルトバケットと保存されているUID2ソルトバケットを比較します。 ローテーションした場合は、新しいraw UID2のためにDIIをIDマッピングサービスに再送信します。
- UID2->>DP: 3-d. ID マッピングサービスから返された raw UID2 とソルトバケットを保存します。
- end
-
-
+ participant DP as Data Provider
+ participant UID2 as UID2 Operator
+ participant DSP
+ loop 1. IDマップエンドポイントを使用して、DII の UID2 を取得します。
+ DP->>UID2: 1-a. DII を含むリクエストを ID マッピングエンドポイントに送信します。
+ UID2->>DP: 1-b. ID マッピングサービスから返された raw UID2 とソルトバケットを格納します。
+ end
+ DP-->>DSP: 2. 蓄積した raw UID2 を DSP に送信し、オーディエンスを作成します。
+
+ loop 3. 蓄積されている UID2 に関連するソルトバケットのローテーションを監視します。
+ DP->>UID2: 3-a. バケットサービスを利用して、ソルトバケットのローテーションを返します。
+ UID2->>DP: 3-b. 指定されたタイムスタンプ以降にローテーションしたソルトバケットを返します。
+ DP->>UID2: 3-c. ローテーションしたソルトバケットと保存されている UID2 ソルトバケットを比較します。 ローテーションした場合は、新しい raw UID2 のために DII を ID マッピングサービスに再送信します。
+ UID2->>DP: 3-d. ID マッピングサービスから返された raw UID2 とソルトバケットを保存します。
+ end
+
+
+
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/dsp-guide-flow-mermaid.md.bk b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/dsp-guide-flow-mermaid.md.bk
index d69d67989..6d8e09e43 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/dsp-guide-flow-mermaid.md.bk
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/dsp-guide-flow-mermaid.md.bk
@@ -1,21 +1,39 @@
+
+
+
+
+
+
sequenceDiagram
participant U as User
participant SSP
participant DSP
- participant UID2 as UID2 Service
+ participant EUID as UID2 Operator
participant TC as Transparency & Control Portal
Note over U,TC: 1. ユーザーのオプトアウトを受け入れます。
U->>TC: 1-a. ユーザーがオプトアウトしました。
activate TC
- TC->>UID2: 1-b. UID2 Serviceはオプトアウトを受け付けます。
+ TC->>EUID: 1-b. UID2 Servic はオプトアウトを受け付けます。
deactivate TC
- activate UID2
- UID2->>DSP: 1-c. DSPはオプトアウトを受信します。
- deactivate UID2
- Note over U,TC: 2. RTBで使用する UID2 Token を復号化します。
- SSP-->>DSP: SSPは入札のためにDSPを呼び出します。
+ activate EUID
+ EUID->>DSP: 1-c. DSP はオプトアウトを受信します。
+ deactivate EUID
+ Note over U,TC: 2. RTB で使用する UID2 Token を復号化します。
+ SSP-->>DSP: SSP は入札のために DSP を呼び出します。
DSP->>DSP: 2-a. UID2 Token を復号化します。
DSP->>DSP: 2-b. 1 からのユーザーオプトアウトを受け入れた入札ロジックを実行します。
-
+
+
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-javascript-client-server-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-javascript-client-server-mermaid.md.bak
index a9dfa0495..5e2568ff2 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-javascript-client-server-mermaid.md.bak
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-javascript-client-server-mermaid.md.bak
@@ -1,4 +1,8 @@
-sequenceDiagram
+
+
+
+
+ sequenceDiagram
participant U as User
participant P as Publisher
participant UID2 as UID2 Service
@@ -47,8 +51,15 @@ sequenceDiagram
P->>U: 4-b. パブリッシャーはユーザーの UID2 Token をクリアします。
deactivate P
-
+}
+ -->
+
+
\ No newline at end of file
+-->
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-publisher-server-side-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-publisher-server-side-mermaid.md.bak
new file mode 100644
index 000000000..a48919211
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/integration-publisher-server-side-mermaid.md.bak
@@ -0,0 +1,66 @@
+
+
+
+
+ sequenceDiagram
+ participant U as User
+ participant P as Publisher
+ participant UID2 as UID2 Operator
+ participant SSP
+
+ Note over U,SSP: 1. アイデンティティの確立
+ U->>+P: 1-a. ユーザーがパブリッシャーアセットにアクセスした。
+ P->>-U: 1-b. パブリッシャーは、データの活用についての透明性を提供します。
+ activate U
+ U->>P: 1-c. ユーザー認証
+ deactivate U
+ activate P
+ P->>UID2: 1-d. パブリッシャーはユーザーの DII をトークン生成サービスに送信します。
+ deactivate P
+ activate UID2
+ UID2->>P: 1-e. トークン生成サービスは、UID2 Token を返します。
+ deactivate UID2
+ activate P
+ P->>U: 1-f. パブリッシャーはユーザーに UID2 を設定します。
+ deactivate P
+
+ Note over U,SSP: 2. UID2 Token を用いた入札
+ P->>SSP: 2-a. パブリッシャーは UID2 Token を使って広告のために SSP を呼び出します。
+ activate SSP
+ SSP->>P: 2-b. SSP は、表示する広告を返します。
+ deactivate SSP
+ activate P
+ P->>U: 2-c. パブリッシャーは、ユーザーに広告を表示します。
+ deactivate P
+
+ Note over U,SSP: 3. UID2 Token のリフレッシュ
+ U->>P: 3-a. ユーザーがパブリッシャーアセットに戻ります。
+ activate P
+ P->>UID2: 3-b. パブリッシャーは Refresh Token を使用して、ユーザーの新しい UID2 Token をリクエストします。
+ deactivate P
+ activate UID2
+ UID2->>P: 3-c. ユーザーがオプトアウトしていない場合、Refresh Token Service は新しい UID2 Token を返します。
+ deactivate UID2
+ activate P
+ P->>U: 3-d. パブリッシャーはユーザーの新しい UID2 を設定します。
+ deactivate P
+
+ Note over U,SSP: 4. ユーザーログアウト
+ U->>P: 4-a. ユーザーがパブリッシャーアセットからログアウトしました。
+ activate P
+ P->>U: 4-b. パブリッシャーはユーザーの UID2 Token をクリアします。
+ deactivate P
+
+
+
+
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-dsp-no-sdk.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-dsp-no-sdk.md
index b90f1d3f3..d15a2e259 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-dsp-no-sdk.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-dsp-no-sdk.md
@@ -154,7 +154,7 @@ For more information about client-side UID2 integration, refer to one of these i
- [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md)
- [UID2 Client-Side Integration Guide for Mobile](integration-mobile-client-side.md)
-### Honor User Opt-Out After Token Decryption
+## Honor User Opt-Out After Token Decryption
After decrypting the token, you must check the resulting raw UID2 against your opt-out records. If it appears on your opt-out records, you must honor the user's opt-out preference, including by not using the UID2 for bidding.
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 717eed16b..05f696afb 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
@@ -18,7 +18,7 @@ import ExampleClientServerSendUid2ToSdk from '/docs/snippets/_example-client-ser
Client-Side の JavaScript の変更 **だけ** で UID2 とインテグレーションする場合は、[Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) を参照してください。
-SDK の技術的な詳細については、[SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照してください。
+SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照してください。
## Sample Implementation Website
@@ -50,6 +50,8 @@ Google Ad Managerを使用していて、セキュアシグナル機能を使用
![Publisher Flow](images/integration-javascript-client-server-mermaid.png)
+
+
以下のセクションでは、図中の各ステップについての詳細を説明します:
1. [Establish identity: capture user data](#establish-identity-capture-user-data)
@@ -77,7 +79,7 @@ Step 1-c でパブリッシャーがユーザーのメールアドレスまた
`Identity` レスポンスを SDK に渡す必要があります。[Sending the UID2 Token to the SDK](#sending-the-uid2-token-to-the-sdk) を参照してください。
:::warning
-セキュリティ上の理由から、トークン生成に使用される API キーとシークレットはサーバーサイドで呼び出す必要があります。これらの値をクライアントサイドに保存しないでください。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。
+セキュリティ上の理由から、トークン生成に使用される API キーとシークレットはサーバーサイドで呼び出す必要があります。これらの値をクライアントサイドに保存しないでください。詳細は [Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。
:::
#### Sending the UID2 Token to the SDK
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 2d999be19..72b6ec285 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
@@ -68,7 +68,7 @@ SDK のデバッグビルドを使用したい場合は、代わりに以下の
アカウント設定ページに記載されている手順に従って、UID2 アカウントの設定を完了してください。アカウント設定プロセスの一環として、この SDK for JavaScript で使用するサイトの**ドメイン名**のリストを提供する必要があります。
-アカウントのセットアップが完了すると、Publicc Key(公開鍵) と Subesciption ID(サブスクリプション ID) が発行されます。これらの値はアカウント固有のもので、UID2 モジュールの設定に使用します。
+アカウントのセットアップが完了すると、UID2 サーバーがユーザーを識別するために使用する 2 つの値であるクライアントキーペアが発行されます: Subscription ID と Public key。これらの値はあなたに固有で、UID2 モジュールの設定に使用します。詳細は [Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key) を参照してください。
:::tip
アカウント設定に必要なのは、ルートレベルのドメインだけです。例えば、JavaScript 用の UID2 SDK を example.com、shop.example.com、example.org で使用する場合、ドメイン名 example.com と example.org を指定するだけです。
@@ -113,7 +113,7 @@ window.__uid2.callbacks.push((eventType, payload) => {
```
-SDK の詳細については、[SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照してください。
+SDK の詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照してください。
### Using the UID2 Integration Environment
@@ -165,7 +165,7 @@ SDK を設定するには、アカウントセットアップ時に受け取っ
- トークンをユーザーのブラウザに保存します。
- ユーザーのブラウザでサイトを開いている間、必要に応じてトークンを自動的にリフレッシュします。
-UID2 SDK には、ユーザーの DII をハッシュ化して渡すことも、ハッシュ化せずに渡すこともできます。ハッシュ化せずに DII を渡すと、UID2 SDK が代わりにハッシュ化します。すでにハッシュ化された DII を SDK に渡したい場合は、ハッシュ化する前に正規化する必要があります。詳細については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
+UID2 SDK には、ユーザーの DII をハッシュ化して渡すことも、ハッシュ化せずに渡すこともできます。ハッシュ化せずに DII を渡すと、UID2 SDK が代わりにハッシュ化します。すでにハッシュ化された DII を SDK に渡したい場合は、ハッシュ化する前に正規化する必要があります。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
## Format Examples for DII
@@ -220,7 +220,7 @@ await __uid2.setIdentityFromEmailHash(
```
このシナリオでは:
-- **メールアドレスの正規化とハッシュ化はパブリッシャーの責任です。** 詳細については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
+- **メールアドレスの正規化とハッシュ化はパブリッシャーの責任です。** 詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
- UID2 SDK は、UID2 Service に送信する前にハッシュを暗号化します。
@@ -281,7 +281,9 @@ await __uid2.setIdentityFromPhoneHash(
既存のトークンをチェックし、使用またはリフレッシュすることで、このコストを回避できる可能性があります。これを行うには
[__uid2.isLoginRequired](../sdks/sdk-ref-javascript#isloginrequired-boolean) を呼び出し、ブール値を受け取ります。これが `true` の場合、UID2 SDK は既存のリソースで新しい Advertising Token を作成できず、DII はまったく新しい UID2 Token を生成する必要があることを意味します。
-以下のコードスニペットは、SDK for JavaScript とインテグレーションして、上記の 2 つのシナリオを実現する方法を示しています。—トークンがない状態から開始し、既存の UID2 Token が見つかった場合はそれを再利用/リフレッシュします。
+DII を提供すると、[__uid2.isLoginRequired](../sdks/sdk-ref-javascript#isloginrequired-boolean) が `false` の値を返す可能性があります。これは、ユーザーが UID2 からオプトアウトしている場合に発生します。UID2 SDK for JavaScript は、ユーザーのオプトアウトを受け入れ、UID2 Token を生成しないため、同じ DII を使用していても、`setIdentity` メソッドのいずれかを呼び出しても UID2 Token を生成しません。オプションとして、このような呼び出し実行しないようにすることもできます。
+
+以下のコードスニペットは、UID2 SDK for JavaScript とインテグレーションして、上記の 2 つのシナリオを実現する方法を示しています。—トークンがない状態から開始し、既存の UID2 Token が見つかった場合はそれを再利用/リフレッシュします。
```js
@@ -311,7 +313,7 @@ window.__uid2.callbacks.push(async (eventType, payload) => {
// The InitCompleted event occurs just once.
//
// If there is a valid UID2 token, it is in payload.identity.
- if (payload.identity) {
+ if (payload?.identity) {
//
// payload looks like this:
// {
@@ -326,25 +328,29 @@ window.__uid2.callbacks.push(async (eventType, payload) => {
// }
var advertising_token_to_use = payload.identity.advertising_token;
} else {
- if (__uid2.isLoginRequired()) {
+ if (__uid2.isLoginRequired()) {
// Call one of the setIdentityFrom functions to generate a new UID2 token.
// Add any retry logic around this call as required.
await __uid2.setIdentityFromEmailHash(
emailHash,
- clientSideConfig
- );
+ clientSideConfig);
+ }
else {
- // there is a token generation API call in flight which triggers
- // a IdentityUpdated event
+ // there is a token generation API call in flight which triggers a IdentityUpdated event
+ // or no token would be generated because one of previous `setIdentity` calls determines the DII has opted out.
}
- }
}
break;
case "IdentityUpdated":
// The IdentityUpdated event happens when a UID2 token is generated or refreshed.
// See previous comment for an example of how the payload looks.
- var advertising_token_to_use = payload.identity.advertising_token;
+ // It's possible that payload/identity objects could be null for reasons such as the token
+ // expired and cannot be refreshed, or the user opted out of UID2.
+ // Check that the advertising token exists before using it.
+ if (payload?.identity?.advertising_token) {
+ var advertising_token_to_use = payload.identity.advertising_token;
+ }
break;
}
});
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 a38cb8778..975e491b6 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
@@ -34,6 +34,8 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref
このガイドの、**UID2 mobile SDKs** は、SDK for Android と SDK for iOS の両方を含むグループ用語です。
:::
+モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。
+
以下の手順を完了する必要があります:
1. [Complete the UID2 account setup](#complete-the-uid2-account-setup).
@@ -56,7 +58,7 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref
アカウントの設定を完了するには、[Account Setup](../getting-started/gs-account-setup.md) に記載されている手順に従ってください。
-アカウントの設定が完了すると、ユニークな API Key とクライアントシークレットが送信されます。これらの値はあなたに固有であり、安全に保管することが重要です。詳細については、[API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。
+アカウントの設定が完了すると、ユニークな API Key とクライアントシークレットが送信されます。これらの値はあなたに固有であり、安全に保管することが重要です。詳細は [API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。
## Client-Server Mobile Integration Data Flow Overview
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 9d7ccf4f6..10cbd0f47 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
@@ -33,6 +33,8 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref
このガイドの、**UID2 mobile SDKs** は、SDK for Android と SDK for iOS の両方を含むグループ用語です。
:::
+モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。
+
UID2 を Client-Side でインテグレーションするには、以下の手順を完了する必要があります:
1. [Complete the UID2 account setup](#complete-the-uid2-account-setup).
@@ -177,7 +179,7 @@ see UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist
-必要に応じて、デフォルトの Subscription ID と public key を割り当てられた値に変更し、UID2 本番環境に接続することもできます。詳細については、[Optional: Specifying the API Base URL to Reduce Latency](#optional-specifying-the-api-base-url-to-reduce-latency) を参照してください。
+必要に応じて、デフォルトの Subscription ID と public key を割り当てられた値に変更し、UID2 本番環境に接続することもできます。詳細は [Optional: Specifying the API Base URL to Reduce Latency](#optional-specifying-the-api-base-url-to-reduce-latency) を参照してください。
## Complete the UID2 Account Setup
@@ -187,7 +189,7 @@ see UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist
- iOS Bundle Identifier
- iOS App Store ID
-When account setup is complete, you'll receive a [Subscription ID and public key](../getting-started/gs-credentials.md#subscription-id-and-public-key). These values are unique to you, and you'll use them when you [configure the UID2 mobile SDK](#configure-the-uid2-mobile-sdk).
+アカウントのセットアップが完了すると、UID2 サーバーがユーザーを識別するために使用する 2 つの値であるクライアントキーペアが発行されます: Subscription ID と Public key。これらの値はあなたに固有で、UID2 モジュールの設定に使用します。詳細は [Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key) を参照してください。
## Add the UID2 Mobile SDK to Your Mobile App
@@ -309,7 +311,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
@@ -424,7 +426,7 @@ Task {
このシナリオでは:
-- パブリッシャーはメールアドレスを正規化およびハッシュ化する責任があります。詳細については、[Email Address Normalization](../getting-started/gs-normalization-encoding.md#email-address-normalization) を参照してください。
+- パブリッシャーはメールアドレスを正規化およびハッシュ化する責任があります。詳細は [Email Address Normalization](../getting-started/gs-normalization-encoding.md#email-address-normalization) を参照してください。
- UID2 mobile SDK は、ハッシュ化された DII を UID2 Service に送信する前に暗号化します。
@@ -476,7 +478,7 @@ Task {
このシナリオでは:
-- パブリッシャーは電話番号を正規化する責任があります。詳細については、[Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) を参照してください。
+- パブリッシャーは電話番号を正規化する責任があります。詳細は [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) を参照してください。
- UID2 mobile SDK は、ハッシュ化された電話番号を UID2 Service に送信する前に暗号化します。
@@ -524,7 +526,7 @@ Task {
このシナリオでは:
-- パブリッシャーは電話番号を正規化およびハッシュ化する責任があります。詳細については、[Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) を参照してください。
+- パブリッシャーは電話番号を正規化およびハッシュ化する責任があります。詳細は [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) を参照してください。
- UID2 mobile SDK は、ハッシュ化された DII を UID2 Service に送信する前に暗号化します。
@@ -665,7 +667,7 @@ UID2Manager.shared.getAdvertisingToken()
-`getAdvertisingToken()` が null を返し、identity ステータスが `OPT_OUT`/`optOut` でない場合、新しいトークンを生成する必要があります。これを行うには、`generateIdentity` メソッドに DII を再度渡します。詳細については、[Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。
+`getAdvertisingToken()` が null を返し、identity ステータスが `OPT_OUT`/`optOut` でない場合、新しいトークンを生成する必要があります。これを行うには、`generateIdentity` メソッドに DII を再度渡します。詳細は [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。
+
次のセクションでは、図中の各ステップについて詳細を説明します:
1. [Establish identity: capture user data](#establish-identity-capture-user-data)
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 9d04f618d..1997ea089 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
@@ -119,7 +119,7 @@ AWS で 1 つまたは複数の UID2 Operator をサブスクライブしてデ
以下は、[デプロイ](#deployment) の実行中または実行後にカスタマイズできる内容です。
-- VPC: 新しい VPC とサブネットを設定するか、既存のものを使用するかのどちらかです。
+- VPC: 既存の VPC と関連する VPC サブネット ID を指定する必要があります。
- ルートボリュームサイズ (8G Minimum)
- SSH キー: UID2 Operator の EC2 インスタンスにアクセスする際に使用する SSH キーです。
- [Instance type](https://aws.amazon.com/ec2/instance-types/m5/): m5.2xlarge、m5.4xlarge、といった具合です。カスタマイズがない場合は、デフォルト値の m5.2xlarge を推奨します。
@@ -187,7 +187,9 @@ UID2 Operator を AWS Marketplace にデプロイするには、以下の手順
| Instance root volume size | 15GB 以上を推奨します。 |
| Key Name for SSH | デプロイされた EC2 インスタンスに SSH アクセスするための EC2 キーペアです。 |
| Trusted Network CIDR | CIDR (Classless Inter-Domain Routing) 値は、オペレーターサービスにアクセスできる IP アドレス範囲を決定します。 UID2 オペレーターへのアクセスを制限して、内部ネットワークまたはロードバランサーからのみアクセスできるようにするには、CIDR 値として内部 IP 範囲を指定します。 |
-
+| VPC | 既存の VPC ID。 |
+| VpcSubnet1 | 既存の VPC AZ1 サブネット ID。 |
+| VpcSubnet2 | 既存の VPC AZ2 サブネット ID。 |
### Stack Configuration Options
@@ -293,7 +295,7 @@ Operator インスタンスがデプロイされると、デフォルトのロ
}
```
-この設定の詳細については、[logrotate(8) - Linux man page](https://linux.die.net/man/8/logrotate) を参照するか、Linux 環境で `man logrotate` を実行してください。
+この設定の詳細は [logrotate(8) - Linux man page](https://linux.die.net/man/8/logrotate) を参照するか、Linux 環境で `man logrotate` を実行してください。
#### cronjob Configuration
logrotate は、デフォルトで `/etc/cron.daily` に次のスクリプトを生成します:
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 1cbfecb47..3d9244f98 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
@@ -12,7 +12,7 @@ import ReleaseMatrix from '/docs/snippets/_private-operator-release-matrix.mdx';
# UID2 Private Operator for Azure Integration Guide
-このガイドでは、Microsoft Azure の [Confidential Container](https://learn.microsoft.com/en-us/azure/confidential-computing/confidential-containers) で UID2 Operator サービスを設定する方法について説明します。Confidential Container は、Microsoft Azure の機密コンピューティングオプションで、データの整合性、データの機密性、コードの整合性などの固有の機能を提供するハードウェアバックドの Trusted Execution Environment (TEE) で実行されます。
+このガイドでは、Microsoft Azure の [Confidential Container](https://learn.microsoft.com/en-us/azure/confidential-computing/confidential-containers) で UID2 Operator Serviceを設定する方法について説明します。Confidential Container は、Microsoft Azure の機密コンピューティングオプションで、データの整合性、データの機密性、コードの整合性などの固有の機能を提供するハードウェアバックドの Trusted Execution Environment (TEE) で実行されます。
UID2 Operator Confidential Container の Docker コンテナが起動すると、UID2 Core Service は Operator Service と Operator Service が実行されているエンクレーブ環境の信頼性を検証ための認証プロセスを完了します。
@@ -112,7 +112,13 @@ az group create --name {RESOURCE_GROUP_NAME} --location {LOCATION}
ロケーションには、いくつかの制限があります:
- UID2 Private Operator for Azure は、次の地域ではサポートされていません: Europe、China。
-- Azure 仮想ネットワークのデプロイメント可用性については、Azure ドキュメントの [Linux container groups](https://learn.microsoft.com/en-us/azure/container-instances/container-instances-region-availability#linux-container-groups) を参照してください。表の **Confidential SKU** 列が **Y** に設定されているリージョンのみにデプロイできます。
+- Azure 仮想ネットワーク展開の可用性については、Azure ドキュメントの「Linux container groups(https://learn.microsoft.com/en-us/azure/container-instances/container-instances-resource-and-quota-limits#confidential-container-resources-preview) を確認し、Confidential Container の地域サポートの可用性を確認してください。
+
+- 場所のエイリアスを取得するには、次のコマンドを実行します。
+
+```
+az account list-locations -o table
+```
### Complete Key Vault and Managed Identity Setup
@@ -182,7 +188,7 @@ Microsoft Azure で UID2 Private Operator をホストする Virtual Private Clo
| Parameter | Description |
| :--- | :--- |
| `vaultName` | Operator Key シークレットをホストするためのキー vault の名前。選択する名前はグローバルに一意である必要があります。 |
- | `deploymentEnvironment` | デプロイ先の環境を示します: `integ` または `prod`。詳細については、[Deployment Environments](#deployment-environments) を参照してください。 |
+ | `deploymentEnvironment` | デプロイ先の環境を示します: `integ` または `prod`。詳細は [Deployment Environments](#deployment-environments) を参照してください。 |
2. (オプション) デフォルトを受け入れたくない場合は、`operator.parameters.json` ファイルを次の値で更新します。これらのパラメータはデフォルト値を受け入れたくない場合にのみ更新する必要があります。
@@ -286,6 +292,11 @@ import AttestFailure from '/docs/snippets/_private-operator-attest-failure.mdx';
+### Scraping Metrics
+Azure の Private Operator は、ポート 9080 で `/metrics` エンドポイントを介して [Prometheus-formatted metric](https://prometheus.io/docs/concepts/data_model/) を公開します。これらのメトリクスを収集して集計するために、Prometheus 互換のスクレイパーを使用できます。
+
+スクレイパーは、Private Operator が実行されている VNet にアクセスできる必要があります。ロードバランサーに `/metrics` エンドポイントへのアクセスを許可することは勧めません。
+
## Upgrading
UID2 Azure Confidential Container の新しいバージョンがリリースされると、Private Operator は新しいリリースリンクを含む更新通知のメールを受信します。アップグレードのためのウィンドウがあり、その後、古いバージョンは非アクティブ化され、サポートされなくなります。
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 f6724bc30..85ca4babe 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
@@ -342,6 +342,9 @@ gcloud CLI を使用して、UID2 Operator Service を実行するためのサ
--source-ranges=0.0.0.0/0 \
--target-service-accounts={SERVICE_ACCOUNT_NAME}@{PROJECT_ID}.iam.gserviceaccount.com
```
+:::warning
+`source-ranges` は、クライアントが Private Operator を呼び出すために使用する IP アドレスの範囲を指定します。CIDR 表記であり、複数の範囲を提供するためにカンマ区切りの値を使用できます。例: `--source-ranges="。範囲が正確であり、自分のものである IP アドレスのみが含まれていることを確認してください。
+:::
#### Create Secret for the Operator Key in Secret Manager
@@ -449,14 +452,7 @@ $ gcloud compute instances create {INSTANCE_NAME} \
手順については、[Health Check—gcloud CLI](#health-checkgcloud-cli) を参照してください。
-## Tasks
-
-このセクションでは、次のタスクの完了手順を提供します。該当する場合は、両方の環境についての手順が提供されます。以下を含みます:
-
-- [Running the Health Check](#running-the-health-check)
-- [Upgrading](#upgrading)
-
-### Running the Health Check
+## Running the Health Check
ヘルスチェックエンドポイントを呼び出して、実装の健全性をテストします。
@@ -467,7 +463,7 @@ $ gcloud compute instances create {INSTANCE_NAME} \
- [Health Check—Terraform Template](#health-checkterraform-template)
- [Health Check—gcloud CLI](#health-checkgcloud-cli)
-#### Health Check—Terraform Template
+### Health Check—Terraform Template
次の例は、Terraform テンプレートオプションのヘルスチェックを示しています:
@@ -482,7 +478,7 @@ $ gcloud compute instances create {INSTANCE_NAME} \
HTTP 200 とレスポンスボディが `OK` の場合、健全な状態です。
-#### Health Check—gcloud CLI
+### Health Check—gcloud CLI
次の例は、`gcloud` コマンドラインオプションのヘルスチェックを示しています:
1. デプロイされたインスタンスのパブリック IP アドレスを取得します:
@@ -518,3 +514,6 @@ Terrafom テンプレートを使用してデプロイした場合、アップ
gcloud CLI を使用してデプロイした場合、アップグレードするには、新しい `{OPERATOR_IMAGE}` を使用して新しいインスタンスを立ち上げ、古いインスタンスをシャットダウンする必要があります。
手動でロードバランサーを設定した場合、ロードバランサーのマッピングも更新する必要があります。
+
+## Scraping Metrics
+GCP の Private Operator は、`/metrics` エンドポイントで [Prometheus-formatted metrics](https://prometheus.io/docs/concepts/data_model/) ポート 9080 で公開します。Prometheus 互換のスクレイパーを使用して、これらのメトリクスを収集して集計することができます。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md
index 0cf6273b9..9a9790632 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md
@@ -21,11 +21,11 @@ UID2 の以下のリストが Snowflake marketplace で入手可能です:
次の表は、UID2 Snowflake インテグレーション で利用可能な機能をまとめたものです。
-| Encrypt Raw UID2 to UID2 Token | Decrypt Raw UID2 from UID2 Token | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s |
+| Encrypt Raw UID2 to UID2 Token | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s |
| :--- | :--- | :--- | :--- | :--- |
-| Supported | Supported | Not supported* | Not supported | Supported |
+| ✅ | ✅ | —* | — | ✅ |
-*DII から直接 UID2 Token を生成することはできません。しかし、DII を raw UID2 に変換し、raw UID2 を暗号化して UID2 Token にすることはできます。
+*Snowflake を使用して DII から直接 UID2 Token を生成することはできません。ただし、DII を raw UID2 に変換し、raw UID2 を UID2 Tokenに暗号化することはできます。
:::note
ビッドストリームで UID2 Token を共有するパブリッシャーの場合は、[Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md) を参照してください
@@ -475,7 +475,7 @@ select a.*, b.LAST_SALT_UPDATE_UTC
- 電話番号とハッシュ化された電話番号の両方のマッピングをサポートしています。
- ユーザーのオプトアウトをサポートしました。
-- `UNMAPPED` という新しいカラムが追加されました。何らかの理由で DII を UID2 にマッピングできない場合、この列にはその理由についての情報が含まれます。詳細については、[Values for the UNMAPPED Column](#values-for-the-unmapped-column) を参照してください。
+- `UNMAPPED` という新しいカラムが追加されました。何らかの理由で DII を UID2 にマッピングできない場合、この列にはその理由についての情報が含まれます。詳細は [Values for the UNMAPPED Column](#values-for-the-unmapped-column) を参照してください。
このセクションには、新機能へのアップグレードに役立つ以下の情報が含まれています:
@@ -517,7 +517,7 @@ FN_T_UID2_IDENTITY_MAP(EMAIL_HASH, 'email_hash')
### Using the Values for the UNMAPPED Column
新しい関数を実装したら、`FN_T_UID2_IDENTITY_MAP`が返す `UNMAPPED` カラムをチェックすることができます。DII が UID2 にマッピングできなかった場合、この列にはその理由が示されます。
-値とその説明の詳細については、[Values for the UNMAPPED Column](#values-for-the-unmapped-column) を参照してください。
+値とその説明の詳細は [Values for the UNMAPPED Column](#values-for-the-unmapped-column) を参照してください。
## Usage for UID2 Sharers
@@ -551,7 +551,7 @@ raw UID2 を UID2 Token に暗号化するには、関数 `FN_T_UID2_ENCRYPT`
|Column Name|Data Type|Description|
| :--- | :--- | :--- |
| `UID2_TOKEN` | TEXT | 値は次のいずれかです:
暗号化成功: raw UID2 を含む UID2 Token。
暗号化失敗: `NULL`
|
-| `ENCRYPTION_STATUS` | TEXT | 値は次のいずれかです。
暗号化成功: `NULL`
暗号化失敗: raw UID2 が暗号化されなかった理由。例: `INVALID_RAW_UID2` または `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`。 詳細については、[Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column) を参照してください。
|
+| `ENCRYPTION_STATUS` | TEXT | 値は次のいずれかです。
暗号化成功: `NULL`
暗号化失敗: raw UID2 が暗号化されなかった理由。例: `INVALID_RAW_UID2` または `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`。 詳細は [Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column) を参照してください。
|
#### Values for the ENCRYPTION_STATUS Column
@@ -638,7 +638,7 @@ UID2 Token を raw UID2 に復号するには、関数 `FN_T_UID2_DECRYPT` を
| :--- | :--- | :--- |
| `UID2` | TEXT | 値は次のいずれかです:
復号化成功: UID2 Token に対応する raw UID2。
復号化失敗: `NULL`.
|
| `SITE_ID` | INT | 値は次のいずれかです:
復号化成功: トークンを暗号化した UID2 参加者の識別子。
復号化失敗: `NULL`.
|
-| `DECRYPTION_STATUS` | TEXT | 値は次のいずれかです:
復号化成功: `NULL`.
暗号化失敗: UID2 Token が復号化されなかった理由。例えば、`EXPIRED_TOKEN` です。 詳細については、[Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column) を参照してください。
|
+| `DECRYPTION_STATUS` | TEXT | 値は次のいずれかです:
復号化成功: `NULL`.
暗号化失敗: UID2 Token が復号化されなかった理由。例えば、`EXPIRED_TOKEN` です。 詳細は [Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column) を参照してください。
|
:::note
UID2 Token がうまく復号化できない場合、この関数は行を返しません。
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 5627a3ead..a119b1833 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
@@ -36,7 +36,7 @@ import Link from '@docusaurus/Link';
以下のリソースは、パブリッシャーの Web インテグレーションに利用できます。
:::tip
-Web インテグレーションオプションの詳細については、[Web Integration Overview](integration-options-publisher-web.md) を参照してください。
+Web インテグレーションオプションの詳細は [Web Integration Overview](integration-options-publisher-web.md) を参照してください。
:::
| Integration Guide | Content Description |
@@ -108,7 +108,8 @@ The following resources are available for DSPs integrating with UID2.
| Integration Guide | Content Description |
| :--- | :--- |
-| [DSP](./dsp-guide.md) | この DSP のためのインテグレーションガイドは、入札のための UID2 の処理と、ユーザーのオプトアウトに対応することをカバーしています。 |
+| [DSP Integration Guide](../guides/dsp-guide.md) | この DSP 向けのインテグレーションガイドでは、入札およびユーザーオプトアウトの処理に関する UID2 の取り扱いについて説明しています。 |
+| [DSP Direct Integration Instructions](../guides/integration-dsp-no-sdk.md) | SDK を使用せずにインテグレーションを希望する DSP 向けの手順です。 |
## Private Operator Service Integrations
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md
index 1a0ae3fc2..003b18371 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md
@@ -86,6 +86,7 @@ UID2 を実装する DSP には、以下のドキュメントリソースが用
| SDK for C# / .NET | [SDK for C# / .NET Reference Guide](../sdks/sdk-ref-csharp-dotnet.md) | .NET Server-Side を使用し、UID2 Advertising Token を復号して raw UID2 にアクセスしたい人のための SDK。 |
| SDK for C++ | [SDK for C++ Reference Guide](../sdks/sdk-ref-cplusplus.md) | C++ Server-Side を使用し、UID2 Advertising Token を復号して raw UID2 にアクセスしたい人のための SDK。 |
| Integration Guide | [DSP Integration Guide](../guides/dsp-guide.md) | DSP 向けのこのインテグレーションガイドでは、入札のための UID2 の取り扱いと、ユーザーのオプトアウトの受け入れについて説明します。 |
+| DSP Direct Integration Instructions | [DSP Direct Integration Tips](../guides/integration-dsp-no-sdk.md) | UID2 SDK のいずれも使用せずにインテグレーションすることを希望する DSP 向けの手順。 |
@@ -67,7 +75,7 @@ UID2 とインテグレーションすることで得られるメリットの一
1. 該当する [implementation resources](#implementation-resources) を使用して、SDK または UID2 と直接インテグレーションしてください。
:::note
- UID2 へのリクエストメッセージは必ず暗号化してください。詳細については、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。
+ UID2 へのリクエストメッセージは必ず暗号化してください。詳細は [Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。
:::
1. テスト:
@@ -91,7 +99,7 @@ UID2 とインテグレーションすることで得られるメリットの一
以下のリソースは、パブリッシャーの Web インテグレーションに利用できます。
:::tip
-Web インテグレーションオプションの詳細については、[Web Integration Overview](../guides/integration-options-publisher-web.md) を参照してください。
+Web インテグレーションオプションの詳細は [Web Integration Overview](../guides/integration-options-publisher-web.md) を参照してください。
:::
| Integration Type| Documentation | Content Description |
@@ -114,6 +122,8 @@ Web インテグレーションオプションの詳細については、[Web In
| Android/iOS (Overview) | [Mobile Integration Overview for Android and iOS](../guides/integration-mobile-overview.md) | SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのオプションの概要です。 |
| Android/iOS, Client-Side Integration | [Client-Side Integration Guide for Mobile](../guides/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 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです: