diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map-v2.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map-v2.md index c938f0d71..3011096d5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map-v2.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map-v2.md @@ -28,10 +28,15 @@ UID2 のオプトアウトワークフローとユーザーがオプトアウト 知っておくべきことは以下のとおりです: - リクエストの最大サイズは 1MB です。 -- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムのバッチサイズで、それらを *連続した* バッチで送信してください。 -- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用して、[Directly Identifying Information (DII)](../ref-info/glossary-uid.md#gl-dii) を連続してマッピングしてください。 +- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムで送信してください。同時に送信するバッチは 20 件以内にすることを勧めます。 - メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする必要がある場合に、処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングのみを再計算することで、毎日更新が必要な raw UID2 の数は約 1/365 となり、総処理時間を短縮できます。[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) も参照してください。 +## Rate Limiting + +公正な使用とプラットフォームの安定性を確保するために、`POST /identity/map` エンドポイントは、急激なトラフィックの増加から保護するためにレート制限を適用しています。短時間に多数のリクエストを送信すると、`429` エラー応答が返される可能性があります。 + +レート制限エラーを適切に処理するには、リクエストを再試行する際に [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff) とランダムジッターを実装することを勧めます。制限内でスループットを最大化するには、多数の小さなリクエストを送信するのではなく、リクエストごとに最大バッチサイズの 5,000 アイテムを使用してください。 + ## Request Format `POST '{environment}/v2/identity/map'` @@ -203,5 +208,6 @@ echo '{"phone": ["+12345678901", "+441234567890"]}' | python3 uid2_request.py ht | `success` | 200 | リクエストは成功しました。レスポンスは暗号化されています。 | | `client_error` | 400 | リクエストに不足している、または無効なパラメータがありました。 | | `unauthorized` | 401 | リクエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行するのに許可されていないベアラートークンが含まれていました。 | +| N/A | 429 | このエンドポイントへのリクエストが多すぎます。待ってからexponential backoffを使用して再試行してください。 | -`status` の値が `success` 以外であれば、`message` フィールドにその問題に関する追加情報が表示されます。 +`status` の値が `success` 以外であれば、`message` フィールドにその問題に関する追加情報が表示されます。Note: 429 のレスポンスには、JSON 形式のレスポンス本文が含まれていません。 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 ef4c99caf..de8911b71 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 @@ -28,10 +28,15 @@ UID2 のオプトアウト手順とユーザーがオプトアウトする方法 以下が必要な情報です: - 最大リクエストサイズは 1MB です。 -- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマッピングする場合は、1 バッチあたり最大 5,000 アイテムの *順次* バッチで送信します。 -- Private Operator を使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化またはハッシュされていない Directly Identifying Information (DII) 値のバッチを連続して送信し、複数の並行接続を作成しないでください。 +- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムで送信してください。同時に送信するバッチは 20 件以内にすることを勧めます。 - メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする際に処理時間が大幅に増加する可能性があります。ただし、実際に更新が必要なマッピングのみを再計算すると、UID2 の約 1/365 が毎日更新されるため、総処理時間が短縮されます。詳細は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 +## Rate Limiting + +公正な使用とプラットフォームの安定性を確保するために、`POST /identity/map` エンドポイントは、急激なトラフィックの増加から保護するためにレート制限を適用しています。短時間に多数のリクエストを送信すると、`429` エラー応答が返される可能性があります。 + +レート制限エラーを適切に処理するには、リクエストを再試行する際に [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff) とランダムジッターを実装することを勧めます。制限内でスループットを最大化するには、多数の小さなリクエストを送信するのではなく、リクエストごとに最大バッチサイズの 5,000 アイテムを使用してください。 + ## Request Format `POST '{environment}/v3/identity/map'` @@ -140,12 +145,12 @@ Response: { "u": "AdvIvSiaum0P5s3X/7X8h8sz+OhF2IG8DNbEnkWSbYM=", "p": "EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4=", - "r": 1735689600000 + "r": 1735689600 }, { "u": "IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ=", "p": null, - "r": 1735862400000 + "r": 1735862400 }, { "e": "invalid identifier" }, { "e": "optout" } @@ -176,7 +181,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ | :------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `u` | string | リクエストで提供されたメールアドレスまたは電話番号に対応する raw UID2。 | | `p` | string | 以下のいずれか: | -| `r` | number | raw UID2 を更新する可能性がある時刻を示す Unix タイムスタンプ（ミリ秒）。raw UID2 はこのタイムスタンプまで有効です。 | +| `r` | number | raw UID2 を更新する可能性がある時刻を示す Unix タイムスタンプ（秒）。raw UID2 はこのタイムスタンプまで有効です。 | :::note raw UID2 はリフレッシュタイムスタンプの前では変化しません。リフレッシュタイムスタンプの後、DII を再マッピングすると新しいリフレッシュタイムスタンプが返されますが、raw UID2 は変化する場合もあれば変化しない場合もあります。raw UID2 が複数のリフレッシュ間隔にわたって変化しない可能性もあります。 @@ -197,8 +202,13 @@ raw UID2 はリフレッシュタイムスタンプの前では変化しませ | `success` | 200 | リクエストは成功しました。レスポンスは暗号化されます。 | | `client_error` | 400 | リクエストに欠落または無効なパラメーターが含まれていました。 | | `unauthorized` | 401 | リクエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行する権限のないベアラートークンが含まれていました。 | +| N/A | 429 | このエンドポイントへのリクエストが多すぎます。待ってからexponential backoffを使用して再試行してください。 | -`status` プロパティの値が `success` 以外の場合、`message` フィールドには問題に関する追加情報が提供されます。 +`status` の値が `success` 以外であれば、`message` フィールドにその問題に関する追加情報が表示されます。Note: 429 のレスポンスには、JSON 形式のレスポンス本文が含まれていません。 + +:::note +429 のレスポンスには、JSON 形式のレスポンスボディが含まれていません。 +::: ## Migration from v2 Identity Map @@ -285,7 +295,7 @@ for index, item in enumerate(response['body']['email']): import time def is_refresh_needed(mapping): - now = int(time.time() * 1000) # Convert to milliseconds + now = int(time.time()) # Current time in seconds return now >= mapping['refresh_from'] # Check individual mappings for refresh needs 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 1124507a9..122c78169 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 @@ -75,7 +75,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス ## Decrypting Responses -レスポンスを復号化するコードを自分で書くか、UID2 SDKを使うか、提供されているコード例のいずれかを使うかの選択肢があります([Encryption and Decryption Code Examples](#encryption-and-decryption-code-examples) を参照)。独自のコードを書く場合は、[Encrypted Response Envelope](#encrypted-response-envelope) および [Encrypted Response Envelope](#unencrypted-response-data-envelope) に記載されているフィールドレイアウトの要件に従うようにしてください。 +レスポンスを復号化するコードを自分で書くか、UID2 SDK を使うか、提供されているコード例のいずれかを使うかの選択肢があります([Encryption and Decryption Code Examples](#encryption-and-decryption-code-examples) を参照)。独自のコードを書く場合は、[Encrypted Response Envelope](#encrypted-response-envelope) および [Encrypted Response Envelope](#unencrypted-response-data-envelope) に記載されているフィールドレイアウトの要件に従うようにしてください。 :::note レスポンスは、サービスが HTTP ステータスコード 200 を返す場合のみ、暗号化されます。 @@ -127,7 +127,7 @@ Windows の場合、PowerShell の代わりに Windows コマンドプロンプ 以下のコードサンプルは Python を使ってリクエストを暗号化し、レスポンスを復号化します。必要なパラメータはコード例の一番上に示されており、 `python3 uid2_request.py` を実行することで得ることができます。 :::note -Windowsの場合は `python3` を `python` に置き換えてください。 +Windows の場合は `python3` を `python` に置き換えてください。 ::: Python のコードには `pycryptodomex` と `requests` パッケージが必要です。これらは以下のようにしてインストールできます: @@ -205,7 +205,7 @@ Maven を使用している場合は、以下の最小限の `pom.xml` を使用 以下のコードサンプルは、C# を使用してリクエストを暗号化し、レスポンスを復号化します。必要なパラメータはファイルの先頭に記載されています。また、`.\uid2_request` をビルドして実行することでも確認できます。 -このファイルには.NET 7.0が必要です。必要であれば、それ以前のバージョンを使用することもできますが、.NET Core 3.0以降でなければなりません。バージョンを変更するには、[top-level statements](https://learn.microsoft.com/ja-jp/dotnet/csharp/fundamentals/program-structure/top-level-statements) を Main メソッドに、[using 宣言](https://learn.microsoft.com/ja-jp/cpp/cpp/using-declaration?view=msvc-170) を [using ステートメント](https://learn.microsoft.com/ja-jp/dotnet/csharp/language-reference/proposals/csharp-8.0/using) に置き換えてください。 +このファイルには .NET 7.0 が必要です。必要であれば、それ以前のバージョンを使用することもできますが、.NET Core 3.0 以降でなければなりません。バージョンを変更するには、[top-level statements](https://learn.microsoft.com/ja-jp/dotnet/csharp/fundamentals/program-structure/top-level-statements) を Main メソッドに、[using 宣言](https://learn.microsoft.com/ja-jp/cpp/cpp/using-declaration?view=msvc-170) を [using ステートメント](https://learn.microsoft.com/ja-jp/dotnet/csharp/language-reference/proposals/csharp-8.0/using) に置き換えてください。 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 9c9972f07..108e57992 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 @@ -136,7 +136,7 @@ Refresh Token のワークフローをテストするにはどうすればよい メールアドレスの正規化、ハッシュ化、Base64 エンコードされたハッシュ値、または、電話番号のハッシュ化、Base64 エンコードされたハッシュ値を取得するには、ハッシングツールを使用できます。詳細は、[UID2 Hashing Tool](gs-normalization-encoding.md#uid2-hashing-tool) を参照してください。 ::: -SDKを使うかどうかで手順は少し異なります。 +SDK を使うかどうかで手順は少し異なります。 ##### With SDK: @@ -237,10 +237,6 @@ raw UID2 は、リフレッシュタイムスタンプの前では変化しま はい。何百万ものメールアドレスや電話番号をマッピングする必要がある場合、マッピングを保存しないことで処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングだけを再計算すると、毎日更新する必要があるのは UID2 の約 365 分の 1 なので、総処理時間が短縮されます。 -:::important -Private Operator を使用していない場合は、単一の HTTP 接続を使用して、バッチあたり最大 5,000 アイテムのバッチサイズで、メールアドレス、電話番号、またはハッシュを連続してマッピングする必要があります。つまり、複数の並行接続を作成せずにマッピングを行ってください。 -::: - #### How should I handle user opt-outs? ユーザーのオプトアウトはどのように処理すればよいですか？ 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 85e5bd985..9b13dbfd1 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 @@ -60,10 +60,10 @@ UID2 Operator Service< 以下の表は、シンプルな入力メールアドレスと、各手順を適用して安全で不透明な値に到達する結果を示しています。 -最終的な値、すなわちSHA-256ハッシュの16進数からBase64エンコードされた表現が、UID2 Operator endpoint に提供する値となります。 +最終的な値、すなわち SHA-256 ハッシュの 16 進数から Base64 エンコードされた表現が、UID2 Operator endpoint に提供する値となります。 :::warning -Base64エンコーディングを適用する際は、ハッシュの生のバイト列をBase64エンコードするか、16進数エンコードされた値を入力として受け取るBase64エンコーダーを使用してください。テキストを入力として受け取る関数を使用すると、結果として得られる文字列が長くなり、UID2の目的では無効となります。 +Base64 エンコーディングを適用する際は、ハッシュの生のバイト列を Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用してください。テキストを入力として受け取る関数を使用すると、結果として得られる文字列が長くなり、UID2 の目的では無効となります。 ::: | Type | Example | Comments and Usage | @@ -82,7 +82,7 @@ Base64エンコーディングを適用する際は、ハッシュの生のバ いくつかの例では、プラス記号（+）を含むメールアドレスと異なるドメインが示されています。`gmail` アドレスの場合、プラス記号とその後の文字は、`@` 記号まで無視されます。他のドメインでは、これらの文字は正規化された値に含まれます。 :::important -自身のUID2を扱う際には、常に最終値（Base64エンコードされた値）を UID2 Operator endpoint に提供してください。 +自身の UID2 を扱う際には、常に最終値（Base64 エンコードされた値）を UID2 Operator endpoint に提供してください。 ::: @@ -169,7 +169,7 @@ Base64 エンコーディングを適用する際は、ハッシュの生のバ 正規化、ハッシュ化、エンコードが正しく行われているかを確認するには、[UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) を使用できます。 :::note -UID2 ハッシュツールは、以前の場所 `https://unifiedid.com/examples/hashing-tool/` から移動しました。ハッシュツールへの保存済みリンクがある場合は、必ず最新のURLに更新してください。 +UID2 ハッシュツールは、以前の場所 `https://unifiedid.com/examples/hashing-tool/` から移動しました。ハッシュツールへの保存済みリンクがある場合は、必ず最新の URL に更新してください。 ::: Email または Phone Number を選択し、値を入力または貼り付けてから **Enter** をクリックします。 @@ -195,7 +195,7 @@ Email または Phone Number を選択し、値を入力または貼り付けて ## UID2 Token Validator :::note -このセクションはパブリッシャー向けです。パブリッシャーは、直接識別可能な情報（DII）を使用して [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を生成する唯一の参加者です。 +このセクションはパブリッシャー向けです。パブリッシャーは、直接識別可能な情報 (DII) を使用して [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を生成する唯一の参加者です。 ::: エンドツーエンドで完全なトークン生成パイプラインを検証し、正規化、ハッシュ化、およびエンコードされた値から生成された UID2 Token が正しいことを確認するには、[UID2 Token Validator](../ref-info/ref-token-validator.md) を使用してください。 @@ -212,6 +212,6 @@ Email または Phone Number を選択し、値を入力または貼り付けて - 正規化手順: [Phone Number Normalization](#phone-number-normalization). - 照合ツール: [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). -- **Use the Base64-encoded value**: このプロセスには、ハッシュ値のバイト列を正規化、ハッシュ化、Base64エンコードする手順が含まれます。UID2 を生成する際の入力は、このBase64エンコードされた値です。必ずこの44文字の文字列値を使用してください。 +- **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](https://hashing-tool.samples.uidapi.com/) でテストしてください。 \ 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-sharing.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-sharing.md index f76a63616..e606abbcb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-sharing.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-sharing.md @@ -26,7 +26,7 @@ UID2 Sharing は、UID2 参加者が UID2 参加ポリシーに従うことに UID2 Sharing に参加する前に、UID2 参加ポリシーを組み込んだ効果的な UID2 契約を設定する必要があります。この要件を満たしていない場合は、UID2 Sharing を続行できません。 -UID2 参加ポリシーに同意した場合、UID2 Sharing を行うことができます: [UID2 Sharing](/docs/category/uid2-sharing) を参照してください。 +UID2 参加ポリシーに同意した場合、UID2 Sharing を行うことができます: [UID2 Sharing](../sharing/sharing-overview) を参照してください。 この条件を満たす必要がある場合、または質問がある場合は、[UID2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) までお問い合わせください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-databricks.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-databricks.md index ac956df90..14c140577 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-databricks.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-databricks.md @@ -37,7 +37,7 @@ Databricks Clean Rooms 環境をセットアップしたら、UID2 サービス ## Key Benefits -UID2 処理に Databricks を統合する主なメリットは以下の通りです。 +UID2 処理に Databricks をインテグレーションする主なメリットは以下の通りです。 - Databricks データクリーンルーム内での UID2 ワークフロー管理をネイティブにサポート。 - パートナーデータセット間での安全なアイデンティティ相互運用性。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md index 4fc68fc26..446e33db5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md @@ -179,7 +179,7 @@ DII が電話番号の場合、UID2 [Phone Number Normalization](../getting-star | :--- | :--- | :--- | | `UID` | TEXT | 値は次のいずれかです: | | `PREV_UID` | TEXT | 値は次のいずれかです: | -| `REFRESH_FROM` | TIMESTAMP | 値は次のいずれかです: | +| `REFRESH_FROM` | NUMBER | 値は次のいずれかです: | | `UNMAPPED` | TEXT | 値は次のいずれかです: | #### Values for the UNMAPPED Column @@ -401,7 +401,7 @@ UID2 のリフレッシュが必要なものを特定するには、関数から | Column Name | Data Type | Description | | :--- | :--- | :--- | | `UID` | TEXT | UID2 に関連付けられた DII です。これは、アイデンティティマッピング関数によって返された現在の UID2 値です。 | -| `REFRESH_FROM` | TIMESTAMP | この UID2 をリフレッシュする必要がある時刻を示すタイムスタンプ (エポック秒) です。この値を現在の時刻と比較して、再生成が必要かどうかを判断します。 | +| `REFRESH_FROM` | NUMBER | この UID2 をリフレッシュする必要がある時刻を示すタイムスタンプ (エポック秒) です。この値を現在の時刻と比較して、再生成が必要かどうかを判断します。 | 以下の例は、入力テーブルと、リフレッシュ時間が到達したために再生成する必要がある UID2 をテーブル内で見つけるために使用されるクエリです。 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 fd0b3b81d..290ccabd9 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 @@ -318,6 +318,20 @@ Azure の Private Operator は、ポート 9080 で `/metrics` エンドポイ スクレイパーは、Private Operator が実行されている VNet にアクセスできる必要があります。ロードバランサーに `/metrics` エンドポイントへのアクセスを許可することは推奨しません。 +## Network Security Group Policy + +:::note +ドメインに関連付けられた証明書がエンクレーブに渡されるのを防ぐため、許可されるのはインバウンド HTTP のみです。インバウンド HTTPS は許可されません。これにより、すでに組織内のプライベートネットワークである環境において、追加のセキュリティ層を導入することによる余分な負荷も回避できます。 +::: + +以下の表は、サポートされているプロトコルに関する情報を提供します。 + +| Port Number | Direction | Protocol | Description | +| ----------- | --------- | -------- | ------ | +| 80 | Inbound | HTTP | ヘルスチェックエンドポイント `/ops/healthcheck` を含むすべての UID2 API を提供します。
すべてが正常に稼働している場合、エンドポイントは HTTP 200 とレスポンス本文 `OK` を返します。詳細は [Running the Health Check](#running-the-health-check) を参照してください。 | +| 9080 | Inbound | HTTP | Prometheus メトリックを提供します (`/metrics`)。詳細は [Scraping Metrics](#scraping-metrics) を参照してください。 | +| 443 | Outbound | HTTPS | UID2 Core Service と Azure Blob Storage への呼び出し、オプトアウトデータとキーストアのファイルをダウンロードします。 | + ## Upgrading UID2 Azure Confidential Containers の新しいバージョンがリリースされると、Private Operator は新しいリリースリンクを含む更新通知のメールを受信します。アップグレードのためのウィンドウがあり、その後、古いバージョンは非アクティブ化され、サポートされなくなります。 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 b176e2446..1c58e04ae 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 @@ -56,7 +56,7 @@ UID2 を使用する DSP のメリットの一部を次に示します。以下 - UID2 Token を復号して raw UID2 にします。 - ユーザーがオプトアウトしたかどうかを確認し、オプトアウトした場合は入札を行いません。 - raw UID2 をオーディエンスセグメントにマッチさせます。 -4. DSP は UID2 Token を付加したビッドレスポンス (入札レスポンス) をビッドストリームに送信します。 +4. DSP は UID2 Token を付加したビッドレスポンス (ビッドレスポンス) をビッドストリームに送信します。 ![Buy-Side Workflow](images/UID2BuySIdeDSPWorkflow.jpg) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md index 04fc612f8..06f1dcc8d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md @@ -134,7 +134,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
AKS
AKS は Azure Kubernetes Service の略です。詳細は、[Azure Kubernetes Service (AKS) とは?](https://learn.microsoft.com/ja-jp/azure/aks/what-is-aks) (Microsoft documentation) を参照してください。
機密コンテナ上で AKS クラスターを実行するために、Microsoft は、Microsoft Azure コンテナインスタンス上の仮想ノードで実行するソリューションを提供しています。詳細は、[Virtual nodes on Azure Container Instances](https://learn.microsoft.com/ja-jp/azure/container-instances/container-instances-virtual-nodes) (Microsoft documentation) を参照してください。
-
UID2 のコンテキストでは、AKS は Private Operator をホストするためのサポートされるセキュアコンピューティング環境の1つです。
+
UID2 のコンテキストでは、AKS は Private Operator をホストするためのサポートされるセキュアコンピューティング環境の 1 つです。
詳細は、UID2 Private Operator for AKS Integration Guide を参照してください。
@@ -175,7 +175,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
API key を参照してください。
Client keypair
-
Client-Side のパブリッシャーインテグレーションの場合、アカウントを一意に識別するためにパブリッシャーに発行される2つの値は、Subscription ID と public key です。Client keypair とは、この2つの値をまとめて呼ぶ用語です。
+
Client-Side のパブリッシャーインテグレーションの場合、アカウントを一意に識別するためにパブリッシャーに発行される 2 つの値は、Subscription ID と public key です。Client keypair とは、この2つの値をまとめて呼ぶ用語です。
詳細は Subscription ID and Public Key を参照してください。
Client secret
@@ -221,7 +221,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Data provider
-
UID2 のコンテキストでは、データプロバイダーは、データパートナー、測定パートナー、オフライン測定プロバイダーなど、広告に関連するデータおよび測定サービスを提供する事業者を指します。
+
UID2 のコンテキストでは、データプロバイダーは、データパートナー、測定パートナー、オフライン測定プロバイダーなど、広告に関連するデータおよび測定サービスを提供する Operator (参加者) を指します。
詳細は participant (Data Providers) を参照してください。
Demand-side platform (DSP)
@@ -377,7 +377,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
詳細は、参加者 を参照してください。
Private Operator
-
Private operator は、Operator Service のプライベートインスタンスを実行する事業者です。Private Operator は、安全な環境で独自のリソース (ハードウェアなど) を使用して、自身のために UID2 を生成および管理します。
+
Private operator は、Operator Service のプライベートインスタンスを実行する参加者です。Private Operator は、安全な環境で独自のリソース (ハードウェアなど) を使用して、自身のために UID2 を生成および管理します。
詳細は The UID2 Operator を参照してください。
Private Operator Service
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index c4a14d7bc..5dc687b00 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -134,6 +134,13 @@ import Link from '@docusaurus/Link'; - Code: [uid2-examples/tools/hashing-tool](https://github.com/IABTechLab/uid2-examples/tree/main/tools/hashing-tool) - Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding) +### UID Verify Chrome Extension + +UID2 Verify は、UID2 インテグレーションのデバッグのための Google Chrome ブラウザ拡張機能です。ウェブサイト上の UID2 SDK 情報を検査し、イベントとイベント履歴を追跡し、ストレージ（クッキーとローカルストレージ）を監視します。また、Prebid.js と Google Secure Signals のインテグレーションもサポートしています。 + +- Site: [UID Verify on Chrome Web Store](https://chromewebstore.google.com/detail/uid-verify/cfpjjmdagnkmmolcddnoagffeoekkmle) +- Doc: [UID Verify Chrome Extension](https://unifiedid.com/docs/ref-info/ref-uid-verify) + :::note このファイルのサンプルサイトは、一般的なインテグレーションのいくつかを強調していますが、利用可能なすべての UID2 インテグレーションオプションを表しているわけではありません。利用可能なすべてのインテグレーションオプションの概要については、[UID2 Integration Guides: Summary](../guides/summary-guides) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-token-validator.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-token-validator.md index 7cdf6324c..e975831e7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-token-validator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-token-validator.md @@ -14,7 +14,7 @@ import Link from '@docusaurus/Link'; ## Overview -DII を提供することで UID2 Token を生成するパブリッシャーは、有効に見えるにもかかわらず UID2 エコシステムで使用できないトークンを受け取ることがあります。これは、正規化またはハッシュ化のステップが正しく実行されなかった場合に発生します。UID2 はトークンの導出に DII の正規化・ハッシュ化された形式を使用するため、いずれかのステップでエラーが発生すると、そのパブリッシャー固有の raw UID2 が生成されます。この不一致な raw UID2 は、他の参加者が同じ DII に対して使用するものと一致しないため、そのパブリッシャーのトークンは、他のパブリッシャー、データプロバイダー、または広告主の CRM アップロードによるトークンと一致しません。 +パブリッシャーが DII を提供して UID2 Token を生成する際、結果の UID2 Token が有効に見えるが実際にはそうでない場合があります。これは、正規化やハッシュ化のステップが正しく実行されていないためです。UID2 は DII の正規化されたハッシュ化された形式を使用してトークンを生成するため、いずれかのステップでエラーが発生すると、その DII から他の参加者が生成した正しい値と対応しない UID2 Token と基になる raw UID2 が生成されます。 ## Prerequisites @@ -27,25 +27,28 @@ UID2 Token Validator を使用するには、以下が必要です: ## Using the Token Validator -Token Validation セクションの上部にあるフィールドに **API Key** (Client Key) と **Client Secret** を入力します。 +Token Validator を使用するには、以下の手順に従います: -検証対象の **Operator**（環境）を選択します。UID2 の環境については、[Environments](../getting-started/gs-environments.md) を参照してください。 +1. Token Validator セクションの上部にあるフィールドに、**API Key** (Client Key) と **Client Secret** を入力します。 +2. 検証対象とする **Operator** (環境) を選択します。UID2 環境の詳細については、[Environments](../getting-started/gs-environments.md) を参照してください。 ### Validate a Single Token +単一のトークンと識別子のペアを検証するには、以下の手順に従います: + 1. **Input Mode** で **Single Validation** を選択します。 2. **Identifier** フィールドに、トークンの生成に使用した DII を入力します。以下のいずれかを入力できます: - 生のメールアドレス - 生の電話番号 - - Base64 エンコードされたメールアドレスハッシュ - - Base64 エンコードされた電話番号ハッシュ + - 正規化し、Base64 エンコードされたメールアドレスハッシュ + - 正規化し、Base64 エンコードされた電話番号ハッシュ 3. 入力内容に一致する識別子タイプを選択します。 4. **Token** フィールドに、検証する UID2 Token を貼り付けます。 5. **Validate Tokens** をクリックします。 ### Validate Multiple Tokens (CSV) -トークンと識別子のペアを一括検証するには: +トークンと識別子のペアを一括検証するには、以下の手順に従います: 1. **Input Mode** で **CSV** を選択します。 2. 次の列を持つ CSV ファイルを用意します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-uid-verify.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-uid-verify.md new file mode 100644 index 000000000..283695f61 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-uid-verify.md @@ -0,0 +1,133 @@ +--- +title: UID Verify Chrome Extension +description: UID Verify Chrome 拡張機能を使用して、任意の Web ページの UID2 インテグレーションをデバッグおよび検査する方法。 +hide_table_of_contents: false +sidebar_position: 03 +displayed_sidebar: docs +--- + +import Link from '@docusaurus/Link'; + +# UID Verify Chrome Extension + +UID Verify は、UID2 インテグレーションのデバッグ用ブラウザ拡張機能です。現在のページの UID2 実装をリアルタイムで検査し、UID2 SDK の設定、アイデンティティストレージ、イベント履歴、エラーを表示します。 + +この拡張機能は、SDK for JavaScript、Prebid.js、Google Secure Signals を使用したインテグレーションをサポートします。 + +## Overview + +UID2 のインテグレーションを行う際、UID2 SDK が正しく初期化されているか、Token が有効か、ライフサイクルのどこでエラーが発生しているかを判断することが難しい場合があります。UID Verify は、UID2 SDK の設定、アイデンティティデータ、イベントストリームをページから直接読み取り、構造化された検索可能なインターフェースで表示することでデバッグを支援します。 + +この拡張機能は、ページが UID2 SDK を直接使用しているか、Prebid.js を使用しているか、Google Secure Signals を使用しているか（またはその組み合わせ）を検出し、各インテグレーションタイプに関連する情報を表示します。 + +## Prerequisites + +UID Verify には以下が必要です: + +- **Google Chrome** ブラウザ +- UID2 インテグレーションを持つ Web ページ — 以下のいずれかがページに存在する必要があります: + - SDK for JavaScript がページに読み込まれている（`window.__uid2` 経由でアクセス可能） + - Prebid.js と UID2 ユーザー ID モジュールが設定されている + - Google Publisher Tags (GPT) に UID2 Secure Signals プロバイダーが登録されている + +複数のインテグレーションタイプが検出された場合は、ポップアップ上部のインテグレーションタイプタブを使用して切り替えができます。 + +:::note +Server-Side インテグレーションは現在サポートされていません。UID Verify は、ブラウザストレージや UID2 SDK グローバル変数などの Client-Side シグナルを読み取ることで動作しますが、Server-Side インテグレーションにはこれらが存在しません。 +::: + +## Installing the Extension + +Chrome ウェブストアから UID Verify をインストールするには、次の手順に従います: + +1. Chrome ウェブストアで [UID Verify のリスト](https://chromewebstore.google.com/detail/uid-verify/cfpjjmdagnkmmolcddnoagffeoekkmle) を開きます。 +2. **Chrome に追加** をクリックします。 +3. プロンプトが表示されたら、**拡張機能を追加** をクリックします。 +4. 拡張機能をツールバーにピン留めしてアクセスしやすくします: ブラウザの拡張機能アイコンをクリックし、UID Verify の横にあるピンアイコンをクリックします。 + +## Using UID Verify + +インストール後、UID2 インテグレーションを検査するには次の手順に従います: + +1. UID2 インテグレーションを持つ Web ページに移動します。 +2. ブラウザのツールバーにある **UID Verify** アイコンをクリックして、拡張機能のポップアップを開きます。 +3. 拡張機能はページ上のインテグレーションタイプを検出し、適切なタブを表示します。 + +:::note +UID Verify は UID2 と EUID の両方をサポートしています。ページは UID2（北米とアジアの一部）または EUID（ヨーロッパおよびその他の GDPR 適用地域）のいずれかを使用する必要があり、両方を使用することはできません。同じページで両方が検出された場合、拡張機能はエラーを表示します。 +::: + +## Interpreting Results + +以下のセクションでは、UID Verify ポップアップの各タブで利用可能な情報について説明します。各タブのコンテンツは、検出されたインテグレーションタイプによって異なります。 + +### Config Tab + +**Config** タブは、トークン生成の成功、エラー、オプトアウトアイデンティティ、その他の設定状態のステータスバナーを含む、インテグレーションの現在の状態のスナップショットを提供します。表示される情報はインテグレーションタイプによって異なります（以下のセクションを参照）。 + +**UID2 SDK integrations:** + +- UID2 SDK バージョン +- UID2 SDK 初期化オプション +- 現在のアイデンティティオブジェクト（以下を含む）: + - Advertising Token + - Refresh Token + - Token とリフレッシュの有効期限タイムスタンプ +- `getAdvertisingToken()` の結果 +- `isLoginRequired()` の結果 + +**Prebid.js integrations:** + +- `window.pbjs.getUserIds().uid2` からの現在の UID2 Token +- `window.pbjs.getConfig().userSync.userIds` からの Prebid.js 設定パラメータ（例: `uid2ApiBase`、`subscriptionId`、`serverPublicKey`） + +**Google Secure Signals integrations:** + +- Google Publisher Tags が検出されているか +- UID2 プロバイダー ID が登録されているか +- `getAdvertisingTokenAsync` が利用可能か +- コレクター関数が登録されているか（UID2 Token を暗号化されたシグナルとして Google Ad Manager に渡す関数） + +### Storage Tab + +**Storage** タブは、現在のインテグレーションのブラウザに保存されている生のアイデンティティデータを表示します。 + +**UID2 SDK and Prebid.js integrations** + +SDK と Prebid.js インテグレーションには、次の表に示すフィールドが含まれます。 + +| Field | Description | +|---|---| +| Storage Type | アイデンティティがクッキーと `localStorage` のどちらに保存されているかを示します。| +| Storage Key | クッキーまたは `localStorage` キーの名前。UID2 SDK インテグレーションの場合: `__uid_2` または `UID2-sdk-identity`。Prebid.js インテグレーションの場合: `__uid2_advertising_token`。| +| Stored Value | `advertising_token`、`refresh_token`、`identity_expires`、`refresh_expires`、`refresh_from`、`refresh_response_key` を含む生のアイデンティティ JSON。| +| Valid Identity | 保存されているアイデンティティが現在有効かどうかを示します — つまり、Advertising Token の有効期限が切れておらず、ユーザーがオプトアウトしていないことを意味します。| +| Optout Identity | アイデンティティがオプトアウトしたユーザーを反映しているかどうかを示します。| + +Google Secure Signals インテグレーションの場合、このタブはセキュアシグナルの状態と現在の UID2 Advertising Token を表示します。シグナルがまだ生成されていない場合は、キャッシュされたシグナルも UID2 SDK の Advertising Token も利用できないことを示します。コレクター関数が正常に実行されると、拡張機能は「Secure signal is cached」というステータスメッセージを表示し、`_GESPSK-uidapi.com` に保存されたキャッシュ値を表示します。キャッシュされたシグナルは `[providerId, advertisingToken, expiryTimestamp]` の形式です。現在の UID2 Advertising Token も別途表示されます。 + +### Callbacks Tab + +**Callbacks** タブは UID2 SDK インテグレーションのみで利用可能です。UID2 SDK に登録されたすべてのコールバック関数のソースコードをシンタックスハイライト付きで表示します。これは、正しいコールバックが登録されていることを確認し、ページコードのどこでイベントが処理されているかを特定するのに役立ちます。 + +### Event History Tab + +**Event History** タブは、ページで発生する UID2 SDK イベントのリアルタイムで検索可能なログを表示します。次の表に示す列が含まれます。 + +| Column | Description | +|---|---| +| Date | イベントが記録された日付。| +| Time | イベントが記録された時刻。| +| Event | イベントタイプ（例: `SdkLoaded`、`InitCompleted`、`TokenUpdated`）。| +| Advertising Token | イベントに関連する Advertising Token（存在する場合）。| + +検索バーを使用して、イベントタイプまたはトークン値でフィルタリングします。 + +このタブには、エラーが検出された場合の **Error Log** も含まれます。拡張機能は以下を含む複数のソースからエラーをキャプチャします: + +- UID2 Operator へのネットワークリクエストの失敗 +- リソースの読み込み失敗（UID2 SDK スクリプトなど） +- UID2 SDK コードからの `console.error` 呼び出し +- UID2 SDK メソッドによってスローされたエラー + +既知のエラーパターンについては、拡張機能はエラーとともにコンテキストに応じたトラブルシューティングガイダンスを表示します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md index e7d311afe..3662e3d96 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md @@ -20,6 +20,41 @@ UID2 ドキュメントリソースの最新アップデートを確認してく タグツールバーを使用して、ドキュメントの更新の一部を表示できます。 ::: +## Q2 2026 + +2026 年第 2 四半期にリリースされたドキュメントは以下の通りです。 + + + +### UID2 Token Validator + +April 24, 2026 + +UID2 Token の生成プロセスが正しいことを確認できるよう、ソースとなる DII に対して UID2 Token の有効性を検証するウェブベースのツール [UID2 Token Validator](ref-token-validator.md) の新しいリファレンスページを追加しました。 + +詳細は、[UID2 Token Validator](ref-token-validator.md) を参照してください。 + + + + + + + +### Rate Limiting and Parallel Request Updates for POST /identity/map + +April 1, 2026 + +[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントのドキュメントが、以下の変更で更新されました: + +- エンドポイントがトラフィックの急増からシステムを保護するためにレート制限を強制することを説明する、新しい [Rate Limiting](../endpoints/post-identity-map.md#rate-limiting) セクションを追加しました。 +- 単一の HTTP 接続でバッチを順次に送信するという以前の推奨事項を削除しました。 + +これらの変更は、[v2](../endpoints/post-identity-map-v2.md) と [v3](../endpoints/post-identity-map.md) の両方のエンドポイントに適用されます。 + + + + + ## Q1 2026 2026 年第 1 四半期にリリースされたドキュメントは以下の通りです。 @@ -496,7 +531,7 @@ March 4, 2024 February 28, 2024 -Java SDKは、[POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントの使用を希望する広告主およびデータプロバイダーをサポートするようになりました。 +Java SDK は、[POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントの使用を希望する広告主およびデータプロバイダーをサポートするようになりました。 詳細は、*SDK for Javaリファレンスガイド*: [Usage for Advertisers and Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) の更新されたドキュメントを参照してください。 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 59f96c133..ecde08b62 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 @@ -18,7 +18,7 @@ UID2 Server-Side SDK を使用すると、UID2 Token を復号化して raw UID2 ## Functionality -このSDKは、Server-Sideのコーディングに C++ を使用している DSP または UID2 Sharers のために、UID2 とのインテグレーションを簡素化します。次の表に、この SDK がサポートする機能を示します。 +この SDK は、Server-Side のコーディングに C++ を使用している DSP または UID2 Sharers のために、UID2 とのインテグレーションを簡素化します。次の表に、この SDK がサポートする機能を示します。 | Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s | Monitor Rotated Salt Buckets | | :--- | :--- | :--- | :--- | :--- | :--- | @@ -54,7 +54,7 @@ Release tags は以下の GitHub で入手できますが、バイナリーは ## Initialization -初期化関数は、SDKが UID2 Service で認証するために必要なパラメータを設定します。また、エラー発生時の再試行間隔を設定することもできます。 +初期化関数は、SDK が UID2 Service で認証するために必要なパラメータを設定します。また、エラー発生時の再試行間隔を設定することもできます。 | Parameter | Description | Recommended Value | | :--- | :--- | :--- | @@ -123,7 +123,7 @@ UID2 Sharing Partic ```cpp const auto client = UID2ClientFactory::Create(baseUrl, apiKey, secretKey); ``` -2. 起動時に一度リフレッシュし、その後定期的にリフレッシュします (推奨リフレッシュ間隔は1時間毎): +2. 起動時に一度リフレッシュし、その後定期的にリフレッシュします (推奨リフレッシュ間隔は 1 時間毎): ```cpp client->Refresh(); @@ -153,7 +153,7 @@ UID2 Sharing Partic DecryptionResult decrypted = client->Decrypt(uidToken); ``` - 2. 復号化に成功した場合は、raw UID2を使用します: + 2. 復号化に成功した場合は、raw UID2 を使用します: ```cpp if (decrypted.IsSuccess()) 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 02883cc12..346fb0936 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 @@ -18,7 +18,7 @@ Server-Side では、C# / .NET SDK を使用して、raw UID2 を暗号化して ## Functionality -この SDK は、Server-Sideのコーディングに C# / .NET を使用している DSP または UID2 sharer のために、UID2 とのインテグレーションを簡素化します。次の表は、この SDK がサポートする機能を示しています。 +この SDK は、Server-Side のコーディングに C# / .NET を使用している DSP または UID2 sharer のために、UID2 とのインテグレーションを簡素化します。次の表は、この SDK がサポートする機能を示しています。 | Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s | Monitor Rotated Salt Buckets | | :--- | :--- | :--- | :--- | :--- | :--- | @@ -70,7 +70,7 @@ SDK が UID2 Service で認証するために必要な値を提供する必要 ユーザーのオプトアウトを処理する入札ロジックの詳細は [DSP Integration Guide](../guides/dsp-guide.md) を参照してください。 -`SharingClient` クラスを使うと、raw UID2 を暗号化して UID2 Token に変換したり、UID2 Token を復号してraw UID2 に変換したりすることができます。 +`SharingClient` クラスを使うと、raw UID2 を暗号化して UID2 Token に変換したり、UID2 Token を復号して raw UID2 に変換したりすることができます。 :::note SDK を使用する場合、復号鍵を保存したり管理したりする必要はありません。 @@ -78,7 +78,7 @@ SDK を使用する場合、復号鍵を保存したり管理したりする必 ### Encryption Response Content -`SharingClient`で暗号化する場合、SDKは以下の情報を返します： +`SharingClient`で暗号化する場合、SDK は以下の情報を返します： | Property | Description | | :--- | :--- | @@ -130,7 +130,7 @@ SDK を使用する場合、復号鍵を保存したり管理したりする必 var client = new BidstreamClient(UID2_BASE_URL, UID2_API_KEY, UID2_SECRET_KEY); ``` -2. 起動時に一度リフレッシュし、その後定期的にリフレッシュします(推奨リフレッシュ間隔は1時間毎): +2. 起動時に一度リフレッシュし、その後定期的にリフレッシュします(推奨リフレッシュ間隔は 1 時間毎): ```cs client.Refresh(); 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 ae2196790..df58fd097 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 @@ -32,7 +32,7 @@ iOS SDK を使用すると、UID2 を使用したクライアント ID の生成 SDK for iOS は、iOS アプリケーションに代わって UID2 ID を生成または管理するように設計されています。プラットフォームネイティブの暗号化ツールを使って ID をデバイスに安全に保存することで、UID2 ID をアプリのライフサイクル全体にわたって持続させることができます。 -デフォルトでは、SDK は有効期限に基づいて UID2 ID を自動的にリフレッシュします。ただし、これを無効にして、アプリが UID2 IDのライフサイクルを手動で管理できるように実装することもできます。 +デフォルトでは、SDK は有効期限に基づいて UID2 ID を自動的にリフレッシュします。ただし、これを無効にして、アプリが UID2 ID のライフサイクルを手動で管理できるように実装することもできます。 ## UID2 Account Setup @@ -78,7 +78,7 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S ## Installation -Swift Package Manager (SPM) を使って iOS SDK をインストールします。2つのインストールオプションがあります: +Swift Package Manager (SPM) を使って iOS SDK をインストールします。2 つのインストールオプションがあります: - [Package.swift](#installing-with-packageswift) - [Xcode](#installing-with-xcode) @@ -116,7 +116,7 @@ pod 'UID2', '~> 2.0' iOS の場合、`UID2Manager` は初めてアクセスされたときに自動的に初期化されます。自動または手動のリフレッシュ機能をサポートするように設定できます。 -UID2 Identity を確立する方法は2つあります: +UID2 Identity を確立する方法は 2 つあります: 1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順は、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 @@ -153,7 +153,7 @@ UID2Manager.shared.getAdvertisingToken() ## UID2Manager API -このセクションには、UID2Manager APIの一部である関数と変数が含まれています。 +このセクションには、UID2Manager API の一部である関数と変数が含まれています。 ### Functions @@ -191,7 +191,7 @@ SDK が管理している UID2 Identity を手動でリフレッシュします ### Variables -UID2Manager APIでは、以下の変数を使用できます: +UID2Manager API では、以下の変数を使用できます: - [identity](#identity) - [identityStatus](#identitystatus) @@ -202,4 +202,4 @@ Identity 変数は、SDK によって管理されている現在の UID2Identity #### identityStatus -identityStatus変数は、SDKが管理している現在のUID2 Identityのステータスを格納し、返します。 +identityStatus 変数は、SDK が管理している現在の UID2 Identity のステータスを格納し、返します。 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 d7c31b84f..575593a3a 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 @@ -282,7 +282,7 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in if (identity.isDueForRefresh()) {..} ``` 4. リフレッシュが必要な場合は、[POST token/refresh](../endpoints/post-token-refresh.md)エンドポイントを、以下のように呼び出します: - 1. Headers: HTTPライブラリによっては、次のようになります: + 1. Headers: HTTP ライブラリによっては、次のようになります: `.putHeader("Authorization", "Bearer " + UID2_API_KEY)` `.putHeader("X-UID2-Client-Version", PublisherUid2Helper.getVersionHttpHeader())`. 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 e27942ae0..591da5558 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 @@ -85,7 +85,7 @@ Web インテグレーションの詳細は [Client-Server Integration Guide for | :--- | :--- | :---| :---| :---| | Initialization | `undefined`| `undefined`| コールバックが呼び出されるまでの初期状態です。 | N/A | | Identity Is Available | available |`false` | 有効な ID が正常に確立または更新されました。ターゲティング広告で Advertising Toke を使用できます。 |`ESTABLISHED` or `REFRESHED` | -| Identity Is Temporarily Unavailable |`undefined` | `false`| Advertising Token の有効期限が切れたため、自動更新に失敗しました。[Background auto-refresh](#background-token-auto-refresh) は、Refresh Token の有効期限が切れるか、ユーザーがオプトアウトするまで続きます。
以下のいずれかを行ってください:
- ユーザーをリダイレクトし、メールアドレスまたは電話番号の入力を求める。
- ターゲティングしない広告を使用する。
NOTE: ID は後で正常にリフレッシュされるかもしれません。—たとえば、UID2 Serviceが一時的に利用できなくなった場合などです。 | `EXPIRED` | +| Identity Is Temporarily Unavailable |`undefined` | `false`| Advertising Token の有効期限が切れたため、自動更新に失敗しました。[Background auto-refresh](#background-token-auto-refresh) は、Refresh Token の有効期限が切れるか、ユーザーがオプトアウトするまで続きます。
以下のいずれかを行ってください:
- ユーザーをリダイレクトし、メールアドレスまたは電話番号の入力を求める。
- ターゲティングしない広告を使用する。
NOTE: ID は後で正常にリフレッシュされるかもしれません。—たとえば、UID2 Service が一時的に利用できなくなった場合などです。 | `EXPIRED` | | Identity Is Not Available | `undefined`| `false`| ID が利用できず、リフレッシュできません。SDK はファーストパーティクッキーをクリアします。
UID2 ベースのターゲティング広告を再度使用するには、UID2 を取得できるログインまたはフォーム入力にユーザーをリダイレクトする必要があります。 | `INVALID`, `NO_IDENTITY`, `REFRESH_EXPIRED`, or `OPTOUT` | 次の図は、対応する ID の [status values](#identity-status-values) を含む 4 つの状態と、それらの間で可能な遷移を示しています。SDK は各遷移で [callback function](#callback-function) を呼び出します。 @@ -94,12 +94,12 @@ Web インテグレーションの詳細は [Client-Server Integration Guide for ### Background Token Auto-Refresh -SDKの [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 +SDK の [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 Token の Auto-refresh について知っておくべきことは以下のとおりです: - 同時にアクティブにできる [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイント呼び出しは1つだけです。 -- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 +- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2 ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 - SDK の初期化時に指定された [callback function](#callback-function) は、以下の場合に呼び出されます: - リフレッシュが成功するたびに呼び出されます。 - 有効期限が切れた Advertising Token のリフレッシュに最初に失敗した場合。 @@ -171,7 +171,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 | :--- | :--- | :--- | :--- | :--- | | `callback` | `function(object): void` | 必須 | 渡された ID を検証した後に SDK が呼び出す関数です。[Callback Function](#callback-function) を参照してください。 | N/A | | `identity` | object | オプション | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) 呼び出しが成功したときの `body` プロパティ値です。
[ファーストパーティクッキー](#uid2-cookie-format) からの ID を使用するには、このプロパティを空にしておきます。 | N/A | -| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | +| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URL です。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | | `refreshRetryPeriod` | number | オプション | 断続的なエラーが発生した場合に、トークンのリフレッシュを再試行する秒数です。 | 5 | | `cookieDomain` | string | オプション | [UID2 cookie](#uid2-cookie-format) に適用するドメイン名文字列です。
たとえば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | | `cookiePath` | string | オプション | [UID2 cookie](#uid2-cookie-format) に適用する Path 文字列です。 | `/` | @@ -323,7 +323,7 @@ SDK はファーストパーティクッキーを使用してユーザーの ID ### Contents Structure -UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いてURI エンコードした文字列表現です。 +UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いて URI エンコードした文字列表現です。 以下は UID2 cookie 構造の例です: 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 d8657d21e..5c4323ad7 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 @@ -115,7 +115,7 @@ Version 3 以降の SDK は、`async` または `defer` スクリプトローデ サイトで `async` または `defer` スクリプトのロードを使用している場合は、次のようにしてください: - (必須) `SdkLoaded` イベントを受信したときに、[callback function](#callback-function) から `__uid2.init` を呼び出していることを確認します。 -- (必須) Scriptタグに関連する属性を追加します。 +- (必須) Script タグに関連する属性を追加します。 - (推奨) 以下の例のように、Script タグがページの `` 部分にあることを確認してください: ```html @@ -146,12 +146,12 @@ SDK を使用して UID2 ID を確立するための Client-Side ワークフロ ### Background Token Auto-Refresh -SDKの [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 +SDK の [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 Token の Auto-refresh について知っておくべきことは以下のとおりです: - 一度にアクティブにできる Token refresh call は 1 つだけです。 -- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 +- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2 ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 - SDK の初期化時に指定された [callback function](#callback-function) は、以下の場合に呼び出されます: - リフレッシュが成功するたびに呼び出されます。 - ユーザがオプトアウトした場合など、IDが無効になった場合。
NOTE: ID が一時的に使用できなくなり、自動リフレッシュに失敗し続けた場合、コールバックは呼び出されません。この場合、SDK は有効期限が切れていない限り、既存の Advertising Token を使用し続けます。 @@ -162,7 +162,7 @@ Token の Auto-refresh について知っておくべきことは以下のとお [Array Push Pattern](#array-push-pattern) を使用して、UID2 SDK からイベントを受信する関数を登録できます。現在利用可能なイベントはいくつかあります: - `SdkLoaded` は SDK がパースされ、グローバルな `__uid2` オブジェクトが構築された後に発生します。これは `init()` を呼び出す際に便利で、特にスクリプトのロード順序が保証されていない場合に便利です (例えば、スクリプトのロードに `async` や `defer` を使用している場合など)。 - `init()` が終了し、SDK を使用できる状態になると `InitCompleted` が発生します。`init` 呼び出しで ID が提供された場合、または SDK が以前に提供された ID をロードできた場合、その ID がペイロードに含まれます。 -- `IdentityUpdated` は、新しいIDが利用可能になるか、既存の ID が利用できなくなるたびに発生します。 +- `IdentityUpdated` は、新しい ID が利用可能になるか、既存の ID が利用できなくなるたびに発生します。 :::tip コールバック関数はいくつでも用意でき、どこからでも登録できます。これにより、サイトにとって意味のある方法でコードを分割することができます。 @@ -325,11 +325,11 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 | Property | Data Type | Attribute | Description | Default Value | | :--- | :--- | :--- | :--- | :--- | | `identity` | object | オプション | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) 呼び出しが成功したときの `body` プロパティ値です。
[ファーストパーティクッキー](sdk-ref-javascript-v2.md#uid2-cookie-format) からの ID を使用するには、このプロパティを空にしておきます。 | N/A | -| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
例えば: `https://my.operator.com`. | `https://prod.uidapi.com`. | +| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URL です。
例えば: `https://my.operator.com`. | `https://prod.uidapi.com`. | | `refreshRetryPeriod` | number | オプション | 断続的なエラーが発生した場合に、トークンのリフレッシュを再試行するミリ秒数です。
この値は 1000 以上でなければなりません。 | 5000 | | `cookieDomain` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用するドメイン名文字列です。
例えば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | | `cookiePath` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用する Path 文字列です。 | `/` | -| `useCookie` | `boolean` | オプション | この値を `true` に設定すると、SDK はローカルストレージではなくクッキーに ID を保存します。この値がfalseであるか、提供されていない場合でも、ファーストパーティクッキーを使用して ID を提供することができます。 | +| `useCookie` | `boolean` | オプション | この値を `true` に設定すると、SDK はローカルストレージではなくクッキーに ID を保存します。この値が false であるか、提供されていない場合でも、ファーストパーティクッキーを使用して ID を提供することができます。 | | `callback` | `function(object): void` | 非推奨 | 渡された ID を検証した後に SDK が呼び出す関数です。新しいインテグレーションには使用しないでください。 | N/A | #### Multiple Init Calls @@ -514,7 +514,7 @@ UID2 SDK に新しい ID を提供するには、この関数を使用します SDK はユーザーの ID を保存するのに、ローカルストレージかファーストパーティクッキーのどちらかを使用します。デフォルトではローカルストレージを使用しますが、[init parameter](#init-parameters) を使用して変更できます。 -ローカルストレージを使用する場合でも、SDK はファーストパーティクッキーに利用可能な新しい ID があるかどうかを確認します。これにより、SDK はローカルストレージを利用しながら、ファーストパーティクッキーを設定することでIDを提供することができます。 +ローカルストレージを使用する場合でも、SDK はファーストパーティクッキーに利用可能な新しい ID があるかどうかを確認します。これにより、SDK はローカルストレージを利用しながら、ファーストパーティクッキーを設定することで ID を提供することができます。 ### UID2 Cookie Properties @@ -529,7 +529,7 @@ SDK はユーザーの ID を保存するのに、ローカルストレージか ### Contents Structure -UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いてURI エンコードした文字列表現です。 +UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いて URI エンコードした文字列表現です。 以下は UID2 cookie 構造の例です: 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 671e29d1c..6b8c9e623 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 @@ -124,7 +124,7 @@ Version 3 以降の SDK は、`async` または `defer` スクリプトローデ サイトで `async` または `defer` スクリプトのロードを使用している場合は、次のようにしてください: - (必須) `SdkLoaded` イベントを受信したときに、[callback function](#callback-function) から `__uid2.init` を呼び出していることを確認します。 -- (必須) Scriptタグに関連する属性を追加します。 +- (必須) Script タグに関連する属性を追加します。 - (推奨) 以下の例のように、Script タグがページの `` 部分にあることを確認してください: ```html @@ -155,12 +155,12 @@ SDK を使用して UID2 ID を確立するための Client-Side ワークフロ ### Background Token Auto-Refresh -SDKの [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 +SDK の [initialization](#initopts-object-void) の一部として、ID の Token Auto-refresh が設定され、ID の Timestamp または断続的なエラーによるリフレッシュの失敗によってバックグラウンドでトリガーされます。 Token の Auto-refresh について知っておくべきことは以下のとおりです: - 一度にアクティブにできる Token refresh call は 1 つだけです。 -- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 +- [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2 ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります（[isLoginRequired()](#isloginrequired-boolean)は`true`を返します）。 - SDK の初期化時に指定された [callback function](#callback-function) は、以下の場合に呼び出されます: - リフレッシュが成功するたびに呼び出されます。 - ユーザがオプトアウトした場合など、IDが無効になった場合。
NOTE: ID が一時的に使用できなくなり、自動リフレッシュに失敗し続けた場合、コールバックは呼び出されません。この場合、SDK は有効期限が切れていない限り、既存の Advertising Token を使用し続けます。 @@ -171,7 +171,7 @@ Token の Auto-refresh について知っておくべきことは以下のとお [Array Push Pattern](#array-push-pattern) を使用して、UID2 SDK からイベントを受信する関数を登録できます。現在利用可能なイベントはいくつかあります: - `SdkLoaded` は SDK がパースされ、グローバルな `__uid2` オブジェクトが構築された後に発生します。これは `init()` を呼び出す際に便利で、特にスクリプトのロード順序が保証されていない場合に便利です (たとえば、スクリプトのロードに `async` や `defer` を使用している場合など)。 - `init()` が終了し、SDK を使用できる状態になると `InitCompleted` が発生します。`init` 呼び出しで ID が提供された場合、または SDK が以前に提供された ID をロードできた場合、その ID がペイロードに含まれます。 -- `IdentityUpdated` は、新しいIDが利用可能になるか、既存の ID が利用できなくなるたびに発生します。 +- `IdentityUpdated` は、新しい ID が利用可能になるか、既存の ID が利用できなくなるたびに発生します。 :::tip コールバック関数はいくつでも用意でき、どこからでも登録できます。これにより、サイトにとって意味のある方法でコードを分割することができます。 @@ -319,11 +319,11 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 | Property | Data Type | Attribute | Description | Default Value | | :--- | :--- | :--- | :--- | :--- | | `identity` | object | オプション | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) 呼び出しが成功したときの `body` プロパティ値です。
[ファーストパーティクッキー](sdk-ref-javascript-v2.md#uid2-cookie-format) からの ID を使用するには、このプロパティを空にしておきます。 | N/A | -| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | +| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URL です。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | | `refreshRetryPeriod` | number | オプション | 断続的なエラーが発生した場合に、トークンのリフレッシュを再試行するミリ秒数です。
この値は 1000 以上でなければなりません。 | 5000 | | `cookieDomain` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用するドメイン名文字列です。
たとえば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | | `cookiePath` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用する Path 文字列です。 | `/` | -| `useCookie` | `boolean` | オプション | この値を `true` に設定すると、SDK はローカルストレージではなくクッキーに ID を保存します。この値がfalseであるか、提供されていない場合でも、ファーストパーティクッキーを使用して ID を提供することができます。 | +| `useCookie` | `boolean` | オプション | この値を `true` に設定すると、SDK はローカルストレージではなくクッキーに ID を保存します。この値が false であるか、提供されていない場合でも、ファーストパーティクッキーを使用して ID を提供することができます。 | #### Multiple Init Calls @@ -495,7 +495,7 @@ UID2 SDK に新しい ID を提供するには、この関数を使用します SDK はユーザーの ID を保存するのに、ローカルストレージかファーストパーティクッキーのどちらかを使用します。デフォルトではローカルストレージを使用しますが、[init parameter](#init-parameters) を使用して変更できます。 -ローカルストレージを使用する場合でも、SDK はファーストパーティクッキーに利用可能な新しい ID があるかどうかを確認します。これにより、SDK はローカルストレージを利用しながら、ファーストパーティクッキーを設定することでIDを提供することができます。 +ローカルストレージを使用する場合でも、SDK はファーストパーティクッキーに利用可能な新しい ID があるかどうかを確認します。これにより、SDK はローカルストレージを利用しながら、ファーストパーティクッキーを設定することで ID を提供することができます。 ### UID2 Cookie Properties @@ -510,7 +510,7 @@ SDK はユーザーの ID を保存するのに、ローカルストレージか ### Contents Structure -UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いてURI エンコードした文字列表現です。 +UID2 Cookie の内容は、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスの `body` プロパティと同じ構造を持つ JSON オブジェクトを、`private` オブジェクトを除いて URI エンコードした文字列表現です。 以下は UID2 cookie 構造の例です: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-use-cases.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-use-cases.md index 49b214c4a..da0047c12 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-use-cases.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-use-cases.md @@ -17,7 +17,7 @@ import Link from '@docusaurus/Link'; - Tokenized Sharing (sharing a UID2 token) examples: - パブリッシャー (送信者) は、UID2 Token をビッドストリーム経由で DSP (受信者) に送信します。([Tokenized Sharing in the Bidstream](sharing-tokenized-from-data-bid-stream.md) を参照) - 広告主 (送信者) がトラッキングピクセルを通じて UID2 Token をデータプロバイダー (受信者) に送信します。([Tokenized Sharing in Pixels](sharing-tokenized-from-data-pixel.md) を参照) -- Raw UID2 共有 (sharing a raw UID2) の例: +- raw UID2 共有 (sharing a raw UID2) の例: - 測定パートナー (送信者) は、Amazon Simple Storage Service (S3) を介して、raw UID2 を広告主 (受信者) に送信します。([Raw UID2 Sharing](sharing-raw.md) を参照) - DSP (送信者) は、raw UID2 をレポート経由で広告主 (受信者) に送信します。([Raw UID2 Sharing](sharing-raw.md) を参照)