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 482452c55..ef4c99caf 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 @@ -176,7 +176,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ | :------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `u` | string | リクエストで提供されたメールアドレスまたは電話番号に対応する raw UID2。 | | `p` | string | 以下のいずれか: | -| `r` | number | Unix タイムスタンプ（ミリ秒単位）で、raw UID2 がリフレッシュされる可能性のある時刻を示します。このタイムスタンプまで、raw UID2 は有効であることが保証されています。 | +| `r` | number | raw UID2 を更新する可能性がある時刻を示す Unix タイムスタンプ（ミリ秒）。raw UID2 はこのタイムスタンプまで有効です。 | :::note raw UID2 はリフレッシュタイムスタンプの前では変化しません。リフレッシュタイムスタンプの後、DII を再マッピングすると新しいリフレッシュタイムスタンプが返されますが、raw UID2 は変化する場合もあれば変化しない場合もあります。raw UID2 が複数のリフレッシュ間隔にわたって変化しない可能性もあります。 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 e782bb41a..449ef7947 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 @@ -15,11 +15,7 @@ import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-gen Used by: このエンドポイントは、主にパブリッシャーが使用します。 -:::important -`optout_check` パラメータは値 `1` が必須で、ユーザーがオプトアウトしたかどうかをチェックします。 -::: - - + このエンドポイントを直接呼び出すのではなく、UID2 SDK を使って管理することもできます。オプションの概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 @@ -41,12 +37,12 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | 必須 | インテグレーション環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。
Notes: | +| `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: ユーザーの所在地に応じて最適な URL が異なります。ユースケースに最適な URL の選択方法および有効なベース URL の全リストは、[Environments](../getting-started/gs-environments.md) を参照してください。
Notes: | ### Unencrypted JSON Body Parameters :::important -リクエストを暗号化するときには、以下の 4 つの条件付きパラメータのうち **1 つ** と、必須パラメータである `optout_check` の値 `1` のみを、JSON ボディのキーと値のペアとして含める必要があります。 +リクエストを暗号化するときには、以下の 4 つの条件付きパラメータのうち **1 つ** のみを JSON ボディのキーと値のペアとして含める必要があります。 ::: | Body Parameter | Data Type | Attribute | Description | @@ -55,7 +51,6 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | `email_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) した [正規化](../getting-started/gs-normalization-encoding.md#email-address-normalization) 済みメールアドレスです。 | | `phone` | string | 条件付きで必須 | トークンを生成する [正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号です。 | | `phone_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) した、[正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号です。 | -| `optout_check` | number | 必須 | ユーザーがオプトアウトしたかどうかをチェックします。このパラメータは `1` とします。 | ### Request Examples @@ -67,33 +62,29 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 ```json { - "email": "username@example.com", - "optout_check": 1 + "email": "username@example.com" } ``` ```json { - "email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=", - "optout_check": 1 + "email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=" } ``` ```json { - "phone": "+12345678901", - "optout_check": 1 + "phone": "+12345678901" } ``` ```json { - "phone_hash": "wdN1alhrbw1Bmz49GzKGdPvGxLhCNn7n3teAOQ/FSK4=", - "optout_check": 1 + "phone_hash": "wdN1alhrbw1Bmz49GzKGdPvGxLhCNn7n3teAOQ/FSK4=" } ``` 以下は、メールアドレスハッシュの暗号化トークン生成リクエストの例です: ```sh -echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_check":1}' | python3 uid2_request.py https://prod.uidapi.com/v2/token/generate [Your-Client-API-Key] [Your-Client-Secret] +echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="}' | python3 uid2_request.py https://prod.uidapi.com/v2/token/generate [Your-Client-API-Key] [Your-Client-Secret] ``` 詳細といくつかのプログラミング言語でのコードの例は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 @@ -133,7 +124,7 @@ echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_chec | `advertising_token` | string | ユーザーの暗号化された Advertising Token (UID2) です。 | | `refresh_token` | string | UID2 Service と最新の identity トークンのセットを交換できる暗号化されたトークンです。 | | `identity_expires` | number | Advertising Token の有効期限を示す Unix タイムスタンプ (ミリ秒単位) です。 | -| `refresh_from` | number | SDK for JavaScript ([SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照) が UID2 Token のリフレッシュを開始するタイミングを示す Unix タイムスタンプ (ミリ秒単位)。
TIP: SDK を使用していない場合は、このタイムスタンプから UID2 Token もリフレッシュすることを検討してください。 | +| `refresh_from` | number | UID2 Token のリフレッシュを検討するタイミングを示す Unix タイムスタンプ (ミリ秒単位) です。 | | `refresh_expires` | number | Refresh Token の有効期限を示す Unix タイムスタンプ (ミリ秒単位) です。 | | `refresh_response_key` | string | [POST /token/refresh](post-token-refresh.md) リクエストでレスポンス復号化のために使用される鍵です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md index e6628582d..07bf59c9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md @@ -130,4 +130,4 @@ API Key と Client Secret は、認証情報が漏洩するリスクを減らす \ No newline at end of file +--> 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 db586d9c4..1124507a9 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 @@ -114,7 +114,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントでは、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) へのコールで事前に取得した `refresh_token` と `refresh_response_key` の値を使用します。 :::note -Windows の場合、PowerShell の代わりに Windows コマンドプロンプトを使用している場合は、JSON を囲むシングルクォートも削除する必要があります。たとえば、`echo {"email": "test@example.com", "optout_check": 1}` とします。 +Windows の場合、PowerShell の代わりに Windows コマンドプロンプトを使用している場合は、JSON を囲むシングルクォートも削除する必要があります。たとえば、`echo {"email": "test@example.com"}` とします。 ::: ### Prerequisites and Notes @@ -228,8 +228,8 @@ Usage: echo '' | python3 uid2_request.py Example: - echo '{"email": "test@example.com", "optout_check": 1}' | python3 uid2_request.py https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= - + 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 @@ -356,7 +356,7 @@ public class Uid2Request { + "java -jar Uid2Request-jar-with-dependencies.jar " + "\n\n" + "Example:" + "\n " - + "echo '{\"email\": \"test@example.com\",\"optout_check\": 1}' | java -jar Uid2Request-jar-with-dependencies.jar https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=" + "\n\n\n" + + "echo '{\"email\": \"test@example.com\"}' | java -jar Uid2Request-jar-with-dependencies.jar https://prod.uidapi.com/v2/token/generate PRODGwJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg=" + "\n\n\n" + "Refresh Token Usage:" + "\n " + "java -jar Uid2Request-jar-with-dependencies.jar --refresh-token " + "\n\n" @@ -466,8 +466,8 @@ Usage: echo '' | .\uid2_request Example: - echo '{"email": "test@example.com", "optout_check": 1}' | .\uid2_request https://prod.uidapi.com/v2/token/generate UID2-C-L-999-fCXrMM.fsR3mDqAXELtWWMS+xG1s7RdgRTMqdOH2qaAo= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= - + 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 @@ -810,8 +810,8 @@ func printUsage() { echo '' | go run uid2_request.go Example: - echo '{"email": "test@example.com", "optout_check": 1}' | go run uid2_request.go https://prod.uidapi.com/v2/token/generate UID2-C-L-999-fCXrMM.fsR3mDqAXELtWWMS+xG1s7RdgRTMqdOH2qaAo= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= - + echo '{"email": "test@example.com"}' | go run uid2_request.go https://prod.uidapi.com/v2/token/generate UID2-C-L-999-fCXrMM.fsR3mDqAXELtWWMS+xG1s7RdgRTMqdOH2qaAo= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= + Refresh Token Usage: go run uid2_request.go --refresh-token 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 881841462..9c9972f07 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 @@ -100,7 +100,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ ユーザーのオプトアウトはどのように通知されますか？ ユーザーがオプトアウトした場合、API レスポンスは以下のいずれかのケースで通知します: -- 直接または UID2 SDK のいずれかで [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを呼び出し、UID2 Token を生成する場合、必須の `optout_check` パラメータに `1` を指定します。 +- 直接または UID2 SDK のいずれかで [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを呼び出し、UID2 Token を生成する場合。 - 直接または UID2 SDK のいずれかで [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出し、UID2 Token をリフレッシュした場合。 #### Where should I make token generation calls—from the server side or the client side? diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md index 642038163..45a252c59 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md @@ -135,7 +135,7 @@ UID2 Operator Service へのリクエストで電話番号を送信する前に 例: - US: `1 (234) 567-8901` は `+12345678901` に正規化されます。 - Singapore: `65 1243 5678` は `+6512345678` に正規化されます。 - - Sydney, Australia: `(02) 1234 5678` は、先頭のゼロを削除し、国コードを含めるように正規化されます: `+61212345678`。 + - Australia: 携帯電話番号 `0491 570 006` は、国番号を追加し、先頭のゼロを削除して正規化されます：`+61491570006`。 :::warning 正規化された電話番号が UTF-8 であることを確認してください。他のエンコーディングシステム（例: UTF-16）ではありません。 @@ -194,7 +194,7 @@ Email または Phone Number を選択し、値を入力または貼り付けて ## Troubleshooting -いずれの場合も、自身で DII を処理準備するための手順を実行し、その後 [UID2 Hashing Tool](#uid2-hashing-tool) を使用して結果値を確認してください。結果が一致しない場合は、各手順を確認してエラー箇所を特定してください。 +いずれの場合も、自身で DII を処理準備するための手順を実行し、その後 [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) を使用して結果値を確認してください。結果が一致しない場合は、各手順を確認してエラー箇所を特定してください。 問題が発生したりエラーが出たりする場合、あるいは手順を正しく実行できているか確認したい場合にも、以下の点をチェックしてみてください。 @@ -202,8 +202,8 @@ Email または Phone Number を選択し、値を入力または貼り付けて このサービスはメールアドレスを正規化しますが、電話番号の正規化はできません。例えば、国コードが欠落している場合の値を判断できません。以下のリソースを利用してください。 - 正規化手順: [Phone Number Normalization](#phone-number-normalization). - - 照合ツール: [UID2 Hashing Tool](#uid2-hashing-tool). + - 照合ツール: [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). - **Use the Base64-encoded value**: このプロセスには、ハッシュ値のバイト列を正規化、ハッシュ化、Base64エンコードする手順が含まれます。UID2 を生成する際の入力は、このBase64エンコードされた値です。必ずこの44文字の文字列値を使用してください。 -- 以下のエラーメッセージが表示される場合があります：「The hashing value must be 44 characters. (ハッシュ値は44文字でなければなりません）」。この場合、使用しているハッシュ関数に問題があります。SHA-256ハッシュの16進数からBase64へのエンコードを使用してください。詳細は[Email Address Hash Encoding](#email-address-hash-encoding)または[Phone Number Hash Encoding](#phone-number-hash-encoding)を参照してください。確認のため、[UID2 Hashing Tool](#uid2-hashing-tool)でテストしてください。 \ No newline at end of file +- 以下のエラーメッセージが表示される場合があります：「The hashing value must be 44 characters. (ハッシュ値は44文字でなければなりません）」。この場合、使用しているハッシュ関数に問題があります。SHA-256ハッシュの16進数からBase64へのエンコードを使用してください。詳細は[Email Address Hash Encoding](#email-address-hash-encoding)または[Phone Number Hash Encoding](#phone-number-hash-encoding)を参照してください。確認のため、[UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) でテストしてください。 \ No newline at end of file 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 8a7b491d6..19753797f 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 | | :--- | :--- | - | パブリッシャー | [POST /token/generate](../endpoints/post-token-generate.md) を必須パラメータ `optout_check` を `1` に設定して呼び出したパブリッシャー、または [POST /token/refresh](../endpoints/post-token-refresh.md) を呼び出したパブリッシャーは、UID2 Token の代わりにオプトアウトレスポンスを受け取ります。| + | パブリッシャー | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) を呼び出したパブリッシャーは、UID2 Token の代わりにオプトアウトレスポンスを受け取ります。| | DSP | 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) エンドポイントを使用して、raw 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/guides/integration-javascript-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md index 634a27006..ae7f52af6 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 @@ -40,7 +40,7 @@ UID2 を使用してクライアントの ID を確立し、Advertising Token SDK for JavaScript を使用しないパブリッシャーのインテグレーションシナリオは、[Publisher Integration Guide, Server-Side](integration-publisher-server-side.md) を参照してください。 :::note -Google Ad Managerを使用していて、セキュアシグナル機能を使用したい場合は、まずこのガイドの手順に従った後、[Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) の追加手順に従ってください。 +Google Ad Manager を使用していて、セキュアシグナル機能を使用したい場合は、まずこのガイドの手順に従った後、[Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) の追加手順に従ってください。 ::: ## Integrating with Single Sign-On (SSO) 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 dbfaefa42..923edf7d0 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 @@ -90,7 +90,7 @@ When account setup is complete, you'll receive a client keypair consisting of tw ## Add SDK for JavaScript to Your Site -以下のコードスニペットは、ウェブサイトに追加する必要があるコードの概要です。また、SDKがトリガーする可能性のあるさまざまなイベントも示しています。 +以下のコードスニペットは、ウェブサイトに追加する必要があるコードの概要です。また、SDK がトリガーする可能性のあるさまざまなイベントも示しています。 より詳細なコードスニペットについては、[Example Integration Code and When to Pass DII to the UID2 SDK](#example-integration-code-and-when-to-pass-dii-to-the-uid2-sdk) を参照してください。 @@ -127,7 +127,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 @@ -198,7 +198,7 @@ SDK は、ハッシュ化された DII を UID2 Service に送信する前に暗 - 電話番号、未ハッシュ - 電話番号、正規化およびハッシュ化済み -SDKが複数回設定された場合、最新の設定値が使用されます。 +SDK が複数回設定された場合、最新の設定値が使用されます。 JavaScript でメールアドレスと電話番号のハッシュを生成する方法の例については、[Example Code: Hashing and Base-64 Encoding](#example-code-hashing-and-base-64-encoding) を参照してください。 @@ -239,7 +239,7 @@ await __uid2.setIdentityFromEmailHash( このシナリオでは: - **パブリッシャーはメールアドレスの正規化とハッシュ化を行う責任があります**。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 -- UID2 SDKは、UID2 Serviceに送信する前にハッシュを暗号化します。 +- UID2 SDK は、UID2 Service に送信する前にハッシュを暗号化します。 @@ -277,7 +277,7 @@ await __uid2.setIdentityFromPhoneHash( このシナリオでは: - **パブリッシャーは電話番号の正規化、ハッシュ化、および Base64 エンコードを行う責任があります**。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。 -- UID2 SDKは、UID2 Serviceに送信する前にハッシュを暗号化します。 +- UID2 SDK は、UID2 Service に送信する前にハッシュを暗号化します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md index 849cad6fc..1c52a6f01 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md @@ -259,7 +259,7 @@ Prebid の実施を計画する際には、以下を考慮してください: - リフレッシュされたトークンを生成するために使用された元のトークンと一致しない新しいトークンを提供した場合、モジュールは保存されているすべてのトークンを破棄し、代わりに新しいトークンを使用し、リフレッシュされた状態を維持します。 -- インテグレーションテストでは、`params.uid2ApiBase` を `"https://operator-integ.uidapi.com"` に設定します。トークンの生成に使用する環境(本番環境またはインテグレーション環境)と同じ値に設定する必要があります(資格情報は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)。 +- インテグレーションテストでは、`params.uid2ApiBase` を `"https://operator-integ.uidapi.com"` に設定します。トークンの生成に使用する環境(本番環境またはインテグレーション環境)と同じ値に設定する必要があります(認証情報については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)。 - Prebid.js client-server インテグレーションの場合、クライアントサイドインテグレーション機能を無効にして、より小さな Prebid.js ビルドを作成できます。これを行うには、`--disable UID2_CSTG` フラグを渡します: @@ -311,7 +311,7 @@ UID2 Module に有効な UID2 Token があるかどうかを確認するには ` - ブラウザのコンソールログを確認してください。 - ブラウザのデベロッパーツールを使って、UID2 Service への API コールを調べます。 -その他のヘルプは、Prebidのドキュメント [Troubleshooting Prebid.js](https://docs.prebid.org/troubleshooting/troubleshooting-guide.html) and [Debugging Prebid.js](https://docs.prebid.org/debugging/debugging.html) を参照してください。 +その他のヘルプは、Prebid のドキュメント [Troubleshooting Prebid.js](https://docs.prebid.org/troubleshooting/troubleshooting-guide.html) および [Debugging Prebid.js](https://docs.prebid.org/debugging/debugging.html) を参照してください。 Prebid.js の設定を検証・デバッグするツールの例として、オープンソースの Chrome 拡張機能である Professor Prebid があります: 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 0f9ff5eaf..d6a57397a 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 @@ -90,7 +90,7 @@ UID2 モジュールを設定するには、アカウント設定中に受け取 1. 次に、ハッシュ値の結果のバイトを Base64 エンコーディングを使用してエンコードします。 詳細については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。例については、[Configuring the UID2 Module: Code Example](#configuring-the-uid2-module-code-example) を参照してください。 -- UID2 モジュールは、UID2 サービスに送信する前に、ハッシュ化された DII を暗号化します。 +- UID2 モジュールは、UID2 Service に送信する前に、ハッシュ化された DII を暗号化します。 - モジュールが複数回設定された場合は、最新の設定値が使用されます。 #### Configuring the UID2 Module: Code Example @@ -161,6 +161,25 @@ pbjs.setConfig({ ユーザーが以前に UID2 をオプトアウトしている可能性があります。この場合、UID2 モジュールはユーザーのオプトアウトを尊重し、Prebid.js によって UID2 Token が生成および収集されることはありません。 +以下の例は、オプトアウトしたユーザーに対するレスポンスを示しています： + +```json +{ + "identity": "optout", + "status": "optout" +} +``` + +以下の例は、デコードされた UID2 userId オブジェクトを示しています: + +```json +{ + "uid2": { + "optout": true + } +} +``` + ## Checking the Integration UID2 モジュールが正常に UID2 Token を生成したことを確認するには、`pbjs.getUserIds().uid2` を呼び出します。値が返された場合、有効な UID2 Token が UID2 モジュールに存在します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md index 0cfa60156..80585bd12 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md @@ -14,7 +14,7 @@ import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emai # Publisher Integration Guide, Server-Side -このガイドは、UID2 Token (Advertising Token) を RTB ビッドストリーム 用に生成するために、UID2 と直接インテグレーションを行いながら、UID2 対応シングルサインオンや ID プロバイダーではなく、すべてのインテグレーションをサーバーサイドで行うパブリッシャー向けのガイドです。 +このガイドは、UID2 Token (Advertising Token) を RTB ビッドストリーム 用に生成するために、UID2 と直接インテグレーションを行いながら、UID2 対応シングルサインオンや ID プロバイダーではなく、すべてのインテグレーションを Server-Side で行うパブリッシャー向けのガイドです。 パブリッシャーが UID2 と Server-Side でインテグレーションするには、以下のオプションが利用可能です: @@ -98,7 +98,7 @@ Step 1-c で認証が行われ、パブリッシャーがユーザーのメー ### Bid Using a UID2 Token -UID2 ID 情報をどのように管理し、ターゲティング広告に使用したいかを検討する必要があります。たとえば、返された UID2 token を SSP に渡す等。 +UID2 ID 情報をどのように管理し、ターゲティング広告に使用したいかを検討する必要があります。たとえば、返された UID2 Token を SSP に渡す等。 | Step | Endpoint | Description | | :--- | :--- | :--- | @@ -112,14 +112,14 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー `POST /token/refresh` エンドポイントを使用して、常に有効で最新の UID2 Token を持つようにします。UID2 ローテーションと同期させるには、UID2 Token をリフレッシュする必要があります。さらに、トークンリフレッシュプロセスではユーザーのオプトアウトステータスをチェックし、ユーザーがオプトアウトしている場合は新しいトークンを送信しません。これによりトークンリフレッシュチェーンが終了します。その UID2 Token を二度と使用してはなりません。 -UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 | Step | Endpoint | Description | | :--- | :--- | :--- | | 3-a | N/A | ユーザーがアセットに戻り、再びアクティブになったとき、UID2 Token をリフレッシュしてから、SSP に送信します。 | | 3-b | [POST /token/refresh](../endpoints/post-token-refresh.md) | Step [1-e](#establish-identity-capture-user-data) で取得した `refresh_token` をクエリパラメータとして送信します。 | | 3-c | [POST /token/refresh](../endpoints/post-token-refresh.md) | UID2 Service は、オプトアウトしていないユーザーに対して新しい ID トークンを発行します。 | -| 3-d | N/A | `POST /token/refresh` エンドポイントから返される値、`advertising_token` と `refresh_token` を、ユーザーにリンクされるように配置します。ファーストパーティのクッキーのような Client-Side のストレージか、サーバサイドのストレージを検討するとよいでしょう。 | +| 3-d | N/A | `POST /token/refresh` エンドポイントから返される値、`advertising_token` と `refresh_token` を、ユーザーにリンクされるように配置します。ファーストパーティのクッキーのような Client-Side のストレージか、Server-Side のストレージを検討するとよいでしょう。 | :::tip [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントによって返された ID の `refresh_from` タイムスタンプからトークンのリフレッシュを始めてください。 @@ -136,7 +136,7 @@ UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳 ## Sample Implementation -Server-only のインテグレーションのためのサンプルアプリケーションをがあります。以下を参照してください: +Server-only のインテグレーションのためのサンプルアプリケーションがあります。以下を参照してください: - [Server-Only UID2 Integration Example](https://example-srvonly-integ.uidapi.com/login) - [Server-Only UID2 Integration Example (readme)](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md index dfb575693..a09cf817c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md @@ -82,5 +82,4 @@ Maven でインストールするには、`pom.xml` ファイルに依存関係 R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。 - ProGuard を使用している場合は、[uid2-gma.pro](https://github.com/IABTechLab/uid2-android-sdk/blob/main/securesignals-gma/uid2-gma.pro) で指定されたオプションを手動で追加する必要があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aks-enclave.md index 50e1cd8a6..1310a0697 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 @@ -104,7 +104,7 @@ Kubernetesの `kubectl` コマンドラインインターフェイスをイン | Environment | Details | | :--- | :--- | -| Integration (`integ`) | テスト専用です。デバックモードはテスト環境で利用可能です。 | +| Integration (`integ`) | テスト専用です。デバッグモードはテスト環境で利用可能です。 | | Production (`prod`) | 本番トラフィックを管理するためのものです。 | ## Deployment @@ -124,7 +124,7 @@ AKS の新しい UID2 Private Operator をデプロイするには、次の主 1. UID2 の連絡先に、デプロイメントファイルを含む ZIP ファイルを依頼してください。 -1. ダウンロードし、解答します。 +1. ダウンロードし、解凍します。 + + + ## Q4 2025 当四半期にリリースされたドキュメントは以下の通りです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md index 713d8182b..983e4af08 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md @@ -72,7 +72,7 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S ## Minimum Requirements -To consume the binary package of this SDK in your app: +この SDK のバイナリパッケージをアプリで使用するには: - 最低限のターゲット Android バージョン: 4.4+ / API 19+ (SDK) 5.0+ @@ -117,7 +117,7 @@ Maven を使用してインストールするには、`pom.xml` ファイルに **UID2Manager** シングルトンは、SDK for Android の主要な開発者 API です。UID2 Token を含む UID2 Identity の保存、リフレッシュ、取得を行います。 -UDI2Manager シングルトンは使用前に初期化する必要があります。なぜなら: +UID2Manager シングルトンは使用前に初期化する必要があります。なぜなら: - 後でのアクセスが容易になるからです。 - 消費アプリケーションがリクエストを行うためのネットワークインスタンスを提供できる可能性があるからです。 @@ -168,7 +168,7 @@ UID2Manager.getInstance().getAdvertisingToken() ## UID2Manager API -このセクションには、UID2Manager APIの一部である関数と変数が含まれています。 +このセクションには、UID2Manager API の一部である関数と変数が含まれています。 ### Functions @@ -182,7 +182,7 @@ UID2Manager API の一部として利用可能な関数は次のとおりです: #### generateIdentity() -D直接識別情報 (DII) を使用して UID2 Identity を生成します。手順は、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 +直接識別情報 (DII) を使用して UID2 Identity を生成します。手順は、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 #### setIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md index e65140fc1..59f96c133 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md @@ -69,7 +69,7 @@ Release tags は以下の GitHub で入手できますが、バイナリーは SDK を使用する際に、復号鍵を保存したり管理したりする必要はありません。 ::: -DSP の場合は、入札のために UID2 Advertising Token を復号化して UID2 を返すインターフェースを呼び出します。ユーザーのオプトアウトを処理する入札ロジックの詳細は [DSPインテグレーションガイド](../guides/dsp-guide.md) を参照してください。 +DSP の場合は、入札のために UID2 Advertising Token を復号化して UID2 を返すインターフェースを呼び出します。ユーザーのオプトアウトを処理する入札ロジックの詳細は [DSP Integration Guide](../guides/dsp-guide.md) を参照してください。 以下は、C++ での decrypt メソッド呼び出しです: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md index 15698d26b..02883cc12 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md @@ -68,7 +68,7 @@ SDK が UID2 Service で認証するために必要な値を提供する必要 `BidstreamClient` クラスを使用すると、UID2 Token を raw UID2 に復号することができます。 -ユーザーのオプトアウトを処理する入札ロジックの詳細は [DDSP Integration Guide](../guides/dsp-guide.md) を参照してください。 +ユーザーのオプトアウトを処理する入札ロジックの詳細は [DSP Integration Guide](../guides/dsp-guide.md) を参照してください。 `SharingClient` クラスを使うと、raw UID2 を暗号化して UID2 Token に変換したり、UID2 Token を復号してraw UID2 に変換したりすることができます。 @@ -210,4 +210,4 @@ else } ``` -For a full example, see the `ExampleSharingClient` method in [SampleApp/Program.cs](https://github.com/IABTechLab/uid2-client-net/blob/main/src/SampleApp/Program.cs). +完全な例は、[SampleApp/Program.cs](https://github.com/IABTechLab/uid2-client-net/blob/main/src/SampleApp/Program.cs) の `ExampleSharingClient` メソッドを参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md index 0fad5bd43..ae2196790 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md @@ -20,7 +20,7 @@ iOS SDK を使用すると、UID2 を使用したクライアント ID の生成 | Google Interactive Media Ads SDK for iOS を使用して iOS/tvOS アプリから広告リクエストで [secure signals](https://support.google.com/admob/answer/11556288) として UID2 Token を送信する | [UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios.md) | ## tvOS Support -Although this page refers to SDK for iOS, this SDK also supports tvOS. For the required tvOS version, see [Minimum Requirements](#minimum-requirements). +このページは iOS 用 SDK について説明していますが、この SDK は tvOS もサポートしています。必要な tvOS バージョンについては、[Minimum Requirements](#minimum-requirements) を参照してください。 ## Functionality @@ -70,7 +70,7 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S - Xcode バージョン: 15.0+ - iOS 最低対象バージョン: 13.0+ - すべての機能を使用するには: 13.0+ - - 一部の機能を使用するには: 12.0+。SDK を統インテグレーションしたアプリはすべてのデバイスにインストールできますが、iOS バージョンが 13.0 未満のデバイスでは、Client-Side で UID2 Token を生成または取得することはできません。 + - 一部の機能を使用するには: 12.0+。SDK をインテグレーションしたアプリはすべてのデバイスにインストールできますが、iOS バージョンが 13.0 未満のデバイスでは、Client-Side で UID2 Token を生成または取得することはできません。 - tvOS 最低対象バージョン: 13.0+ - Swift バージョン: 5.0+ 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 3c4e30172..d7c31b84f 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 @@ -147,16 +147,10 @@ SDK の HTTP 実装を使用している場合は、以下の手順に従って 2. ユーザーのメールアドレスまたは電話番号を入力として受け取り、`TokenGenerateResponse` オブジェクトを生成する関数を呼び出します。以下の例では、メールアドレスを使用しています: ```java - TokenGenerateResponse tokenGenerateResponse = publisherUid2Client.generateTokenResponse(TokenGenerateInput.fromEmail("user@example.com").doNotGenerateTokensForOptedOut()); + TokenGenerateResponse tokenGenerateResponse = publisherUid2Client.generateTokenResponse(TokenGenerateInput.fromEmail("user@example.com")); ``` - :::important - 常に `doNotGenerateTokensForOptedOut()` を適用します。これは POST /token/generate エンドポイントの呼び出しで `optout_check=1` を設定するのと同様のパラメータを適用します([Unencrypted JSON Body Parameters](../endpoints/post-token-generate.md#unencrypted-json-body-parameters)) を参照してください。 - ::: - - + #### Basic Usage, Client-Server Integration @@ -224,21 +218,16 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in 2. ユーザーのメールアドレスまたは電話番号を入力として受け取り、安全なリクエストデータエンベロープを作成する関数を呼び出します。[Encrypting requests](../getting-started/gs-encryption-decryption.md#encrypting-requests) を参照してください。以下の例ではメールアドレスを使用しています: ```java - EnvelopeV2 envelope = publisherUid2Helper.createEnvelopeForTokenGenerateRequest(TokenGenerateInput.fromEmail("user@example.com").doNotGenerateTokensForOptedOut()); + EnvelopeV2 envelope = publisherUid2Helper.createEnvelopeForTokenGenerateRequest(TokenGenerateInput.fromEmail("user@example.com")); ``` 3. 選択した HTTP クライアントライブラリを使用して、ヘッダーとボディを含むこのエンベロープを [POST token/generate](../endpoints/post-token-generate.md) エンドポイントにポストします: - 1. Headers: HTTP ライブラリによっては、以下のようになります: + 1. Headers: HTTP ライブラリによっては、以下のようになります: - `.putHeader("Authorization", "Bearer " + UID2_API_KEY)` + `.putHeader("Authorization", "Bearer " + UID2_API_KEY)` `.putHeader("X-UID2-Client-Version", PublisherUid2Helper.getVersionHttpHeader())` 2. Body: `envelope.getEnvelope()` - :::important - 常に `doNotGenerateTokensForOptedOut()` を適用してください。これは POST /token/generate エンドポイントの呼び出しで `optout_check=1` を設定するのと同様のパラメータを適用します ([Unencrypted JSON Body Parameters](../endpoints/post-token-generate.md#unencrypted-json-body-parameters) を参照)。 - ::: - + 4. HTTP レスポンスステータスコードが 200 でない場合は、[Response Status Codes](../endpoints/post-token-generate.md#response-status-codes) を参照して次のステップを決定します。そうでない場合は、UID2 ID レスポンスの内容を `TokenGenerateResponse` オブジェクトに変換します: @@ -275,7 +264,7 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in ``` 3. ユーザーが別のページにアクセスしたときや、タイマーで、更新が必要かどうかを判断します: - 1. ユーザーのセッションから ID JSON 文字列を取得し、`IDentityTokens` オブジェクトを生成する以下の関数を呼び出します: + 1. ユーザーのセッションから ID JSON 文字列を取得し、`IdentityTokens` オブジェクトを生成する以下の関数を呼び出します: ```java IdentityTokens identity = IdentityTokens.fromJsonString(identityJsonString); @@ -309,7 +298,7 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in ## Usage for Advertisers/Data Providers -以下のの手順は、最新バージョンの `POST /identity/map` エンドポイントを使用して DII を raw UID2 にマップする方法の例です。 +以下の手順は、最新バージョンの `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) を参照してください。 @@ -574,9 +563,9 @@ else ## Usage for UID2 Sharers -UID2 共有参加者は、送信者または受信者として共有に参加し、他の参加者と UID2 を共有する企業です。 +UID2 共有参加者は、送信者または受信者として共有に参加し、他の参加者と UID2 を共有する企業です。 -広告主およびデータプロバイダーは、この SDK を使用して、他の承認された UID2 共有参加者と UID2 を共有できます (トークン化された共有)。彼らは [raw UID2](../ref-info/glossary-uid#gl-raw-uid2) を UID2 Token に暗号化し、それを共有のために別の参加者に送信できます (ピクセルでの [Tokenized Sharing in Pixels](../sharing/sharing-tokenized-from-data-pixel.md)を参照)。ピクセルでデータを送信しない場合は、[Security Requirements for UID2 Sharing](../sharing/sharing-security.md)に記載されている要件に従う限り、UID2 共有に参加できます。 +広告主およびデータプロバイダーは、この SDK を使用して、他の承認された UID2 共有参加者と UID2 を共有できます (Tokenized Sharing)。彼らは [raw UID2](../ref-info/glossary-uid#gl-raw-uid2) を UID2 Token に暗号化し、それを共有のために別の参加者に送信できます (詳細は [Tokenized Sharing in Pixels](../sharing/sharing-tokenized-from-data-pixel.md) を参照)。ピクセルでデータを送信しない場合は、[Security Requirements for UID2 Sharing](../sharing/sharing-security.md)に記載されている要件に従う限り、UID2 共有に参加できます。 :::important このプロセスで生成される UID2 Token は共有専用であり、ビッドストリームでは使用できません。ビッドストリーム用のトークンを生成するための別のワークフローがあります: [Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md)を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md index 0c5b472cd..e27942ae0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md @@ -20,8 +20,6 @@ import SnptExampleJavaScriptV2Init from '../snippets/_snpt-example-javascript-v2 コンテンツパブリッシャー向けのインテグレーション手順は、[Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) を参照してください。 -サンプルアプリケーションについては、[Client-Server UID2 Integration Example using JavaScript SDK](https://js-client-server.samples.uidapi.com/) と [uid2-examples/web-integrations/javascript-sdk/client-server](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-server) を参照してください。 - ## Functionality この SDK は、UID2 をサポートしたいすべてのパブリッシャーに対して、UID2 とのインテグレーションを簡素化します。次の表は、SDK がサポートする機能を示しています。 @@ -207,13 +205,13 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 [callback function](#callback-function) は `UID2.IdentityStatus` enum から `status` フィールドの値を数値として返します。`UID2.IdentityStatus[state.status]` を呼び出すことで、対応する文字列に変換することができます。次の表に `status` enum の文字列を示します。 :::important -以下の値は、ID の可溶性を通知することのみを目的としています。条件文などでは使用しないでください。 +以下の値は、ID の可用性を通知することのみを目的としています。条件文などでは使用しないでください。 ::: | Status | Advertising Token Availability | Description | | :--- | :--- | :--- | | `ESTABLISHED` | Available | ID は有効で、渡された値またはファーストパーティクッキーから設定され、ターゲティング広告に利用できるようになりました。 | -| `REFRESHED` | Available | ID は UID2 オペレータへの呼び出しによってい正常に更新され、ターゲティング広告に使用できる様になりました。 | +| `REFRESHED` | Available | ID は UID2 オペレータへの呼び出しによって正常に更新され、ターゲティング広告に使用できるようになりました。 | | `EXPIRED` | Not available | SDK がトークンのリフレッシュに失敗したため、ターゲティング広告に使用できる ID がありません。まだ有効な Refesh Token があるため、自動リフレッシュの試行は継続されます | | `REFRESH_EXPIRED` | Not available | ファーストパーティクッキーの Refresh Token または渡された ID の有効期限が切れているため、ターゲティング広告に利用できる ID がありません。 | | `NO_IDENTITY` | Not available | ファーストパーティクッキーが設定されておらず、`init()` 関数に ID が渡されていないため、ターゲティング広告に利用できる ID がありません。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v3.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v3.md index 329a74260..d8657d21e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v3.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v3.md @@ -52,14 +52,6 @@ UID2 Identify Module、または UID2 サポートのある他の製品と Prebi | :--- | :--- | :--- | :--- | :--- | :--- | | — | — | ✅ | ✅ | — | — | -## Sample Implementation - -サンプルアプリケーションと関連するドキュメントは以下を参照してください: - - JavaScript SDK を使用した Client-Side インテグレーション: - - Site: [Client-Side UID2 Integration Example using JavaScript SDK](https://js-client-side.samples.uidapi.com/) - - Code: [uid2-examples/web-integrations/javascript-sdk/client-side](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-side) - - JavaScript SDK を使用した Client-Server インテグレーション: Code: [uid2-examples/web-integrations/javascript-sdk/client-server](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-server) および動作サイト ([Client-Server UID2 Integration Example using JavaScript SDK](https://js-client-server.samples.uidapi.com/)) - ## UID2 Account Setup UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従ってください。 @@ -268,7 +260,7 @@ SDK がローカルストレージまたはクッキーから以前に保存さ #### Provide an Identity by Calling `setIdentity` -`init` が完了したら、いつでも [`setIdentity`](#setidentityidentity-identity-void) を呼び出して、SDK に新しい ID を渡すことができあす。 +`init` が完了したら、いつでも [`setIdentity`](#setidentityidentity-identity-void) を呼び出して、SDK に新しい ID を渡すことができます。 ## API Reference @@ -388,7 +380,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 ``` -`getAdvertisingToken()` 関数を使うと、初期化完了時のコールバックだけでなく、どこからでも Advertising Token にアクセスすることができます。この関数は以下の条件のいずれかに該当する場合に `undefined` をします: +`getAdvertisingToken()` 関数を使うと、初期化完了時のコールバックだけでなく、どこからでも Advertising Token にアクセスすることができます。 この関数は、以下の条件のいずれかに該当する場合、`undefined` を返します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 6c7702124..671e29d1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -51,13 +51,15 @@ Version 4 には、Version 3 からの主な変更が含まれています: | :--- | :--- | :--- | :--- | :--- | :--- | | — | — | ✅ | ✅ | — | — | -## Sample Implementation +## Sample Implementations サンプルアプリケーションと関連するドキュメントは以下を参照してください: - JavaScript SDK を使用した Client-Side インテグレーション: - - Site: [Client-Side UID2 Integration Example using JavaScript SDK](https://js-client-side.samples.uidapi.com/) - - Code: [uid2-examples/web-integrations/javascript-sdk/client-side](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-side) - - JavaScript SDK を使用した Client-Server インテグレーション: Code: [uid2-examples/web-integrations/javascript-sdk/client-server](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-server) および動作サイト ([Client-Server UID2 Integration Example using JavaScript SDK](https://js-client-server.samples.uidapi.com/)) + - [Code](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-side) + - Running site: [Client-Side UID2 Integration Example](https://js-client-side.samples.uidapi.com/) + - JavaScript SDK を使用した Client-Server インテグレーション: + - [Code](https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-server) + - Running site: [Client-Server UID2 Integration Example](https://js-client-server.samples.uidapi.com/) ## UID2 Account Setup @@ -74,7 +76,7 @@ SDK が提供する特定の機能を使用する権限が与えられ、その ## SDK Version -このドキュメントは SDK for JavaScript version 3 用です。 +このドキュメントは SDK for JavaScript version 4 用です。 ## GitHub Repository @@ -253,7 +255,7 @@ SDK がローカルストレージまたはクッキーから以前に保存さ #### Provide an Identity by Calling `setIdentity` -`init` が完了したら、いつでも [`setIdentity`](#setidentityidentity-identity-void) を呼び出して、SDK に新しい ID を渡すことができあす。 +`init` が完了したら、いつでも [`setIdentity`](#setidentityidentity-identity-void) を呼び出して、SDK に新しい ID を渡すことができます。 ## API Reference @@ -371,7 +373,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 ``` -`getAdvertisingToken()` 関数を使うと、初期化完了時のコールバックだけでなく、どこからでも Advertising Token にアクセスすることができます。この関数は以下の条件のいずれかに該当する場合に `undefined` をします: +`getAdvertisingToken()` 関数を使うと、初期化完了時のコールバックだけでなく、どこからでも Advertising Token にアクセスすることができます。 この関数は、以下の条件のいずれかに該当する場合、`undefined` を返します: 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 3c2827014..61c26e182 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 @@ -86,7 +86,7 @@ SDK が　UID2 Service と通信するために必要な値を提供する必要 | :--- | :--- | | `base_url` | UID2 Service のエンドポイント。[Environments](../getting-started/gs-environments) を参照してください。 | | `auth_key` | API Key。[UID2 Credentials](../getting-started/gs-credentials) を参照してください。 | -| `secret_key` | Cient　Secret。[UID2 Credentials](../getting-started/gs-credentials) を参照してください。 | +| `secret_key` | Client Secret。[UID2 Credentials](../getting-started/gs-credentials) を参照してください。 | ## Interface @@ -127,7 +127,7 @@ SDK を使用すると、復号化キーを保存または管理する必要が `BidstreamClient` または `SharingClient` を使用して復号化すると、SDK が次の表に示す情報を返します。 -| Property　| Description | +| Property | Description | | :--- | :--- | | `status` | 復号結果のステータス。取り得る値のリストと定義につては、[Decryption Response Statuses](#decryption-response-statuses) を参照してください。 | | `uid` | UID2 Token に対応する raw UID2。 | @@ -135,7 +135,7 @@ SDK を使用すると、復号化キーを保存または管理する必要が ### Decryption Response Statuses -Decryption response codes, and their meanings, are shown in the following table. +復号化のレスポンスコードとその意味を次の表に示します。 | Value | Description | | :--- | :--- | @@ -158,16 +158,10 @@ Decryption response codes, and their meanings, are shown in the following table. 2. ユーザーのメールアドレスまたは電話番号を入力として受け取り、`TokenGenerateResponse` オブジェクトを生成する関数を呼び出します。次の例では、メールアドレスを使用しています: ```py - token_generate_response = client.generate_token(TokenGenerateInput.from_email("user@example.com").do_not_generate_tokens_for_opted_out()) + token_generate_response = client.generate_token(TokenGenerateInput.from_email("user@example.com")) ``` - - - `do_not_generate_tokens_for_opted_out()`　は、[POST /token/generate](../endpoints/post-token-generate.md) の呼び出しに `optout_check=1` を適用します。これを行わないと、後方互換性が維持を維持するために `optout_check` が省略されます。 + ### Client-Server Integration @@ -246,7 +240,7 @@ DII を raw UID2s にマッピングするには、次の手順に従います: ```py input = IdentityMapV3Input.from_emails(["user@example.com", "user2@example.com"]) ``` - Or combine multiple identity types: + または、複数のアイデンティティタイプを組み合わせることもできます: ```py input = IdentityMapV3Input() .with_email("user@example.com") diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-runtime-errors.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-runtime-errors.mdx new file mode 100644 index 000000000..d184e8de0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-private-operator-runtime-errors.mdx @@ -0,0 +1,3 @@ +| Error Code | Issue | How to Identify in Logs | Steps to Resolve | +| :--- | :--- | :--- | :--- | +| E12 | Data Download Failure | `E12: Data Download Failure` を含むログメッセージ、または `RotatingStoreVerticle` からの `Failed to load` エラーを確認してください。これらのメッセージには、HTTP ステータスコード（例：`HTTP response code 403`）や例外の種類（例：`exception: IOException`）が含まれます。 | エラーメッセージ内の HTTP ステータスコードまたは例外を確認し、それに応じて対処してください:
**404 エラー**: Operator Key が環境に対して有効であることを確認してください。
**403 エラー**: Operator Key および認証情報が正しいことを確認してください。
**タイムアウトエラー**: ネットワーク接続を確認し、ファイアウォール／セキュリティグループの設定で HTTPS（ポート 443）へのアウトバウンド通信が許可されていることを確認し、UID2 Service のエンドポイントにアクセス可能であることを確認してください。
**500/503 エラー**: このコードは一時的な UID2 Service の問題を示します。再試行し、エラーが継続する場合は UID2 サポートへ連絡してください。 |