diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md index ebd3ef7b6..6a337fea8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md @@ -14,6 +14,12 @@ import Link from '@docusaurus/Link'; Used by: このエンドポイントは、主に広告主とデータプロバイダーによって使用されます。詳細は [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 +:::important +最新バージョン (v3) の `POST /v3/identity/map` を使用している場合は、`POST /identity/buckets` を使用する必要はありません。以前のバージョン (v2) の `POST /v2/identity/map` を使用している場合にのみ必要です。 + +v2 バージョンを使用している場合は、改善点を活用するためにできるだけ早くアップグレードすることをお勧めします。移行ガイダンスは、[Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map) を参照してください。 +::: + ## Request Format `POST '{environment}/v2/identity/buckets'` @@ -31,7 +37,7 @@ Used by: このエンドポイントは、主に広告主とデータプロバ | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters 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 95f88bf30..dc755ce3a 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 @@ -15,6 +15,14 @@ Used by: このエンドポイントは、主に広告主やデータプロバ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +## Version + +このドキュメントは、このエンドポイントのバージョン 2 のものであり、最新バージョンではありません。最新バージョン v3 の詳細は、[POST /identity/map](post-identity-map.md) を参照してください。 + +:::note +v2 バージョンを使用している場合は、改善点を活用するためにできるだけ早くアップグレードすることを推奨します。移行ガイダンスは、[Migration from v2 Identity Map](post-identity-map.md#migration-from-v2-identity-map) を参照してください。 +::: + ## Batch Size and Request Parallelization Requirements 知っておくべきことは以下のとおりです: @@ -41,7 +49,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳 | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters 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 ce1108f09..94bceea1c 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 @@ -11,68 +11,64 @@ import POSTIdentityMapImprovements from '../snippets/_post-identity-map-improvem # POST /identity/map -:::note -このページには、近日中に翻訳される新しいコンテンツが含まれています。 -::: +複数のメールアドレス、電話番号、またはそれぞれのハッシュを、raw UID2 にマッピングします。このエンドポイントを使用して、オプトアウト情報の更新をチェックしたり、raw UID2 の更新が可能な時期を確認したり、現在の raw UID2 が 発行されてから 90 日未満の場合に前の UID2 を表示することもできます。 -Maps multiple email addresses, phone numbers, or their respective hashes to their raw UID2s. You can also use this endpoint to check for updates to opt-out information, check when a raw UID2 can be refreshed, or view the previous UID2 if the current UID2 is less than 90 days old. +Used by: このエンドポイントは、主に広告主とデータプロバイダーによって使用されます。詳細は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 -Used by: This endpoint is used mainly by advertisers and data providers. For details, see [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md). - -For details about the UID2 opt-out workflow and how users can opt out, see [User Opt-Out](../getting-started/gs-opt-out.md). +UID2 のオプトアウト手順とユーザーがオプトアウトする方法は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 ## Version -This documentation is for the latest version of this endpoint, version 3. +このドキュメントは、エンドポイントの最新版であるバージョン 3 を対象としています。 -If needed, documentation is also available for the previous version: see [POST /identity/map (v2)](post-identity-map-v2.md). +必要に応じて、以前のバージョンのドキュメントも利用可能です: [POST /identity/map (v2)](post-identity-map-v2.md) を参照してください。 ## Batch Size and Request Parallelization Requirements -Here's what you need to know: +以下が必要な情報です: -- The maximum request size is 1MB. -- To map a large number of email addresses, phone numbers, or their respective hashes, send them in *sequential* batches with a maximum batch size of 5,000 items per batch. -- Unless you are using a Private Operator, do not send batches in parallel. In other words, use a single HTTP connection and send batches of hashed or unhashed directly identifying information (DII) values consecutively, without creating multiple parallel connections. -- Be sure to store mappings of email addresses, phone numbers, or their respective hashes.
Not storing mappings could increase processing time drastically when you have to map millions of email addresses or phone numbers. Recalculating only those mappings that actually need to be updated, however, reduces the total processing time because only about 1/365th of UID2s need to be updated daily. See also [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) and [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers). +- 最大リクエストサイズは 1MB です。 +- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマッピングする場合は、1 バッチあたり最大 5,000 アイテムの *順次* バッチで送信します。 +- プライベートオペレーターを使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化または非ハッシュ化された 直接識別情報 (DII) 値のバッチを連続して送信し、複数の並行接続を作成しないでください。 +- メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする際に処理時間が大幅に増加する可能性があります。ただし、実際に更新が必要なマッピングのみを再計算すると、UID2 の約 1/365 が毎日更新されるため、総処理時間が短縮されます。詳細は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 ## Request Format `POST '{environment}/v3/identity/map'` -For authentication details, see [Authentication and Authorization](../getting-started/gs-auth.md). +認証の詳細は、[Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 :::important -You must encrypt all requests using your secret. For details, and code examples in different programming languages, see [Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md). +すべてのリクエストをシークレットを使用して暗号化する必要があります。詳細は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 ::: ### Path Parameters | Path Parameter | Data Type | Attribute | Description | | :--- | :--- | :--- | :--- | -| `{environment}` | string | Required | Testing (integration) environment: `https://operator-integ.uidapi.com`
Production environment: The best choice depends on where your users are based. For information about how to choose the best URL for your use case, and a full list of valid base URLs, see [Environments](../getting-started/gs-environments.md). | +| `{environment}` | string | Required | テスト（インテグレーション）環境: `https://operator-integ.uidapi.com`
本番環境: 最適な選択は、ユーザーの所在地によって異なります。ユースケースに適したURLの選択方法や、有効なベース URL の一覧は、[Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -The integration environment and the production environment require different API keys. For information about getting credentials for each environment, see [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials). +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報の取得方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters :::important -Include one or more of the following four parameters as key-value pairs in the JSON body of the request when encrypting it. +暗号化を行う際には、リクエストの JSON 本文に次の 4 つのパラメーターのいずれかをキーと値のペアとして含めてください。 ::: -| Body Parameter | Data Type | Attribute | Description | -|:---------------|:----------------------------|:-----------------------| :--- | -| `email` | string array | Conditionally Required | The list of email addresses to be mapped. | -| `email_hash` | string array | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#email-address-normalization) email addresses to be mapped. | -| `phone` | string array | Conditionally Required | The list of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. | -| `phone_hash` | string array | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. | +| Body Parameter | Data Type | Attribute | Description | +| :--- | :--- | :--- | :--- | +| `email` | string array | 条件付きで必須 | マッピングするメールアドレスのリスト。 | +| `email_hash` | string array | 条件付きで必須 | マッピングする[正規化済み](../getting-started/gs-normalization-encoding.md#email-address-normalization)メールアドレスの[Base64エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding)ハッシュのリスト。 | +| `phone` | string array | 条件付きで必須 | マッピングする[正規化済み](../getting-started/gs-normalization-encoding.md#phone-number-normalization)電話番号のリスト。 | +| `phone_hash` | string array | 条件付きで必須 | マッピングする[正規化済み](../getting-started/gs-normalization-encoding.md#phone-number-normalization)電話番号の[Base64エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding)ハッシュのリスト。 | ### Request Examples -The following are unencrypted JSON request body examples to the `POST /identity/map` endpoint: +以下の例は、`POST /identity/map` エンドポイントへの暗号化されていない JSON リクエスト本文の例です: ```json { @@ -100,27 +96,27 @@ The following are unencrypted JSON request body examples to the `POST /identity/ } ``` -Here's an encrypted request example to the `POST /identity/map` endpoint for phone numbers: +以下は、電話番号の `POST /identity/map` エンドポイントへの暗号化されたリクエストの例です: ```sh echo '{"phone": ["+12345678901", "+441234567890"]}' | python3 uid2_request.py https://prod.uidapi.com/v3/identity/map [YOUR_CLIENT_API_KEY] [YOUR_CLIENT_SECRET] ``` -For details, and code examples in different programming languages, see [Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md). +詳細および異なるプログラミング言語でのコード例は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 ## Decrypted JSON Response Format :::note -The response is encrypted only if the HTTP status code is 200. Otherwise, the response is not encrypted. +HTTPステータスコードが 200 の場合、レスポンスは暗号化されます。それ以外の場合、レスポンスは暗号化されません。 ::: -A successful decrypted response returns the current raw UID2s, previous raw UID2s, and refresh timestamps for the specified email addresses, phone numbers, or their respective hashes. +復号化に成功したレスポンスは、指定されたメールアドレス、電話番号、またはそれぞれのハッシュに対する現在の raw UID2、以前の raw UID2、および更新タイムスタンプを返します。 -The response arrays preserve the order of input arrays. Each element in the response array maps directly to the element at the same index in the corresponding request array. This ensures that you can reliably associate results with their corresponding inputs based on array position. +レスポンスの配列は、入力配列の順序を保持します。レスポンス配列の各要素は、対応するリクエスト配列の同じインデックスにある要素に直接マッピングされます。これにより、結果をその対応する入力と信頼性高く関連付けることができます。 -Input values that cannot be mapped to a raw UID2 are mapped to an error object with the reason for unsuccessful mapping. An unsuccessful mapping occurs if the DII is invalid or has been opted out from the UID2 ecosystem. In these cases, the response status is `success` but no raw UID2 is returned. +raw UID2 にマッピングできない入力値は、マッピングできなかった理由を含むエラーオブジェクトにマッピングされます。マッピングに失敗するのは、DII が無効であるか、UID2 エコシステムからオプトアウトされている場合です。このような場合、レスポンスステータスは `success` ですが、raw UID2 は返されません。 -The following example shows the input and corresponding response. +以下の例は、入力と対応するレスポンスを示しています。 Input: @@ -164,45 +160,45 @@ Response: ### Response Body Properties -The response body includes one or more of the properties shown in the following table. +レスポンス本文には、以下の表に示すプロパティのいずれかが含まれます。 -| Body Parameter | Data Type | Description | -|:---------------|:----------------------------|:------------------------------------------------------------------------------------------------| -| `email` | array of mapped DII objects | The list of mapped DII objects corresponding to the list of emails in the request. | -| `email_hash` | array of mapped DII objects | The list of mapped DII objects corresponding to the list of email hashes in the request. | -| `phone` | array of mapped DII objects | The list of mapped DII objects corresponding to the list of phone numbers in the request. | -| `phone_hash` | array of mapped DII objects | The list of mapped DII objects corresponding to the list of phone number hashes in the request. | +| Body Parameter | Data Type | Description | +| :--- | :--- | :--- | +| `email` | マッピングされた DII オブジェクトの配列 | リクエスト内のメールアドレスのリストに対応するマッピングされた DII オブジェクトのリスト。 | +| `email_hash` | マッピングされた DII オブジェクトの配列 | リクエスト内のメールアドレスハッシュのリストに対応するマッピングされた DII オブジェクトのリスト。 | +| `phone` | マッピングされた DII オブジェクトの配列 | リクエスト内の電話番号のリストに対応するマッピングされた DII オブジェクトのリスト。 | +| `phone_hash` | マッピングされた DII オブジェクトの配列 | リクエスト内の電話番号ハッシュのリストに対応するマッピングされた DII オブジェクトのリスト。 | -For successfully mapped DII, the mapped object includes the properties shown in the following table. +DII が正常にマッピングされた場合、マッピングされたオブジェクトには以下の表に示すプロパティが含まれます。 -| Property | Data Type | Description | -|:---------|:-----------|:--------------------------------------------------------------------------------------------------------------------------------------| -| `u` | string | The raw UID2 corresponding to the email or phone number provided in the request. | -| `p` | string | One of the following: | -| `r` | number | The Unix timestamp (in milliseconds) that indicates when the raw UID2 might be refreshed. The raw UID2 is guaranteed to be valid until this timestamp. | +| Property | Data Type | Description | +| :--- | :--- | :--- | +| `u` | string | リクエストで提供されたメールアドレスまたは電話番号に対応する raw UID2。 | +| `p` | string | 以下のいずれか: | +| `r` | number | Unix タイムスタンプ（ミリ秒単位）で、raw UID2 がリフレッシュされる可能性のある時刻を示します。このタイムスタンプまで、raw UID2 は有効であることが保証されています。 | -For unsuccessfully mapped input values, the mapped object includes the properties shown in the following table. +マッピングできなかった入力値に対しては、マッピングされたオブジェクトに以下の表に示すプロパティが含まれます。 -| Property | Data Type | Description | -|:---------|:----------|:-----------------------------------------------------------------------------------------------------------------| -| `e` | string | The reason for being unable to map the DII to a raw UID2. One of two possible values: | +| Property | Data Type | Description| +| :--- | :--- | :--- | +| `e`| string | マッピングできなかった理由。次のいずれかの値: | ### Response Status Codes -The following table lists the `status` property values and their HTTP status code equivalents. +以下の表は、`status` プロパティの値とその HTTP ステータスコードの対応を示しています。 | Status | HTTP Status Code | Description | | :--- | :--- | :--- | -| `success` | 200 | The request was successful. The response will be encrypted. | -| `client_error` | 400 | The request had missing or invalid parameters. | -| `unauthorized` | 401 | The request did not include a bearer token, included an invalid bearer token, or included a bearer token unauthorized to perform the requested operation. | +| `success` | 200 | リクエストは成功しました。レスポンスは暗号化されます。 | +| `client_error` | 400 | リクエストに欠落または無効なパラメーターが含まれていました。 | +| `unauthorized` | 401 | リクエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行する権限のないベアラートークンが含まれていました。 | -If the `status` value is anything other than `success`, the `message` field provides additional information about the issue. +`status` プロパティの値が `success` 以外の場合、`message` フィールドには問題に関する追加情報が提供されます。 ## Migration from v2 Identity Map -The following sections provide general information and guidance for migrating to version 3 from earlier versions, including: +以下のセクションでは、以前のバージョンからバージョン 3 への移行に関する一般的な情報とガイダンスを提供します: - [Version 3 Improvements](#version-3-improvements) - [Key Differences Between v2 and v3](#key-differences-between-v2-and-v3) @@ -215,18 +211,18 @@ The following sections provide general information and guidance for migrating to ### Key Differences Between v2 and v3 -The following table shows key differences between the versions. +以下の表は、バージョン間の主な違いを示しています。 -| Feature | V2 Implementation | V3 Implementation | -|:-------------------------------|:--------------------------------------------|:-------------------------------------------| -| Endpoints Required | `/v2/identity/map` + `/v2/identity/buckets` | `/v3/identity/map` only | -| Identity Types per Request | Single identity type only | Multiple identity types | -| Refresh Management | Monitor salt bucket rotations via `/identity/buckets` endpoint | Re-map when past `refresh_from` timestamps | -| Previous UID2 Access | Not available | Available for 90 days | +| Feature | V2 Implementation | V3 Implementation | +| :--- | :--- | :--- | +| 必要なエンドポイント | `/v2/identity/map` + `/v2/identity/buckets` | `/v3/identity/map` のみ | +| リクエストごとのアイデンティティタイプ | 単一のアイデンティティタイプのみ | 複数のアイデンティティタイプ | +| リフレッシュ管理 | `/identity/buckets` エンドポイントを介してソルトバケットのローテーションをモニター | `refresh_from` タイムスタンプを過ぎたときに再マッピング | +| 前の UID2 アクセス | 利用不可 | 90 日間利用可能 | ### Required Changes -To upgrade from an earlier version to version 3, follow these steps: +以前のバージョンからバージョン 3 へのアップグレードは、以下の手順に従ってください。 1. [Update Endpoint URL](#1-update-endpoint-url) 2. [Update V3 Response Parsing Logic](#2-update-v3-response-parsing-logic) @@ -234,7 +230,7 @@ To upgrade from an earlier version to version 3, follow these steps: #### 1. Update Endpoint URL -Update any reference to the endpoint URL so that it references the /v3/ implementation, as shown in the following example. +エンドポイント URL を更新して、/v3/ 実装を参照するようにしてください。以下の例を参照してください。 ```python # Before (v2) @@ -246,7 +242,7 @@ url = '/v3/identity/map' #### 2. Update v3 Response Parsing Logic -Update the logic for parsing the response, as shown in the following example. +以下の例に従って、レスポンスの解析ロジックを更新してください。 V2 Response Parsing: ```python @@ -277,9 +273,9 @@ for index, item in enumerate(response['body']['email']): #### 3. Replace Salt Bucket Monitoring with Refresh Timestamp Logic -Update your code for salt bucket monitoring, replacing it with code that checks the `refresh_from` timestamp to determine raw UID2s that are due for refresh. +Salt Bucketのモニタリングを更新して、`refresh_from` タイムスタンプをチェックし、raw UID2 の更新が必要なものを判断するコードに置き換えます。 -The following example shows an implementation of the v3 approach for checking refresh timestamps: +以下の例は、リフレッシュタイムスタンプをチェックするための v3 アプローチの実装を示しています: ```python import time @@ -294,11 +290,11 @@ remap_identities(to_remap) ``` ### Additional Resources -- [SDK for Java](../sdks/sdk-ref-java.md) for Java implementations (see Usage for Advertisers/Data Providers section) +- [SDK for Java](../sdks/sdk-ref-java.md) Java 実装 (Advertisers/Data Providers section を参照) -For general information about identity mapping, see [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md). +ID マッピングの一般的な情報は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md index 6afd1a844..d3d96e397 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md @@ -44,7 +44,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters @@ -75,7 +75,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ echo '{"advertising_ids": ["ufv1uGRovNiJNbJqiE/xzM+aKE7jP69MgspOZoEQ3xc="]}' | python3 uid2_request.py https://prod.uidapi.com/v2/optout/status [Your-Client-API-Key] [Your-Client-Secret] ``` -詳細と、さまざまなプログラミング言語でのコード例については、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 +詳細と、さまざまなプログラミング言語でのコード例は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 ## Decrypted JSON Response Format 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 f9de7f507..3bbdda373 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 @@ -21,7 +21,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 -このエンドポイントを直接呼び出すのではなく、UID2 SDK を使って管理することもできます。オプションの概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 +このエンドポイントを直接呼び出すのではなく、UID2 SDK を使って管理することもできます。オプションの概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 ## Request Format diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md index ec7e1d2f4..78ee46626 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md @@ -18,7 +18,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 このエンドポイントは、Client-Side (たとえば、ブラウザやモバイルアプリ) から呼び出すことができます。それは、API key を使用する必要がないためです。 :::note -このエンドポイントを直接呼び出す代わりに、UID2 SDK のいずれかを使用して管理することができます。オプションの概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 +このエンドポイントを直接呼び出す代わりに、UID2 SDK のいずれかを使用して管理することができます。オプションの概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 ::: ## Request Format diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md index 901f7c38a..f31113278 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md @@ -35,7 +35,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md index ed0a6ed96..b86c28f4e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md @@ -22,14 +22,32 @@ import Link from '@docusaurus/Link'; | [POST /token/validate](post-token-validate.md) | Advertising Token (UID2) が指定されたメールアドレス、電話番号、またはそれぞれのハッシュと一致するかどうかを検証するためのテストに使用します。 | 必須 | 必須 | | [POST /token/refresh](post-token-refresh.md) | [POST /token/generate](./post-token-generate.md) レスポンスから、ユーザーの Refresh Token 用に新しいトークンを生成します。 | N/A | 必須 | -## Identity Maps +## Identity Map -以下のエンドポイントは、広告主とサードパーティのデータプロバイダーが使用します。パブリッシャーは、これらのエンドポイントを使用する必要はありません。 +以下のエンドポイントは、広告主とサードパーティのデータプロバイダーが使用します。パブリッシャーはこれらのエンドポイントを使用する必要はありません。 + +### Latest Identity Map Endpoint (v3) + +最新の Identity Map インテグレーションでは、1 つのエンドポイント `POST /identity/map` を呼び出すだけで済みます。`POST /identity/buckets` エンドポイントはワークフローの一部ではありません。 + +:::important +以前のバージョンを使用している場合は、改善点を活用するためにできるだけ早くアップグレードすることを推奨します。 +::: + +最新の Identity Map インテグレーションでは、次のエンドポイントを使用します: + +| Endpoint | Description | Request Encryption | Response Decryption | +| :--- | :--- | :--- | :--- | +| [POST /identity/map](post-identity-map.md) |1 つ以上のメールアドレス、電話番号、またはそのハッシュに対して、raw UID2、以前の raw UID2、および更新タイムスタンプをマップします。 | 必須 | 必須 | + +### Earlier Identity Map Endpoints (v2) + +以下のエンドポイントは、以前の Identity Map インテグレーション (バージョン 2) の一部です。 | Endpoint | Description | Request Encryption | Response Decryption | | :--- | :--- | :--- | :--- | -| [POST /identity/buckets](post-identity-buckets.md) | 最後に更新されたタイムスタンプを使用して、ローテーションされたソルトバケットを監視します。 | 必須 | 必須 | -| [POST /identity/map (v2)](post-identity-map-v2.md) | 1 つ以上のメールアドレス、電話番号、またはそれぞれのハッシュの UID2 とソルトバケット ID を取得します。 | 必須 | 必須 | +| [POST /identity/buckets](post-identity-buckets.md) | ローテーションしたソルトバケットの最終更新タイムスタンプをモニターします。 | 必須 | 必須 | +| [POST /identity/map (v2)](post-identity-map-v2.md) | 1 つ以上のメールアドレス、電話番号、またはそれぞれのハッシュに対して、raw UID2 と salt bucket ID をマッピングします。 | 必須 | 必須 | ## Opt-Out Status diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md index caf121d4d..e581b86df 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md @@ -14,7 +14,7 @@ UID2 エンドポイントの認証には、以下が必要です: - クライアントの [API Key](gs-credentials.md#api-key-and-client-secret)。API Key はベアラートークンとしてリクエストのAuthorizationヘッダに含めます。たとえば:
`Authorization: Bearer YourTokenBV3tua4BXNw+HVUFpxLlGy8nWN6mtgMlIk=` -- API リクエストを暗号化し、API レスポンスを復号化するためのクライアントシークレット。これは、[POST /token/refresh](../endpoints/post-token-refresh.md) を除くすべてのエンドポイントで必要です。
詳細と、いくつかのプログラミング言語での暗号化/復号化の例については、[Encrypting Requests and Decrypting Responses](gs-encryption-decryption.md) を参照してください。 +- API リクエストを暗号化し、API レスポンスを復号化するためのクライアントシークレット。これは、[POST /token/refresh](../endpoints/post-token-refresh.md) を除くすべてのエンドポイントで必要です。
詳細と、いくつかのプログラミング言語での暗号化/復号化の例は、[Encrypting Requests and Decrypting Responses](gs-encryption-decryption.md) を参照してください。 :::note パブリッシャーで Client-Side に UID2 を実装している場合、認証と許可は Prebid.js ([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照) や JavaScript SDK([Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照)などの実装によって自動的に管理されます。 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 f0d105248..b91f3a4da 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 @@ -22,7 +22,7 @@ UID2 の 環境 と本番環境の両方を使用している場合、それぞれの環境用に別々の認証情報が提供されます。詳細は [Getting Your Credentials](#getting-your-credentials) を参照してください。 -さらに、いくつかのケースでは、異なるシナリオに対して異なるセットの認証情報を持つことを勧めますが、必須ではありません。たとえば: +さらに、いくつかのケースでは、異なるシナリオに対して異なるセットの認証情報を持つことを推奨しますが、必須ではありません。たとえば: - UID2 Token を生成する Publisher である場合([POST /token/generate](../endpoints/post-token-generate.md) または他の方法で)、または自分のために UID2 を生成/マッピングする場合([POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) を参照)、それぞれの活動に対して異なる認証情報を持つことがあります。 - 広告主の場合、広告主キーを使用して複数のサービスプロバイダが運用するシナリオで、各サービスプロバイダに対して異なる認証情報割り当てることができます。 @@ -105,7 +105,7 @@ Client-Side または Server-Side の実装を使用している場合([UID2 Cli - 各キーには、それを使用できるエンドポイントを決定する [Permissions](gs-permissions.md) のセットがあります。 - 各キーには対応するクライアントシークレットがあります。 - ほとんどの API エンドポイントは、認証のために API Key とクライアントシークレットの両方を必要とします。詳細は [Authentication and Authorizatio](gs-auth.md) を参照してください。 -- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 - クライアントシークレットは特定の [Environment](gs-environments.md) で有効です。インテグレーション環境と本番環境の両方を使っている場合、それぞれの環境用のクライアントシークレットを取得します。 UID2 アカウントのセットアップの一環として、1つ以上の API Key が発行され、それぞれに対応するクライアントシークレットが割り当てられます。相談相手の詳細は [Contact Info](gs-account-setup.md#contact-info) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md index 7069cb8bd..dedc498e6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md @@ -31,14 +31,14 @@ import Link from '@docusaurus/Link'; Notes: - すべての UID2 エンドポイントは同じベース URL を使用します。 -- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境用の認証情報の取得方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境用の認証情報の取得方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 - [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントまたは [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントで返される UID2 Token の有効期限は変更される可能性がありますが、常にインテグレーション環境では本番環境よりもはるかに短くなります。 ## Getting Credentials for Each Environment インテグレーション環境と本番環境の両方を使用している場合は、それぞれの環境用に別々の認証情報が必要です。 -各環境にアクセスするために必要な値を取得する方法については、[Getting Your Credentials](gs-credentials.md#getting-your-credentials) を参照してください。 +各環境にアクセスするために必要な値を取得する方法は、[Getting Your Credentials](gs-credentials.md#getting-your-credentials) を参照してください。 ## Specifying the Base URL to Reduce Latency @@ -51,5 +51,5 @@ Notes: UID2 サーバーに最も近い場所にリクエストを自動的に送信する AWS グローバルアクセラレータを活用することも検討してください。このオプションは、一部のリージョンのサーバーが一時的にダウンしている場合にも高い可用性を確保するためにも優れています。 :::note -デフォルトでは、一部の実装オプションは UID2 本番環境サーバーに米国のサーバーを使用して API コールを行います。デフォルト値を確認し、設定の更新方法については、インテグレーションのドキュメントを参照してください。 +デフォルトでは、一部の実装オプションは UID2 本番環境サーバーに米国のサーバーを使用して API コールを行います。デフォルト値を確認し、設定の更新方法は、インテグレーションのドキュメントを参照してください。 ::: 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 5e8b680d3..3099c68a5 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 @@ -32,7 +32,7 @@ UID2 フレームワークに関するよくある質問を紹介します。 - [パブリックオペレーターとプライベートオペレーターのどちらを使用すべきですか？](#should-i-use-a-public-operator-or-a-private-operator) :::note -モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 +モバイルパブリッシャーインテグレーションに関する FAQs は、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 ::: #### Will all integration partners in the EUID infrastructure (SSPs, third-party data providers, measurement providers) be automatically integrated with UID2? @@ -62,7 +62,7 @@ UID2 は HIPAA で規制されているデータの処理を許可しますか ほとんどの参加者にとって、Public Operator が最もシンプルなソリューションです。Public Operator のインテグレーションは、独自の Private Operator をホストするよりも簡単なオプションです。Private Operator インスタンスを持つことにはいくつかの利点がありますが、追加の複雑さとコストがかかります。 -最適な選択肢は、自身の状況やニーズによって異なります。決定に役立つ情報については、以下を参照してください: +最適な選択肢は、自身の状況やニーズによって異なります。決定に役立つ情報は、以下を参照してください: 1. [The UID2 Operator](../ref-info/ref-operators-public-private.md) @@ -180,39 +180,40 @@ UID2 をシングルサインオン (SSO) とインテグレーションする UID2 フレームワークを使用する広告主やデータプロバイダーによくある質問を紹介します。 -- [ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには？](#how-do-i-know-when-to-refresh-the-uid2-due-to-salt-bucket-rotation) -- [更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？](#do-refreshed-emails-get-assigned-to-the-same-bucket-with-which-they-were-previously-associated) +- [raw UID2 を更新するタイミングはどのように判断すればよいですか？](#how-do-i-know-when-to-refresh-a-raw-uid2) - [インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか？](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates) - [マッピング用の DII の SHA-256 はどのように生成すればよいですか？](#how-should-i-generate-the-sha-256-of-dii-for-mapping) - [メールアドレス、電話番号、または対応するハッシュと raw UID2 のマッピングを、自身のデータセットに保存すべきでしょうか？](#should-i-store-mapping-of-email-addresses-phone-numbers-or-corresponding-hashes-to-raw-uid2s-in-my-own-datasets) - [ユーザーのオプトアウトはどのように処理すればよいですか？](#how-should-i-handle-user-opt-outs) - [同じ DII は常に同じ生UID2になりますか？](#does-the-same-dii-always-result-in-the-same-raw-uid2) +- [If two operators process the same DII, are the results the same?](#if-two-operators-process-the-same-dii-are-the-results-the-same) - [2 つの Operator が同じ DII を処理した場合、結果は同じになりますか？](#if-two-operators-process-the-same-dii-are-the-results-the-same) +- [更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？](#do-refreshed-emails-get-assigned-to-the-same-bucket-that-they-were-previously-associated-with) -#### How do I know when to refresh the UID2 due to salt bucket rotation? -ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには？ - -UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用される salt bucket が含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎となる DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。 +#### How do I know when to refresh a raw UID2? +raw UID2 を更新するタイミングはどのように判断すればよいですか？ -:::note -ローテーションがいつ行われるかについては、いかなる約束もいたしません。可能な限り最新の状態を保つため、1 時間に 1 回のチェックを勧めます。 -::: +[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントは、レスポンス内のリフレッシュタイムスタンプ（`r`フィールド）を提供します。このタイムスタンプ以降に、各 raw UID2 がリフレッシュされる可能性があります。このタイムスタンプを使用して、保存されたデータの raw UID2 を再生成するタイミングを判断します。 -#### Do refreshed emails get assigned to the same bucket with which they were previously associated? -更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？ +raw UID2 を更新するかどうかを決定するには： -必ずしもそうとは限りません。特定のバケット ID に関連付けられたメールアドレスを再マッピングした後、そのメールが異なるバケット ID に割り当てられる可能性があります。バケット ID を確認するには、[マッピング関数を呼び出す](../guides/integration-advertiser-dataprovider-overview.md#1-generate-raw-uid2s-from-dii) そして返された raw UID2 とバケット ID を再び保存してください。 +1. [POST /identity/map](../endpoints/post-identity-map.md) のレスポンスから保存したリフレッシュタイムスタンプと現在の時刻を比較します。 +2. 現在の時刻がリフレッシュタイムスタンプ以降であれば、同じ DII を使用して再度アイデンティティマップエンドポイントを呼び出すことで、raw UID2 を再生成します。 -:::info -メールアドレスのマッピングや再マッピングを行う際には、バケットの数やローテーションする日、メールアドレスが割り当てられる特定のバケットについて、いかなる仮定も行わないようにしてください。 +:::note +リフレッシュの機会を毎日チェックすることをお勧めします。raw UID2 は、指定されたタイムスタンプの前にリフレッシュされることは保証されていません。その時点以降のいつかで、raw UID2 がリフレッシュされます。 ::: #### How often should raw UID2s be refreshed for incremental updates? インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか？ -オーディエンスの更新は、毎日行うことが推奨されています。 +The recommended cadence for updating audiences is daily. + +A raw UID2 for a specific user changes roughly once per year. The latest version of the [POST /identity/map](../endpoints/post-identity-map.md) endpoint provides refresh timestamps that indicate a point after which each raw UID2 might refresh. We recommend checking these timestamps daily to ensure your raw UID2s remain current and valid for audience targeting. -ソルトバケットは 1 年に 1 回程度更新されますが、個々のバケットの更新は 1 年に分散して行われます。これは、全バケットの約 1/365 が毎日ローテーションされることを意味します。もし忠実さが重要であれば、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントをもっと頻繁に、たとえば 1 時間ごとに呼び出すことを検討してください。 +For implementations that reference earlier versions of this endpoint (see [POST /identity/map v2](../endpoints/post-identity-map-v2.md)): + +Even though each salt bucket is updated roughly once a year, individual bucket updates are spread over the year. This means that about 1/365th of all buckets are rotated daily. If fidelity is critical, consider calling the [POST /identity/buckets](../endpoints/post-identity-buckets.md) endpoint more frequently; for example, hourly. #### How should I generate the SHA-256 of DII for mapping? マッピング用の DII の SHA-256 はどのように生成すればよいですか？ @@ -231,7 +232,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 #### How should I handle user opt-outs? ユーザーのオプトアウトはどのように処理すればよいですか？ -ユーザーが [Transparency and Control Portal](https://www.transparentadvertising.com/) を通じて UID2 ベースのターゲティング広告をオプトアウトすると、オプトアウト信号が DSP とパブリッシャーに送信され、DSP とパブリッシャーが入札時にオプトアウトを処理します。広告主やデータプロバイダーは、[POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントを通じて、ユーザーがオプトアウトしたかどうかを定期的に確認することを勧めます。 +ユーザーが [Transparency and Control Portal](https://www.transparentadvertising.com/) を通じて UID2 ベースのターゲティング広告をオプトアウトすると、オプトアウト信号が DSP とパブリッシャーに送信され、DSP とパブリッシャーが入札時にオプトアウトを処理します。広告主やデータプロバイダーは、[POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントを通じて、ユーザーがオプトアウトしたかどうかを定期的に確認することを推奨します。 広告主やデータプロバイダーは、raw UID2 に対するオプトアウトステータスを確認するために、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用することもできます。 @@ -244,7 +245,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 ただし、raw UID2 の生成に使用される秘密の [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細は [How often should raw UID2s be refreshed for incremental updates?](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates)) を参照)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。 -詳細は、*Advertiser/Data Provider Integration Guide*の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。 +詳細は、*Advertiser/Data Provider Integration Guide*の [Monitor for Raw UID2 Refresh](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-raw-uid2-refresh) を参照してください。 #### If two operators process the same DII, are the results the same? 2 つの Operator が同じ DII を処理した場合、結果は同じになりますか？ @@ -255,9 +256,26 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 タイミングが重要なのは、ソルトバケットのローテーションのためです。リクエスト間でソルト値が変化すると、結果は異なる raw UID2 になります。 - しかし、パブリッシャーが [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイント経由、または SDK 経由で UID2 Token のリクエストに DII を送信した場合、生成される UID2 Token には同じ暗号化された raw UID が含まれます。ただし、トークン自体は常に一意です。 +#### How do I know when to refresh the UID2 due to salt bucket rotation? +ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには？ + +UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用される salt bucket が含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎となる DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。 + +:::note +ローテーションがいつ行われるかは、いかなる約束もいたしません。可能な限り最新の状態を保つため、1 時間に 1 回のチェックを推奨します。 +::: + +#### Do refreshed emails get assigned to the same bucket that they were previously associated with? +更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？ + +必ずしもそうとは限りません。特定のバケット ID に関連付けられたメールアドレスを再マッピングした後、そのメールが異なるバケット ID に割り当てられる可能性があります。バケット ID を確認するには、[マッピング関数を呼び出す](../guides/integration-advertiser-dataprovider-overview.md#1-generate-raw-uid2s-from-dii) そして返された raw UID2 とバケット ID を再び保存してください。 + +:::info +メールアドレスのマッピングや再マッピングを行う際には、バケットの数やローテーションする日、メールアドレスが割り当てられる特定のバケットについて、いかなる仮定も行わないようにしてください。 +::: + ## FAQs for DSPs demand-side platform (DSP) に関するよくある質問を紹介します。 @@ -265,13 +283,12 @@ demand-side platform (DSP) に関するよくある質問を紹介します。 - [UID2 に適用する復号キーを知るには？](#how-do-i-know-which-decryption-key-to-apply-to-a-uid2) - [復号キーはどこで入手できますか？](#where-do-i-get-the-decryption-keys) - [メモリ上に存在する復号鍵の数は？](#how-many-decryption-keys-may-be-present-in-memory-at-any-point) -- [ソルトバケットがローテーションしたかどうか、あるいはいつローテーションしたかを知るにはどうしたらいいですか？](#how-do-i-know-ifwhen-the-salt-bucket-has-rotated) +- [マップされた raw UID2 を更新するタイミングを知るには？](#how-do-i-know-when-to-refresh-mapped-raw-uid2s) - [DSP はレイテンシーを気にすべきでしょうか？](#should-the-dsp-be-concerned-with-latency) - [UID2 で DSP はどのように適切なフリクエンシーキャッピング周波数キャッピングを維持すべきでしょうか？](#how-should-the-dsp-maintain-proper-frequency-capping-with-uid2) - [ユーザーのオプトアウトトラフィックはすべて DSP に送られますか？](#will-all-user-opt-out-traffic-be-sent-to-the-dsp) - [DSP は、すでに保存している UID2 についてのみオプトアウトシグナルを処理することを期待されているのか？](#is-the-dsp-expected-to-handle-opt-out-signals-only-for-the-uid2s-that-they-already-store) - [DSP はオプトアウトリストをどれくらいの期間保管すべきですか？](#how-long-should-the-dsp-keep-the-opt-out-list) -- [オプトアウトされたユーザーの UID2 は、暗号化された形式でオプトアウトエンドポイントに送信されますか？](#is-the-uid2-of-an-opted-out-user-sent-to-the-opt-out-endpoint-in-an-encrypted-form) - [オプトアウトされたユーザーの UID2 は、どのような形式で Webhook に送信されますか？](#in-what-format-is-the-uid2-of-an-opted-out-user-sent-to-the-webhook) - [オプトアウトはどのリクエストタイプを使いますか？](#what-request-type-do-opt-outs-use) - [オプトアウトに応じるための条件はどの程度厳しいのですか？](#how-strict-are-the-requirements-for-honoring-opt-outs) @@ -293,10 +310,15 @@ Server-Side SDK のいずれか([SDK](../sdks/summary-sdks.md) を参照) を使 システムには、ある時点で何千もの復号鍵が存在する可能性があります。 -#### How do I know if/when the salt bucket has rotated? -ソルトバケットがローテーションしたかどうか、あるいはいつローテーションしたかを知るにはどうしたらいいですか？ +#### How do I know when to refresh mapped raw UID2s? +マップされた raw UID2 を更新するタイミングを知るには？ + +[Advertisers and Data Providers section](#how-do-i-know-when-to-refresh-a-raw-uid2) を参照して下さい。 + +#### How do I know if/when the raw UID2 has rotated? +raw UID2 がローテーションしたか、またローテーション時期を確認するには？ -DSP は、UID2 ソルトバケットがいつローテーションしたかを知ることができません。これは、ユーザーが Cookie をクリアしても DSP が気づかないのと同じです。ソルトバケットのローテーションは、DSP に大きな影響を与えません。 +DSP は、raw UID2 がローテーションしたかどうかを知ることはできません。これは、ユーザーがクッキーをクリアした場合に DSP がそのことを知らないのと同様です。raw UID2 のローテーションは、DSP にとって大きな影響はありません。 #### Should the DSP be concerned with latency? DSP はレイテンシーを気にすべきでしょうか？ @@ -321,7 +343,7 @@ DSP は、すでに保存している UID2 についてのみオプトアウト #### How long should the DSP keep the opt-out list? DSP はオプトアウトリストをどれくらいの期間保管すべきですか？ -オプトアウト情報は無期限に保管することを勧めます。 +オプトアウト情報は無期限に保管することを推奨します。 #### Is the UID2 of an opted-out user sent to the opt-out endpoint in an encrypted form? オプトアウトされたユーザーの UID2 は、暗号化された形式でオプトアウトエンドポイントに送信されますか？ 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 005e95e63..e445dbccd 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 @@ -1,6 +1,6 @@ --- title: Normalization and Encoding -description: 情報を安全かつ解読できるように正規化し、符号化する方法。 +description: 情報を正規化およびエンコードして、安全にデコードできるようにする方法。 hide_table_of_contents: false sidebar_position: 13 displayed_sidebar: docs @@ -10,142 +10,144 @@ import Link from '@docusaurus/Link'; # Normalization and Encoding -このページでは、ユーザー情報の正規化とエンコードに関する情報を提供します。UID2 を使用する際には、正規化とエンコードを正しく行うことが重要です。 +このページでは、DII の正規化とエンコードに関する情報を提供します。UID2 を使用する際には、正規化とエンコードが正しく行われることが重要です。 ## Introduction -メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。メールアドレスを正規化するか否か、メールアドレスや電話番号をハッシュ化するか否かに関わらず、手順を正確に実行してください。そうすることで、作成した UID2 値を、同じユーザーによる他のオンライン行動と安全かつ匿名で照合できるようになります。 +メールアドレスなどのユーザー情報を取得し、UID2 の raw UID2 や Advertising Token を作成するには、必要なすべての手順に従うことが非常に重要です。メールアドレスを正規化するかどうか、メールアドレスや電話番号をハッシュ化するかどうかに関係なく、手順を正確に実行してください。そうすることで、作成した UID2 値が同じユーザーによる他のオンライン行動のインスタンスと安全かつ匿名で照合できることを保証できます。 :::important -- Raw UID2 とそれに関連する UID2 Token は、大文字と小文字を区別します。UID2 を扱う際には、大文字小文字を変えずにすべての ID とトークンを渡すことが重要です。ID が不一致の場合、ID の解析やトークンの復号化でエラーが発生する可能性があります。 -- 必要なステップのどれかを欠いた場合—たとえば、最初に正規化せずにハッシュした場合—その結果は有効な UID2 値にはなりません。
たとえば、データプロバイダが `Jane.Saoirse@gmail.com` から UID2 を生成したいとします。これは `janesaoirse@gmail.com` に正規化され、ハッシュ化されて Base64 エンコードされた値は `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` となります。
同じメールアドレスを持つパブリッシャーは誤って正規化しませんでした。メールアドレス `Jane.Saoirse@gmail.com` をハッシュ化し Base64 エンコードした値は `f8upG1hJazYKK8aEtAMq3j7loeAf5aA4lSq6qYOBR/w=` です。これら2つの異なる値は、2つの異なる UID2 になります。最初のものは正しく処理され、同じ元データから生成された他のインスタンスと一致すします。2つ目は正しく処理されていないため、一致しません。
このシナリオでは、UID2 が同じユーザーの他のインスタンスと一致しないため、パブリッシャーはターゲティング広告から利益を得る機会を逃してしまいます。 +- Raw UID2 と関連する UID2 Token は、ケースセンシティブです。UID2 を使用する場合は、すべての ID とトークンをケースを変更せずに渡すことが重要です。ID が一致しないと、ID の解析やトークンの復号化エラーが発生する可能性があります。 +- 必須のステップを一つでも省略した場合（例えば、正規化せずにハッシュ化した場合）、入力データに対して正しい UID2 値は生成されません。
たとえば、データ提供者が `JANESaoirse@gmail.com` というメールアドレスからUID2を生成したいとします。このメールアドレスは、正規化されると `janesaoirse@gmail.com` となり、ハッシュ化されてBase64でエンコードされた値は `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` となります。
一方で、同じメールアドレスを持つパブリッシャーが、誤って正規化をせずに処理したとします。正規化されていないメールアドレス`JANESaoirse@gmail.com` をそのままハッシュ化してBase64でエンコードすると、`VpLXEp5N1bj/V1WzjgZsC+FfuYdntAOywSVIO00FD/E=` という値になります。この 2 つの異なる値からは、それぞれ異なる UID2 が生成されてしまいます。正しく処理された最初のUID2は、同じ元のデータから生成された他の UID2 と一致しますが、誤って処理された2番目の UID2 は一致しません。
この場合、UID2 が同じユーザーの他のインスタンスと一致しないため、パブリッシャーはターゲティング広告の恩恵を受ける機会を逃してしまいます。 ::: ## Types of Directly Identifying Information -UID2は、以下の種類の DII (direct identifying information) をサポートしています: +UID2 は、次の種類の直接識別情報 (DII) をサポートしています。 - メールアドレス - 電話番号 ## Email Address Normalization -UID2 Operator Service にハッシュ化されていないメールアドレスを送信すると、同サービスはメールアドレスを正規化してからハッシュ化します。メールアドレスを送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に正規化する必要があります。 +UID2 Operator Service にメールアドレスをハッシュ化せずに送信すると、サービスはメールアドレスを正規化してからハッシュ化します。メールアドレスを送信する前に自分でハッシュ化したい場合は、ハッシュ化する前にメールアドレスを正規化する必要があります。 :::important -ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。 +ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになるため、データを照合できるようになります。ハッシュ化の前に正規化しないと、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。 ::: メールアドレスを正規化するには、次の手順を実行します: -1. 先頭と末尾のスペースを削除します。 -2. 大文字があれば小文字に変換します。 -3. `gmail.com` アドレスのみ: - 1. アドレスの中にピリオド(`.`)(ASCII 10 進コード 46 / UTF-8 16 進コード 2E) があれば、それを削除します。 +1. メールアドレスの先頭と末尾のスペースを削除します。 +2. メールアドレスに大文字が含まれている場合は、小文字に変換します。 +3. `gmail.com` アドレスの場合のみ: + 1. ピリオド (`.`)（ASCII decimal code 46/UTF-8 hexadecimal code 2E）がアドレスに含まれている場合、それを削除します。 + + たとえば、`jane.doe@gmail.com` を `janedoe@gmail.com` に正規化します。 - たとえば、`jane.doe@gmail.com` を `janedoe@gmail.com` に正規化します。 + 2. `@gmail.com` の前にプラス記号 (`+`) とその後の文字列がある場合、プラス記号 (`+`)（ASCII decimal code 43/UTF-8 hexadecimal code 2B）とその後のすべての文字を削除します。 - 2. プラス記号(`+`)とその後ろに追加文字列がある場合、`@gmail.com` の前にあるプラス記号 (`+`)(ASCII 10 進コード 43 / UTF-8 16 進コード 2B)とそれに続くすべての文字を削除します。 - - たとえば、`janedoe+home@gmail.com` を `janedoe@gmail.com` に正規化します。 + たとえば、`janedoe+home@gmail.com` を `janedoe@gmail.com` に正規化します。 :::warning -正規化されたメールアドレスが UTF-16 のような他のエンコーディングシステムではなく、UTF-8 であることを確認してください。 +正規化されたメールアドレスが UTF-8 であることを確認してください。他のエンコーディングシステム（例: UTF-16）ではありません。 ::: -さまざまなシナリオの例は、[Normalization Examples for Email](#normalization-examples-for-email) を参照してください。 +様々なシナリオの例は、[Normalization Examples for Email](#normalization-examples-for-email) を参照してください。 ## Email Address Hash Encoding -メールアドレスハッシュは、正規化されたメールアドレスの SHA-256 ハッシュを Base64 エンコードしたものです。メールアドレスはまず正規化され、次に SHA-256 ハッシュアルゴリズムを使ってハッシュ化され、その結果のハッシュ値のバイトが Base64 エンコーディングを使ってエンコードされます。Base64 エンコーディングはハッシュ値のバイトに適用されるのであって、16 進エンコーディングされた文字列表現には適用されないことに注意してください。 +メールアドレスのハッシュは、正規化されたメールアドレスの Base64 エンコードされた SHA-256 ハッシュです。メールアドレスは最初に正規化され、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化され、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16進数でエンコードされた文字列表現ではないことに注意してください。 | Type | Example | Comments and Usage | | :--- | :--- | :--- | -| 正規化メールアドレス | `user@example.com` | 正規化は常に最初のステップです。 | -| 正規化されたメールアドレスのSHA-256ハッシュ | `b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514` | この 64 文字の文字列は、32 バイトの SHA-256 を 16 進符号化したものです。 | -| SHA-256 ハッシュの 16 進数から Base64 へのエンコード | `tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=` | この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。
WARNING: 上の例の SHA-256 ハッシュ文字列は、ハッシュ値を 16 進符号化したものです。ハッシュの Raw バイトを Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用する必要があります。
リクエストボディに送られる `email_hash` 値にはこのエンコーディングを使用します。 | +| 元のメールアドレス | `USER@example.com` | N/A | +| 正規化されたメールアドレス | `user@example.com` | 正規化は常に最初のステップです。 | +| 正規化されたメールアドレスの SHA-256 ハッシュ| `b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514` | これは、32 バイトの SHA-256 の16進数エンコードされた表現です。 | +| SHA-256 ハッシュの16進数から Base64 へのエンコード | `tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=` | この 44 文字の文字列は、32 バイトの SHA-256 の Base64 エンコードされた表現です。
SHA-256 ハッシュの文字列は、ハッシュ値の 16 進数エンコードされた表現であることに注意してください。ハッシュの生のバイトを Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用する必要があります。
このエンコードをリクエストボディで送信される `email_hash` 値に使用します。 | :::important -Base64 エンコードを適用する場合、ハッシュの Raw バイトを必ず Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用してください。 +Base64 エンコーディングを適用する際は、ハッシュの生のバイトを Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用してください。 ::: その他の例は、[Normalization Examples for Email](#normalization-examples-for-email) を参照してください。 +## Normalization Examples for Email + +以下の表は、元のメールアドレスと正規化された値およびハッシュ値の例を示しています。 + +いくつかの例では、プラス記号（+）を含むメールアドレスと異なるドメインが示されています。`gmail` アドレスの場合、プラス記号とその後の文字は、`@` 記号まで無視されます。他のドメインでは、これらの文字は正規化された値に含まれます。 + +| Original Value | Normalized | Hashed and Base64-Encoded | +| :--- | :--- | :--- | +| `MyEmail@example.com`
`MYEMAIL@example.com` | `myemail@example.com` | Hashed: `16c18d336f0b250f0e2d907452ceb9658a74ecdae8bc94864c23122a72cc27a5`
Base64-Encoded: `FsGNM28LJQ8OLZB0Us65ZYp07NrovJSGTCMSKnLMJ6U=` | +| `My.Email@example.com` | `my.email@example.com` | Hashed: `e22b53bc6f871274f3a62ab37a3caed7214fc14d676215a96a242fcfada1c81f`
Base64-Encoded: `4itTvG+HEnTzpiqzejyu1yFPwU1nYhWpaiQvz62hyB8=` | +| `JANESAOIRSE@example.com`
`JaneSaoirse@example.com` | `janesaoirse@example.com` | Hashed: `d6670e7a92007f1b5ff785f1fc81e53aa6d3d7bd06bdf5c473cdc7286c284b6d`
Base64-Encoded: `1mcOepIAfxtf94Xx/IHlOqbT170GvfXEc83HKGwoS20=` | +| `jane.saoirse@example.com`
`Jane.Saoirse@example.com` | `jane.saoirse@example.com` | Hashed: ` b196432c7b989a2ca91c83799957c515da53e6c13abf20b78fea94f117e90bf8`
Base64-Encoded: `sZZDLHuYmiypHIN5mVfFFdpT5sE6vyC3j+qU8RfpC/g=` | +| `JaneSaoirse+Work@example.com` | `janesaoirse+work@example.com` | Hashed: `28aaee4815230cd3b4ebd88c515226550666e91ac019929e3adac3f66c288180`
Base64-Encoded: `KKruSBUjDNO069iMUVImVQZm6RrAGZKeOtrD9mwogYA=` | +| `JANE.SAOIRSE@gmail.com`
`Jane.Saoirse@gmail.com`
`JaneSaoirse+Work@gmail.com` | `janesaoirse@gmail.com` | Hashed: `92ee26057ed9dea2535d6c8b141d48373932476599196e00352254896db5888f`
Base64-Encoded: `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` | + ## Phone Number Normalization :::important -UID2 Operator Service にリクエストを送信する前に、電話番号を正規化する **必要** があります。ハッシュ化とエンコードを適用するかどうかに関わらず、電話番号を正規化する必要があります。 +UID2 Operator Service　へのリクエストで電話番号を送信する前に、**必ず**電話番号を正規化してください。ハッシュ化とエンコードを適用するかどうかに関係なく、正規化が必要です。 ::: -ここでは、電話番号の正規化ルールについて説明します: +ここでは、電話番号の正規化ルールについて知っておくべきことを説明します: -- UID2 Operator は、[E.164](https://ja.wikipedia.org/wiki/E.164) 形式の電話番号を受け付けます。これは、国際的に一意性を保証する国際電話番号の形式です。 -- E.164 電話番号は、最大 15 桁までです。 -- 正規化された E.164 電話番号は、スペース、ハイフン、括弧、その他の特殊文字を使用せず、以下の構文を使用します:
- `[+] [country code] [subscriber number including area code]` - Examples: +- UID2 Operator は、国際的な電話番号形式である [E.164](https://en.wikipedia.org/wiki/E.164) 形式の電話番号を受け入れます。これにより、グローバルな一意性が確保されます。 +- E.164 電話番号は、最大 15 桁の数字を含むことができます。 +- 正規化された E.164 電話番号は、スペース、ハイフン、括弧、その他の特殊文字を含まない次の構文を使用します:
+ `[+] [国コード] [加入者番号（市外局番を含む）]` + 例: - US: `1 (234) 567-8901` は `+12345678901` に正規化されます。 - Singapore: `65 1243 5678` は `+6512345678` に正規化されます。 - - Sydney, Australia: `(02) 1234 5678` は、都市名の先頭のゼロを削除し、国コードを含むように正規化されます: `+61212345678`。 + - Sydney, Australia: `(02) 1234 5678` は、先頭のゼロを削除し、国コードを含めるように正規化されます: `+61212345678`。 :::warning -正規化されたメールアドレスが UTF-16 のような他のエンコーディングシステムではなく、UTF-8 であることを確認してください。 +正規化された電話番号が UTF-8 であることを確認してください。他のエンコーディングシステム（例: UTF-16）ではありません。 ::: ## Phone Number Hash Encoding -電話番号ハッシュは、正規化された電話番号の SHA-256 ハッシュを Base64 エンコードしたものです。電話番号はまず正規化され、次にSHA-256ハッシュアルゴリズムを使ってハッシュ化され、その結果のハッシュ値のバイトが Base64 エンコーディングを使ってエンコードされます。Base64 エンコーディングはハッシュ値のバイトに適用されるのであって、16 進エンコーディングされた文字列表現には適用されないことに注意してください。 +電話番号のハッシュは、正規化された電話番号の Base64 エンコードされた SHA-256 ハッシュです。電話番号は最初に正規化し、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化し、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16 進数でエンコードされた文字列表現ではないことに注意してください。 -次の表は、単純な入力電話番号の例と、安全で不透明な URL-safe な値を得るために各ステップが適用された結果を示しています。 +以下の表は、単純な入力電話番号の例と、各ステップを適用して安全で不透明な URL-safe な値にする結果を示しています。 | Type | Example | Comments and Usage | | :--- | :--- | :--- | -| 正規化電話番号 | `+12345678901` | 正規化は常に最初のステップです。 | -| 正規化された電話番号の SHA-256 ハッシュ | `10e6f0b47054a83359477dcb35231db6de5c69fb1816e1a6b98e192de9e5b9ee` | この64文字の文字列は、32 バイトの SHA-256 を 16 進符号化したものです。 | -| SHA-256 ハッシュの 16 進数から Base64 へのエンコード | `EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4=` | この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。
NOTE: SHA-256 ハッシュは 16 進数値です。16 進値を入力とする Base64 エンコーダを使う必要があります。リクエストボディに送られる `phone_hash` の値にはこのエンコーディングを使います。| +| 元の電話番号 | `1 (234) 567-8901` | N/A | +| 正規化された電話番号 | `+12345678901` | 正規化は常に最初のステップです。 | +| 正規化された電話番号の SHA-256 ハッシュ | `10e6f0b47054a83359477dcb35231db6de5c69fb1816e1a6b98e192de9e5b9ee` |この 64 文字の文字列は、32 バイト SHA-256 の 16 進数エンコードされた表現です。 | +| SHA-256 ハッシュの 16 進数から Base64 へのエンコーディング | `EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4=` | この 44 文字の文字列は、32 バイト SHA-256 の Base64 エンコードされた表現です。
注: SHA-256 ハッシュは 16 進数の値です。16 進数の値を入力として受け取る Base64 エンコーダーを使用する必要があります。このエンコーディングは、リクエストボディに送信される `phone_hash` 値に使用します。 | :::warning -Base64 エンコーディングを適用する場合は、必ず 16 進数値を入力として受け取る関数を使用してください。テキストを入力として受け取る関数を使った場合、結果は UID2 の目的には無効な長い文字列となります。 +Base64 エンコーディングを適用する際は、ハッシュの生のバイトを Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用してください。 ::: -## Normalization Examples for Email - -次の表は、元のメールアドレスと正規化された値、ハッシュ化された値の例を示しています。 - -いくつかの例では、プラス記号 (+) を含み、ドメインが異なるメールアドレスを示しています。`gmail` アドレスの場合、プラス記号とそれに続く文字 (`@`記号まで) は正規化では無視されます。その他のドメインの場合、これらの文字は正規化された値に含まれます。 - -| Original Value | Normalized | Hashed and Base64-Encoded | -| :--- | :--- | :--- | -| `MyEmail@example.com`
`MYEMAIL@example.com` | `myemail@example.com` | Hashed: `16c18d336f0b250f0e2d907452ceb9658a74ecdae8bc94864c23122a72cc27a5`
Base64-Encoded: `FsGNM28LJQ8OLZB0Us65ZYp07NrovJSGTCMSKnLMJ6U=` | -| `My.Email@example.com` | `my.email@example.com` | Hashed: `e22b53bc6f871274f3a62ab37a3caed7214fc14d676215a96a242fcfada1c81f`
Base64-Encoded: `4itTvG+HEnTzpiqzejyu1yFPwU1nYhWpaiQvz62hyB8=` | -| `JANESAOIRSE@example.com`
`JaneSaoirse@example.com` | `janesaoirse@example.com` | Hashed: `d6670e7a92007f1b5ff785f1fc81e53aa6d3d7bd06bdf5c473cdc7286c284b6d`
Base64-Encoded: `1mcOepIAfxtf94Xx/IHlOqbT170GvfXEc83HKGwoS20=` | -| `jane.saoirse@example.com`
`Jane.Saoirse@example.com` | `jane.saoirse@example.com` | Hashed: ` b196432c7b989a2ca91c83799957c515da53e6c13abf20b78fea94f117e90bf8`
Base64-Encoded: `sZZDLHuYmiypHIN5mVfFFdpT5sE6vyC3j+qU8RfpC/g=` | -| `JaneSaoirse+Work@example.com` | `janesaoirse+work@example.com` | Hashed: `28aaee4815230cd3b4ebd88c515226550666e91ac019929e3adac3f66c288180`
Base64-Encoded: `KKruSBUjDNO069iMUVImVQZm6RrAGZKeOtrD9mwogYA=` | -| `JANE.SAOIRSE@gmail.com`
`Jane.Saoirse@gmail.com`
`JaneSaoirse+Work@gmail.com` | `janesaoirse@gmail.com` | Hashed: `92ee26057ed9dea2535d6c8b141d48373932476599196e00352254896db5888f`
Base64-Encoded: `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` | - ## Example Code -JavaScript でメールアドレスと電話のハッシュを生成する方法の例については、[Example Code: Hashing and Base-64 Encoding](../guides/integration-javascript-client-side#example-code-hashing-and-base-64-encoding) を参照してください。 +メールアドレスや電話番号のハッシュを生成する方法の例は、[Example Code: Hashing and Base-64 Encoding](../guides/integration-javascript-client-side#example-code-hashing-and-base-64-encoding) を参照してください。 ## UID2 Hashing Tool -正規化、ハッシュ化、エンコードが正しく行われているかチェックするには、[UID2 hashing tool](https://unifiedid.com/examples/hashing-tool/) を使ってテストすることができます。 +正規化、ハッシュ化、エンコードが正しく行われているかを確認するには、[UID2 hashing tool](https://unifiedid.com/examples/hashing-tool/) を使用できます。 -Email または Phone Number を選択し、値を入力またはペーストして、**Enter** をクリックします。 +Email または Phone Number を選択し、値を入力または貼り付けてから **Enter** をクリックします。 -このツールは以下を行います: -- Email: 以下の３つの値を表示します: - - Normalized value (正規化した値) - - Hashed value (ハッシュした値) - - Base64-encoded value (Base64 エンコードした値) +このツールは、次のことを行います: +- Email: 以下の 3 つの値を表示します: + - Normalized value + - Hashed value + - Base64-encoded value -- Phone: 以下の2つの値を表示します: - - Hashed value (ハッシュした値) - - Base64-encoded value (Base64 エンコードした値) +- Phone: 以下の 2 つの値を表示します: + - Hashed value + - Base64-encoded value :::important - 電話番号の場合は、まずデータを正規化する必要があります。 + 電話番号の場合、最初にデータを正規化する必要があります。 ::: -入力データが有効なメールアドレスまたは電話番号の形式でない場合、または電話番号が正規化されていない場合、ツールはエラーを表示します。 +入力したデータが有効なメールアドレスまたは電話番号の形式でない場合、または電話番号が正規化されていない場合、ツールはエラーを返します。 -このツールを使って、UID2 の正規化した値、ハッシュした値、エンコードした値が正しく作成されるように内部プロセスが設定されているかどうかを確認することができます。 +このツールを使用して、内部プロセスが UID2 の正規化、ハッシュ化、およびエンコードされた値を正しく作成するように設定されていることを確認できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md index 3f52f2c1a..4926b8b95 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-permissions.md @@ -26,5 +26,5 @@ UID2 エコシステムには、特定のアクティビティを完了するた | :--- | :--- | :--- | | Generator | Publishers | Permission to call the [POST /token/generate](../endpoints/post-token-generate.md), [POST /token/validate](../endpoints/post-token-validate.md), and [POST /token/refresh](../endpoints/post-token-refresh.md) の各エンドポイントを呼び出して、DII から UID2 Token を生成/リフレッシュする権限: | | Bidder | DSPs | パブリッシャーからのビッドストリームから送られてくる UID2 Token を、入札目的で raw UID2 に復号化する権限。 | -| Sharer | UID2 sharing に参加するすべての参加者タイプ。詳細は [UID2 Sharing: Overview](../sharing/sharing-overview.md) を参照してください。 | 以下両方の権限: | -| Mapper | Advertisers
Data Providers | [POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用して、ローテーションされたソルトバケットをモニターし、[POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントを使用して、複数のメールアドレス、電話番号、またはそれぞれのハッシュを、raw UID2 とソルトバケット ID にマッピングする権限。 | +| Sharer | UID2 sharing に参加するすべての参加者タイプ。詳細は [UID2 Sharing: Overview](../sharing/sharing-overview.md) を参照してください。 | 以下両方の権限: | +| Mapper | Advertisers
Data Providers | 複数のメールアドレス、電話番号、またはそのハッシュを、raw UID2、以前の raw UID2、および　リフレッシュタイムスタンプにマッピングするために、以下のエンドポイントを呼び出すパーミッション: | 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 54116266a..211f75ae7 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 @@ -16,7 +16,7 @@ Raw UID2 または UID2 Token が他の参加者と共有される場合はす さらに、Raw UID2 を送信するすべての共有参加者は、[Security Requirements for UID2 Sharing](../sharing/sharing-security) で指定されたセキュリティ要件に従う必要があります。UID2 Token を共有するすべての参加者には、これらの手順を遵守することを勧ます。 -技術的な要件は、役割と実装方法によって異なり、共有ドキュメントの各シナリオの手順に記載されています。シナリオの概要については、共有概要の [Approved Sharing Scenarios](sharing/sharing-overview.md#approved-sharing-scenarios) を参照してください。 +技術的な要件は、役割と実装方法によって異なり、共有ドキュメントの各シナリオの手順に記載されています。シナリオの概要は、共有概要の [Approved Sharing Scenarios](sharing/sharing-overview.md#approved-sharing-scenarios) を参照してください。 ## Legal Requirements for UID2 Sharing diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md index 9d9bbdb1c..32a7f8f21 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md @@ -15,7 +15,7 @@ import Link from '@docusaurus/Link'; DSP はビッドリクエストで UID2 Token を受け取り、この機能をサポートする Server-Side SDK のいずれかを使用して [UID2 tokens](../ref-info/glossary-uid.md#gl-uid2-token) を復号化し、入札に使用できる [raw UID2s](../ref-info/glossary-uid.md#gl-raw-uid2) を取得します。 -利用可能な Server-Side SDK の概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 +利用可能な Server-Side SDK の概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 :::note バックエンドが、利用可能な Server-Side SDK のいずれでもカバーされていない言語で書かれている場合は、UID2 の担当者に問い合わせてください。誰に聞けばいいかわからない場合は、[連絡先情報](../getting-started/gs-account-setup.md#contact-info) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid-v3.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid-v3.png new file mode 100644 index 000000000..17451711a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid-v3.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png deleted file mode 100644 index 67752d557..000000000 Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-mermaid.png and /dev/null differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid-v3.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid-v3.png new file mode 100644 index 000000000..f9470f305 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid-v3.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-v2-mermaid.md.bak similarity index 100% rename from i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak rename to i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-v2-mermaid.md.bak diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-v3-mermaid.mermaid b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-v3-mermaid.mermaid new file mode 100644 index 000000000..38fb75074 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-v3-mermaid.mermaid @@ -0,0 +1,29 @@ +%%26/6/25: V3 API Update - Updated endpoints diagram to use V3 identity map API with refresh timestamps instead of salt bucket monitoring. + + sequenceDiagram + participant ADP as Advertiser/Data Provider + participant UID as UID2 Operator + participant DSP + Note over ADP,DSP: 1. ID マップエンドポイントを使用して DII から raw UID2 を生成します。 + loop + ADP->>UID: 1-a. DII 含むリクエストを POST /identity/map エンドポイントに送信します。 + UID->>ADP: 1-b. POST /identity/map エンドポイントから返された raw UID2 (u)、リフレッシュタイムスタンプ (r)、およびオプションで前の UID2 (p) を保存します。 + end + Note over ADP,DSP: 2. raw UID2 とリフレッシュタイムスタンプを保存します。 + Note over ADP,DSP: 3. raw UID2 を操作または組み合わせます。 + Note over ADP,DSP: 4. raw UID2 を DSP に送信します。 + ADP-->>DSP: 保存された raw UID2 を DSP に送信して、オーディエンスやコンバージョンを作成するか、測定に使用します。 + Note over ADP,DSP: 5. raw UID2 の更新を監視します。 + loop + ADP->>ADP: 5-a. 保存されているリフレッシュタイムスタンプと現在の時刻を比較します。 + ADP->>UID: 5-b. リフレッシュ時間に達した場合、POST /identity/map エンドポイントに DII を再送信して更新された raw UID2 を取得します。 + UID->>ADP: 5-c. POST /identity/map エンドポイントから返された新しい raw UID2 (u)、リフレッシュタイムスタンプ (r)、およびオプションで前の UID2 (p) を保存します。 + end + Note over ADP,DSP: 6. オプトアウトステータスを監視します。ローカルストレージからすべてのオプトアウトを削除し、使用しないでください。 + loop + ADP->>UID: 6-a. POST /optout/status エンドポイントを使用してオプトアウトステータスを監視します。 + UID->>ADP: 6-b. オプトアウトステータスを返します。 + end + +%%URL: +%%https://mermaid.live/edit#pako:eNrNVctu2zAQ_JUFTwlgyy_JTnQIEMRF4UOaoG4vhS-MtLaJWqTKR1I3yL93l_KzsYEcq4tMcnd2dnZMvYrClChyAfQ4_BVQFzhWcmFlNdO8WUvrVaFqqT3cjh9BOrgtn5E2HdrOWHoJj9Y8qxLt-4TvkzEn0KsPDzVa6c2JqPH0sdn8YjyCIXCu1KLtHHoJfEbNmQhWvkQoB3NrKhhPJhCc0gvwSwQioL3ya6hkDajL2ijtkwaXn5UxNTRLAm_f3BASwbdlAlMKBwmW23ceCqO9VJqBuYQ3Ef_xYfoNOtsqnRNVCJBgCZxhnwiWmsWYuyUOF-GyRXXmFt0SvKqonKxquLC0LYmEqb0yWq5Wa6gtPisTNuJd1JeU54PVWDbdf4wTLc9K299S3OvKHN7Rc8lZiEEC91KrOqx4PsaSdtWT0geQ2wmcSE43yu_Lk9R0ss3hMZGgMTYGOmZ7Ip7fhUWmIEOp2MJNKzRJquhIUtdidsHFeVQwp0WF0gWLFe7EOsExowaNVlQ45uwGuRFpk8je2jmtcVe0Qcbuulti8ROKYC1ViqqCXJC_yGnbhs4pfuzVjE01mR-F00IWSyzZVY41-phjYzOhLkmyvZ77ogdOztrFoZM1vvynbh4eT4pqt01giaUPLoGvWFE8EJnt0eYWWZlCruIk5AIj7dKANp7Ncn68cSBDHu8_Rfc1D-6mprPmtLM5fX9FHag-5FF_jQodg-6FEC1Roa2kKun2fuXtmWBv40zk9JPo0DhmYqbfKFIGb6ZrXYjc24At0Yx-c8-LfC5Xjnax5E7umw9C_C60BF3QIn8Vv0Xe6_WSfi8dDa8GvfQq7fbSlliLPB1myfAq63cHo-thv5_207eW-GMMwXaT62yQZdfZaERR3WxEGdaExXJXkdB_xNCG1sJyN4cUP0VKu3j6C9F35s4E7UU-evsL2jsrNA \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk deleted file mode 100644 index 12be7ef9b..000000000 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-mermaid.md.bk +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - - sequenceDiagram - participant DP as Data Provider - participant UID2 as UID2 Operator - participant DSP - loop 1. IDマップエンドポイントを使用して、DII の UID2 を取得します。 - DP->>UID2: 1-a. DII を含むリクエストを ID マッピングエンドポイントに送信します。 - UID2->>DP: 1-b. ID マッピングサービスから返された raw UID2 とソルトバケットを格納します。 - end - DP-->>DSP: 2. 蓄積した raw UID2 を DSP に送信し、オーディエンスとコンバージョンを作成します。 - - loop 3. 蓄積されている UID2 に関連するソルトバケットのローテーションを監視します。 - DP->>UID2: 3-a. バケットサービスを利用して、ソルトバケットのローテーションを返します。 - UID2->>DP: 3-b. 指定されたタイムスタンプ以降にローテーションしたソルトバケットを返します。 - DP->>UID2: 3-c. ローテーションしたソルトバケットと保存されている UID2 ソルトバケットを比較します。
ローテーションした場合は、新しい raw UID2 のために DII を ID マッピングサービスに再送信します。 - UID2->>DP: 3-d. ID マッピングサービスから返された raw UID2 とソルトバケットを保存します。 - end - - - - diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-v2-mermaid.md.bak similarity index 100% rename from i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak rename to i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-v2-mermaid.md.bak diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-v3-mermaid.mermaid b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-v3-mermaid.mermaid new file mode 100644 index 000000000..8b02e0dd9 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-v3-mermaid.mermaid @@ -0,0 +1,29 @@ +%%26/6/25: V3 API Update - Updated diagram to use V3 identity map API with refresh timestamps instead of salt bucket monitoring. + + sequenceDiagram + participant ADP as Advertiser/Data Provider + participant UID as UID2 Operator + participant DSP + Note over ADP,DSP: 1. DII から raw UID2 を生成します。 + loop + ADP->>UID: 1-a. SDK, Snowflake, AWS Entity Resolution, HTTP endpoint に DII を含むリクエストを送信します。 + UID->>ADP: 1-b. raw UID2 (u)、リフレッシュタイムスタンプ (r)、およびオプションで前の UID2 (p) を受信します。 + end + Note over ADP,DSP: 2. raw UID2 とリフレッシュタイムスタンプを保存します。 + Note over ADP,DSP: 3. raw UID2 を操作または組み合わせます。 + Note over ADP,DSP: 4. raw UID2 を DSP に送信します。 + ADP-->>DSP: 保存された raw UID2 を DSP に送信して、オーディエンスやコンバージョンを作成するか、測定に使用します。 + Note over ADP,DSP: 5. raw UID2 の更新を監視します。 + loop + ADP->>ADP: 5-a. 保存されているリフレッシュタイムスタンプと現在の時刻を比較します。 + ADP->>UID: 5-b. リフレッシュ時間に達した場合、POST /identity/map エンドポイントに DII を再送信して更新された raw UID2 を取得します。 + UID->>ADP: 5-c. 新しい raw UID2 (u)、リフレッシュタイムスタンプ (r)、およびオプションで前の UID2 (p) を保存します。 + end + Note over ADP,DSP: 6. オプトアウトステータスを監視します。ローカルストレージからすべてのオプトアウトを削除し、使用しないでください。 + loop + ADP->>UID: 6-a. POST /optout/status エンドポイントを使用してオプトアウトステータスを監視します。 + UID->>ADP: 6-b. オプトアウトステータスを返します。 + end + +%% URL: +%% https://mermaid.live/edit#pako:eNpNj81qxCAUhV8lnLUETaKJbtsuu-quuJHxTibQ6OAodBry7rUZWgp3cX8O5zt3wyl6gkHTgGGltLrF13GzoWks8oVWsjC1PcdEt2xhw16VruT4dg8nmJwKMZSrd5meFzcnt_4uyS85ptcH4OAwXF2A2fAJIzrdKq71OEpZq5OS4Q4z9H07dZrrQXOluZTDzvAVY3UVrRgHOSnFharXSTCkWOYLzNl93Ogwfz-UD_6cfn75H_DlSPSnTxQ8padYQobp928lN1Ka \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md index 463f1f8cc..11f531a68 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md @@ -1,7 +1,7 @@ --- title: Advertiser/Data Provider Integration to HTTP Endpoints sidebar_label: HTTP Endpoints -description: ユーザーデータを収集し、他の参加者へプッシュする組織向けのインテグレーション、SDK や Snowflake ではなく HTTP エンドポイントへのコーディング。 +description: ユーザーデータを収集し、他の参加者にプッシュする組織向けのインテグレーション。SDK や Snowflake ではなく、HTTP エンドポイントへのコーディングを行います。 hide_table_of_contents: false sidebar_position: 07 displayed_sidebar: sidebarAdvertisers @@ -11,123 +11,183 @@ import Link from '@docusaurus/Link'; # Advertiser/Data Provider Integration to HTTP Endpoints -このガイドでは、広告主およびデータプロバイダが、UID2 とインテグレーションするために、SDK、Snowflake、または AWS Entity Resolution などの他の実装オプションを使用せずに、UID2 HTTP エンドポイントを呼び出すためのコードを記述する手順について説明します。 +このガイドでは、広告主やデータプロバイダーが UID2 HTTP エンドポイントを呼び出すコードを記述して、SDK、Snowflake、または AWS Entity Resolution などの他の実装オプションを使用するのではなく、UID2 とインテグレーションする手順について説明します。 :::tip -広告主とデータプロバイダー向けのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +広告主及びデータプロバイダー向けのインテグレーションオプションと手順の概要は、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 ::: ## Complete UID2 Account Setup and Configure Account -UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 +UID2 とインテグレーションするには、UID2 アカウントが必要です。まだアカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従ってください。 -アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[UID2 Portal での開始](../portal/portal-getting-started.md) を参照してください。 +初期アカウント設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための指示とリンクが送信されます。ここで、[credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を構成できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 -UID2 Portal の [API Keys](../portal/api-keys.md) ページで、以下の値を設定する必要があります: +UID2 Portal の [API Keys](../portal/api-keys.md) ページで、次の値を設定する必要があります: -- API key、Client Key とも呼ばれます。 -- Client secret、参加者と UID2 Servivce のみが知る値です。 +- API key (クライアントキーとも呼ばれます) +- Client secret (参加者と UID2 サービスのみに知られている値) :::important -これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: ## High-Level Steps -広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです: +UID2 とインテグレーションするための広告主やデータプロバイダー向けの手順は、以下のとおりです: 1. [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) -2. [Store Raw UID2s and Salt Bucket IDs](#2-store-raw-uid2s-and-salt-bucket-ids) +2. [Store Raw UID2s and Refresh Timestamps](#2-store-raw-uid2s-and-refresh-timestamps) 3. [Manipulate or Combine Raw UID2s](#3-manipulate-or-combine-raw-uid2s) 4. [Send Stored Raw UID2s to DSPs to Create Audiences or Conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) -5. [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) +5. [Monitor for Raw UID2 Refresh](#5-monitor-for-raw-uid2-refresh) 6. [Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) ## Integration Diagram -以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了する必要がある手順を示しています。 +次の図は、オーディエンスの構築とターゲティングのために、DII を raw UID2 にマッピングするためにデータ収集者が行わなければならない手順です。 -DII は、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化され、SHA-256 ハッシュされたメールアドレスまたは電話番号を指します。 +DII は、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化および SHA-256 ハッシュ化されたメールアドレスまたは電話番号を指します。 -![Advertiser Flow](images/advertiser-flow-endpoints-mermaid.png) +![Advertiser Flow](images/advertiser-flow-endpoints-mermaid-v3.png) - + ### 1: Generate Raw UID2s from DII | Step | Endpoint | Description | | --- | --- | --- | -| 1-a | [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) request | DII を含むリクエストを ID マッピングエンドポイントに送信します。 | -| 1-b | [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) response | レスポンスで返される `advertising_id` (raw UID2) は、関連する DSP でオーディエンスをターゲットするために使用できます。
レスポンスは、ユーザーの raw UID2 と、それに対応するソルトバケットの `bucket_id` を返します。バケットに割り当てられたソルトは年に一度ローテーションし、生成された raw UID2 に影響を与えます。ソルトバケットのローテーションを確認する方法の詳細は、[5: Monitor for salt bucket rotations related to your stored raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。 | - +| 1-a | [POST /identity/map](../endpoints/post-identity-map.md) request | DIIを含むリクエストをアイデンティティマッピングエンドポイントに送信します。 | +| 1-b | [POST /identity/map](../endpoints/post-identity-map.md) response | レスポンスで返される raw UID2 (`u` フィールド) は、関連する DSP でオーディエンスをターゲティングするために使用できます。
レスポンスは、ユーザーの raw UID2 (`u`)、リフレッシュ タイムスタンプ (`r`)、およびオプションで、現在の UID2 が過去 90 日以内にローテーションされた場合の前の raw UID2 (`p`) を返します。リフレッシュ タイムスタンプを使用して、UID2 を更新するタイミングを判断します。詳細は、[5: Monitor for Raw UID2 Refresh](#5-monitor-for-raw-uid2-refresh) を参照してください。 | -### 2: Store Raw UID2s and Salt Bucket IDs +### 2: Store Raw UID2s and Refresh Timestamps -Step 1 のレスポンス [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) には、マッピング情報が含まれています。以下の情報を保存することを勧めます: +Step 1、[Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) のレスポンスには、マッピング情報が含まれています。以下の情報を保存することを推奨します: -- DII (`identifier`) と raw UID2 (`advertising_id`)、ソルトバケット (`bucket_id`) のマッピングをキャッシュします。 -- レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) で返される `last_updated` タイムスタンプと比較できます。 +- DII と raw UID2 (`u` フィールド) のマッピングをキャッシュします。 +- raw UID2 がいつ更新されるかを知るために、リフレッシュ タイムスタンプ (`r` フィールド) を保存します。 +- 過去 90 日以内にローテーションされた場合の前の raw UID2 (`p` フィールド) をオプションで保存します。 ### 3: Manipulate or Combine Raw UID2s -Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます: +Step 1 で受け取った UID2 を使用します。例えば、以下のような操作を行うことができます: -- 操作を行う: たとえば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。 -- 既存のオーディエンスに新しい UID2 を追加する。 +- いくつかの操作を行います:たとえば、DII から生成した raw UID2 と、広告主やデータプロバイダーなどの別の参加者から受け取った raw UID2 を突合します。 +- 新しい raw UID2 を既存のオーディエンスに追加します。 ### 4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions -raw UID2 を以下の目的で使用します: +raw UID2 は、以下のような目的で使用できます: - - 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。 - - 計測のために raw UID2 を使用する。 + - 保存されている raw UID2s を DSP に送信して、オーディエンスやコンバージョンを作成します。 + - 測定（アトリビューション）のために raw UID2s を使用します。 -たとえば、Step 1-b で返された `advertising_id` (raw UID2) を DSP に送信してオーディエンスを構築します。各 DSP は、オーディエンスを構築するための独自のインテグレーションプロセスを持っています。オーディエンスを構築するために raw UID2 を送信するための DSP から提供されるインテグレーションガイダンスに従ってください。 +例えば、Step 1-b で返された (raw UID2) (`u` フィールド) を DSP に送信して、オーディエンスを構築することができます。各 DSP には、オーディエンスを構築するための独自のインテグレーションプロセスがあります。DSP が提供するインテグレーションガイダンスに従って、raw UID2 を送信してオーディエンスを構築してください。 -また、計測（アトリビューション）やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。 +API またはピクセルを介してコンバージョン情報を送信し、測定（アトリビューション）やリターゲティングに使用することもできます。 -### 5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s +### 5: Monitor for Raw UID2 Refresh -raw UID2 は、特定の時点におけるユーザーの識別子です。raw UID2 は、ソルトバケット のローテーションにより、少なくとも年に一度変更されます。 +raw UID2 は、特定の時点でのユーザーの識別子です。特定のユーザーの raw UID2 は、UID2 リフレッシュプロセスの一環として、およそ 1 年に 1 回変更されます。 -各ソルトバケットは、約1年に1回更新されますが、個々のバケットの更新は年間を通じて分散されます。約 1/365 のソルトバケットが毎日ローテーションされます。このため、ソルトバケットのローテーションを定期的にチェックすることを勧めます。これは、オーディエンスの更新に合わせた頻度で行うことが望ましいです。たとえば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。 +v3 Identity Map API のレスポンスには、各 raw UID2 がいつリフレッシュされるかを示すリフレッシュ タイムスタンプ (`r` フィールド) が含まれています。このタイムスタンプを使用して、保存されたデータの raw UID2 を再生成するタイミングを判断します。このタイムスタンプ以降に raw UID2 がリフレッシュされることは保証されています。 -ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated) を参照してください。 +リフレッシュの機会を毎日確認することを推奨します。以下の表は、raw UID2 のリフレッシュを監視する手順を示しています。 -以下の表は、ソルトバケットのローテーションを確認するための手順を示しています。 +| Step | Action | Description | +| :--- | :--- | :--- | +| 5-a | ローカルでのタイムスタンプチェック | 現在の時刻と、以前に [POST /identity/map](../endpoints/post-identity-map.md) レスポンスから保存したリフレッシュ タイムスタンプ (`r` フィールド) を比較します。 | +| 5-b | [POST /identity/map](../endpoints/post-identity-map.md) | 現在の時刻がリフレッシュ タイムスタンプ以降である場合、同じ DII でアイデンティティマップエンドポイントを再度呼び出して raw UID2 を再生成します。 | +| 5-c | ローカルストレージの更新 | レスポンスから返された新しい raw UID2 (`u` フィールド)、リフレッシュ タイムスタンプ (`r` フィールド)、およびオプションで前の UID2 (`p` フィールド) を保存します。 | -| Step | Endpoint | Description | -| --- | --- | --- | -| 5-a | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | 特定のタイムスタンプ以降に変更されたすべてのソルトバケットに対して、`POST /identity/buckets` エンドポイントにリクエストを送信します。 | -| 5-b | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | UID2 Service: `POST /identity/buckets` エンドポイントは、`bucket_id` と `last_updated` タイムスタンプのリストを返します。 | -| 5-c | [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) | 返された `bucket_id` をキャッシュした raw UID2 のソルトバケットと比較します。
1 つ以上の raw UID2 のソルトバケットが更新された場合は、新しい raw UID2 用に DII を `POST /identity/map` エンドポイントに再送信します。 | -| 5-d | [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) | `advertising_id` と `bucket_id` の新しい値を保存します。 | +#### Determine whether to refresh a raw UID2 -#### Determine whether the salt bucket has been rotated +raw UID2 を更新する必要があるかを判断するには、以下の手順に従います: -特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。 +1. 現在の時刻と、[POST /identity/map](../endpoints/post-identity-map.md) のレスポンスから保存したリフレッシュタイムスタンプ（`r` フィールド）を比較します。 -1. 以下の 2 つの値を比較します: +2. 現在の時刻がリフレッシュ タイムスタンプ以降である場合、同じ DII で [POST /identity/map](../endpoints/post-identity-map.md) を再度呼び出して raw UID2 を再生成します。 - - ソルトバケットのローテーション時に返された、同じ `bucket_id` の raw UID2 の `last_updated` タイムスタンプ。 - - - Step 1 で返され、Step 2 で保存された、同じ `bucket_id` の raw UID2 生成時のタイムスタンプ。 - -1. `last_updated` タイムスタンプが、以前に記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その場合、この `bucket_id` に関連するすべての raw UID2 を再生成する必要があります。この場合は、Step 1 の [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従ってください。 +このアプローチにより、raw UID2 が最新の状態で、オーディエンスターゲティングや測定に有効であることが保証されます。 ### 6: Monitor for Opt-Out Status -ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの UID2 を引き続き使用しないようにしてください。 +ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの raw UID2 を引き続き使用しないようにすることが重要です。 + +UID2 Operator Service を使用して、最新のオプトアウト情報を取得する方法は2つあります: + +- [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。 + +- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して raw UID2 のオプトアウトステータスを確認します。 + +UID2 のオプトアウト手順の詳細と、ユーザーがどのようにオプトアウトできるかは、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + +## Using POST /identity/map Version 2 + +:::note +以下の情報は、`POST /identity/map` エンドポイントのバージョン 2 またはそれ以前を使用している場合にのみ関連し、参照用に提供されています。新しい実装では最新バージョンを使用する必要があります。手順は、[High-Level Steps](#high-level-steps) を参照してください。 +::: + +v2 Identity Map API の使用時との主な違いは以下の通りです: + +- **Step 2**: リフレッシュタイムスタンプの代わりにソルトバケット ID を保存します。 +- **Step 5**: リフレッシュタイムスタンプの代わりにソルトバケットのローテーションを監視します。 + +その他の Step (1, 3, 4, and 6) は、v3 実装で説明されている内容と同じです: [High-Level Steps](#high-level-steps) を参照してください。 + +### Integration Diagram (v2) + +次の表は、v2 インテグレーションフローを示しています。違いは Step 2（ソルトバケット ID の保存）と Step 5（ソルトバケットのローテーションの監視）です。 + +![Advertiser Flow](images/advertiser-flow-endpoints-mermaid.png) + + + +### Store Raw UID2s and Salt Bucket IDs (v2) + +:::note +このステップは、v3 実装の Step 2 を置き換えます。 +::: + +Step 1 のレスポンスには、マッピング情報が含まれています。以下の情報を保存することを推奨します: + +- DII (`identifier`)、raw UID2 (`advertising_id`)、およびソルトバケット (`bucket_id`) のマッピングをキャッシュします。 +- レスポンスデータを受信した時刻のタイムスタンプを保存します。後で、このタイムスタンプを Step 5 で返される `last_updated` タイムスタンプと比較できます。 + +### Monitor for Salt Bucket Rotations for Your Stored Raw UID2s (v2) + +:::note +このステップは、v3 実装の Step 5 を置き換えます。 +::: + +raw UID2 は、特定の時点におけるユーザーを識別する ID です。特定のユーザーの raw UID2 は、ソルトバケット のローテーションの結果として、おおよそ 1 年に 1 回変更されます。 + +各ソルトバケットはおおよそ年に 1 回更新されますが、個々のバケットの更新は年間を通じて分散されます。おおよそ 365 分の 1 のソルトバケットが毎日ローテーションされます。このことを考慮して、オーディエンスの更新に合わせてソルトバケットのローテーションを定期的に確認することを推奨します。例えば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。 + +ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated) を参照してください。 + +次の表は、ソルトバケットのローテーションを確認する手順を示しています。 + +| Step | Endpoint | Description | +| --- | --- | --- | +| 5-a | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | 特定のタイムスタンプ以降に変更されたすべてのソルトバケットについて、`POST /identity/buckets` エンドポイントにリクエストを送信します。 | +| 5-b | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | UID2 Service: `POST /identity/buckets` エンドポイントは、`bucket_id` と `last_updated` タイムスタンプのリストを返します。 | +| 5-c | [POST /identity/map](../endpoints/post-identity-map-v2.md) | 返された `bucket_id` をキャッシュしている raw UID2 のソルトバケットと比較します。
1 つ以上の raw UID2 のソルトバケットが更新されている場合は、DII を `POST /identity/map` エンドポイントに再送信して新しい raw UID2 を取得します。 | +| 5-d | [POST /identity/map](../endpoints/post-identity-map-v2.md) | 返された `advertising_id` と `bucket_id` の新しい値を保存します。 | + +##### Determine whether the salt bucket has been rotated + +特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、以下の手順に従います。 -UID2 Operator Service に最新のオプトアウト情報があるかを確認する方法は 2 つあります: +1. 以下の値を比較します: -- [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。 + - 監視中のソルトバケットのローテーションの一環として返された各 `bucket_id` の `last_updated` タイムスタンプ。 -- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認します。 + - 同じ `bucket_id` の raw UID2 生成時のタイムスタンプ。これはステップ 1 で返され、ステップ 2 で保存されました。 -UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法についての詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +1. `last_updated` タイムスタンプが以前のタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。そのため、この `bucket_id` に関連付けられた raw UID2 を再生成する必要があります。Step 1 の [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従ってください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md index 7d837663f..002a06abe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md @@ -1,7 +1,7 @@ --- title: Advertiser/Data Provider Integration Overview sidebar_label: Advertiser/Data Provider Integration Overview -description: ユーザーデータを収集し、他の参加者へプッシュする組織向けのインテグレーションの概要。 +description: ユーザーデータを収集し、他の参加者に送信する組織向けのインテグレーションオプションの概要。 hide_table_of_contents: false sidebar_position: 07 displayed_sidebar: sidebarAdvertisers @@ -11,151 +11,208 @@ import Link from '@docusaurus/Link'; # Advertiser/Data Provider Integration Overview -このガイドでは、ユーザーデータを収集し、他の UID2 参加者へプッシュする組織向けのインテグレーションオプションの概要を提供します。データコレクターには、広告主、データオンボーダー、計測プロバイダー、アイデンティティグラフプロバイダー、サードパーティデータプロバイダー、および他のデータを他の参加者に送信する組織が含まれます。 +このガイドは、ユーザーデータを収集し、他の UID2 参加者に送信する組織向けのインテグレーションオプションの概要を提供します。データ収集者には、広告主、データオンボーダー、測定プロバイダー、ID グラフプロバイダー、サードパーティデータプロバイダー、およびその他のデータを他の参加者に送信する組織が含まれます。 ## Advertiser/Data Provider Routes to Use UID2 -アドテク業界では、広告主は ID を使用してオーディエンスを構築し、コンバージョンを追跡し、グラフを生成します。広告主または広告主を代表してデータプロバイダーとして、UID2 を使用してこれらの目標を達成する方法の一部の例を次の表に示します。 +アドテクノロジー業界では、広告主はアイデンティティを使用してオーディエンスを構築し、コンバージョンを追跡し、グラフを生成します。広告主として、または広告主に代わって行動するデータプロバイダーとして、以下の表は UID2 を使用してこれらの目標の一部を達成する方法の例を示しています。 :::note -これらのユースケース以外にも、UID2 を使用する方法があります。以下に、いくつかの例を示します。 +UID2 は、これらのユースケース以外でも使用できます。これらは一部の例に過ぎません。 ::: | Send/Receive? | Action | Advantage/Result | | --- | --- | --- | -| オーディエンスを送信 | API またはピクセルを介して UID2 を送信 | オーディエンスを作成します。 | -| コンバージョンを送信 | UID2 をコンバージョン情報として送信 | 測定（アトリビューション）またはリターゲティングのためにコンバージョン情報を使用します。 | -| グラフデータを受信 | API またはピクセルを介してグラフ/データプロバイダーから UID2 を受信 | グラフデータを構築します。 | +| オーディエンスを送信 | API またはピクセルを介して raw UID2 を送信 | オーディエンスを作成します。 | +| コンバージョンを送信 | コンバージョン情報として raw UID2 を送信 | コンバージョン情報を計測（アトリビューション）または API やピクセルを介してリターゲティングに使用します。 | +| グラフデータを受信 | API またはピクセルを介してグラフ/データプロバイダーから raw UID2 を受信 | グラフデータを構築します。 | ## High-Level Steps -広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです: +UID2 とインテグレーションする広告主とデータプロバイダーのインテグレーション手順は、次のとおりです。 1. [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) -2. [Store Raw UID2s and Salt Bucket IDs](#2-store-raw-uid2s-and-salt-bucket-ids) +2. [Store Raw UID2s and Refresh Timestamps](#2-store-raw-uid2s-and-refresh-timestamps) 3. [Manipulate or Combine Raw UID2s](#3-manipulate-or-combine-raw-uid2s) 4. [Send Stored Raw UID2s to DSPs to Create Audiences or Conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) -5. [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) +5. [Monitor for Raw UID2 Refresh](#5-monitor-for-raw-uid2-refresh) 6. [Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) +:::note +[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントのバージョン 3 より前のバージョンを使用している場合は、[Using POST /identity/map Version 2](#using-post-identitymap-version-2) を参照してください。このバージョンを使用している場合は、強化された機能を利用するためにできるだけ早くアップグレードすることを推奨します。 +::: + ## Summary of Implementation Options -以下の表は、広告主およびデータプロバイダーが利用できる実装オプションを、各ステップごとに示しています。一部のステップは、独自のカスタム実装の一部としてのみ管理されます。一部のステップは、利用可能な UID2 実装オプションのいずれかを使用して管理できます。詳細は、各ステップのリンクをクリックしてください。 +以下の表は、広告主とデータプロバイダー向けの実装オプションを、各レベルのステップごとに示しています。一部のステップは、独自のカスタム実装の一部としてのみ管理されます。一部のステップは、利用可能な UID2 実装オプションの 1 つ以上によって管理できます。詳細は、各ステップのリンクをクリックしてください。 | High-Level Step | Implementation Options | | --- | --- | -| [1: Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | DII を raw UID2 にマッピングするには、以下のオプションのいずれかをします: | -| [2: Store Raw UID2s and Salt Bucket IDs](#2-store-raw-uid2s-and-salt-bucket-ids) | カスタム（適切な方法で）。 | -| [3: Manipulate or Combine Raw UID2s](#3-manipulate-or-combine-raw-uid2s) | カスタム（適切な方法で）。 | -| [4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) | カスタム（適切な方法で）。 | -| [5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) | 以下のいずれかのオプションを使用してください: | -| [6: Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) | API コールを使用して、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントにアクセスします。 | +| [1: Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | DII を raw UID2 にマップするには、次のいずれかのぷションを利用します: | +| [2: Store Raw UID2s and Refresh Timestamps](#2-store-raw-uid2s-and-refresh-timestamps) | カスタム（必要に応じて） | +| [3: Manipulate or Combine Raw UID2s](#3-manipulate-or-combine-raw-uid2s) | カスタム（必要に応じて） | +| [4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) | カスタム（必要に応じて） | +| [5: Monitor for Raw UID2 Refresh](#5-monitor-for-raw-uid2-refresh) | [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントから返されるリフレッシュタイムスタンプ（`r` フィールド）を使用して、Raw UID2 を更新するタイミングを判断します。 | +| [6: Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) | [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントへの API コール。 | ## Integration Diagram -以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了しなければならない手順を示しています。 +以下の図は、データ収集者がオーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするために完了する必要があるステップを概説しています。 -DII とは、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化され、SHA-256 ハッシュされたメールアドレスまたは電話番号を指します。 +DII とは、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化されて SHA-256 ハッシュ化されたメールアドレスまたは電話番号を指します。 -UID2 に基づくオーディエンス情報を正確かつ最新の状態に保つために、毎日以下のインテグレーション手順に従ってください。 +UID2 ベースのオーディエンス情報を正確かつ最新の状態に保つには、これらのインテグレーションステップを毎日実行してください。 -![Advertiser Flow](images/advertiser-flow-overview-mermaid.png) +![Advertiser Flow](images/advertiser-flow-overview-mermaid-v3.png) - + -図の各部分の詳細は、次のセクションを参照してください。 +図の各部分の詳細は、以下のセクションを参照してください。 ### 1: Generate Raw UID2s from DII -raw UID2 は、直接識別情報 (DII) から生成するか、広告主を代表してデータプロバイダーなどの他の UID2 参加者から UID2 を受け取ることができます。 +directly identifying information (DII) から raw UID2 を生成するか、データプロバイダーなどの他の UID2 参加者から UID2 を受信できます。 -raw UID2 を生成するには、以下のオプションのいずれかを使用します: +raw UID2 を生成するには、次のいずれかのオプションを使用します: - UID2 SDK のいずれか: - - Python SDK: [Map DII to Raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s) を参照してください。 - - Java SDK: [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) を参照してください。 + - Python SDK: See [Map DII to Raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s). + - Java SDK: See [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers). - Snowflake: [Map DII](integration-snowflake.md#map-dii) を参照してください。 - AWS Entity Resolution: [AWS Entity Resolution Integration Guide](integration-aws-entity-resolution.md) を参照してください。 -- HTTP endpoints: [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md). 詳細は、[Generate Raw UID2s from DII](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii) を参照してください。 +- HTTP endpoints: [POST /identity/map](../endpoints/post-identity-map.md) を参照してください。詳細は、[Generate Raw UID2s from DII](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii) を参照してください。 -### 2: Store Raw UID2s and Salt Bucket IDs +### 2: Store Raw UID2s and Refresh Timestamps -Step 1 のレスポンス [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) には、マッピング情報が含まれています。以下の情報を保存することを勧めます: +Step 1 [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) のレスポンスには、マッピング情報が含まれています。Step 1 で返される以下の情報を保存することを推奨します: -- DII (`identifier`) と raw UID2 (`advertising_id`)、ソルトバケット (`bucket_id`) のマッピングをキャッシュします。 -- レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) で返される `last_updated` タイムスタンプと比較できます。 +- DII と raw UID2 (`u` フィールド) のマッピングをキャッシュします。 +- リフレッシュタイムスタンプ (`r` フィールド) を保存して、raw UID2 がいつリフレッシュされるかを把握します。 +- オプションで、過去 90 日以内に UID2 がリフレッシュされたユーザーのために提供された場合は、前の raw UID2 (`p` フィールド) を保存します。 ### 3: Manipulate or Combine Raw UID2s -Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます: +Step 1 で受け取った raw UID2 を使用します。たとえば、以下を行うことができます: -- 操作する: たとえば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。 -- 既存のオーディエンスに新しい UID2 を追加する。 +- 何らかの操作を行う: たとえば、DII から生成した raw UID2 と、広告主やデータプロバイダーなどの他の参加者から受け取った raw UID2 を組み合わせます。 +- 新しい raw UID2 を既存のオーディエンスに追加します。 ### 4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions -UID2 を以下の目的で使用します: +raw UID2 を次の目的で使用します: - - 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。 - - 計測のために raw UID2 を使用する。 + - 保存された raw UID2 を DSP に送信して、オーディエンスやコンバージョンを作成します。 + - 測定のために raw UID2 を使用します。 -たとえば、Step 1-b で返された `advertising_id` (raw UID2) を DSP に送信してオーディエンスを構築します。各 DSP は、オーディエンスを構築するための独自のインテグレーションプロセスを持っています。オーディエンスを構築するために raw UID2 を送信するための DSP から提供されるインテグレーションガイダンスに従ってください。 +たとえば、Step 1 で返された (raw UID2 (`u` フィールド)) を DSP に送信してオーディエンスを構築することができます。各 DSP にはオーディエンスを構築するための独自のインテグレーションプロセスがあるため、raw UID2 を送信してオーディエンスを構築するためのインテグレーションガイダンスに従ってください。 -また、計測（アトリビューション）やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。 +コンバージョン情報を API またはピクセルを介して送信して、測定 (アトリビューション) またはリターゲティングを行うこともできます。 -### 5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s +### 5: Monitor for Raw UID2 Refresh -raw UID2 は、特定の時点におけるユーザーの識別子です。raw UID2 は、ソルトバケットのローテーションにより、少なくとも年に一度変更されます。 +raw UID2 は、特定の時点でのユーザーの識別子です。特定のユーザーの raw UID2 は、UID2 リフレッシュプロセスの一環として、約 1 年に 1 回変更されます。 -各ソルトバケットは、約1年に1回更新されますが、個々のバケットの更新は年間を通じて分散されます。約 1/365 のソルトバケットが毎日ローテーションされます。このため、ソルトバケットのローテーションを定期的にチェックすることを勧めます。これは、オーディエンスの更新に合わせた頻度で行うことが望ましいです。たとえば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。 +V3 Identity Map API は、各 raw UID2 がいつリフレッシュされるかを示すリフレッシュタイムスタンプ (`r` フィールド) をレスポンスで提供します。このタイムスタンプを使用して、保存されたデータの raw UID2 を再生成するタイミングを判断します。この時刻より前にリフレッシュされないことが保証されています。 -ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated) を参照してください。 +リフレッシュのタイミングを毎日確認することを推奨します。raw UID2 をリフレッシュするかどうかを判断するには、次の手順に従います: -ソルトバケットのローテーションを監視する場合については、次のいずれかを参照してください: +1. 現在の時刻と[POST /identity/map](../endpoints/post-identity-map.md) レスポンスから保存したリフレッシュタイムスタンプ (`r` フィールド) を比較します。 -- Python SDK: [Monitor Rotated Salt Buckets](../sdks/sdk-ref-python.md#monitor-rotated-salt-buckets). +2. If the current time is greater than or equal to the refresh timestamp, regenerate the raw UID2 by calling [POST /identity/map](../endpoints/post-identity-map.md) again with the same DII. + +このアプローチにより、raw UID2 が最新かつ有効であり、オーディエンスのターゲティングや測定に使用できることが保証されます。 + +### 6: Monitor for Opt-Out Status + +ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの raw UID2 を使用し続けないようにします。 + +UID2 Operator Service で最新のオプトアウト情報を確認するには、次の 2 つの方法があります: + +- [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。 -- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake-previous.md#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s). +- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して raw UID2 のオプトアウトステータスを確認します。 -- HTTP endpoints: [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](integration-advertiser-dataprovider-endpoints.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s). +UID2 オプトアウトワークフローの詳細や、ユーザーがオプトアウトする方法は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 + +## Using POST /identity/map Version 2 :::note -AWS Entity Resolution では、ソルトバケットの監視方法はありません。代わりに、AWS Entity Resolution サービスを使用して定期的に raw UID2 を再生成することができます。 +以下の情報は、`POST /identity/map` エンドポイントの以前のバージョン 2 を使用するインテグレーションアプローチにのみ関連し、参照用に提供されています。新しい実装では最新バージョンを使用する必要があります: [High-Level Steps](#high-level-steps) を参照してください。 ::: -#### Determine whether the salt bucket has been rotated +Identity Map API のバージョン 2 を使用する場合の主な違いは次のとおりです: -特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。 +- **Step 2**: ソルトバケット ID を保存する代わりにリフレッシュタイムスタンプを保存します +- **Step 5**: ソルトバケットのローテーションを監視する代わりにリフレッシュタイムスタンプを使用します -1. 2 つの値を比較します: +他のすべてのステップ (1, 3, 4, および 6) は、v3 実装で説明されているとおりです: [High-Level Steps](#high-level-steps) を参照してください。 - - ソルトバケットのローテーション時に返された、同じ `bucket_id` の raw UID2 の `last_updated` タイムスタンプ。(選択したオプションによって返されたもの) - - - 同じ `bucket_id` の raw UID2 生成時のタイムスタンプ。Step 1 で返され、Step 2 で保存されたもの。 +### Integration Diagram (v2) -1. `last_updated` タイムスタンプが、以前に記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その場合、この `bucket_id` に関連するすべての raw UID2 を再生成する必要があります。これには、Step 1 の [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従います。 +以下の図は、v2 インテグレーションフローを概説しています。主な違いは、Step 2（ソルトバケット ID の保存）と Step 5（ソルトバケットのローテーションの監視）にあります。 -### 6: Monitor for Opt-Out Status +![Advertiser Flow](images/advertiser-flow-overview-mermaid.png) + + + +### Store Raw UID2s and Salt Bucket IDs (v2) + +:::note +このステップは、v3 実装の Step 2 を置き換えます。 +::: -ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの UID2 を引き続き使用しないようにしてください。 +Step 1 のレスポンスには、マッピング情報が含まれています。Step 1 で返される以下の情報を保存することを推奨します: -UID2 Operator Service で最新のオプトアウト情報があるかを確認する方法は 2 つあります: +- DII (`identifier`) と raw UID2 (`advertising_id`) とソルトバケット (`bucket_id`) のマッピングを保存します。 +- レスポンスデータを受信したタイムスタンプを保存します。後で、このタイムスタンプを Step 5 で返される `last_updated` タイムスタンプと比較できます。 + +### Monitor for Salt Bucket Rotations for Your Stored Raw UID2s (v2) + +:::note +このステップは、v3 実装の Step 5 を置き換えます。 +::: + +raw UID2 は特定の時点でのユーザーの識別子です。特定のユーザーの raw UID2 は、salt bucketのローテーションの結果として、約 1 年に 1 回変更されます。 + +各ソルトバケットは約 1 年に 1 回更新されますが、個々のバケットの更新は年間を通じて分散されます。おおよそ 365 分の 1 のソルトバケットが毎日ローテーションされます。これに基づいて、オーディエンスの更新に合わせて定期的にソルトバケットのローテーションを確認することを推奨します。たとえば、毎週更新する場合は、毎週ソルトバケットの更新を確認します。 + +ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated-v2) を参照してください。 + +ソルトバケットのローテーションを監視する手順は、以下のいずれかを参照してください: + +- Python SDK: [Monitor Rotated Salt Buckets](../sdks/sdk-ref-python.md#monitor-rotated-salt-buckets). + +- Snowflake: [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](integration-snowflake-previous#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s). + +- HTTP endpoints: [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s (v2)](integration-advertiser-dataprovider-endpoints.md#monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s-v2). + + + +:::note +AWS Entity Resolution では、ソルトバケットの監視を行う方法はありません。代わりに、AWS Entity Resolution サービスを使用して定期的に raw UID2 を再生成することができます。 +::: + +##### Determine whether the salt bucket has been rotated (v2) + +特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。 + +1. 2 つの値を比較します: -- [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイイントを使用して、raw UID2 のオプトアウトステータスを確認します。オプトアウトされた DII には、raw UID2 は生成されません。 + - ソルトバケットのローテーションを監視する際に返される各 `bucket_id` の `last_updated` タイムスタンプ。 -- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認します。 + - 同じ `bucket_id` の raw UID2 生成のタイムスタンプ。これは Step 1 で返され、Step 2 で保存したものです。 -UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法についての詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +1. `last_updated` タイムスタンプが、先ほど記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その結果、この `bucket_id` に関連付けられているすべての raw UID2 を、Step1 [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従って再生成する必要があります。 ## FAQs -UID2 のフレームワークを使用する広告主およびデータプロバイダー向けのよくある質問のリストについては、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 +UID2 フレームワークを使用する広告主とデータプロバイダー向けのよくある質問のリストは、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md index 7fc0ddbbb..acc191405 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md @@ -20,10 +20,10 @@ import Link from '@docusaurus/Link'; 現在 UID2 エコシステムに参加していない場合は、[Request Access to UID2](https://unifiedid.com/request-access) にアクセスしてください。 ::: -AWS Entity Resolution を使用して UID2 とインテグレーションに関するビデオプレゼンテーションとデモについては、YouTube の [Getting Started with AWS Entity Resolution Integration with Unified ID 2.0](https://www.youtube.com/watch?v=ORbSsKMgVj8) を参照してください。 +AWS Entity Resolution を使用して UID2 とインテグレーションに関するビデオプレゼンテーションとデモは、YouTube の [Getting Started with AWS Entity Resolution Integration with Unified ID 2.0](https://www.youtube.com/watch?v=ORbSsKMgVj8) を参照してください。 :::tip -広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要は、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 ::: ## Functionality @@ -109,7 +109,7 @@ AWS Data Exchange の [Unified ID 2.0 Identity Resolution](https://aws.amazon.co UID2 の参加者は AWS の S3 バケットにデータを保存し、AWS Entity Resolution とインテグレーションします。AWS アカウントを作成したら([Create AWS Account](#create-aws-account) を参照してください。)、基本的な手順は以下の通りです。 :::note -詳細な手順については、AWSドキュメントの [Setting up AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/userguide/setting-up.html) を参照してください。 +詳細な手順は、AWSドキュメントの [Setting up AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/userguide/setting-up.html) を参照してください。 ::: 1. [管理者ユーザーを作成します](https://docs.aws.amazon.com/entityresolution/latest/userguide/setting-up.html#setting-up-create-iam-user). @@ -132,7 +132,7 @@ UID2 の参加者は AWS の S3 バケットにデータを保存し、AWS Entit 最初のアカウント作成とセットアップが完了したら、次のステップはデータのマッチングワークフローを作成することです。 -以下のステップは、AWS Entity Resolution ユーザーインターフェースで行うアクションの概要です。詳細と手順については、AWS Entity Resolution ドキュメントの [Creating a matching workflow with UID 2.0](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow-provider.html#create-mw-uid) を参照してください。 +以下のステップは、AWS Entity Resolution ユーザーインターフェースで行うアクションの概要です。詳細と手順は、AWS Entity Resolution ドキュメントの [Creating a matching workflow with UID 2.0](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow-provider.html#create-mw-uid) を参照してください。 :::note UID2 は、UID2 生成のためにメールアドレスまたは電話番号のいずれかをサポートします。しかし、AWS Entity Resolution では、スキーママッピングに両方の値が存在する場合、ワークフローはメールアドレスを使用し、電話番号はパススルーフィールドとして扱います。もしデータにメールアドレスと電話番号が混在している場合、最適な方法は、スキーママッピングを別々にして、それぞれ別のワークフローを作成することです。このシナリオでは、以下のステップを2回行います—1つはメールアドレス用のワークフロー、もう1つは電話番号用のワークフローを作成します。 @@ -141,7 +141,7 @@ UID2 は、UID2 生成のためにメールアドレスまたは電話番号の マッチングワークフローを作成するには、まず AWS Management コンソールにサインインし、**AWS Entity Resolution** ページを開き、**Workflows** > **Matching workflows** > **Create matching workflow** を選択します。次に、マッチングワークフローの以下のステップを完了します。 1. 一致するワークフローについて、以下の詳細を指定します: - - **Name**: この値は必須です。短く、わかりやすく、直感的な名前を勧めます。たとえば、会社名を指定する場合: `CompanyName_UID2_Daily_Matching`。 + - **Name**: この値は必須です。短く、わかりやすく、直感的な名前を推奨します。たとえば、会社名を指定する場合: `CompanyName_UID2_Daily_Matching`。 - **Description**: マッチングワークフローの説明(オプション)。 - **Data input**: AWS のデータソース。ドロップダウンリストから、AWS Glue データベース、AWS Glue テーブル、スキーママッピングの順に選択します。データ入力は複数指定できます。以下の例では、メールアドレスのみを指定しています: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md index 94f347e86..5b094082b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md @@ -37,7 +37,7 @@ UID2 とインテグレーションするには、次の 3 つの主要なステ UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[UID2 Portal での開始](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細は、[UID2 Portal での開始](../portal/portal-getting-started.md) を参照してください。 設定する具体的な値は、[CTV integration options](#ctv-integration-options) で選択したオプションによって異なります: @@ -46,7 +46,7 @@ UID2 とインテグレーションするには、UID2 のアカウントが必 - Client secret、参加者と UID2 Servivce のみが知る値です。 :::important - これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 + これらの値を安全に保管することは非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: - Client-Side の実装には、UID2 Portal の [Client-Side Integration](../portal/client-side-integration.md) ページで次の値を設定する必要があります: - Subscription ID と Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 @@ -121,7 +121,7 @@ CTV インテグレーションのベストプラクティスは次のとおり - **トークンを事前にローテーションさせる** - CTV 広告は広告ブレイク中のトラフィックスパイクに関連付けられています。これらの時間帯に UID2 Token を生成またはリフレッシュすることは理想的ではありません。忙しい時間帯の前にトークンを生成またはリフレッシュすることを勧めます。 + CTV 広告は広告ブレイク中のトラフィックスパイクに関連付けられています。これらの時間帯に UID2 Token を生成またはリフレッシュすることは理想的ではありません。忙しい時間帯の前にトークンを生成またはリフレッシュすることを推奨します。 トークンが有効期限前にリフレッシュされた場合、古いトークンが有効期限切れになるまで、新しいトークンまたは古いトークンのいずれかを使用できます。TTL (time to live) タイムスタンプは、トークンが生成またはリフレッシュされたときに UID2 Operator から返されるレスポンスボディの一部です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md index fe03d1e34..663b8f614 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md @@ -152,7 +152,7 @@ SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID ## Sample Implementations -Google Ad Manager のセキュアシグナル機能との連携方法については、以下のサンプルアプリケーションを参照してください: +Google Ad Manager のセキュアシグナル機能との連携方法は、以下のサンプルアプリケーションを参照してください: - UID2 JavaScript SDK と Google secure signals を使用した Server-Side インテグレーションのサンプル: - [Sample implementation](https://secure-signals-server-side-integ.uidapi.com/) 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 519afb796..93ce00131 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 @@ -14,7 +14,7 @@ import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # Client-Server Integration Guide for JavaScript -このガイドは、Web アセットを持つパブリッシャー向けに、RTB bidstream で UID2 を使用して ID トークンを生成し、サーバーサイドで UID2 トークンを生成してパブリッシャーの Web ページに渡し、JavaScript の UID2 SDK を使用してクライアントサイドでトークンをリフレッシュする方法を説明します。 +このガイドは、Web アセットを持つパブリッシャー向けに、RTB bidstream で UID2 を使用して ID トークンを生成し、サーバーサイドで UID2 Tokenを生成してパブリッシャーの Web ページに渡し、JavaScript の UID2 SDK を使用してクライアントサイドでトークンをリフレッシュする方法を説明します。 これは、JavaScript インテグレーションステップが Client-Side であり、その他のステップが Server-Side であるため、Client-Server インテグレーションと呼ばれます。 @@ -24,7 +24,7 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re ## Sample Implementation -実装例については、次の UID2 SDK インテグレーション例を参照してください。 +実装例は、次の UID2 SDK インテグレーション例を参照してください。 - [Client-Server UID2 SDK Integration Example](https://example-jssdk-integ.uidapi.com/) - [Code Repository with Readme](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) @@ -36,13 +36,13 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 -UID2 を使用してクライアントの ID を確立し、Advertising Token を取得するプロセスを容易にするために、このガイドで提供する Web インテグレーション手順は、JavaScript 用の UID2 SDK に依存しています。このガイドに記載されているインテグレーションステップと SDK の使用方法(現在はメールアドレスのみ) を示す [example application](https://example-jssdk-integ.uidapi.com/) を以下に示します。アプリケーションのドキュメントについては、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) を参照してください。 +UID2 を使用してクライアントの ID を確立し、Advertising Token を取得するプロセスを容易にするために、このガイドで提供する Web インテグレーション手順は、JavaScript 用の UID2 SDK に依存しています。このガイドに記載されているインテグレーションステップと SDK の使用方法(現在はメールアドレスのみ) を示す [example application](https://example-jssdk-integ.uidapi.com/) を以下に示します。アプリケーションのドキュメントは、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) を参照してください。 :::tip ファーストパーティ Cookie とローカルストレージの実装の詳細は 将来変更される可能性があります。潜在的な問題を回避するため、ID 管理には [SDK for JavaScript API Reference](../sdks/sdk-ref-javascript.md#api-reference) に記載されている機能を使用してください。 ::: -SDK for JavaScript を使用しないパブリッシャーのインテグレーションシナリオについては、[Publisher Integration Guide, Server-Side](integration-publisher-server-side.md) を参照してください。 +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) の追加手順に従ってください。 @@ -56,7 +56,7 @@ Google Ad Managerを使用していて、セキュアシグナル機能を使用 UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 Client-Server インテグレーションを行う場合は、UID2 Portal の [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: @@ -64,7 +64,7 @@ Client-Server インテグレーションを行う場合は、UID2 Portal の [A - Client secret、参加者と UID2 Servivce のみが知る値です。 :::important -これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +これらの値を安全に保管することは非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: ## Integration Steps @@ -97,7 +97,7 @@ Step 1-c でパブリッシャーがユーザーのメールアドレスまた 最初のステップは、サーバーで UID2 Token を生成することです。 -手順や例については、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 +手順や例は、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 `Identity` レスポンスを SDK に渡す必要があります。[Sending the UID2 Token to the SDK](#sending-the-uid2-token-to-the-sdk) を参照してください。 @@ -132,7 +132,7 @@ SDKは、指定された [callback function](../sdks/sdk-ref-javascript.md#callb | 2-a | SDK for JavaScript | 以下に示すように、[getAdvertisingToken() 関数](../sdks/sdk-ref-javascript.md#getadvertisingtoken-string) を使用して、現在のユーザーの Advertising Token を取得します。| :::note -UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例については、[ビッドストリームで UID2 Token はどのように見えますか？](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bidstream) を参照してください。 +UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例は、[ビッドストリームで UID2 Token はどのように見えますか？](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bidstream) を参照してください。 ::: ```html @@ -177,4 +177,4 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー ## FAQs -パブリッシャー向けのよくある質問については、[FAQs for Publishers](../getting-started/gs-faqs.md#faqs-for-publishers) を参照してください。 +パブリッシャー向けのよくある質問は、[FAQs for Publishers](../getting-started/gs-faqs.md#faqs-for-publishers) を参照してください。 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 40891fc19..6dc18c5d4 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 @@ -59,7 +59,7 @@ SDK のデバッグビルドを使用したい場合は、代わりに以下の ## Sample Implementation -実装例については、次の例を参照してください: +実装例は、次の例を参照してください: - Code: [Example Client-Side Integration for JavaScript](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - ランニングサイト: [Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/) @@ -95,9 +95,9 @@ When account setup is complete, you'll receive a client keypair consisting of tw 以下のコードスニペットは、ウェブサイトに追加する必要があるコードの概要です。また、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) を参照してください。 +より詳細なコードスニペットは、[Example Integration Code and When to Pass DII to the UID2 SDK](#example-integration-code-and-when-to-pass-dii-to-the-uid2-sdk) を参照してください。 -`UID2_JS_SDK_URL` の値については、[SDK for JavaScript Version](#sdk-for-javascript-version) を参照してください。 +`UID2_JS_SDK_URL` の値は、[SDK for JavaScript Version](#sdk-for-javascript-version) を参照してください。 ```js @@ -134,7 +134,7 @@ SDK の詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript ### Using the UID2 Integration Environment -デフォルトでは、この SDK は UID2 本番環境 `https://prod.uidapi.com` で動作するように設定されています。代わりに UID2 インテグレーション環境を使用する場合 (資格情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)、`init` に以下の URL を指定します: +デフォルトでは、この SDK は UID2 本番環境 `https://prod.uidapi.com` で動作するように設定されています。代わりに UID2 インテグレーション環境を使用する場合 (資格情報は [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)、`init` に以下の URL を指定します: ```js __uid2.init({ @@ -142,14 +142,14 @@ __uid2.init({ }); ``` :::note -UID2 インテグレーション環境からのトークンは、ビッドストリームに渡しても無効です。インテグレーション環境では、**Subscription ID** と **public key** の値が異なります。各環境の認証情報を取得すr方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +UID2 インテグレーション環境からのトークンは、ビッドストリームに渡しても無効です。インテグレーション環境では、**Subscription ID** と **public key** の値が異なります。各環境の認証情報を取得すr方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Optional: Specifying the API Base URL to Reduce Latency デフォルトでは、この SDK は米国の UID2 本番環境サーバーにリクエストを送信します。 -ユースケースに最適な URL を選択する方法と、有効なベース URL の全リストについては、[Environments](../getting-started/gs-environments.md) を参照してください。 +ユースケースに最適な URL を選択する方法と、有効なベース URL の全リストは、[Environments](../getting-started/gs-environments.md) を参照してください。 デフォルト以外の UID2 サーバーを指定するには、`init` 呼び出しで変更します: @@ -199,7 +199,7 @@ SDK は、特定のユーザーに対して、4 つの DII フォーマットの SDK が複数回設定された場合、最新の設定値が使用されます。 -JavaScript でメールアドレスと電話のハッシュを生成する方法の例については、[Example Code: Hashing and Base-64 Encoding](#example-code-hashing-and-base-64-encoding) を参照してください。 +JavaScript でメールアドレスと電話のハッシュを生成する方法の例は、[Example Code: Hashing and Base-64 Encoding](#example-code-hashing-and-base-64-encoding) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md index 7c13ad76a..6bfab0456 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md @@ -15,7 +15,7 @@ import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; このガイドは、UID2 とインテグレーションし、SDK for JavaScript を使ってUID2 token(Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 -Prebid.js と追加 SDK オプションを含むすべてのウェブオプションの概要については、[Publisher Web Integration Overview](integration-options-publisher-web.md) を参照してください。 +Prebid.js と追加 SDK オプションを含むすべてのウェブオプションの概要は、[Publisher Web Integration Overview](integration-options-publisher-web.md) を参照してください。 ## Introduction @@ -69,7 +69,7 @@ Client-Side のオプションでは、ローカルストレージを使用し JavaScript SDK は、UID2 Token の生成、更新、保存を管理しますが、トークンをビッドストリームに渡すことは管理しません。 -トークンは、Prebid.jsなどのオプションを使用してビッドストリームに渡すことができます。いくつかの提案については、*Publisher Web インテグレーション概要*の [Pass the UID2 Token Into the Bidstream](integration-options-publisher-web.md#pass-the-uid2-token-into-the-bidstream) を参照してください。 +トークンは、Prebid.jsなどのオプションを使用してビッドストリームに渡すことができます。いくつかの提案は、*Publisher Web インテグレーション概要*の [Pass the UID2 Token Into the Bidstream](integration-options-publisher-web.md#pass-the-uid2-token-into-the-bidstream) を参照してください。 ## JavaScript Integration Overview: High-Level Steps @@ -79,7 +79,7 @@ SDK for JavaScript を使って UID2 とインテグレーションするには 1. SDKをサイトに追加します。 1. SDKを設定します。 -詳細な手順については、以下のインテグレーションガイドのいずれかを参照してください: +詳細な手順は、以下のインテグレーションガイドのいずれかを参照してください: - [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) - [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md index c0a59f985..7d7859d8a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md @@ -40,4 +40,4 @@ For details, see [Normalization and Encoding](../getting-started/gs-normalizatio ## Troubleshooting Assistance -詳細情報や LiveRamp のトラブルシューティング支援については、[LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) を参照してください。ヘルプリソースを確認するか、LiveRamp の担当者に連絡してください。 +詳細情報や LiveRamp のトラブルシューティング支援は、[LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) を参照してください。ヘルプリソースを確認するか、LiveRamp の担当者に連絡してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md index 85654a06e..afba430b7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-server.md @@ -37,7 +37,7 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref このガイドの、**UID2 mobile SDKs** は、SDK for Android と SDK for iOS の両方を含むグループ用語です。 ::: -モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 +モバイルパブリッシャーインテグレーションに関する FAQs は、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 以下の手順を完了する必要があります: @@ -55,7 +55,7 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref - SDK for Android (version 1.6.0 以降) - SDK for iOS (version 1.7.0 以降) -正しい SDK/バージョンをモバイルアプリにインストールする手順については、[Add the UID2 Mobile SDK to Your Mobile App](#add-the-uid2-mobile-sdk-to-your-mobile-app) を参照してください。 +正しい SDK/バージョンをモバイルアプリにインストールする手順は、[Add the UID2 Mobile SDK to Your Mobile App](#add-the-uid2-mobile-sdk-to-your-mobile-app) を参照してください。 ## Integrating with Single Sign-On (SSO) @@ -90,7 +90,7 @@ Client-Server インテグレーションには、UID2 Portal の [API Keys](../ モバイル向けの Client-Server UID2 インテグレーションの場合、最初のステップは、サーバーで UID2 Token を生成できるようにすることです。その後、トークンをモバイルアプリに渡して RTB ビッドストリームに送信できます。 -手順や例については、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 +手順や例は、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 `Identity` レスポンスをモバイルアプリに渡す必要があります: [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。 @@ -109,13 +109,13 @@ Token Refresh を Server-Side で管理し、クライアント/モバイルサ - [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出します。 - UID2 Server-Side SDK のいずれかの Publisher Client クラスを使用します。これらのクラスは、リクエストを単一のメソッド呼び出しに簡素化します。 - 手順については、[SDK for Java, Usage for Publishers, Basic Usage Server-Side Integration section](../sdks/sdk-ref-java.md#basic-usage-server-side-integration) または [SDK for Python, Usage for Publishers, Server-Side Integration section](../sdks/sdk-ref-python.md#server-side-integration) を参照してください。 + 手順は、[SDK for Java, Usage for Publishers, Basic Usage Server-Side Integration section](../sdks/sdk-ref-java.md#basic-usage-server-side-integration) または [SDK for Python, Usage for Publishers, Server-Side Integration section](../sdks/sdk-ref-python.md#server-side-integration) を参照してください。 その後、このガイドの残りの部分に従って、新しくリフレッシュされた `Identity` 値をモバイルアプリに渡します。 ## Add the UID2 Mobile SDK to Your Mobile App -インストール方法については、以下のいずれかを参照してください: +インストール方法は、以下のいずれかを参照してください: - [SDK for Android Reference Guide](../sdks/sdk-ref-android.md) - [SDK for iOS Reference Guide](../sdks/sdk-ref-ios.md) @@ -126,7 +126,7 @@ Token Refresh を Server-Side で管理し、クライアント/モバイルサ デフォルトでは、この SDK は UID2 本番環境: `https://prod.uidapi.com` で動作するように構成されています。代わりに UID2 インテグレーション環境を使用する場合は、UID2Manager の初期化時に次の URL を指定してください。 -各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +各環境の認証情報を取得する方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 @@ -161,7 +161,7 @@ UID2Settings.shared.uid2Environment = .custom( デフォルトでは、この SDK は米国の UID2 本番環境サーバーにリクエストを送信します。 -ユースケースに最適な URL を選択する方法と、有効なベース URL の完リストについては、[Environments](../getting-started/gs-environments.md) を参照してください。 +ユースケースに最適な URL を選択する方法と、有効なベース URL の完リストは、[Environments](../getting-started/gs-environments.md) を参照してください。 異なる UID2 サーバーを指定するには、`init` 呼び出しで変更してください: @@ -220,7 +220,7 @@ UID2Manager.shared.setIdentity() `setIdentity` メソッドを呼び出すと、UID2 identity がローカルファイルストレージに永続化されます。 :::warning -ローカルファイルストレージに保存されたファイルの形式、またはファイル名自体が予告なく変更される可能性があります。ファイルを直接読み取ったり更新したりしないことを勧めます。 +ローカルファイルストレージに保存されたファイルの形式、またはファイル名自体が予告なく変更される可能性があります。ファイルを直接読み取ったり更新したりしないことを推奨します。 ::: ## Pass Generated Token for Bidstream Use diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md index ccec3aca5..d7eb16015 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md @@ -35,7 +35,7 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref このガイドの、**UID2 mobile SDKs** は、SDK for Android と SDK for iOS の両方を含むグループ用語です。 ::: -モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 +モバイルパブリッシャーインテグレーションに関する FAQs は、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 UID2 を Client-Side でインテグレーションするには、以下の手順を完了する必要があります: @@ -56,11 +56,11 @@ UID2 を Client-Side でインテグレーションするには、以下の手 - SDK for Android (version 1.6.0 以降) - SDK for iOS (version 1.7.0 以降) -正しい SDK/バージョンをモバイルアプリにインストールする手順については、[Add the UID2 Mobile SDK to Your Mobile App](#add-the-uid2-mobile-sdk-to-your-mobile-app) を参照してください。 +正しい SDK/バージョンをモバイルアプリにインストールする手順は、[Add the UID2 Mobile SDK to Your Mobile App](#add-the-uid2-mobile-sdk-to-your-mobile-app) を参照してください。 ## Client-Side Integration Example -UID2 mobile SDK の設定方法と、モバイル用の Client-Side インテグレーションを使用したトークンの生成方法の例については、UID2 開発アプリを試してください。 +UID2 mobile SDK の設定方法と、モバイル用の Client-Side インテグレーションを使用したトークンの生成方法の例は、UID2 開発アプリを試してください。 Android または iOS 向けの適用可能な手順に従ってください: @@ -229,7 +229,7 @@ SDK をアプリに追加したら、SDK を使用して UID2 Token を生成す ### Using the UID2 Integration Environment -デフォルトでは、この SDK は UID2 本番環境: `https://prod.uidapi.com` で動作するように構成されています。UID2 インテグレーション環境を使用する場合は、(認証情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)、`UID2Manager` の初期化する際に次の URL を指定してください: +デフォルトでは、この SDK は UID2 本番環境: `https://prod.uidapi.com` で動作するように構成されています。UID2 インテグレーション環境を使用する場合は、(認証情報は [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)、`UID2Manager` の初期化する際に次の URL を指定してください: @@ -264,7 +264,7 @@ UID2Settings.shared.uid2Environment = .custom( デフォルトでは、この SDK は米国の UID2 本番環境サーバーにリクエストを送信します。 -ユースケースに最適な URL を選択する方法と、有効なベース URL の完リストについては、[Environments](../getting-started/gs-environments.md) を参照してください。 +ユースケースに最適な URL を選択する方法と、有効なベース URL の完リストは、[Environments](../getting-started/gs-environments.md) を参照してください。 別の UID2 サーバを指定するには、次の例に示すように構成変更を行います: @@ -610,11 +610,11 @@ UID2Manager.shared.getAdvertisingToken() - **Android Kotlin**: `UID2Manager.getInstance().currentIdentityStatus()` - **iOS**: `UID2Manager.shared.identityStatus` - UID2 から DII がオプトアウトされている可能性があります: 詳細については [When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk) を参照してください。 + UID2 から DII がオプトアウトされている可能性があります: 詳細は [When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk) を参照してください。 - ロギングを有効 (`isLoggingEnabled` を `true` に設定する) にして詳細情報を取得できます: [Enable Logging](#enable-logging) を参照してください。 - UID2 identity 内の Advertising Token の有効期限が切れていて、Refresh Token も有効期限が切れているため、SDK がトークンをリフレッシュできません。 -Identity が無い場合は、`generateIdentity` メソッドを再度呼び出す必要があります: 詳細については [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。 +Identity が無い場合は、`generateIdentity` メソッドを再度呼び出す必要があります: 詳細は [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。 詳細は、[When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk)(次項) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md index be7a572d5..cc0a38200 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md @@ -27,7 +27,7 @@ UID2 は、Android/iOS 向けの SDK を提供しており、次の機能をサ - UID2 Token のリフレッシュ - UID2 Token の保存 -さらに、UID2 は、一部の機能に対して代替手段を提供し、UID2 Google GMA/IMA プラグインなどの補完製品も提供しています。利用可能なオプションについては、個々のガイドで説明されています: [Integration Overview: High-Level Steps](#integration-overview-high-level-steps) を参照してください。 +さらに、UID2 は、一部の機能に対して代替手段を提供し、UID2 Google GMA/IMA プラグインなどの補完製品も提供しています。利用可能なオプションは、個々のガイドで説明されています: [Integration Overview: High-Level Steps](#integration-overview-high-level-steps) を参照してください。 ## Integrating with Single Sign-On (SSO) @@ -163,7 +163,7 @@ UID2 Mobile インテグレーションには、UID2 Mobile SDK、UID2 GMA プ 推奨事項: - すでに CocoaPods を使用している場合、特に Google Ad Frameworks を自分でインテグレーションしている場合は、UID2 SDK を CocoaPods を使用してインテグレーションすることが最適です。 -- 依存関係のインテグレーションが初めての場合、または Swift Package Manager ですでに依存関係がある場合は、UID2 モバイルインテグレーションには Swift Package Manager を使用することを勧めます。 +- 依存関係のインテグレーションが初めての場合、または Swift Package Manager ですでに依存関係がある場合は、UID2 モバイルインテグレーションには Swift Package Manager を使用することを推奨します。 :::caution diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md index a9c14b45b..d1c0c1669 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md @@ -41,7 +41,7 @@ Private Operator に参加するメリットは次のとおりです。 参加者は、Private Operator インスタンスをホスト、構成、維持、および更新し、厳格なセキュリティ対策に準拠する必要があります。インテグレーションを行い、継続的な更新を行うためにエンジニアリソースが必要です。 -Private Operator インスタンスをホストするためには、契約を結ぶ必要があります。契約については、[Account Setup](../getting-started/gs-account-setup.md) を参照してください。 +Private Operator インスタンスをホストするためには、契約を結ぶ必要があります。契約は、[Account Setup](../getting-started/gs-account-setup.md) を参照してください。 :::note Privaet Operator は、Public Operator または他の Private Operator によって処理された raw UID2 または UID2 Token の内容を見ることはできません。各 Private Operator は他のすべての Operator から隔離されています。 @@ -85,6 +85,10 @@ Private Operator にはいくつかの制限があります: - Private Operator は、現在、client-side integration　をサポートしていません。 - Private Operator の更新は、年に 3 回リリースされます; Public Operator の更新は、より頻繁にリリースされます。 +## Private Operator Deprecation Schedule + +サポートされるバージョンと廃止時期は、[Private Operator Versions](../ref-info/deprecation-schedule.md#private-operator-versions) を参照してください。 + ## Private Operator Upgrade Policy diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md index b81cb0bf7..dee44ae63 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md @@ -61,7 +61,7 @@ UID2 Token を生成するには、主に2つの方法があります。—U - Client-Side (ユーザーのブラウザ内): [Client-Side Integration Options](#client-side-integration-options) を参照してください。 - Server-Side: [Server-Side Integration Options](#server-side-integration-options) を参照してください。 -それぞれのオプションには利点があります。最も簡単で高速なインテグレーションオプションとして、Prebid.js 8.21.0 以降を使用した Client-Side インテグレーションを勧めます。 +それぞれのオプションには利点があります。最も簡単で高速なインテグレーションオプションとして、Prebid.js 8.21.0 以降を使用した Client-Side インテグレーションを推奨します。 :::note すべてのインテグレーションオプションで、UID2 Token をローカルストレージまたはクッキーストレージに保存することを選択できます。 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 737e159a8..c9ad9d7d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md @@ -26,7 +26,7 @@ Prebid.js を使って UID2 とインテグレーションするには、以下 ## Prebid.js Version -この実装には、Prebid.js version 7.53.0 以降が必要です。バージョン情報については、[https://github.com/prebid/Prebid.js/releases](https://github.com/prebid/Prebid.js/releases) を参照してください。 +この実装には、Prebid.js version 7.53.0 以降が必要です。バージョン情報は、[https://github.com/prebid/Prebid.js/releases](https://github.com/prebid/Prebid.js/releases) を参照してください。 @@ -56,7 +56,7 @@ GWH note 12/14/23 updated 2/7/25: we have a client-side example for Prebid.js bu Prebid.js を使用して UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントがまだ作成されていない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 Client-Server インテグレーションの場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: @@ -64,7 +64,7 @@ Client-Server インテグレーションの場合、UID2 Portal の [API Keys]( - Client secret、参加者と UID2 Service のみが知る値。 :::important -これらの値を安全に保管することが非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: @@ -50,7 +50,7 @@ UID2 Prebid.js Client-Side インテグレーション例は、以下のリン UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。UID2 Portalでは、[本番環境](../getting-started/gs-environments.md) のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。UID2 Portalでは、[本番環境](../getting-started/gs-environments.md) のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 Client-Side インテグレーションには、UID2 Portalの [Client-Side Integration](../portal/client-side-integration.md) ページで以下の値を設定する必要があります: @@ -91,7 +91,7 @@ Notes: 1. 次に、SHA-256 ハッシングアルゴリズムを使用して結果をハッシュ化します。 1. 次に、ハッシュ値のバイトを Base64 エンコードして結果をエンコードします。 - 詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。例については、[Configuring the UID2 Module: Code Example](#configuring-the-uid2-module-code-example) を参照してください。 + 詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。例は、[Configuring the UID2 Module: Code Example](#configuring-the-uid2-module-code-example) を参照してください。 - UID2 module は、ハッシュ化された DII を UID2 Service に送信する前に暗号化します。 - モジュールが複数回設定された場合、最新の設定値が使用されます。 @@ -119,7 +119,7 @@ const baseConfig = { ``` :::note -この例では、UID2 本番環境を使用していると仮定しています。インテグレーションテスト中は、`params.uid2ApiBase` を `'https://operator-integ.uidapi.com'` に設定して UID2 インテグレーション環境を使用してください (資格情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)。UID2 インテグレーション環境からのトークンはビッドストリームに渡すために有効ではありません。インテグレーション環境では、異なる **Subscription ID** と **public key** の値があります。詳細は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 +この例では、UID2 本番環境を使用していると仮定しています。インテグレーションテスト中は、`params.uid2ApiBase` を `'https://operator-integ.uidapi.com'` に設定して UID2 インテグレーション環境を使用してください (資格情報は [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)。UID2 インテグレーション環境からのトークンはビッドストリームに渡すために有効ではありません。インテグレーション環境では、異なる **Subscription ID** と **public key** の値があります。詳細は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ## Storing the UID2 Token in the Browser @@ -176,7 +176,7 @@ UID2 module が正常に UID2 Token を生成したかどうかを確認する - アカウントのセットアップ中に、サイトのドメイン名を UID2 チームに提供したことを確認してください。必要に応じて、UID2 の担当者に確認してください。 - ブラウザのデベロッパーツールを使って、UID2 Service への API コールを調べます。 -その他のヘルプについては、Prebid のドキュメント [Troubleshooting Prebid.js](https://docs.prebid.org/troubleshooting/troubleshooting-guide.html) および [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 があります: @@ -187,7 +187,7 @@ Prebid.js の設定を検証・デバッグするツールの例として、オ デフォルトでは、UID2 モジュールは米国の UID2 本番環境サーバーに対して呼び出しを行います。 -ユースケースに最適な URL を選択する方法と、有効なベース URL の完全なリストについては、[Environments](../getting-started/gs-environments.md) を参照してください。 +ユースケースに最適な URL を選択する方法と、有効なベース URL の完全なリストは、[Environments](../getting-started/gs-environments.md) を参照してください。 UID2 モジュールをデフォルト以外の UID2 サーバーに指定するには、UID2 モジュールを設定する際に、オプションの `params.uid2ApiBase` パラメータを次の例に示すように設定します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md index 56bb6b551..3acfc8812 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md @@ -75,7 +75,7 @@ Prebid.js を使ってサイトを UID2 とインテグレーションするに 1. Prebid.js をサイトに追加します。 1. UID2 module を設定します。 -詳細な手順については、以下のインテグレーションガイドのいずれかを参照してください: +詳細な手順は、以下のインテグレーションガイドのいずれかを参照してください: - [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md) - [UID2 Client-Server Integration Guide for Prebid.js](integration-prebid-client-server.md) 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 035ea1ac6..182894997 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 @@ -23,7 +23,7 @@ import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; ワークフローをデモするサンプルアプリケーションもあります。[Sample Implementation](#sample-implementation) を参照してください。 -パブリッシャーインテグレーションオプションの完全な概要については、[Publisher Integrations](summary-guides.md#publisher-integrations) を参照してください。 +パブリッシャーインテグレーションオプションの完全な概要は、[Publisher Integrations](summary-guides.md#publisher-integrations) を参照してください。 :::tip UID2 と UID2 Token を使用してクライアントのアイデンティティを確立し、UID2 Token を取得するプロセスを容易にするために、SDK for JavaScript を使用することを検討してください。詳細は [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md) を参照してください。 @@ -49,7 +49,7 @@ UID2 と UID2 Token を使用してクライアントのアイデンティティ UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、UID2 Portalにアクセスするための手順とリンクが送信されます。UID2 Portalでは、本番環境のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、UID2 Portalにアクセスするための手順とリンクが送信されます。UID2 Portalでは、本番環境のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 Server-Side インテグレーションの場合、UID2 Portalの [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: @@ -57,7 +57,7 @@ Server-Side インテグレーションの場合、UID2 Portalの [API Keys](../ - Client secret、参加者と UID2 Service のみが知る値。 :::important -これらの値を安全に保管することが非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: ## Integration Steps @@ -82,7 +82,7 @@ Server-Side SDK を使用している場合、SDK はエンドポイントに関 Step 1-c で認証が行われい、パブリッシャーがユーザーのメールアドレスや電話番号を検証した後、パブリッシャーは Server-Side で UID2 Token を生成するリクエストを送信することができます。次の表は、トークン生成ステップの詳細です。 :::tip -このエンドポイントを直接呼び出す代わりに、SDK のいずれかを使用して管理することもできます。オプションの概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 +このエンドポイントを直接呼び出す代わりに、SDK のいずれかを使用して管理することもできます。オプションの概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 ::: | Step | Endpoint | Description | @@ -100,7 +100,7 @@ UID2 ID 情報をどのように管理し、ターゲティング広告に使用 | 2-a | N/A | Step [1-e](#establish-identity-capture-user-data) の `advertising_token` を入札のために SSP に送信します。そのままの値を送信します。 | :::note -UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例については、[ビッドストリームで UID2 Token はどのように見えますか？](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bidstream) を参照してください。 +UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例は、[ビッドストリームで UID2 Token はどのように見えますか？](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bidstream) を参照してください。 ::: ### Refresh a UID2 Token diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-before-february-2025.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-before-february-2025.md index 659326e86..6d9d2a4e2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-before-february-2025.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-before-february-2025.md @@ -15,17 +15,15 @@ import Link from '@docusaurus/Link'; [Snowflake](https://www.snowflake.com/) は、クラウドデータウェアハウジングソリューションで、パートナーとしてデータを保存し、UID2 フレームワークとインテグレーションすることができます。Snowflake を使用することで、UID2 は、機密性の高い直接識別情報 (DII)を公開せずに、消費者識別子データを安全に共有できます。消費者識別子データを直接問い合わせる Operator Web Services があるにもかかわらず、Snowflake UID2 インテグレーションはよりシームレスなエクスペリエンスを提供します。 :::important -このドキュメントは、2025年2月以前に公開された広告主とデータプロバイダー向けの別々の Snowflake marketplace を使用しているユーザー向けです。2025年2月に公開された新しいインテグレーションに関するドキュメントは、[Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous) を参照してください。以前の実装を使用している場合は、更新と強化を活用するために新しいバージョンに移行することを勧めます。移行情報については、[Migration Guide](integration-snowflake.md#migration-guide) を参照してください。 +このドキュメントは、2025年2月以前に公開された広告主とデータプロバイダー向けの別々の Snowflake marketplace を使用しているユーザー向けです。2025年2月に公開された新しいインテグレーションに関するドキュメントは、[Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous) を参照してください。以前の実装を使用している場合は、更新と強化を活用するために新しいバージョンに移行することを勧めます。移行情報は、[Migration Guide](integration-snowflake.md#migration-guide) を参照してください。 ::: - - Snowflake の UID2 インテグレーションの実装は、広告主とデータプロバイダー向けに別々の Snowflake marketplace で提供されていました。これらのリストは、2025年2月に更新されたバージョンが公開された後に削除されました。 実装したものがある場合は、このドキュメントを使用してメンテナンスすることができますが、最新バージョンにアップグレードすることを勧めます。[Snowflake Integration Guide](integration-snowflake.md) を参照してください。 :::tip -広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要は、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 ::: ## Functionality @@ -48,7 +46,7 @@ Snowflake の UID2 インテグレーションの実装は、広告主とデー ![Snowflake Integration Architecture](images/uid2-snowflake-integration-architecture-drawio.png) -|Partner Snowflake Account|UID2 Snowflake Account|UID2 Core Opt-Out Cloud Setup| +| Partner Snowflake Account | UID2 Snowflake Account | UID2 Core Opt-Out Cloud Setup | | :--- | :--- | :--- | | パートナーとして、Snowflake アカウントを設定してデータをホストし、UID2 Share を通じて関数やビューを使うことで、UID2 インテグレーションに関与できます。 | Snowflake アカウントでホストされている UID2 インテグレーションでは、プライベートテーブルからデータを引き出す許可をされた関数とビューへのアクセスが許可されます。プライベートテーブルにはアクセスできません。UID2 Share では、UID2 関連のタスクを実行するために必要な重要なデータのみが公開されます。 | ETL (抽出・変換・ロード) ジョブは、UID2 Core/Optout Snowflake ストレージを常に更新し、UID2 Operator Web Services を動かす内部データを提供します。Operator Web Services で使用されるデータは、UID2 Share からも入手できます。 | | Shared 関数とビューを使用する場合、Snowflake にトランザクションのコストを支払います。 | UID2 Snowflake アカウントで保護されたこれらのプライベートテーブルは、UID2 関連のタスクを完了するために使用される内部データを保持する UID2 Core/Optout Snowflake ストレージと自動的に同期されます。 | | @@ -511,7 +509,7 @@ After: FN_T_UID2_IDENTITY_MAP(EMAIL, 'email') ``` -#### Example for mapping unhashed emails +#### Example for mapping hashed emails Before: @@ -661,7 +659,7 @@ UID2 Token がうまく復号化できない場合、この関数は行を返し | Value | Meaning | | :-- | :-- | -| `NULL` | UID2トークンは正常に復号化されました。 | +| `NULL` | UID2 Token は正常に復号化されました。 | | `EXPIRED_TOKEN` | UID2 Token の有効期限が切れています。 | #### Decrypt Token Request Example—Single UID2 Token diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-previous.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-previous.md index 31dc22b0a..45024ef88 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-previous.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake-previous.md @@ -15,7 +15,7 @@ import Link from '@docusaurus/Link'; [Snowflake](https://www.snowflake.com/)は、パートナーとしてデータを保存し、UID2 フレームワークとインテグレーションできるクラウドデータウェアハウジングソリューションです。Snowflake を使用することで、UID2 では機密性の高い直接識別情報（DII）を公開せずに、消費者識別子データを安全に共有できます。消費者識別子データについて Operator Web Serbvice に直接クエリを実行するオプションもありますが、Snowflake の UID2 インテグレーションはより円滑な体験を提供します。 :::important -このドキュメントは、2025年2月に公開された広告主とデータプロバイダーをインテグレーションした Snowflake マーケットプレイスリスティングを使用する方を対象としています。以前のリスティング（広告主とデータプロバイダー向けに分かれていたもの、つまり2025年2月以前に登録された方）を使用している場合は、[Snowflake Integration (Pre-Feb 2025)](integration-snowflake-before-february-2025.md)を参照してください。以前の実装を使用している場合は、更新と機能強化を活用するために新しいバージョンへの移行を勧めます。詳細については、[Changes from Previous Version](#changes-from-previous-version)を参照してください。移行情報については、[Migration Guide](#migration-guide)を参照してください。 +このドキュメントは、2025年2月以前に公開された広告主とデータプロバイダー向けの別々の Snowflake marketplace を使用しているユーザー向けです。2025年2月に公開された新しいインテグレーションに関するドキュメントは、[Snowflake Integration Guide](integration-snowflake.md) を参照してください。以前の実装を使用している場合は、更新と強化を活用するために新しいバージョンに移行することを推奨します。移行情報は、[Migration Guide](integration-snowflake.md#migration-guide) を参照してください。 ::: ## Snowflake Marketplace Listing @@ -24,7 +24,7 @@ import Link from '@docusaurus/Link'; - [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) :::tip -広告主とデータプロバイダー向けのインテグレーションオプションとステップの概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md)を参照してください。 +広告主とデータプロバイダー向けのインテグレーションオプションとステップの概要は、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md)を参照してください。 ::: ## Functionality @@ -46,7 +46,7 @@ import Link from '@docusaurus/Link'; 2025年2月の UID2 Snowflake マーケットプレイスインテグレーションの更新には、いくつかの更新と機能強化が含まれています。主な変更点の一つは、以前の 2 つのデータ共有（広告主向けとデータプロバイダー向け）の機能を組み合わせた単一のリスティングとデータ共有が含まれることです。これにより、すべての参加者のインテグレーションが簡素化されます。 :::note -これらの変更は、2025年2月以前に公開されたSnowflake関数のバージョンを使用しているコードインテグレーションを想定しています（[nowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-february-2025.md)を参照）。`FN_T_UID2_IDENTITY_MAP_EMAIL` と `FN_T_UID2_IDENTITY_MAP_EMAIL_HASH` 関数を使用するさらに古いバージョンを使用している場合は、[Migration Guide section in the earlier guide](integration-snowflake-before-february-2025.md#migration-guide)の指示に従い、その後再度現在のバージョンにアップグレードすることもできます。ただし、このシナリオでは、このガイドの指示に従い、一度に更新することを勧めます。詳細については、[Migration Guide](#migration-guide)を参照してください。 +これらの変更は、2025年2月以前に公開されたSnowflake関数のバージョンを使用しているコードインテグレーションを想定しています（[nowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-before-february-2025.md)を参照）。`FN_T_UID2_IDENTITY_MAP_EMAIL` と `FN_T_UID2_IDENTITY_MAP_EMAIL_HASH` 関数を使用するさらに古いバージョンを使用している場合は、[Migration Guide section in the earlier guide](integration-snowflake-before-february-2025.md#migration-guide)の指示に従い、その後再度現在のバージョンにアップグレードすることもできます。ただし、このシナリオでは、このガイドの指示に従い、一度に更新することを勧めます。詳細は、[Migration Guide](#migration-guide)を参照してください。 ::: 以下の表は、以前のバージョンからのSnowflake関数の変更詳細を示しています。 @@ -94,7 +94,7 @@ UID2 Share へのアクセスをリクエストするには、以下の手順を 4. The Trade Desk の既存クライアントである場合は、データリクエストフォームの**Message** 欄にThe Trade Desk から発行されたパートナー ID と広告主 ID を記入します。 5. フォームを送信します。 -リクエストが受信された後、UID2 Administrator が適切なアクセス手順について連絡します。Snowflake でのデータリクエストの管理の詳細については、[Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html)を参照してください。 +リクエストが受信された後、UID2 Administrator が適切なアクセス手順について連絡します。Snowflake でのデータリクエストの管理の詳細は、[Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html)を参照してください。 ## Shared Objects @@ -116,7 +116,7 @@ UID2共有参加者向けに、以下の関数も利用可能です： - `FN_T_ENCRYPT`（[Encrypt Tokens](#encrypt-tokens)を参照） - `FN_T_DECRYPT`（[Decrypt Tokens](#decrypt-tokens)を参照） -詳細については、[Usage for UID2 Sharers](#usage-for-uid2-sharers)を参照してください。 +詳細は、[Usage for UID2 Sharers](#usage-for-uid2-sharers)を参照してください。 ### Database and Schema Names @@ -158,7 +158,7 @@ DII が電話番号の場合、UID2 の[Phone Number Normalization](../getting-s | :--- | :--- | :--- | | `UID` | TEXT | 値は以下のいずれかです：
  • DII が正常にマッピングされた場合： DII に関連付けられた UID2。
  • DII が正常にマッピングされなかった場合：`NULL`。
| | `BUCKET_ID` | TEXT | 値は以下のいずれかです：
  • DII が正常にマッピングされた場合：UID2 を生成するために使用されたソルトバケットの ID。この ID は `SALT_BUCKETS` ビューのバケット ID にマッピングされます。
  • DII が正常にマッピングされなかった場合：`NULL`。
| -| `UNMAPPED` | TEXT | 値は以下のいずれかです：
  • DII が正常にマッピングされた場合：`NULL`。
  • DII が正常にマッピングされなかった場合：識別子がマッピングされなかった理由：`OPTOUT`、`INVALID IDENTIFIER`、または`INVALID INPUT TYPE`。
    詳細については、[Values for the UNMAPPED Column](#values-for-the-unmapped-column)を参照してください。
| +| `UNMAPPED` | TEXT | 値は以下のいずれかです：
  • DII が正常にマッピングされた場合：`NULL`。
  • DII が正常にマッピングされなかった場合：識別子がマッピングされなかった理由：`OPTOUT`、`INVALID IDENTIFIER`、または`INVALID INPUT TYPE`。
    詳細は、[Values for the UNMAPPED Column](#values-for-the-unmapped-column)を参照してください。
| #### Values for the UNMAPPED Column @@ -403,7 +403,7 @@ select a.*, b.LAST_SALT_UPDATE_UTC クエリ結果： -以下の表は、応答の各項目を識別しています。結果には、テーブルのID 1の例に示すように、メール、`UID2`、`BUCKET_ID`、`LAST_UID2_UPDATE_UTC`、`LAST_SALT_UPDATE_UTC` が含まれます。ID 2 については、対応する UID2 が最後のバケット更新後に生成されたため、情報は返されません。ID 3 については、UID2 が欠落しているため、`NULL` 値が返されます。 +以下の表は、応答の各項目を識別しています。結果には、テーブルのID 1の例に示すように、メール、`UID2`、`BUCKET_ID`、`LAST_UID2_UPDATE_UTC`、`LAST_SALT_UPDATE_UTC` が含まれます。ID 2 は、対応する UID2 が最後のバケット更新後に生成されたため、情報は返されません。ID 3 は、UID2 が欠落しているため、`NULL` 値が返されます。 ``` +----+----------------------+----------------------------------------------+------------+-------------------------+-------------------------+ @@ -444,7 +444,7 @@ Raw UID2 を UID2 Token に暗号化するには、`FN_T_ENCRYPT` 関数を使 | Column Name | Data Type | Description | | :--- | :--- | :--- | | `UID_TOKEN` | TEXT | 値は以下のいずれかです：
  • 暗号化成功：Raw UID2を含むUID2 Token。
  • 暗号化失敗：`NULL`。
| -| `ENCRYPTION_STATUS` | TEXT | 値は以下のいずれかです：
  • 暗号化成功：`NULL`。
  • 暗号化失敗：Raw UID2が暗号化されなかった理由。例：`INVALID_RAW_UID2` や `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`。
    詳細については、[Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column)を参照してください。
| +| `ENCRYPTION_STATUS` | TEXT | 値は以下のいずれかです：
  • 暗号化成功：`NULL`。
  • 暗号化失敗：Raw UID2が暗号化されなかった理由。例：`INVALID_RAW_UID2` や `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`。
    詳細は、[Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column)を参照してください。
| #### Values for the ENCRYPTION_STATUS Column @@ -513,7 +513,7 @@ UID2 Token を Raw UID2 に復号化するには、`FN_T_DECRYPT` 関数を使 | :--- | :--- | :--- | | `UID` | TEXT | 値は以下のいずれかです：
  • 復号化成功：UID2 Token に対応する Raw UID2。
  • 復号化失敗：`NULL`。
| | `SITE_ID`| INT | 値は以下のいずれかです：
  • 復号化成功：トークンを暗号化した UID2 参加者の識別子。
  • 復号化失敗：`NULL`。
| -| `DECRYPTION_STATUS` | TEXT | 値は以下のいずれかです：
  • 復号化成功：`NULL`。
  • 復号化失敗：UID2 Token が復号化されなかった理由。例：`EXPIRED_TOKEN`。
    詳細については、[Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column)を参照してください。
| +| `DECRYPTION_STATUS` | TEXT | 値は以下のいずれかです：
  • 復号化成功：`NULL`。
  • 復号化失敗：UID2 Token が復号化されなかった理由。例：`EXPIRED_TOKEN`。
    詳細は、[Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column)を参照してください。
| :::note UID2 Tokenが正常に復号化できない状況のほとんどの場合、関数は行を一切返しません。 @@ -622,7 +622,7 @@ UID2 Token が期限切れになるのを防ぐため、送信者から利用可 ### Changing Existing Code -変更の概要については、[Changes from Previous Version](#changes-from-previous-version)を参照してください。このセクションのコードスニペットは、以前の関数がどのように実装されていたか、および新しい関数を使用するように更新する方法についての例です。 +変更の概要は、[Changes from Previous Version](#changes-from-previous-version)を参照してください。このセクションのコードスニペットは、以前の関数がどのように実装されていたか、および新しい関数を使用するように更新する方法についての例です。 #### Example for Mapping Unhashed Emails 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 2c21b0c57..0cea845a0 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 @@ -2,7 +2,7 @@ title: Snowflake Integration sidebar_label: Snowflake pagination_label: Snowflake Integration -description: UID2 Share in Snowflakeを通じたUID2とのインテグレーションに関する情報。 +description: Snowflake の UID2 Share を通じて UID2 とインテグレーションする方法に関する情報。 hide_table_of_contents: false sidebar_position: 04 displayed_sidebar: docs @@ -12,173 +12,169 @@ import Link from '@docusaurus/Link'; # Snowflake Integration Guide -:::note -このページには、近日中に翻訳される新しいコンテンツが含まれています。 -::: - -[Snowflake](https://www.snowflake.com/) is a cloud data warehousing solution, where you as a partner can store your data and integrate with the UID2 framework. Using Snowflake, UID2 enables you to securely share consumer identifier data without exposing sensitive directly identifying information (DII). Even though you have the option to query the Operator Web Services directly for the consumer identifier data, the Snowflake UID2 integration offers a more seamless experience. +[Snowflake](https://www.snowflake.com/) は、パートナーがデータを保存し、UID2 フレームワークとインテグレーションできるクラウドデータウェアハウジングソリューションです。Snowflake を使用することで、UID2 は、機密性の高い 直接識別情報 (DII) を公開することなく、消費者識別子データを安全に共有できます。オペレーター Web サービスを直接クエリして消費者識別子データを取得するオプションもありますが、Snowflake UID2 インテグレーションはよりシームレスなエクスペリエンスを提供します。 :::important -This document is for those using the latest [Snowflake marketplace listing](#snowflake-marketplace-listing). If you're using an earlier version, see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md). If you're using the earlier implementation, we recommend that you migrate to the newer version to take advantage of the updates and enhancements: for details, see [Changes from Previous Version](#changes-from-previous-version). For migration information, see [Migration Guide](#migration-guide). +このドキュメントは、最新の [Snowflake Marketplace listing](#snowflake-marketplace-listing) を使用している方を対象としています。以前のバージョンを使用している場合は、[Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md) を参照してください。以前の実装を使用している場合は、更新と強化を利用するために新しいバージョンへの移行を推奨します。詳細は、[Changes from Previous Version](#changes-from-previous-version) を参照してください。移行情報は、[Migration Guide](#migration-guide) を参照してください。 ::: ## Snowflake Marketplace Listing -The following listing for UID2 is available on the Snowflake marketplace: +以下の UID2 リスティングは、Snowflake Marketplace で利用できます: - [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) :::tip -For a summary of all integration options and steps for advertisers and data providers, see [Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md). + インテグレーションオプションとステップの概要は、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 ::: ## Functionality -The following table summarizes the functionality available with the UID2 Snowflake integration. +以下の表は、UID2 Snowflake インテグレーションで利用可能な機能をまとめたものです。 | 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 | | :--- | :--- | :--- | :--- | :--- | | ✅ | ✅ | —* | — | ✅ | -*You cannot use Snowflake to generate a UID2 token directly from DII. However, you can convert DII to a raw UID2, and then encrypt the raw UID2 into a UID2 token. +*Snowflake を使用して、DII から直接 UID2 Token を生成することはできません。ただし、DII を raw UID2 に変換し、その後 raw UID2 を UID2 Token に暗号化することはできます。 :::note -If you're a publisher who is sharing UID2 tokens in the bidstream, see [Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md). +パブリッシャーで、bidstream で UID2 Token を共有している場合は、[Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md) を参照してください。 ::: ## Changes from Previous Version -The July 2025 update to the UID2 Snowflake Marketplace integration introduces a new identity mapping function that simplifies UID2 refresh management and allows accessing previous raw UID2s for 90 days after rotation. +2025年7月の UID2 Snowflake Marketplace インテグレーションの更新では、UID2 のリフレッシュ管理を簡素化し、ローテーション後 90 日間の以前の raw UID2 にアクセスできる新しい ID マッピング関数が導入されました。 :::note -These changes assume that your code integration uses the version of Snowflake functions published before July 2025: see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md). For details on migrating to this version, see [Migration Guide](#migration-guide). +これらの変更は、コードインテグレーションが 2025 年 7 月以前に公開された Snowflake 関数のバージョンを使用していることを前提としています: [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md) を参照してください。このバージョンへの移行の詳細は、[Migration Guide](#migration-guide) を参照してください。 ::: The following table shows the differences between the old and new identity mapping functions. | Function | Version | Return Fields | Key Differences | Comments | | :-- | :-- | :-- | :-- | :-- | -| `FN_T_IDENTITY_MAP` | Previous | `UID`, `BUCKET_ID`, `UNMAPPED` | Basic identity mapping with salt bucket tracking | Legacy function using salt bucket monitoring for refresh management. For details, see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md).| -| `FN_T_IDENTITY_MAP_V3` | Current | `UID`, `PREV_UID`, `REFRESH_FROM`, `UNMAPPED` | Enhanced with previous UID2 access and refresh timestamps | Returns previous UID2 for 90 days after rotation and uses refresh timestamps instead of salt bucket monitoring. For details, see [Map DII](#map-dii).| +| `FN_T_IDENTITY_MAP` | 以前のバージョン | `UID`, `BUCKET_ID`, `UNMAPPED` | 基本的な ID マッピングとソルトバケットの追跡 | ソルトバケット監視を使用したレガシー関数。詳細は、[Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md) を参照してください。| +| `FN_T_IDENTITY_MAP_V3` | 現在 | `UID`, `PREV_UID`, `REFRESH_FROM`, `UNMAPPED` | 強化された以前の UID2 アクセスとリフレッシュタイムスタンプ | ローテーション後 90 日間の以前の UID2 を返し、ソルトバケット監視の代わりにリフレッシュタイムスタンプを使用します。詳細は、[Map DII](#map-dii) を参照してください。| ### Key Benefits -This update provides two major benefits: +このアップデートにより、以下の 2 つの主要な利点が提供されます: -- **Simplified Refresh Management**: You can monitor for UID2s reaching `REFRESH_FROM` timestamps instead of polling salt buckets for rotation. -- **Previous UID2 Access**: You have access to previous raw UID2s for 90 days after rotation for campaign measurement. +- **Simplified Refresh Management**: `REFRESH_FROM` タイムスタンプに達した UID2 を監視できるようになり、ローテーションのために Salt Bucket をポーリングする必要がなくなります。 +- **Previous UID2 Access**: ローテーション後 90 日間、以前の raw UID2 にアクセスできるようになり、キャンペーンの測定が可能になります。 ## Workflow Diagram -The following diagram and table illustrate the different parts of the UID2 integration process in Snowflake, and the workflow. +以下の図は、Snowflake における UID2 インテグレーションプロセスの異なる部分とワークフローをです。 ![Snowflake Integration Architecture](images/uid2-snowflake-integration-architecture-drawio.png) -|Partner Snowflake Account|UID2 Snowflake Account|UID2 Core Opt-Out Cloud Setup| +| Partner Snowflake Account | UID2 Snowflake Account | UID2 Core Opt-Out Cloud Setup | | :--- | :--- | :--- | -|As a partner, you set up a Snowflake account to host your data and engage in UID2 integration by consuming functions and views through the UID2 Share. | UID2 integration, hosted in a Snowflake account, grants you access to authorized functions and views that draw data from private tables. You can't access the private tables. The UID2 Share reveals only essential data needed for you to perform UID2-related tasks.
**NOTE**: We store salts and encryption keys in the private tables. No DII is stored at any point. |ETL (Extract Transform Load) jobs constantly update the UID2 Core/Optout Snowflake storage with internal data that powers the UID2 Operator Web Services. The data used by the Operator Web Services is also available through the UID2 Share. | -|When you use shared functions and views, you pay Snowflake for transactional computation costs. |These private tables, secured in the UID2 Snowflake account, automatically synchronize with the UID2 Core/Optout Snowflake storage that holds internal data used to complete UID2-related tasks. | | +| パートナーとして、データをホストし、UID2 インテグレーションに参加するための Snowflake アカウントをセットアップします。UID2 Share を通じて関数とビューを消費します。 | UID2 インテグレーションは、Snowflake アカウントでホストされ、UID2 関連のタスクを実行するために必要なデータのみを引き出す認可された関数とビューへのアクセスを提供します。プライベートテーブルにはアクセスできません。UID2 Share は、UID2 関連のタスクを実行するために必要な基本的なデータのみを公開します。
**Note**: Salt と暗号化キーはプライベートテーブルに保存されています。DII はどの時点でも保存されません。 | ETL (Extract Transform Load) ジョブは、UID2 Core/Optout Snowflake ストレージを常に更新し、UID2 Operator Web サービスを動かす内部データを提供します。Operator Web サービスで使用されるデータは、UID2 Share を通じても利用可能です。 | +| 共有関数とビューを使用すると、トランザクションコンピューティングコストを Snowflake に支払います。 | これらのプライベートテーブルは、UID2 Snowflake アカウントで保護され、UID2 関連のタスクを完了するために使用される内部データを保持する UID2 Core/Optout Snowflake ストレージと自動的に同期します。 | | ## Access the UID2 Share -Access to the UID2 Share is available through the following listing on the [Snowflake Data Marketplace](https://www.snowflake.com/data-marketplace/): +UID2 Share へのアクセスは、[Snowflake Data Marketplace](https://www.snowflake.com/data-marketplace/) の以下のリスティングを通じて利用可能です: - [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) :::important -To be able to request data, you must use the `ACCOUNTADMIN` role or another role with the `CREATE DATABASE` and `IMPORT SHARE` privileges in your Snowflake account. +データのリクエストを行うには、`ACCOUNTADMIN` ロールまたは Snowflake アカウントで `CREATE DATABASE` および `IMPORT SHARE` 権限を持つ他のロールを使用する必要があります。 ::: -To request access to the UID2 Share, complete the following steps: +UID2 Share へのアクセスをリクエストするには、以下の手順を完了します: -1. Log in to the Snowflake Data Marketplace and select the UID2 listing: +1. Snowflake Data Marketplace にログインし、UID2 リスティングを選択します: - [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution) -2. In the **Personalized Data** section, click **Request Data**. -3. Follow the onscreen instructions to verify and provide your contact details and other required information. -4. If you are an existing client of The Trade Desk, include your partner and advertiser IDs issued by The Trade Desk in the **Message** field of the data request form. -5. Submit the form. +2. **Personalized Data** セクションで、**Request Data** をクリックします。 +3. 画面の指示に従って、連絡先の詳細やその他の必要な情報を確認して提供します。 +4. The Trade Desk の既存のクライアントである場合は、データリクエストフォームの **Message** フィールドに The Trade Desk によって発行されたパートナーおよび広告主 ID を含めてください。 +5. フォームを送信します。 -After your request is received, a UID2 administrator will contact you with the appropriate access instructions. For details about managing data requests in Snowflake, see the [Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html). +リクエストが受信されると、UID2 Administrator が適切なアクセス手順について連絡します。Snowflake でのデータリクエストの管理に関する詳細は、[Snowflake documentation](https://docs.snowflake.com/en/user-guide/data-marketplace-consumer.html)を参照してください。 ## Shared Objects -You can map DII to UID2s by using the following function: +DII を UID2 にマッピングするには、以下の関数を使用します: -- `FN_T_IDENTITY_MAP_V3` (for details, see [Map DII](#map-dii)) +- `FN_T_IDENTITY_MAP_V3` (詳細は[Map DII](#map-dii)を参照してください) -The following function is deprecated in favor of `FN_T_IDENTITY_MAP_V3`. You can still use it if you are on the previous Snowflake version (see [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md)), but we recommend upgrading as soon as possible: +以下の関数は `FN_T_IDENTITY_MAP_V3` に置き換えられ、非推奨となっています。以前の Snowflake バージョンを使用している場合は引き続き使用できますが、できるだけ早くアップグレードすることをお勧めします（詳細は [Snowflake Integration Guide (Pre-July 2025)](integration-snowflake-previous.md) を参照してください）: - `FN_T_IDENTITY_MAP` (deprecated) :::note -If you are using the deprecated function, and need help migrating to the newer function, see [Migration Guide](#migration-guide). +非推奨の関数を使用していて、新しい関数への移行についてのヘルプが必要な場合は、[Migration Guide](#migration-guide)を参照してください。 ::: -To identify the UID2s that you must regenerate, monitor the `REFRESH_FROM` timestamps returned by the `FN_T_IDENTITY_MAP_V3` function. For details, see [Monitor Raw UID2 Refresh and Regenerate Raw UID2s](#monitor-raw-uid2-refresh-and-regenerate-raw-uid2s). +再生成が必要な UID2 を特定するには、`FN_T_IDENTITY_MAP_V3` 関数から返される `REFRESH_FROM` タイムスタンプを監視します。詳細は [Monitor Raw UID2 Refresh and Regenerate Raw UID2s](#monitor-raw-uid2-refresh-and-regenerate-raw-uid2s) を参照してください。 -The following functions are also available, for UID2 sharing participants: +以下の関数は、UID2 Share 参加者向けに利用可能です: - `FN_T_ENCRYPT` (See [Encrypt Tokens](#encrypt-tokens)) - `FN_T_DECRYPT` (See [Decrypt Tokens](#decrypt-tokens)) -For details, see [Usage for UID2 Sharers](#usage-for-uid2-sharers). +詳細は、[Usage for UID2 Sharers](#usage-for-uid2-sharers)を参照してください。 ### Database and Schema Names -The following sections include query examples for each solution, which are identical except for the database and schema name variables: +以下のセクションは、各ソリューションのクエリ例を含みます。これらは、データベース名とスキーマ名の変数を除いて同一です: ``` {DATABASE_NAME}.{SCHEMA_NAME} ``` -For example: +例: ```sql select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table({DATABASE_NAME}.{SCHEMA_NAME}.FN_T_IDENTITY_MAP_V3('validate@example.com', 'email')); ``` -All query examples use the following default values for each name variable: +すべてのクエリ例は、各名前変数に対して以下のデフォルト値を使用します: -| Variable | Default Value | Comments | -|:------------------|:-------------------|:------------------------------------------------------------------------------------------------------------------------------------------| -| `{DATABASE_NAME}` | `UID2_PROD_UID_SH` | If needed, you can change the default database name when creating a new database after you are granted access to the selected UID2 Share. | -| `{SCHEMA_NAME}` | `UID` | This is an immutable name. | +| Variable | Default Value | Comments | +| :--- | :--- | :--- | +| `{DATABASE_NAME}` | `UID2_PROD_UID_SH` | 必要に応じて、選択した UID2 Share へのアクセスが付与された後に新しいデータベースを作成する際に、デフォルトのデータベース名を変更できます。 | +| `{SCHEMA_NAME}` | `UID` | これは変更できません。 | ### Map DII -To map all types of DII, use the `FN_T_IDENTITY_MAP_V3` function. +すべての種類の DII をマッピングするには、`FN_T_IDENTITY_MAP_V3` 関数を使用します。 -If the DII is an email address, the service normalizes the data using the UID2 [Email Address Normalization](../getting-started/gs-normalization-encoding.md#email-address-normalization) rules. +DII がメールアドレスの場合、サービスは UID2 [Email Address Normalization](../getting-started/gs-normalization-encoding.md#email-address-normalization) ルールを使用してデータを正規化します。 -If the DII is a phone number, you must normalize it before sending it to the service, using the UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) rules. +DII が電話番号の場合、UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) ルールを使用して、サービスに送信する前に正規化する必要があります。 -| Argument | Data Type | Description | -|:-------------|:-------------|:--------------------------------------------------------------------------------------------| -| `INPUT` | varchar(256) | The DII to map to the UID2, refresh timestamp and previous UID2 for 90 days after rotation. | -| `INPUT_TYPE` | varchar(256) | The type of DII to map. Allowed values: `email`, `email_hash`, `phone`, and `phone_hash`. | +| Argument | Data Type | Description | +| :--- | :--- | :--- | +| `INPUT` | varchar(256) | UID2 にマップする DII、リフレッシュ タイムスタンプ、およびローテーション後 90 日間の前の UID2。 | +| `INPUT_TYPE` | varchar(256) | マップする DII のタイプ。許可される値: `email`、`email_hash`、`phone`、 `phone_hash`。 | -A successful query returns the following information for the specified DII. +指定した DII に対して、成功したクエリは以下の情報を返します。 -| Column Name | Data Type | Description | -|:---------------|:----------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `UID` | TEXT | The value is one of the following:
  • DII was successfully mapped: The UID2 associated with the DII.
  • DII was not successfully mapped: `NULL`.
| -| `PREV_UID` | TEXT | The value is one of the following:
  • DII was successfully mapped and a previous UID2 exists: The previous UID2 for this DII. Previous UID2s are available for 90 days after rotation.
  • No previous UID2 exists or DII was not successfully mapped: `NULL`.
| -| `REFRESH_FROM` | TIMESTAMP | The value is one of the following:
  • DII was successfully mapped: The timestamp (in epoch seconds) indicating when this UID2 should be refreshed.
  • DII was not successfully mapped: `NULL`.
| -| `UNMAPPED` | TEXT | The value is one of the following:
  • DII was successfully mapped: `NULL`.
  • DII was not successfully mapped: The reason why the identifier was not mapped: `OPTOUT`, `INVALID IDENTIFIER`, or `INVALID INPUT TYPE`.
    For details, see [Values for the UNMAPPED Column](#values-for-the-unmapped-column).
| +| Column Name | Data Type | Description | +| :--- | :--- | :--- | +| `UID` | TEXT | 値は次のいずれかです:
  • DII が正常にマッピングされた: DII に関連付けられた UID2。
  • DII が正常にマッピングされなかった: `NULL`。
| +| `PREV_UID` | TEXT | 値は次のいずれかです:
  • DII が正常にマッピングされ、以前の UID2 が存在する: この DII の以前の UID2。以前の UID2 はローテーション後 90 日間利用可能です。
  • 以前の UID2 が存在しないか、DII が正常にマッピングされなかった: `NULL`。
| +| `REFRESH_FROM` | TIMESTAMP | 値は次のいずれかです:
  • DII が正常にマッピングされた: この UID2 を更新する必要がある時刻 (エポック秒) を示します。
  • DII が正常にマッピングされなかった: `NULL`。
| +| `UNMAPPED` | TEXT | 値は次のいずれかです:
  • DII が正常にマッピングされた: `NULL`。
  • DII が正常にマッピングされなかった: 識別子がマッピングされなかった理由: `OPTOUT`、`INVALID IDENTIFIER`、または `INVALID INPUT TYPE`。
    詳細は、[UNMAPPED 列の値](#values-for-the-unmapped-column)を参照してください。
| #### Values for the UNMAPPED Column -The following table shows possible values for the `UNMAPPED` column. +以下の表は、`UNMAPPED` 列の可能な値です。 | Value | Meaning | | :-- | :-- | -| `NULL` | The DII was successfully mapped. | -| `OPTOUT` | The user has opted out. | -| `INVALID IDENTIFIER` | The email address or phone number is invalid. | -| `INVALID INPUT TYPE` | The value of `INPUT_TYPE` is invalid. Valid values for INPUT_TYPE are: `email`, `email_hash`, `phone`, `phone_hash`. | +| `NULL` | DII が正常にマッピングされまし。 | +| `OPTOUT` | ユーザーがオプトアウトしています。 | +| `INVALID IDENTIFIER` | メールアドレスまたは電話番号が無効です。 | +| `INVALID INPUT_TYPE` | `INPUT_TYPE` の値が無効です。`INPUT_TYPE` の有効な値は、`email`、`email_hash`、`phone`、`phone_hash` です。 | #### Examples -Mapping request examples in this section: +以下はマッピングリクエストの例です: - [Single Unhashed Email](#mapping-request-example---single-unhashed-email) - [Multiple Unhashed Emails](#mapping-request-example---multiple-unhashed-emails) @@ -190,18 +186,18 @@ Mapping request examples in this section: - [Multiple Hashed Phone Numbers](#mapping-request-example---multiple-hashed-phone-numbers) :::note -The input and output data in these examples is fictitious, for illustrative purposes only. The values provided are not real values. +これらの例の入力および出力データは架空のものであり、説明を目的としています。提供されている値は実際の値ではありません。 ::: #### Mapping Request Example - Single Unhashed Email -The following query illustrates how to map a single email address, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一のメールアドレスをマッピングする方法です。 ```sql select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_T_IDENTITY_MAP_V3('validate@example.com', 'email')); ``` -Query results for a single email: +単一のメールアドレスのクエリ結果は以下の通りです: ``` +----------------------------------------------+--------------------------------------------------+--------------+----------+ @@ -213,7 +209,7 @@ Query results for a single email: #### Mapping Request Example - Multiple Unhashed Emails -The following query illustrates how to map multiple email addresses, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数のメールアドレスをマッピングする方法です。 ```sql select a.ID, a.EMAIL, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENCE a LEFT JOIN( @@ -221,9 +217,9 @@ select a.ID, a.EMAIL, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENC on a.ID=m.ID; ``` -Query results for multiple emails: +複数のメールアドレスのクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` or improperly formatted emails. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式のメールアドレスに対する `NULL` 値を含みます。 ``` +----+----------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+ @@ -239,15 +235,15 @@ The following table identifies each item in the response, including `NULL` value #### Mapping Request Example - Single Unhashed Phone Number -The following query illustrates how to map a phone number, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一の電話番号をマッピングする方法です。 -You must normalize phone numbers using the UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) rules. +電話番号は、UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) ルールを使用して正規化する必要があります。 ```sql select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_T_IDENTITY_MAP_V3('+12345678901', 'phone')); ``` -Query results for a single phone number: +単一の電話番号のクエリ結果は以下の通りです: ``` +----------------------------------------------+----------+--------------+----------+ @@ -259,9 +255,9 @@ Query results for a single phone number: #### Mapping Request Example - Multiple Unhashed Phone Numbers -The following query illustrates how to map multiple phone numbers, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数の電話番号をマッピングする方法です。 -You must normalize phone numbers using the UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) rules. +電話番号は、UID2 [Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) ルールを使用して正規化する必要があります。 ```sql select a.ID, a.PHONE, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENCE a LEFT JOIN( @@ -269,9 +265,9 @@ select a.ID, a.PHONE, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENC on a.ID=m.ID; ``` -Query results for multiple phone numbers: +複数の電話番号のクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` or invalid phone numbers. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式の電話番号に対する `NULL` 値を含みます。 ``` +----+--------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+ @@ -287,13 +283,13 @@ The following table identifies each item in the response, including `NULL` value #### Mapping Request Example - Single Hashed Email -The following query illustrates how to map a single email address hash, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一のメールアドレスハッシュをマッピングする方法です。 ```sql select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_T_IDENTITY_MAP_V3(BASE64_ENCODE(SHA2_BINARY('validate@example.com', 256)), 'email_hash')); ``` -Query results for a single hashed email: +単一のメールアドレスハッシュのクエリ結果は以下の通りです: ``` +----------------------------------------------+----------------------------------------------+--------------+----------+ @@ -305,7 +301,7 @@ Query results for a single hashed email: #### Mapping Request Example - Multiple Hashed Emails -The following query illustrates how to map multiple email address hashes, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数のメールアドレスハッシュをマッピングする方法をです ```sql select a.ID, a.EMAIL_HASH, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENCE a LEFT JOIN( @@ -313,9 +309,9 @@ select a.ID, a.EMAIL_HASH, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AU on a.ID=m.ID; ``` -Query results for multiple hashed emails: +複数のメールアドレスハッシュのクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` hashes. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式のメールアドレスハッシュに対する `NULL` 値を含みます。 ``` +----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+ @@ -330,13 +326,13 @@ The following table identifies each item in the response, including `NULL` value #### Mapping Request Example - Single Hashed Phone Number -The following query illustrates how to map a single phone number hash, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一の電話番号ハッシュをマッピングする方法です。 ```sql select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table(UID2_PROD_UID_SH.UID.FN_T_IDENTITY_MAP_V3(BASE64_ENCODE(SHA2_BINARY('+12345678901', 256)), 'phone_hash')); ``` -Query results for a single hashed phone number: +単一の電話番号ハッシュのクエリ結果は以下の通りです: ``` +----------------------------------------------+----------------------------------------------+--------------+----------+ @@ -348,7 +344,7 @@ Query results for a single hashed phone number: #### Mapping Request Example - Multiple Hashed Phone Numbers -The following query illustrates how to map multiple phone number hashes, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数の電話番号ハッシュをマッピングする方法です。 ```sql select a.ID, a.PHONE_HASH, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AUDIENCE a LEFT JOIN( @@ -356,9 +352,9 @@ select a.ID, a.PHONE_HASH, m.UID, m.PREV_UID, m.REFRESH_FROM, m.UNMAPPED from AU on a.ID=m.ID; ``` -Query results for multiple hashed phone numbers: +複数の電話番号ハッシュのクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` hashes. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式の電話番号ハッシュに対する `NULL` 値を含みます。 ``` +----+----------------------------------------------+----------------------------------------------+----------------------------------------------+--------------+--------------------+ @@ -373,20 +369,20 @@ The following table identifies each item in the response, including `NULL` value ### Monitor Raw UID2 Refresh and Regenerate Raw UID2s -The `FN_T_IDENTITY_MAP_V3` function returns refresh timestamps (`REFRESH_FROM`) that indicate when each UID2 should be refreshed. +`FN_T_IDENTITY_MAP_V3` 関数は、各 UID2 をリフレッシュする必要がある時刻を示すリフレッシュタイムスタンプ (`REFRESH_FROM`) を返します。 -To determine which UID2s need regeneration, compare the current time to the `REFRESH_FROM` timestamps returned by the function. +UID2 のリフレッシュが必要なものを特定するには、関数から返された `REFRESH_FROM` タイムスタンプを現在の時刻と比較します。 -| Column Name | Data Type | Description | -|:------------------|:--------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `UID` | TEXT | The UID2 associated with the DII. This is the current UID2 value returned by the identity mapping function. | -| `REFRESH_FROM` | TIMESTAMP | The timestamp (in epoch seconds) indicating when this UID2 should be refreshed. Compare this value to the current time to determine if regeneration is needed. | +| Column Name | Data Type | Description | +| :--- | :--- | :--- | +| `UID` | TEXT | UID2 に関連付けられた DII です。これは、アイデンティティマッピング関数によって返された現在の UID2 値です。 | +| `REFRESH_FROM` | TIMESTAMP | この UID2 をリフレッシュする必要がある時刻を示すタイムスタンプ (エポック秒) です。この値を現在の時刻と比較して、再生成が必要かどうかを判断します。 | -The following example shows an input table and the query used to find the UID2s in the table that must be regenerated because their refresh time has been reached. +以下の例は、入力テーブルと、リフレッシュ時間が到達したために再生成する必要がある UID2 をテーブル内で見つけるために使用されるクエリです。 #### Targeted Input Table -In this example scenario, the advertiser/data provider has stored the UID2s in a table named `AUDIENCE_WITH_UID2`. The `REFRESH_FROM` column contains the timestamp when each UID2 should be refreshed. If no UID2 has been generated, the value is `NULL`, as shown in the third example. The advertiser/data provider can compare these timestamps to the current time to determine which UID2s need to be regenerated. +この例では、広告主/データプロバイダーは、`AUDIENCE_WITH_UID2` という名前のテーブルに UID2 を保存しています。`REFRESH_FROM` 列には、各 UID2 をリフレッシュする必要があるタイムスタンプが含まれています。UID2 が生成されていない場合、値は `NULL` です（3 番目の例を参照）。広告主/データプロバイダーは、これらのタイムスタンプを現在の時刻と比較して、どの UID2 を再生成する必要があるかを判断できます。 ```sql select * from AUDIENCE_WITH_UID2; @@ -401,16 +397,16 @@ select * from AUDIENCE_WITH_UID2; +----+----------------------+----------------------------------------------+--------------+ ``` -To find missing or outdated UID2s, use the following query example. +欠落または期限切れの UID2 を見つけるには、次のクエリ例を使用します。 ```sql select * from AUDIENCE_WITH_UID2 where REFRESH_FROM <= DATE_PART(epoch_second, CURRENT_TIMESTAMP()) or UID2 IS NULL; ``` -Query results: +クエリの結果: -The following table identifies each item in the response. The result includes UID2s that need to be refreshed because their `REFRESH_FROM` timestamp has passed, or UID2s that are missing. ID 1 is returned because its refresh time (1735689600) is in the past (assuming current time is later). ID 2 is not returned because its refresh time hasn't been reached yet. ID 3 is returned due to a missing UID2. +次の表は、レスポンス内の各アイテムを特定します。結果には、`REFRESH_FROM` タイムスタンプが経過したためにリフレッシュが必要な UID2 または欠落している UID2 が含まれます。ID 1 は、そのリフレッシュ時間 (1735689600) が過去にあるため返されます (現在の時間がそれ以降であると仮定)。ID 2 は、そのリフレッシュ時間がまだ到達していないため返されません。ID 3 は、UID2 が欠落しているため返されます。 ``` +----+----------------------+----------------------------------------------+--------------+ @@ -423,58 +419,58 @@ The following table identifies each item in the response. The result includes UI ## Usage for UID2 Sharers -A UID2 sharing participant is a company that takes part in sharing, either as a sender or a receiver, to share UID2s with another participant. +UID2 sharing participant は、送信者または受信者として共有に参加し、他の参加者と UID2 を共有する組織です。 -Advertisers and data providers can share UID2s with other authorized UID2 sharing participants via Snowflake (tokenized sharing). They can encrypt [raw UID2s](../ref-info/glossary-uid#gl-raw-uid2) into UID2 tokens and then send them to another participant for sharing in pixels (see [Tokenized Sharing in Pixels](../sharing/sharing-tokenized-from-data-pixel.md)). If you are not sending data in pixels within Snowflake, you can take part in UID2 sharing as long as you follow the requirements laid out in [Security Requirements for UID2 Sharing](../sharing/sharing-security.md). +広告主とデータプロバイダーは、Snowflake (tokenized sharing)を介して、他の承認された UID2 共有参加者と UID2 を共有できます。彼らは [raw UID2s](../ref-info/glossary-uid#gl-raw-uid2) を UID2 Token に暗号化し、ピクセルで共有するために別の参加者に送信できます (詳細は [Tokenized Sharing in Pixels](../sharing/sharing-tokenized-from-data-pixel.md) を参照してください)。Snowflake 内でピクセルでデータを送信していない場合でも、[Security Requirements for UID2 Sharing](../sharing/sharing-security.md) に記載されている要件に従う限り、UID2 共有に参加できます。 :::caution -The UID2 token generated during this process is for sharing only—you cannot use it in the bidstream. There is a different workflow for generating tokens for the bidstream: see [Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md). +このプロセスで生成された UID2 Token は共有用であり、ビッドストリームでは使用できません。ビッドストリーム用のトークンを生成するための別のワークフローがあります: [Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md) を参照してください。 ::: -If you are not sending data in pixels or in the bidstream within Snowflake, you can also take part in raw UID2 sharing as long as you follow the requirements laid out in [Security Requirements for UID2 Sharing](../sharing/sharing-security.md). +Snowflake でピクセルやビッドストリームでデータを送信していない場合でも、[Security Requirements for UID2 Sharing](../sharing/sharing-security.md) に記載されている要件に従う限り、UID2 共有に参加できます。 -The following activities support tokenized sharing: +以下の機能は、トークン化された共有をサポートしています: - [Encrypt Tokens](#encrypt-tokens) - [Decrypt Tokens](#decrypt-tokens) ### Encrypt Tokens -To encrypt raw UID2s to UID2 tokens, use the `FN_T_ENCRYPT` function. +raw UID2 を UID2 Token に暗号化するには、`FN_T_ENCRYPT` 関数を使用します。 -|Argument|Data Type|Description| +| Argument | Data Type | Description | | :--- | :--- | :--- | -| `RAW_UID2` | varchar(128) | The raw UID2 to encrypt to a UID2 token. | +| `RAW_UID2` | varchar(128) | UID2 Token に暗号化する raw UID2 | -A successful query returns the following information for the specified raw UID2. +クエリが成功すると、指定された raw UID2 に対して以下の情報が返されます。 -|Column Name|Data Type|Description| +| Column Name | Data Type | Description | | :--- | :--- | :--- | -| `UID_TOKEN` | TEXT | The value is one of the following:
  • Encryption successful: The UID2 token containing the raw UID2.
  • Encryption not successful: `NULL`.
| -| `ENCRYPTION_STATUS` | TEXT | The value is one of the following:
  • Encryption successful: `NULL`.
  • Encryption not successful: The reason why the raw UID2 was not encrypted. For example: `INVALID_RAW_UID2` or `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`.
    For details, see [Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column).
| +| `UID_TOKEN` | TEXT | 値は以下のいずれか:
  • Encryption successful: raw UID2 を含む UID2 Token
  • Encryption not successful: `NULL`
| +| `ENCRYPTION_STATUS` | TEXT | 値は以下のいずれか:
  • Encryption successful: `NULL`.
  • Encryption not successful: raw UID2 が暗号化されなかった理由。例えば: `INVALID_RAW_UID2` または `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`.
    詳細は、[Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column) を参照してください。
| #### Values for the ENCRYPTION_STATUS Column -The following table shows possible values for the `ENCRYPTION_STATUS` column. +以下の表は、`ENCRYPTION_STATUS` 列の可能な値を示しています。 | Value | Meaning | | :-- | :-- | -| `NULL` | The raw UID2 was successfully encrypted. | -| `MISSING_OR_INVALID_RAW_UID2` | The raw UID2 is `NULL`. | -| `INVALID_RAW_UID2` | The raw UID2 is invalid. | -| `MISMATCHING_IDENTITY_SCOPE` | The raw UID2 belongs to an incorrect identity scope; for example, EUID is passed in where UID2 is expected. | -| `NOT_AUTHORIZED_FOR_MASTER_KEY` | The caller does not have access to the required encryption keys. Contact the UID2 administrator. | -| `NOT_AUTHORIZED_FOR_SITE_KEY` | The caller does not have access to the required encryption keys. Contact the UID2 administrator. | +| `NULL` | raw UID2 が正常に暗号化されました。 | +| `MISSING_OR_INVALID_RAW_UID2` | raw UID2 が `NULL` です。 | +| `INVALID_RAW_UID2` | raw UID2 が無効です。 | +| `MISMATCHING_IDENTITY_SCOPE` | raw UID2 が不正なアイデンティティスコープに属しています。たとえば、UID2 が期待される場所に EUID が渡されます。 | +| `NOT_AUTHORIZED_FOR_MASTER_KEY` | 呼び出し元が必要な暗号化キーにアクセスできません。UID2 管理者にお問い合わせください。 | +| `NOT_AUTHORIZED_FOR_SITE_KEY` | 呼び出し元が必要な暗号化キーにアクセスできません。UID2 管理者にお問い合わせください。 | #### Encrypt Token Request Example - Single Raw UID2 -The following query illustrates how to encrypt a single raw UID2 to a UID2 token, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一の raw UID2 を UID2 Token に暗号化する方法です。 ```sql select UID_TOKEN, ENCRYPTION_STATUS from table(UID2_PROD_UID_SH.UID.FN_T_ENCRYPT('2ODl112/VS3x2vL+kG1439nPb7XNngLvOWiZGaMhdcU=')); ``` -Query results for a single raw UID2: +単一の raw UID2 のクエリ結果は以下の通りです: ``` +------------------------+-------------------+ @@ -486,15 +482,15 @@ Query results for a single raw UID2: #### Encrypt Token Request Example - Multiple Raw UID2s -The following query illustrates how to encrypt multiple raw UID2s, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数の raw UID2 を UID2 Token に暗号化する方法です。 ```sql select a.RAW_UID2, t.UID_TOKEN, t.ENCRYPTION_STATUS from AUDIENCE_WITH_UID2 a, lateral UID2_PROD_UID_SH.UID.FN_T_ENCRYPT(a.RAW_UID2) t; ``` -Query results for multiple raw UID2s: +複数の raw UID2 のクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` raw UID2s. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式の電話番号ハッシュに対する `NULL` 値を含みます。 ``` +----+----------------------------------------------+-----------------------+-----------------------------+ @@ -508,42 +504,42 @@ The following table identifies each item in the response, including `NULL` value ### Decrypt Tokens -To decrypt UID2 tokens to raw UID2s, use the `FN_T_DECRYPT` function. +UID2 Token を raw UID2 に復号化するには、`FN_T_DECRYPT` 関数を使用します。 -| Argument | Data Type | Description | -|:------------|:-------------|:-----------------------------------------| -| `UID_TOKEN` | varchar(512) | The UID2 token to decrypt to a raw UID2. | +| Argument | Data Type | Description | +|:-----------|:-------------|:-----------------------------------------| +| `UID_TOKEN`| varchar(512) | raw UID2 に復号化する UID2 Token です。 | -A successful query returns the following information for the specified UID2 token. +クエリが成功すると、指定された UID2 Token に対して以下の情報が返されます。 -| Column Name |Data Type|Description| -|:--------------------| :--- | :--- | -| `UID` | TEXT | The value is one of the following: | -| `SITE_ID` | INT | The value is one of the following: | -| `DECRYPTION_STATUS` | TEXT | The value is one of the following: | +| Column Name | Data Type | Description| +| :--- | :--- | :--- | +| `UID` | TEXT | 以下の値のいずれか: | +| `SITE_ID` | INT | 以下の値のいずれか: | +| `DECRYPTION_STATUS` | TEXT | 以下の値のいずれか: | :::note -In most circumstances where UID2 token cannot be successfully decrypted, the function will not return any rows at all. +UID2 Token が復号化できない場合、関数は通常、行を返しません。 ::: #### Values for the DECRYPTION_STATUS Column -Possible values for `DECRYPTION_STATUS` are: +`DECRYPTION_STATUS` の可能な値は以下の通りです: -| Value | Meaning | -| :-------------- | :---------------------------------------------------------------------------- | -| `NULL` | The UID2 token was successfully decrypted. | -| `EXPIRED_TOKEN` | The UID2 token is beyond its designated lifetime—the token has expired. | +| Value | Meaning | +| :--- | :--- | +| `NULL` | UID2 Token は復号化されました。| +| `EXPIRED_TOKEN` | UID2 Token は指定された有効期限を超えています。| #### Decrypt Token Request Example—Single UID2 Token -The following query illustrates how to decrypt a single UID2 token to a raw UID2, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、単一の UID2 Token を raw UID2 に復号化する方法です。 ```sql select UID, SITE_ID, DECRYPTION_STATUS from table(UID2_PROD_UID_SH.UID.FN_T_DECRYPT('A41234')); ``` -Query results for a single UID2 token: +単一の UID2 Token のクエリ結果は以下の通りです: ``` +----------------------------------------------+-------------------+ @@ -555,7 +551,7 @@ Query results for a single UID2 token: #### Decrypt Token Request Example—Multiple UID2 Tokens -The following query illustrates how to decrypt multiple UID2 tokens, using the [default database and schema names](#database-and-schema-names). +以下のクエリは、[default database and schema names](#database-and-schema-names)を使用して、複数の UID2 Token を raw UID2 に復号化する方法です。 ```sql select a.ID, b.UID, b.SITE_ID, CASE WHEN b.UID IS NULL THEN 'DECRYPT_FAILED' ELSE b.DECRYPTION_STATUS END as DECRYPTION_STATUS @@ -564,9 +560,9 @@ select a.ID, b.UID, b.SITE_ID, CASE WHEN b.UID IS NULL THEN 'DECRYPT_FAILED' ELS on a.ID=b.ID; ``` -Query results for multiple UID2 tokens: +複数の UID2 Token のクエリ結果は以下の通りです: -The following table identifies each item in the response, including `NULL` values for `NULL` and expired UID2 tokens. +以下の表は、レスポンス内の各項目を識別し、`NULL` または不正な形式の電話番号ハッシュに対する `NULL` 値を含みます。 ``` +----+----------------------------------------------+----------+-------------------+ @@ -582,28 +578,28 @@ The following table identifies each item in the response, including `NULL` value ### UID2 Sharing Example -The following instructions provide an example of how sharing works for a sender and a receiver both using Snowflake. In this example scenario an advertiser (the sender) has an audience table with raw UID2s -(`AUDIENCE_WITH_UID2S`) and wants to make data in the table available to a data provider (the receiver) using the [Snowflake Secure Data Sharing](https://docs.snowflake.com/en/user-guide/data-sharing-intro) feature. +以下の手順は、Snowflake を使用する送信者と受信者の両方の共有方法の例を示しています。この例では、広告主 (送信者) が raw UID2s を含むオーディエンステーブル (`AUDIENCE_WITH_UID2S`) を持ち、データプロバイダー (受信者) にテーブル内のデータを [Snowflake Secure Data Sharing](https://docs.snowflake.com/en/user-guide/data-sharing-intro) 機能を使用して利用可能にしたいと考えています。 + #### Sender Instructions - 1. Create a new table named `AUDIENCE_WITH_UID2_TOKENS`. - 2. Encrypt the raw UID2s in the `AUDIENCE_WITH_UID2S` table and store the result in the `AUDIENCE_WITH_UID2_TOKENS` table. For example, the following query could help achieve this task: + 1. `AUDIENCE_WITH_UID2_TOKENS` テーブルを作成します。 + 2. `AUDIENCE_WITH_UID2S` テーブル内の raw UID2s を暗号化し、結果を `AUDIENCE_WITH_UID2_TOKENS` テーブルに保存します。次のクエリは、このタスクを達成するのに役立ちます: ```sql insert into AUDIENCE_WITH_UID2_TOKENS select a.ID, t.UID_TOKEN from AUDIENCE_WITH_UID2S a, lateral UID2_PROD_UID_SH.UID.FN_T_ENCRYPT(a.RAW_UID2) t; ``` - 3. Create a secure share and grant it access to the `AUDIENCE_WITH_UID2_TOKENS` table. - 4. Grant the receiver access to the secure share. + 3. セキュアな共有を作成し、`AUDIENCE_WITH_UID2_TOKENS` テーブルへのアクセスを許可します。 + 4. 受信者にセキュアな共有へのアクセスを許可します。 :::warning -To help prevent UID2 tokens from expiring during sharing, send the newly encrypted UID2 tokens to the receiver as soon as possible. +UID2 Token が共有中に期限切れにならないようにするために、暗号化された UID2 Token をできるだけ早く受信者に送信してください。 ::: #### Receiver Instructions - 1. Create a database from the secure share that the sender provided access to. - 2. Create a new table named `RECEIVED_AUDIENCE_WITH_UID2`. - 3. Decrypt tokens from the shared `AUDIENCE_WITH_UID2_TOKENS` table and store the result in the `RECEIVED_AUDIENCE_WITH_UID2` table. For example, the following query could be used to achieve this: + 1. 送信者が提供したセキュアな共有からデータベースを作成します。 + 2. `RECEIVED_AUDIENCE_WITH_UID2` という新しいテーブルを作成します。 + 3. 共有された `AUDIENCE_WITH_UID2_TOKENS` テーブルからトークンを復号化し、その結果を `RECEIVED_AUDIENCE_WITH_UID2` テーブルに保存します。次のクエリは、このタスクを達成するのに役立ちます: ```sql insert into RECEIVED_AUDIENCE_WITH_UID2 select a.ID, b.UID, CASE WHEN b.UID IS NULL THEN 'DECRYPT_FAILED' ELSE b.DECRYPTION_STATUS END as DECRYPTION_STATUS @@ -613,20 +609,20 @@ To help prevent UID2 tokens from expiring during sharing, send the newly encrypt ``` :::warning -To help prevent UID2 tokens from expiring, decrypt the UID2 tokens as soon as they become available from the sender. +UID2 Token が共有中に期限切れにならないようにするために、受信者は送信者からトークンをできるだけ早く復号化してください。 ::: ## Migration Guide -This section provides information to help you upgrade from the previous version to the new UID2 Snowflake functionality with v3 functions. +このセクションでは、以前のバージョンから新しい UID2 Snowflake v3 機能にアップグレードするための情報を提供します。 :::note -If you're upgrading from a version earlier than February 2025, see [Migration Guide](integration-snowflake-previous.md#migration-guide) in the documentation for the previous version. +2025年2月以前のバージョンからアップグレードする場合は、以前のバージョンのドキュメントの [Migration Guide](integration-snowflake-previous.md#migration-guide) を参照してください。 ::: ### Changing Existing Code -For a summary of changes, see [Changes from Previous Version](#changes-from-previous-version). The code snippets in this section are before/after examples of how the earlier functions might be implemented, and how you could update to use the new function. The key change is migrating from `FN_T_IDENTITY_MAP` to `FN_T_IDENTITY_MAP_V3`, which provides refresh timestamps instead of salt bucket IDs and includes previous UID2 access. +変更の概要は、[Changes from Previous Version](#changes-from-previous-version)を参照してください。このセクションのコードスニペットは、以前の関数がどのように実装されていたかの前後の例であり、新しい関数を使用するように更新する方法を示しています。主な変更点は、`FN_T_IDENTITY_MAP`から`FN_T_IDENTITY_MAP_V3`への移行であり、これによりソルトバケット ID の代わりにリフレッシュタイムスタンプが提供され、以前の UID2 アクセスも含まれます。 #### Example for Mapping Unhashed Emails @@ -658,9 +654,9 @@ select UID, PREV_UID, REFRESH_FROM, UNMAPPED from table({DATABASE_NAME}.{SCHEMA_ #### Example for Monitoring UID2 Refresh and Regenerating Raw UID2s -The v3 function provides refresh timestamps directly, eliminating the need to monitor salt buckets. Instead of joining with salt bucket views, you can compare the current timestamp against the `REFRESH_FROM` timestamp returned by the function. +v3 関数はリフレッシュタイムスタンプを直接提供するため、ソルトバケットを監視する必要がなくなりました。ソルトバケットビューと結合する代わりに、関数から返された `REFRESH_FROM` タイムスタンプを現在のタイムスタンプと比較できます。 -Before (using salt bucket monitoring): +Before (ソルトバケットをモニタリング): ```sql select a.*, b.LAST_SALT_UPDATE_UTC @@ -669,7 +665,7 @@ select a.*, b.LAST_SALT_UPDATE_UTC where a.LAST_UID2_UPDATE_UTC < b.LAST_SALT_UPDATE_UTC or a.UID2 IS NULL; ``` -After (using refresh timestamp monitoring): +After (リフレッシュタイムスタンプを使用): ```sql select * from AUDIENCE_WITH_UID2 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md index cded4cb58..3b67a7faa 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md @@ -32,9 +32,9 @@ UID2 Google Mobile Ads (GMA) Plugin for Android は、[Google Mobile Ads (GMA) S UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 -UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要は、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 ## Requirements diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md index c2617473e..f1fe7fe9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md @@ -32,9 +32,9 @@ UID2 Google Mobile Ads (GMA) Plugin for iOS は、[Google Mobile Ads (GMA) SDK]( UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 -UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要は、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 ## Requirements 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 12f5ad979..ee59c02dc 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 @@ -32,9 +32,9 @@ UID2 Interactive Media Ads (IMA) Plugin for Android は、[Google IMA SDK for An UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 -UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要は、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 ## Requirements diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md index 3b4f7c74c..e2e6398fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md @@ -32,9 +32,9 @@ UID2 Interactive Media Ads (IMA) Plugin for iOS は、[Google IMA SDK for iOS](h UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 -UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要は、[Client-Side, Client-Server, or Server-Side Integration?](integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 ## Requirements 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 d6e67c7a6..32b98bd9f 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 @@ -13,7 +13,11 @@ import UpgradePolicy from '../snippets/_private-operator-upgrade-policy.mdx'; # UID2 Private Operator for AKS Integration Guide -UID2 Operator は UID2 エコシステムの API サーバーです。詳細については、[The UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 +UID2 Operator は UID2 エコシステムの API サーバーです。詳細は、[The UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 + +:::note +AKS の Private Operator をセットアップしたい場合は、UID2 の連絡先にお問い合わせください。詳細は、[Contact Info](../getting-started/gs-account-setup.md#contact-info) を参照してください。 +::: このガイドでは、Azure Kubernetes Service （AKS） クラスター上で Azure Container Instances（ACI） の仮想ノード上で実行される UID2 Operator Service を Private Operator として設定する方法について説明します。[Azure Container Instances 上の仮想ノード](https://learn.microsoft.com/ja-jp/azure/container-instances/container-instances-virtual-nodes)を使用することで、ハードウェアでバックアップされた Trusted Execution Environment （TEE） で実行される機密コンテナの機能を活用できます。この TEE は、データ整合性、データ機密性、コード整合性などの内在的な機能を提供します。 @@ -63,7 +67,7 @@ UID2 の連絡先に、組織を UID2 Operator として登録するよう依頼 ### Install the Azure CLI -Azure コマンドラインインターフェイスをインストールします。詳細については、Azure ドキュメントの [How to install the Azure CLI](https://learn.microsoft.com/ja-jp/cli/azure/install-azure-cli) を参照してください。 +Azure コマンドラインインターフェイスをインストールします。詳細は、Azure ドキュメントの [How to install the Azure CLI](https://learn.microsoft.com/ja-jp/cli/azure/install-azure-cli) を参照してください。 ### Get the Required Azure Permissions @@ -77,11 +81,11 @@ Azure コマンドラインインターフェイスをインストールしま ### Install the kubectl CLI -Kubernetesの `kubectl` コマンドラインインターフェイスをインストールします。詳細については、Kubernetes ドキュメントの [Install Tools](https://kubernetes.io/docs/tasks/tools/) を参照してください。 +Kubernetesの `kubectl` コマンドラインインターフェイスをインストールします。詳細は、Kubernetes ドキュメントの [Install Tools](https://kubernetes.io/docs/tasks/tools/) を参照してください。 ### Install the Helm CLI -`helm` コマンドラインインターフェイスをインストールします。詳細については、[Installing Helm](https://helm.sh/docs/intro/install/) を参照してください。 +`helm` コマンドラインインターフェイスをインストールします。詳細は、[Installing Helm](https://helm.sh/docs/intro/install/) を参照してください。 ## Deployment Environments @@ -169,7 +173,7 @@ az group create --name "${RESOURCE_GROUP}" --location "${LOCATION}" ロケーションに関していくつかの制限があります: - UID2 Private Operator for AKS は、次の地域ではサポートされていません: ヨーロッパ、中国。 -- Azure 仮装ネットワークのデプロイメントの可用性については、[Resource availability & quota limits for ACI](https://learn.microsoft.com/ja-jp/azure/container-instances/container-instances-resource-and-quota-limits#confidential-container-resources-preview) を確認してください。 +- Azure 仮装ネットワークのデプロイメントの可用性は、[Resource availability & quota limits for ACI](https://learn.microsoft.com/ja-jp/azure/container-instances/container-instances-resource-and-quota-limits#confidential-container-resources-preview) を確認してください。 - ロケーションのエイリアスを取得するには、次のコマンドを実行します: @@ -288,6 +292,9 @@ az aks create \ --nodepool-name oprnodepool \ --os-sku Ubuntu ``` +:::note +必ず最新のサポートされている Kubernetes バージョンを使用してください。`--kubernetes-version` フラグを使用します。以前のバージョンを使用する場合は、長期サポート（LTS）を有効にする必要があります。詳細は、Microsoft ドキュメントの [Long-term support for Azure Kubernetes Service (AKS) versions](https://learn.microsoft.com/en-us/azure/aks/long-term-support) を参照してください。 +::: #### Get the Principal ID of the Managed Identity @@ -340,7 +347,7 @@ kubectl get nodes 次のステップは、[Key Vault](https://learn.microsoft.com/ja-jp/azure/key-vault/general/overview) をセットアップし、Operator Key を保存することです。Key Vault を作成したら、[Managed Identity](https://learn.microsoft.com/ja-jp/entra/identity/managed-identities-azure-resources/overview) を作成し、Key Vault へのアクセス権を付与できます。 -後で、AKS クラスターが起動すると、この ID を使用します。詳細については、Microsoft Azure ドキュメントの [Running pods with an Azure Managed Identity](https://github.com/microsoft/virtualnodesOnAzureContainerInstances/blob/main/Docs/PodCustomizations.md#running-pods-with-an-azure-managed-identity) を参照してください。 +後で、AKS クラスターが起動すると、この ID を使用します。詳細は、Microsoft Azure ドキュメントの [Running pods with an Azure Managed Identity](https://github.com/microsoft/virtualnodesOnAzureContainerInstances/blob/main/Docs/PodCustomizations.md#running-pods-with-an-azure-managed-identity) を参照してください。 以下の手順に従ってください: @@ -367,21 +374,32 @@ Private Operator のセットアップを完了するには、次の手順に従 #### Update Placeholder Values -前の手順を完了したら、次の手順に従ってプレースホルダー値を更新します: +前のステップを完了した後、プレースホルダ値を更新するには、次の手順に従ってください: -1. 以下のコマンドを実行して、Managed Identity ID を取得します +1. 以下のコマンドを実行して、Managed Identity ID を取得します: ``` - MANAGED_IDENTITY_ID=$("az identity show --name "${MANAGED_IDENTITY}" --resource-group "${RESOURCE_GROUP}" --query id --output tsv") + MANAGED_IDENTITY_ID=$(az identity show --name "${MANAGED_IDENTITY}" --resource-group "${RESOURCE_GROUP}" --query id --output tsv) ``` -2. `operator.yaml` ファイルの `microsoft.containerinstance.virtualnode.identity` を、返されたマネージド ID に置き換えます: +2. `operator.yaml` ファイルの `microsoft.containerinstance.virtualnode.identity` を、取得した Managed Identity ID で更新します: + + - For Linux, run: ``` sed -i "s#IDENTITY_PLACEHOLDER#$MANAGED_IDENTITY_ID#g" "operator.yaml" ``` -3. 環境変数を使用して、Vault Key と Secret 名を更新します: + - For MacOS, run: + + ``` + sed -i '' "s#IDENTITY_PLACEHOLDER#$MANAGED_IDENTITY_ID#g" "operator.yaml" + ``` + +3. Vault Key と Secret 名を環境変数で更新します: + + - For Linux, run: + ``` sed -i "s#VAULT_NAME_PLACEHOLDER#$KEYVAULT_NAME#g" "operator.yaml" @@ -389,17 +407,26 @@ Private Operator のセットアップを完了するには、次の手順に従 sed -i "s#DEPLOYMENT_ENVIRONMENT_PLACEHOLDER#$DEPLOYMENT_ENV#g" "operator.yaml" ``` + - For MacOS, run: + + ``` + sed -i '' "s#VAULT_NAME_PLACEHOLDER#$KEYVAULT_NAME#g" "operator.yaml" + sed -i '' "s#OPERATOR_KEY_SECRET_NAME_PLACEHOLDER#$KEYVAULT_SECRET_NAME#g" "operator.yaml" + sed -i '' "s#DEPLOYMENT_ENVIRONMENT_PLACEHOLDER#$DEPLOYMENT_ENV#g" "operator.yaml" + ``` + + #### Deploy Operator 以下の手順に従って、Private Operator をデプロイします: -1. 作成した AKS クラスターの Kubernetes 構成資格情報を取得します: +1. Kubernetes configuration credentials を取得するには、次のコマンドを実行します: ``` az aks get-credentials --name ${AKS_CLUSTER_NAME} --resource-group ${RESOURCE_GROUP} ``` -2. Kubernetes 構成資格情報を取得したら、次のコマンドを実行して Private Operator をデプロイします: +2. Kubernetes configuration credentials を取得したら、次のコマンドを実行して Private Operator をデプロイします: ``` kubectl apply -f operator.yaml @@ -407,9 +434,9 @@ Private Operator のセットアップを完了するには、次の手順に従 ## Running the Health Check -実装の状態を確認するには、ヘルスチェックエンドポイントを呼び出します。 +ヘルスチェックエンドポイントを呼び出して、実装のヘルスチェックをテストします。 -ヘルスチェックの実行は、テスト環境と本番環境で同じですが、エンドポイントは異なります。 +ヘルスチェックの実行は、エンドポイントを除き、インテグレーション環境と本番環境で同じです。 以下の手順に従ってください: @@ -419,9 +446,9 @@ Private Operator のセットアップを完了するには、次の手順に従 IP=$(az network public-ip list --resource-group ${AKS_NODE_RESOURCE_GROUP} --query "[?starts_with(name, 'kubernetes')].ipAddress" --output tsv) ``` -2. オペレータの状態をテストするには、ブラウザでヘルスチェックエンドポイントにアクセスします: `http://${IP}/ops/healthcheck`. +2. Operator のステータスをテストするには、ブラウザでヘルスチェックエンドポイントにアクセスします: `http://${IP}/ops/healthcheck`。 - HTTP 200 ステータスコードでレスポンスボディが `OK` の場合、正常な状態を示します。 + HTTP 200 とレスポンスボディ `OK` が表示される場合、ステータスは正常です。 import AttestFailure from '../snippets/_private-operator-attest-failure.mdx'; @@ -429,17 +456,17 @@ import AttestFailure from '../snippets/_private-operator-attest-failure.mdx'; ## Upgrading -UID2 Private Operator for AKS の新しいバージョンがリリースされると、独自の Private Operator をホストしている参加者は、更新の通知を受け取り、新しいリリースリンクまたはインストールファイルを取得するための手順が記載されたメールを受け取ります。アップグレードのウィンドウがあり、その後、古いバージョンは非アクティブになり、サポートされなくなります。 +ASK 用の UID2 Private Operator の新しいバージョンがリリースされると、独自の Private Operator をホストしている参加者は、更新のメール通知を受け取り、新しいリリースリンクまたはインストールファイルを取得するための手順が記載されます。アップグレードのための期間があり、その後、古いバージョンは非アクティブになり、サポートされなくなります。 アップグレードするには、次の手順を完了します: 1. [Download ZIP File and Extract Files](#download-zip-file-and-extract-files) を参照して、新しいバージョンのデプロイメントファイルをダウンロードし、解凍します。 -2. [Complete Key Vault and Managed Identity Setup](#complete-key-vault-and-managed-identity-setup) を参照して、Key Vault と Managed Identity をセットアップします。 +2. [Complete the UID2 Private Operator Setup](#complete-the-uid2-private-operator-setup) の手順に従い、新しいファイルを使用して AKS 実装を新しいバージョンでデプロイします。 -3. 新しい AKS デプロイメントのヘルスを確認し、ステータスが正常であることを確認します: +3. 新しい AKS デプロイメントのヘルスを確認し、ステータスが正常であることを確認します。 -4. 古い AKS ポッドが適切にシャットダウンされていることを確認します: +4. 古い AKS ポッドが適切にシャットダウンされていることを再確認します: ``` kubectl get pods diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index ad154e489..8abcb1830 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -37,7 +37,6 @@ UID2 Private Operator for AWS を契約することで、以下を利用でき | ------- | ------ | ------ | ------ | | Q2 2025 | [v5.55.9](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.55.9-r1) | v5.55.9-r1 | July 1, 2025 | - :::note For information about supported versions and deprecation dates, see [Private Operator Versions](../ref-info/deprecation-schedule.md#private-operator-versions). ::: @@ -167,7 +166,7 @@ UID2 Operator を AWS Marketplace にデプロイするには、以下の手順 1. [Unified ID 2.0 Operator on AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-wdbccsarov5la) をサブスクライブします。AWS がサブスクライブが完了するまで数分かかる場合があります。 2. **Configuration** をクリックし、構成値を指定します。 - ソフトウェアバージョンについては、[Operator Version](#operator-version) を参照し、AWS Version 列で値を選択します。 + ソフトウェアバージョンは、[Operator Version](#operator-version) を参照し、AWS Version 列で値を選択します。 3. Configuration ページで **Launch** をクリックし、**Launch CloudFormation** アクションを選択します。 4. スタック作成ウィザードでテンプレートを指定し、**Next** をクリックします。テンプレートファイルの S3 パスが自動的に入力されます。 5. [スタックの詳細](#stack-details) を入力し、**Next** をクリックします。 @@ -373,10 +372,10 @@ Private Operator 起動時のエラーコードは、リリース v5.49.7 以降 | :--- | :--- | :--- | | E01 | InstanceProfileMissingError | EC2 インスタンスに、必要な権限が付与されたIAMインスタンスプロファイルをアタッチします。UID2 Operator は、AWS Secrets Manager から設定にアクセスするためにこれらの権限が必要です。 | | E02 | OperatorKeyNotFoundError | Private Operator が参照するシークレットが、オペレーターと同じリージョンにある AWS Secrets Manager に存在することを確認し、IAM インスタンス プロファイルがシークレットにアクセスする権限を持っていることを確認してください。必要に応じて、特定のシークレット名とリージョンに関するログを確認できます。 | -| E03 | ConfigurationMissingError | 構成に必須の属性が不足しています。詳細についてはログを確認し、Secrets Manager で不足している属性を更新してください。 | -| E04 | ConfigurationValueError | 構成値が無効です。AWS Secrets Manager内の構成値が、必要な形式と環境と一致していることを確認してください。Note： `debug_mode = true` は `integ` 環境でのみ許可されています。詳細についてはログを確認してください。 | +| E03 | ConfigurationMissingError | 構成に必須の属性が不足しています。詳細はログを確認し、Secrets Manager で不足している属性を更新してください。 | +| E04 | ConfigurationValueError | 構成値が無効です。AWS Secrets Manager内の構成値が、必要な形式と環境と一致していることを確認してください。Note： `debug_mode = true` は `integ` 環境でのみ許可されています。詳細はログを確認してください。 | | E05 | OperatorKeyValidationError | Operator Key が環境に適しており、提供されたものと一致していることを確認してください。 | -| E06 | UID2ServicesUnreachableError | UID2 Core および Opt-out Service の IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスおよび DNS の詳細については、ログを参照してください。 | +| E06 | UID2ServicesUnreachableError | UID2 Core および Opt-out Service の IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスおよび DNS の詳細は、ログを参照してください。 | ## Technical Support 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 75b545b0d..5acf59301 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 @@ -75,7 +75,7 @@ Azure CLI をインストールします。詳細は、Azure ドキュメント ## Deployment Environments -以下の環境が利用可能です。ベストプラクティスとして、本番環境にデプロイする前に、インテグレーション環境で実装をテストして検証することを勧めます。 +以下の環境が利用可能です。ベストプラクティスとして、本番環境にデプロイする前に、インテグレーション環境で実装をテストして検証することを推奨します。 :::note 各環境に対して別々の `{OPERATOR_KEY}` 値が受け取れます。使用する環境に応じて正しいキーを使用してください。デプロイメントの成果物と処理の流れは、どちらの環境でも同じです。 @@ -125,7 +125,7 @@ az group create --name {RESOURCE_GROUP_NAME} --location {LOCATION} ロケーションには、いくつかの制限があります: - UID2 Private Operator for Azure は、次の地域ではサポートされていません: Europe、China。 -- Azure 仮想ネットワーク展開の可用性については、Azure ドキュメントの「Linux container groups(https://learn.microsoft.com/en-us/azure/container-instances/container-instances-resource-and-quota-limits#confidential-container-resources-preview) を確認し、Confidential Containers の地域サポートの可用性を確認してください。 +- Azure 仮想ネットワーク展開の可用性は、Azure ドキュメントの[Linux container groups](https://learn.microsoft.com/en-us/azure/container-instances/container-instances-resource-and-quota-limits#confidential-container-resources-preview) を確認し、Confidential Containers の地域サポートの可用性を確認してください。 - 場所のエイリアスを取得するには、次のコマンドを実行します。 @@ -280,11 +280,11 @@ Microsoft Azure で UID2 Private Operator をホストする Virtual Private Clo ``` :::tip -コンテナを更新しても、Azure バックエンドプールは新しいコンテナの IP アドレスで自動的に更新されません。ソリューションについては、Azure ドキュメントの [Automate infrastructure reconfiguration by using Azure](https://learn.microsoft.com/en-us/azure/architecture/web-apps/guides/networking/automation-application-gateway) を参照してください。 +コンテナを更新しても、Azure バックエンドプールは新しいコンテナの IP アドレスで自動的に更新されません。ソリューションは、Azure ドキュメントの [Automate infrastructure reconfiguration by using Azure](https://learn.microsoft.com/en-us/azure/architecture/web-apps/guides/networking/automation-application-gateway) を参照してください。 ::: :::caution -この例では、HTTP を使用して Gateway Load Balancer をデプロイします。SSL を設定することを強く勧めます。手順については、Azure ドキュメントの [Tutorial: Configure an Application Gateway with TLS termination using the Azure portal](https://learn.microsoft.com/en-us/azure/application-gateway/create-ssl-portal) を参照してください。 +この例では、HTTP を使用して Gateway Load Balancer をデプロイします。SSL を設定することを強く推奨します。手順は、Azure ドキュメントの [Tutorial: Configure an Application Gateway with TLS termination using the Azure portal](https://learn.microsoft.com/en-us/azure/application-gateway/create-ssl-portal) を参照してください。 ::: ## Running the Health Check @@ -347,8 +347,8 @@ Private Operator 起動時のエラーコードは、リリース v5.49.7 以降 | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | | E02 | OperatorKeyNotFoundError | Operator Key を格納するシークレットボールトとシークレット名が正しく構成されていることを確認してください。`VAULT_NAME` と `OPERATOR_KEY_SECRET_NAME` として設定されていることを確認してください。 | -| E03 | ConfigurationMissingError | 構成に必要な属性が不足しています。詳細については、ログを参照し、Azure オペレーターを実行する前に不足している属性を更新してください。 | +| E03 | ConfigurationMissingError | 構成に必要な属性が不足しています。詳細は、ログを参照し、Azure オペレーターを実行する前に不足している属性を更新してください。 | | E04 | ConfigurationValueError | 構成値が無効です。構成値が必要な形式と環境に一致していることを確認してください。Note: `debug_mode = true` は `integ` 環境でのみ許可されます。詳細はログを確認してください。 | | E05 | OperatorKeyValidationError | Operator Key が環境に適しており、提供されたものと一致していることを確認してください。 | -| E06 | UID2ServicesUnreachableError | UID2 Core および Opt-out サービスの IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスと DNS の詳細については、ログを参照してください。 | +| E06 | UID2ServicesUnreachableError | UID2 Core および Opt-out サービスの IP アドレスをアウトバウンドファイアウォールで許可します。IP アドレスと DNS の詳細は、ログを参照してください。 | | E08 | OperatorKeyPermissionError | コンテナを起動するマネージド ID (operatorIdentifier パラメータで指定) は、オペレーターキーが格納されているキーボールトへのアクセス権を持っている必要があります。`operatorIdentifier` の値は、すべての構成 JSON ファイルで同じである必要があります。 | \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md index f86ab0db6..4763b8dae 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md @@ -53,7 +53,7 @@ For information about supported versions and deprecation dates, see [Private Ope ペストプラクティスは、まずインテグレーション環境にデプロイし、次に本番環境にデプロイすることです。 1. 利用可能な[deployment options](#deployment-options) に関する情報を確認し、それぞれの利点を比較して、使用するオプションを決定します。 - Terraform テンプレートオプションを勧めます。 + Terraform テンプレートオプションを推奨します。 1. 選択したデプロイメントオプションに従って、適用可能な手順に従います: - [Terraform Template](#deployterraform-template) - [gcloud CLI](#deploygcloud-cli) @@ -75,7 +75,7 @@ UID2 Operator Service は、任意の GCP アカウントとプロジェクト デプロイメントオプションを選択する前に、次の Google Cloud のセットアップ手順を完了してください: -1. UID2 Operator を実行する GCP プロジェクトを作成します。UID2 Operator Service が実行される GCP プロジェクトを作成することを勧めますが、既存のプロジェクトを使用することもできます。次のガイドラインに従ってください: +1. UID2 Operator を実行する GCP プロジェクトを作成します。UID2 Operator Service が実行される GCP プロジェクトを作成することを推奨しますが、既存のプロジェクトを使用することもできます。次のガイドラインに従ってください: - プロジェクト名を選択します。たとえば、`UID2-Operator-Production` とします。この値は、後の手順で `{PROJECT_ID}` 値として使用します。 - 請求が有効になっている GCP プロジェクトを定義してください。 @@ -117,7 +117,7 @@ UID2 アカウント登録が完了し、gcloud CLI をインストールした | Environment | Details | | :--- | :--- | | Integration (`integ`) | テスト専用。デバッグモードはインテグレーション環境で使用できます。 | -| Production (`prod`) | 本番トラフィックの管理用。この環境では、Terraform テンプレート経由で、ロードバランシングを行い、HTTPS を有効にしてデプロイすることを勧めます。[Deployment Options](#deployment-options) を参照してください。 | +| Production (`prod`) | 本番トラフィックの管理用。この環境では、Terraform テンプレート経由で、ロードバランシングを行い、HTTPS を有効にしてデプロイすることを推奨します。[Deployment Options](#deployment-options) を参照してください。 | ## Deployment Options @@ -211,7 +211,7 @@ Terraform がインストールされていない場合は、[terraform.io](http | `uid_deployment_env` | `string` | `integ` | yes | 有効な値: `integ` はインテグレーション環境、`prod` は本番環境。
マシンタイプはデプロイ環境によって決まります。`integ` は `n2d-standard-2` を使用し、`prod` は `n2d-standard-16` を使用します。 | | `debug_mode` | `bool` | `true` | yes | より多くの診断情報を有効にするには `true` に設定します。本番環境では `false` に設定しなければなりません。 | -2. (オプション、強く勧めます) ロードバランサーを HTTPS に設定します。次の表に示すパラメータお値を設定します: +2. (オプション、強く推奨します) ロードバランサーを HTTPS に設定します。次の表に示すパラメータお値を設定します: | Name | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | @@ -223,7 +223,7 @@ Terraform がインストールされていない場合は、[terraform.io](http | Name | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | - | `region` | `string` | `us-east1` | no | デプロイ先のリージョン。有効なリージョンの一覧については、Google Cloud ドキュメントの [Available regions and zones](https://cloud.google.com/compute/docs/regions-zones#available) を参照してください。
NOTE: GCP Confidential Space 用の UID2 Private Operator の実装は、次の地域ではサポートされていません: ヨーロッパ、中国。 | + | `region` | `string` | `us-east1` | no | デプロイ先のリージョン。有効なリージョンの一覧は、Google Cloud ドキュメントの [Available regions and zones](https://cloud.google.com/compute/docs/regions-zones#available) を参照してください。
NOTE: GCP Confidential Space 用の UID2 Private Operator の実装は、次の地域ではサポートされていません: ヨーロッパ、中国。 | | `network_name` | `string` | `uid-operator` | no | VPC リソース名（ルール/インスタンスタグにも使用されます）。 | | `min_replicas` | `number` | `1` | no | デプロイする最小レプリカ数を示します。 | | `max_replicas` | `number` | `5` | no | デプロイする最大レプリカ数を示します。 | @@ -248,7 +248,7 @@ Terraform の `state` ファイルに関する推奨に従ってください: 実装のヘルスをテストするために、ヘルスチェックエンドポイントを使用します。ヘルスチェックの期待される結果は、HTTP 200 で、レスポンスボディが `OK` です。 -手順については、[Health Check—Terraform Template](#health-checkterraform-template) を参照してください。 +手順は、[Health Check—Terraform Template](#health-checkterraform-template) を参照してください。 #### Delete All Created Resources @@ -273,7 +273,7 @@ Terraform テンプレートからの出力値は次の表の通りです。 gcloud CLI を使用して GCP Confidential Space Enclave に新しい UID2 Operator をデプロイするには、次の手順に従います。 :::note -本番環境へのデプロイメントにはこのオプションを使用しないことを勧めます。本番環境へのデプロイメントには、Terraform テンプレートを使用し、ロードバランシングを行い、HTTPS を有効にすることを勧めます。 +本番環境へのデプロイメントにはこのオプションを使用しないことを推奨します。本番環境へのデプロイメントには、Terraform テンプレートを使用し、ロードバランシングを行い、HTTPS を有効にすることを推奨します。 ::: 1. [Set Up Service Account Rules and Permissions](#set-up-service-account-rules-and-permissions) @@ -463,7 +463,7 @@ $ gcloud compute instances create {INSTANCE_NAME} \ ヘルスチェックエンドポイントを呼び出して、実装の健全性をテストします。期待される結果は、HTTP 200 で、レスポンスボディが `OK` です。 -手順については、[Health Check—gcloud CLI](#health-checkgcloud-cli) を参照してください。 +手順は、[Health Check—gcloud CLI](#health-checkgcloud-cli) を参照してください。 ## Running the Health Check @@ -541,7 +541,7 @@ Private Operator 起動時のエラーコードは、リリース v5.49.7 以降 | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | -| E02 | OperatorKeyNotFoundError | オペレータと同じプロジェクトの GCP Secret Manager に指定されたシークレット名が存在し、サービスアカウントがシークレットにアクセスする権限を持っていることを確認してください。`tee-env-API_TOKEN_SECRET_NAME` に設定されていることを確認してください。必要に応じて、特定のシークレット名についてはログを確認できます。 | +| E02 | OperatorKeyNotFoundError | オペレータと同じプロジェクトの GCP Secret Manager に指定されたシークレット名が存在し、サービスアカウントがシークレットにアクセスする権限を持っていることを確認してください。`tee-env-API_TOKEN_SECRET_NAME` に設定されていることを確認してください。必要に応じて、特定のシークレット名はログを確認できます。 | | E03 | ConfigurationMissingError | 構成に必要な属性が不足しています。詳細はログを参照し、GCP オペレーターを実行する前に不足している属性を更新してください。 | | E04 | ConfigurationValueError | 設定値が無効です。設定値が必要な形式と環境に一致していることを確認してください。注意: `debug_mode = true` は `integ` 環境でのみ許可されます。詳細はログを確認してください。 | | E05 | OperatorKeyValidationError | Operator Key が環境に対して正しいことを確認し、提供されたものと一致していることを確認してください。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md index 487f7dc5b..05acc4a38 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md @@ -48,7 +48,7 @@ UID2 フレームワークは、以下の技術原則に基づいて構築され ## Elements of the UID2 Infrastructure -UID2 インフラの重要な要素や、UID2 のその他の側面については、次のページを参照してください: +UID2 インフラの重要な要素や、UID2 のその他の側面は、次のページを参照してください: - [UID2 Identifier Types](ref-info/uid-identifier-types.md) - [UID2 Components](ref-info/uid-components.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md index f1e0c76a8..2efee983a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md @@ -39,15 +39,15 @@ UID2 のドキュメント一式に左サイドバーからアクセスしたい 以下のステップは、ユーザーデータを収集し DSP にプッシュする組織 (広告主、ID グラフプロバイダー、サードパーティデータプロバイダーなど) を想定したワークフローのアウトラインを提供するものです。 バックグラウンドで以下の処理が行われます: -* 広告主とデータプロバイダーは、ローテーションされたソルトバケットの UID2 Operator を監視し、必要に応じて UID2 を更新します。 +* 広告主またはデータプロバイダーは、リフレッシュ タイムスタンプ を監視し、現在の時刻が各保存された UID2 のリフレッシュ タイムスタンプを超えた場合に UID2 を更新します。 以下のステップは、広告主が UID2 とインテグレーションする方法の一例です: 1. 広告主は、ユーザーの [directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を UID2 Operator に送信します。 -2. UID2 Operator は、raw UID2 とソルトバケット ID を生成して返します。 -3. 広告主は UID2 とソルトバケット ID を保存し、UID2 ベースのファーストパーティおよびサードパーティのオーディエンスセグメントを DSP に送信します。 +2. UID2 Operator は、raw UID2とリフレッシュタイムスタンプを生成して返します。 +3. 広告主は UID2 とリフレッシュタイムスタンプを保存し、UID2 ベースのファーストパーティおよびサードパーティのオーディエンスセグメントを DSP に送信します。 - Server-Side: 広告主は、マッピングテーブル、DMP、データレイク、またはその他のサーバーサイドアプリケーションに UID2 を保存します。 + Server-side: 広告主は、マッピングテーブル、DMP、データレイク、またはその他のサーバーサイドアプリケーションに UID2 を保存します。 ![Data Provider Workflow](images/UID2AdvertiserAndThirdPartyDataProviderWorkflow.jpg) @@ -82,4 +82,4 @@ UID2 のドキュメント一式に左サイドバーからアクセスしたい ## FAQs for Advertisers -UID2 フレームワークを使用する広告主向けのよくある質問については、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 +UID2 フレームワークを使用する広告主向けのよくある質問は、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md index e1b453ca1..e90a5c1c7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md @@ -44,13 +44,13 @@ UID2 を使用することで、データプロバイダーとして得られる 以下のステップは、ユーザーデータを収集し DSP にプッシュする組織 (広告主、ID グラフプロバイダー、サードパーティデータプロバイダーなど) を対象としたワークフローのアウトラインを提供するものです。 バックグラウンドで以下の処理が行われます: -* 広告主やデータプロバイダーは、ローテーションされたソルトバケットの UID2 Operator を監視し、必要に応じて UID2 を更新します。 +* 広告主またはデータプロバイダーは、リフレッシュ タイムスタンプ を監視し、現在の時刻が各保存された UID2 のリフレッシュ タイムスタンプを超えた場合に UID2 を更新します。 以下のステップは、データプロバイダーが UID2 とインテグレーションする方法の一例です: -1. データプロバイダーが、ユーザーの [directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を UID2 Operator に送信します。 -2. UID2 Operator は、raw UID2 とソルトバケット ID を生成して返します。 -3. データプロバイダーは UID2 とソルトバケット ID を保存し、UID2 ベースのファーストパーティおよびサードパーティのオーディエンスセグメントを DSP に送信します。 +1. 広告主は、ユーザーの [directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を UID2 Operator に送信します。 +2. UID2 Operator は、raw UID2とリフレッシュタイムスタンプを生成して返します。 +3. 広告主は UID2 とリフレッシュタイムスタンプを保存し、UID2 ベースのファーストパーティおよびサードパーティのオーディエンスセグメントを DSP に送信します。 Server-side: 広告主またはデータプロバイダーは、UID2 をマッピングテーブル、DMP、データレイク、またはその他の Server-Side アプリケーションに格納します。 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 195cbb95e..db8822636 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 @@ -108,4 +108,4 @@ Optionally, if DSPs want to generate UID2s themselves from DII, they can also fo ## FAQs for DSPs -UID2 フレームワークを使用する DSP に関するよくある質問については [FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 +UID2 フレームワークを使用する DSP に関するよくある質問は [FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md index f11966c8c..c7c46f7af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md @@ -29,7 +29,7 @@ API Key とクライアント シークレットを使用すると、UID2 参加者 名やタイプなどです。アカウント作成時に提供した情報が表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md index 78424e7e3..1fb372cbf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md @@ -66,7 +66,7 @@ UID2 Portal で実行する操作（チームメンバーの追加、ドメイ ## Set Up Your Account -アカウントの設定については、[Getting Started with the UID2 Portal](portal-getting-started.md) を参照してください。 +アカウントの設定は、[Getting Started with the UID2 Portal](portal-getting-started.md) を参照してください。 ## Participant Switcher @@ -74,6 +74,6 @@ UID2 Portal で実行する操作（チームメンバーの追加、ドメイ 現在の参加者は、左サイドバーの上部に表示されます。現在のユーザーが複数の参加者のチームに所属している場合、矢印が表示され、ユーザーは正しい参加者のコンテキストで操作を実行するために参加者間を切り替えることができます。 -図については、[UID2 Portal Structure](#uid2-portal-structure) を参照してください。 +図は、[UID2 Portal Structure](#uid2-portal-structure) を参照してください。 ユーザーがログアウトすると、最新の参加者の選択が保存され、次回ユーザーがログインすると適用されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md index 77fc82d72..4e8885ad4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md @@ -42,7 +42,7 @@ UID2 Portal での共有権限の設定は、Raw UID2 | +Refresh timestamp | Refresh token **S** @@ -211,7 +212,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Core Service
UID2 Core Serviceは、UID2 エコシステムの 秘密の ソルト、暗号化キー、その他の関連データへのアクセスを管理する一元的なサービスです。
-
すべてのUID2 Service の概要については、UID2 Component Services を参照してください。
+
すべてのUID2 Service の概要は、UID2 Component Services を参照してください。
@@ -242,7 +243,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Enclave
Enclave は、コンピューティング環境のセキュアなサブセクションです。エンクレーブには追加のビジネスロジックとセキュリティ対策が施され、改ざんできないようになっています。
-
UID2 のコンテキストでは、Private Operator はエンクレーブ内で実行されなければなりません。サポートされるエンクレーブバージョンの概要については、*UID2 Private Operator Integration Overview* の Hosting Options for Private Operators を参照してください。
+
UID2 のコンテキストでは、Private Operator はエンクレーブ内で実行されなければなりません。サポートされるエンクレーブバージョンの概要は、*UID2 Private Operator Integration Overview* の Hosting Options for Private Operators を参照してください。
Enclave では、オペレータイメージは特殊で、事前に定義されたバージョンでなければならず、セキュリティを確保するために追加の制約が適用されます。
Encryption key
@@ -338,7 +339,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
詳細は、[OpenID Connect Basic Client Implementer's Guide 1.0 - draft 40](https://openid.net/specs/openid-connect-basic-1_0.html) (specification) を参照してください。
Opaque
-
UID2 Token が不透明な文字列であるというのは、トークンが計算される方法やそのフォーマットが UID2 参加者に伝えられず、変更される可能性があるためです。文字列のフォーマットや長さ、その他の側面については、何も前提を立てるべきではありません。
+
UID2 Token が不透明な文字列であるというのは、トークンが計算される方法やそのフォーマットが UID2 参加者に伝えられず、変更される可能性があるためです。文字列のフォーマットや長さ、その他の側面は、何も前提を立てるべきではありません。
Open Operator
Open Operator は、Public Operator の別名です。
@@ -355,7 +356,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Operator Service
Operator のすべての機能を可能にするサービスです
-
すべての UID2 Service の概要については、UID2 Component Services を参照してください。
+
すべての UID2 Service の概要は、UID2 Component Services を参照してください。
Opt-Out
UID2 エコシステムに参加しているエンドユーザーは、Transparency and Control Portal にアクセスすることで、いつでもオプトアウトすることができます。
@@ -363,7 +364,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Opt-Out Service
Opt-Out Service は、ユーザーのオプトアウト要求を管理・保存するグローバルな UID2 Service です。
-
すべての UID2 Service の概要については、UID2 Component Services を参照してください。
+
すべての UID2 Service の概要は、UID2 Component Services を参照してください。
@@ -400,6 +401,10 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
UID2 API または SDK を通じて、ユーザーの directly identifying information (メールアドレスまたは電話番号) を入力として作成される、暗号化されていない英数字の識別子。raw UID2 を暗号化して UID2 Token を作成します。raw UID2 は一意な値であり、同じ UID2 は2つとありません。raw UID2 とそれに関連付けられた UID2 Token は、大文字と小文字を区別します。
詳細は UID2 Identifier Types を参照してください。
+
Refresh timestamp
+
DII を raw UID2 にマッピングする場合、リフレッシュタイムスタンプは、POST /identity/map エンドポイントのレスポンスの r フィールドで返される Unix タイムスタン (秒単位) です。raw UID2 は、このタイムスタンプまで有効であり、その後にリフレッシュされます。
+
リフレッシュタイムスタンプを使用して、保存されたデータの raw UID2 をいつ再生成するかを判断します。現在の時刻と保存されたリフレッシュタイムスタンプを比較して、毎日リフレッシュの機会を確認することを推奨します。
+
Refresh Token
Refresh tokenは、UID2 Tokenとともに発行される不透明な文字列です。UID2 token の有効期限を更新するために使用されます。
UID2 Server は、新しい UID2 Token のリクエストとともに Refresh Token を受け取ると、ユーザーの Opt-Out をチェックします。ユーザーが UID2 を Opt-Out している場合、新しい UID2 Token は生成されません。
@@ -418,10 +423,12 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
Salt bucket
ソルトバケットは、raw UID2 や UID2 Token を生成するために使用される秘密の salt の値を長期間管理するために使用されます。各バケットには、約1年間有効な現在のソルト値が含まれており、新しい値にローテーションされる前に更新されます。バケットは互いに独立して更新できます。
ソルトバケットは、100万以上あり、各メールアドレスまたは電話番号は、特定のバケットに決定論的に割り当てられます。ただし、この割り当ては永続的ではなく、バケットの現在のソルトが新しい値にローテーションされると変更される可能性があります。
+
[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントのバージョン 3 以前では、ソルトバケットは ソルトバケット ID を使用して識別されます。バージョン 3 以降では、ソルトバケット情報は必要ありません。
Salt bucket ID
ソルトバケット ID は、特定の ソルトバケット を識別する一意の文字列です。ソルトバケット ID を使用すると、最近、ソルト値が更新されたソルトバケットを確認し、どのメールアドレスまたは電話番号が raw UID2 値を再生成する必要があるかを確認できます。
-
ソルトバケット ID の例については、`POST /identity/buckets` エンドポイントのレスポンスを参照してください: Decrypted JSON Response Format。
+
[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントのバージョン 3 以前、たとえば [POST /identity/map (v2)](../endpoints/post-identity-map-v2.md) では、エンドポイントはソルトバケット ID を返します。バージョン 3 以降では、ソルトバケット情報は必要ありません。
+
ソルトバケット ID の例は、[POST /v2/identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントのレスポンスを参照してください: Decrypted JSON Response Format。`POST /v3/identity/map` を使用している場合、`POST /v2/identity/buckets` を使用する必要はありません。
Salted hash
hash 関数を適用する前に入力文字列に salt 値を追加すると、結果はソルトハッシュとなります。入力値がハッシュ化される前にソルト化されると、ハッシュを持つ攻撃者は、同じ出力に到達するために多くの可能な入力を試して入力値を決定することができなくなります。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md index ce94441cc..e7fb57a21 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-how-uid-is-created.md @@ -22,13 +22,13 @@ import Link from '@docusaurus/Link'; - 手順が順番に実行された場合、その結果の値は、同じ個人のオンラインアクティビティから生成された他の [UID2 identifier types](uid-identifier-types.md) と関連付けられることが認識されます: 基礎となる [raw UID2](../ref-info/glossary-uid.md#gl-raw-uid2) は、同じ DII から生成された他の UID2 参加者による raw UID2 と一致し、したがってそのトークンはターゲティング広告に適しています。 - 順序を間違えると、その結果の値は、同じ個人のオンラインアクティビティから生成された他の UID2 identifiers と関連付けられることができません。そのため、そのトークンはターゲティング広告に適していません。 -概要については、[Steps to Create a UID2 Token](#steps-to-create-a-uid2-token) を参照してください。図形式の例については、[Creating a UID2 Token—Example](#creating-a-uid2-tokenexample) を参照してください。 +概要は、[Steps to Create a UID2 Token](#steps-to-create-a-uid2-token) を参照してください。図形式の例は、[Creating a UID2 Token—Example](#creating-a-uid2-tokenexample) を参照してください。 ## Steps to Create a UID2 Token 以下の表は、DII から UID2 Token を作成する手順、順序、および各ステップを実行する担当者を示しています。 -サンプル値を使用した例については、[Creating a UID2 Token—Example](#creating-a-uid2-tokenexample) を参照してください。 +サンプル値を使用した例は、[Creating a UID2 Token—Example](#creating-a-uid2-tokenexample) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md index cc27bd722..c2b57d8b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md @@ -70,4 +70,4 @@ Private Operator オプションのデメリットは、構築と維持に継続 Public Operator とのインテグレーションは、独自のインスタンスを作成するよりもはるかに簡単なオプションです。参加者に費用はかからず、初期設定と構成以外のエンジニアリング作業は事実上必要ありません。 -これらの理由から、Public Operator を選択することを勧めます。 +これらの理由から、Public Operator を選択することを推奨します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md index 0fa584f96..c30f6e099 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md @@ -35,7 +35,7 @@ import TabItem from '@theme/TabItem'; - **SDK**: UID2 Server-Side SDK を使用して、Publisher Client クラスのいずれかを使用します。これらのクラスは、リクエストを 1 つのメソッド呼び出しに簡素化します。 - 手順については、次のいずれかを参照してください: + 手順は、次のいずれかを参照してください: - [SDK for Java, Usage for Publishers, Basic Usage](../sdks/sdk-ref-java.md#basic-usage) - [SDK for Python, Usage for Publishers](../sdks/sdk-ref-python.md#usage-for-publishers) @@ -61,7 +61,7 @@ import TabItem from '@theme/TabItem'; - **API**: [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出します。 - このガイドの残りの部分で必要な `Identity` レスポンスは、成功したエンドポイントのレスポンスの body セクション内のコンテンツです。例については、[Successful Response](../endpoints/post-token-generate.md#successful-response) を参照してください。 + このガイドの残りの部分で必要な `Identity` レスポンスは、成功したエンドポイントのレスポンスの body セクション内のコンテンツです。例は、[Successful Response](../endpoints/post-token-generate.md#successful-response) を参照してください。 :::important トークンを生成する DII が UID2 からオプトアウトされている場合、エンドポイントと SDK API はオプトアウトステータスを返します。この場合、情報を保存し、同じ DII に対してトークン生成エンドポイントを呼び出さないでください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md index 3efa1bc98..1c9a54557 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md @@ -111,4 +111,4 @@ Refresh Token に関する主なポイントは次のとおりです: ## FAQs -トークンのリフレッシュに関するよくある質問については、[パブリッシャー向け FAQ](../getting-started/gs-faqs.md#faqs-for-publishers) を参照してください。 +トークンのリフレッシュに関するよくある質問は、[パブリッシャー向け FAQ](../getting-started/gs-faqs.md#faqs-for-publishers) を参照してください。 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 f8af017e1..d5174317e 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,39 @@ UID2 ドキュメンテーションリソースの最新アップデートを確 タグツールバーを使用して、ドキュメントの更新の一部を表示できます。 ::: +## Q3 2025 + +当四半期にリリースされたドキュメントは以下の通りです。 + + + +### Identity Map v3 (Python SDK, Snowflake) + +July 31, 2025 + +July 11 に発表された Identity Map API (v3) の新バージョンに対応するため、2 つの追加ドキュメントを更新しました。この新バージョンは、広告主とデータプロバイダーに大幅な改善を提供します。 + +以下の実装と対応するドキュメントを更新しました: + +- Python SDK: [SDK for Python Reference Guide](../sdks/sdk-ref-python.md) を参照してください。 +- Snowflake: [Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。 + + + + + + + +### Identity Map v3 + +July 11, 2025 + +Identity Map API (v3) の新バージョンをリリースしました。このバージョンは、広告主とデータプロバイダーに大幅な改善を提供します。この更新には、[POST /identity/map](../endpoints/post-identity-map.md) エンドポイント、[SDK for Java Reference Guide](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers)、および [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) のドキュメントが含まれています。 + + + + + ## Q1 2025 当四半期にリリースされたドキュメントは以下の通りです。 @@ -132,7 +165,7 @@ January 10, 2025 広告主とデータプロバイダーのドキュメントを大幅に拡充し、再構築しました。新しい概要ドキュメントと、Snowflake、AWS Entity Resolution、HTTP エンドポイントの 3 つの主要なインテグレーションオプションに関する個別のドキュメントがあります: -広告主とデータプロバイダー向けのすべてのインテグレーションオプションの概要については、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 +広告主とデータプロバイダー向けのすべてのインテグレーションオプションの概要は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 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 b0fbcb711..bbd2d0667 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 @@ -19,7 +19,7 @@ Android SDK を使用すると、UID2 を使用したクライアント ID の | Google Mobile Ads (GMA) SDK を使用して、Android アプリからの広告リクエストで UID2 token を [Secure Signals](https://support.google.com/admob/answer/11556288) として送信するには、次の手順に従います。 | [UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md) | | Google Interactive Media Ads (IMA) SDK for Android を使用して、Android アプリからの広告リクエストで UID2 token を [Secure Signals](https://support.google.com/admob/answer/11556288) として送信するには、次の手順に従います。 | [UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md) | -モバイルパブリッシャーインテグレーションに関する FAQs については、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 +モバイルパブリッシャーインテグレーションに関する FAQs は、[FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations) を参照してください。 ## Non-Mobile Android Device Support @@ -48,7 +48,7 @@ UID2 とのインテグレーションを行うには、UID2 アカウントが - オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。 - オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションオプションの概要については、[Client-Side, Client-Server, or Server-Side Integration?](../guides/integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションオプションの概要は、[Client-Side, Client-Server, or Server-Side Integration?](../guides/integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 @@ -58,7 +58,7 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S このドキュメントは、SDK for Android バージョン 1.6.0 以降用です。 -リリースノートの情報については、[https://github.com/IABTechLab/uid2-android-sdk/releases](https://github.com/IABTechLab/uid2-android-sdk/releases) を参照してください。 +リリースノートの情報は、[https://github.com/IABTechLab/uid2-android-sdk/releases](https://github.com/IABTechLab/uid2-android-sdk/releases) を参照してください。 ## GitHub Repository/Binary @@ -135,9 +135,9 @@ class MyApplication : Application() { 最初の UID2 Identity を確立する方法は 2 つあります: -1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順については、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 +1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順は、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 -2. Server-Side で UID2 ID を生成し、それを UID2 SDK に渡します。インテグレーション手順については、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) を参照してください。 +2. Server-Side で UID2 ID を生成し、それを UID2 SDK に渡します。インテグレーション手順は、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) を参照してください。 UID2 Mobile SDK は、UID2 identifier が確立された後に UID2 identities をリフレッシュできます。これは、リフレッシュ機能が UID2 Identity の一部である Refresh Token に依存しているためです。 @@ -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) を参照してください。 +D直接識別情報 (DII) を使用して UID2 Identity を生成します。手順は、*Client-Side Integration Guide for Mobile* の [Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 #### setIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md index d8ddf814c..e65140fc1 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 @@ -34,7 +34,7 @@ UID2 とインテグレーションするには、UID2 アカウントが必要 - アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 - オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細は、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 DSP の場合は、資格情報を送信します。 @@ -59,7 +59,7 @@ Release tags は以下の GitHub で入手できますが、バイナリーは | Parameter | Description | Recommended Value | | :--- | :--- | :--- | | `endpoint` | UID2 Service のエンドポイント。 | N/A | -| `authKey` | クライアントに付与された認証トークン。UID2 へのアクセスについては [Contact Info](../getting-started/gs-account-setup.md#contact-info) を参照してください。 | N/A | +| `authKey` | クライアントに付与された認証トークン。UID2 へのアクセスは [Contact Info](../getting-started/gs-account-setup.md#contact-info) を参照してください。 | N/A | ## Interface @@ -88,7 +88,7 @@ SDK から返される利用可能な情報の概要を次の表に示します | Function | Description | | :--- | :--- | -| `GetStatus()` | 復号結果のステータス。指定可能な値の一覧と定義については、[Response Statuses](#response-statuses) を参照してください。 | +| `GetStatus()` | 復号結果のステータス。指定可能な値の一覧と定義は、[Response Statuses](#response-statuses) を参照してください。 | | `GetUid()` | UID2 Advertising Token に対応する raw UID2。 | | `GetEstablished()` | ユーザーがパブリッシャーと最初に UID2 を確立した時を示すタイムスタンプ。 | @@ -114,7 +114,7 @@ UID2 Sharing Partic このプロセスで生成される UID2 Token は共有専用です—ビッドストリームでは使用できません。ビッドストリーム用のトークン生成には別のワークフローがあります: [Tokenized Sharing in the Bidstream](../sharing/sharing-tokenized-from-data-bid-stream.md) を参照してください。 ::: - 使用例については [com.uid2.client.test.IntegrationExamples](https://github.com/IABTechLab/uid2-client-java/blob/master/src/test/java/com/uid2/client/test/IntegrationExamples.java) (`runSharingExample` メソッド) を参照してください。 + 使用例は [com.uid2.client.test.IntegrationExamples](https://github.com/IABTechLab/uid2-client-java/blob/master/src/test/java/com/uid2/client/test/IntegrationExamples.java) (`runSharingExample` メソッド) を参照してください。 次の手順では、SDK for C++ を送信者または受信者として使用して共有を実装する方法の例を示します。 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 f7659e857..97d31e047 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 @@ -34,7 +34,7 @@ UID2 とインテグレーションするには、UID2 アカウントが必要 - アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 - オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細は、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 DSP の場合は、資格情報を送信します。 @@ -82,7 +82,7 @@ SDK を使用する場合、復号鍵を保存したり管理したりする必 | Property | Description | | :--- | :--- | -| `Status` | 暗号化結果のステータス。取り得る値のリストと定義については [Encryption Response Statuses](#encryption-response-statuses) を参照してください。 | +| `Status` | 暗号化結果のステータス。取り得る値のリストと定義は [Encryption Response Statuses](#encryption-response-statuses) を参照してください。 | | `EncryptedData` | 暗号化された UID2 Token。 | ### Encryption Response Statuses @@ -104,7 +104,7 @@ SDK を使用する場合、復号鍵を保存したり管理したりする必 | Property | Description | | :--- | :--- | -| `Status` | 復号結果のステータス。取り得る値のリストと定義については [Decryption Response Statuses](#decryption-response-statuses) を参照してください。 | +| `Status` | 復号結果のステータス。取り得る値のリストと定義は [Decryption Response Statuses](#decryption-response-statuses) を参照してください。 | | `Uid` | UID2 Token に対応する raw UID2。 | | `Established` | ユーザーがパブリッシャーと最初に UID2 を確立した時のタイムスタンプ。 | @@ -155,7 +155,7 @@ else } ``` -完全な例については、[SampleApp/Program.cs](https://github.com/IABTechLab/uid2-client-net/blob/main/src/SampleApp/Program.cs) の `ExampleBidStreamClient` メソッドを参照してください。 +完全な例は、[SampleApp/Program.cs](https://github.com/IABTechLab/uid2-client-net/blob/main/src/SampleApp/Program.cs) の `ExampleBidStreamClient` メソッドを参照してください。 ## Usage for UID2 Sharers 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 c7871c716..818a9c54c 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 @@ -45,7 +45,7 @@ UID2 とインテグレーションするには、UID2 アカウントが必要 - オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。 - オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションのオプションの概要については、[Client-Side, Client-Server, or Server-Side Integration?](../guides/integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 +UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションのオプションの概要は、[Client-Side, Client-Server, or Server-Side Integration?](../guides/integration-mobile-overview#client-side-client-server-or-server-side-integration) を参照してください。 @@ -55,7 +55,7 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S このドキュメントは、iOS 用 UID2 SDK のバージョン 1.7.0 以降に対応しています。 -リリースノートの情報については、[https://github.com/IABTechLab/uid2-ios-sdk/releases](https://github.com/IABTechLab/uid2-ios-sdk/releases) を参照してください。 +リリースノートの情報は、[https://github.com/IABTechLab/uid2-ios-sdk/releases](https://github.com/IABTechLab/uid2-ios-sdk/releases) を参照してください。 ## GitHub Open-Source Repository @@ -118,9 +118,9 @@ iOS の場合、`UID2Manager` は初めてアクセスされたときに自動 UID2 Identity を確立する方法は2つあります: -1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順については、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 +1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順は、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) を参照してください。 -2. Server-Side で UID2 ID を生成し、それを UID2 SDK に渡します。インテグレーション手順については、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) を参照してください。 +2. Server-Side で UID2 ID を生成し、それを UID2 SDK に渡します。インテグレーション手順は、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md) を参照してください。 UID2 Mobile SDK は、UID2 identifier が確立された後に UID2 identities をリフレッシュできます。これは、リフレッシュ機能が UID2 Identity の一部である Refresh Token に依存しているためです。 @@ -129,7 +129,7 @@ UID2 Mobile SDK は、UID2 identifier が確立された後に UID2 identities 以下のコードサンプルは、iOS SDK を使用して UID2 を管理する特定のアクティビティを実行する例を示します。 -初期の UID2 Identity を生成します (手順については、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side#configure-the-uid2-mobile-sdk) を参照): +初期の UID2 Identity を生成します (手順は、[Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side#configure-the-uid2-mobile-sdk) を参照): ```js UID2Manager.shared.generateIdentity( @@ -139,7 +139,7 @@ UID2Manager.shared.generateIdentity( appName: String? = nil ) ``` -初期 UID2 Identity を設定します (手順については、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server#configure-the-uid2-mobile-sdk) を参照): +初期 UID2 Identity を設定します (手順は、[Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server#configure-the-uid2-mobile-sdk) を参照): ``` javascript UID2Manager.shared.setIdentity(_ identity: UID2Identity) 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 e26b8fbf5..c910168c5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md @@ -7,6 +7,7 @@ displayed_sidebar: docs --- import Link from '@docusaurus/Link'; +import POSTIdentityMapImprovements from '../snippets/_post-identity-map-improvements-v3.mdx'; # SDK for Java Reference Guide @@ -30,7 +31,7 @@ UID2 とインテグレーションするには、UID2 アカウントが必要 - アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 - オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細は、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 DSP の場合は、資格情報を送信します。 @@ -52,27 +53,28 @@ DSP の場合は、資格情報を送信します。 初期化ステップは、次の表に示すように、役割によって異なります。 -| Role | Create Instance of Class | Link to Instructions | -|:-------------------------| :--- |:-----------------------------------------------------------------------------| -| Publisher | `PublisherUid2Client` | [Usage for Publishers](#usage-for-publishers) | +| Role | Create Instance of Class | Link to Instructions | +| :--- | :--- | :--- | +| Publisher | `PublisherUid2Client` | [Usage for Publishers](#usage-for-publishers) | | Advertiser/Data Provider | `IdentityMapClient` | [Usage for Advertisers/Data Providers](#usage-for-advertisersdata-providers) | -| DSP | `BidstreamClient` | [Usage for DSPs](#usage-for-dsps) | -| Sharer | `SharingClient` | [Usage for UID2 Sharers](#usage-for-uid2-sharers) | +| DSP | `BidstreamClient` | [Usage for DSPs](#usage-for-dsps) | +| Sharer | `SharingClient` | [Usage for UID2 Sharers](#usage-for-uid2-sharers) | SDK が UID2 Service で認証するために必要な値を提供する必要があります。 -| Parameter | Description | -| :--- |:-------------------------------------------------------------------------------------------| -| `baseUrl/uid2BaseUrl` | The endpoint for the UID2 service. See [Environments](../getting-started/gs-environments). | -| `clientApiKey` | The API key. See [UID2 Credentials](../getting-started/gs-credentials). | -| `base64SecretKey` | The client secret. See [UID2 Credentials](../getting-started/gs-credentials). | +| Parameter | Description | +| :--- | :--- | +| `baseUrl/uid2BaseUrl` | The endpoint for the UID2 service. See [Environments](../getting-started/gs-environments). | +| `clientApiKey` | The API key. See [UID2 Credentials](../getting-started/gs-credentials). | +| `base64SecretKey` | The client secret. See [UID2 Credentials](../getting-started/gs-credentials). | ### Interface -`BidstreamClient` クラスを使用すると、UID2 Token を raw UID2 に復号することができます。 +`BidstreamClient` クラスを利用すると UID2 Token を raw UID2 に復号化できます。 + ユーザーのオプトアウトを処理する入札ロジックの詳細は [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 を使用する際に、復号鍵を保存したり管理したりする必要はありません。 @@ -84,7 +86,7 @@ SDK を使用する際に、復号鍵を保存したり管理したりする必 | Method | Description | | :--- | :--- | -| `getStatus()` | 暗号化結果のステータス。取り得る値のリストと定義については、[Encryption Response Statuses](#encryption-response-statuses) を参照してください。 | +| `getStatus()` | 暗号化結果のステータス。取り得る値のリストと定義は、[Encryption Response Statuses](#encryption-response-statuses) を参照してください。 | | `getEncryptedData()` | 暗号化された UID2 token。 | ### Encryption Response Statuses @@ -106,7 +108,7 @@ SDK を使用する際に、復号鍵を保存したり管理したりする必 | Methods | Description | | :--- | :--- | -| `getStatus()` | 復号結果のステータス。取り得る値のリストと定義については、[Decryption Response Statuses](#decryption-response-statuses) を参照してください。 | +| `getStatus()` | 復号結果のステータス。取り得る値のリストと定義は、[Decryption Response Statuses](#decryption-response-statuses) を参照してください。 | | `getUid()` | UID2 Token に対応する raw UID2 | | `getEstablished()` | ユーザーがパブリッシャーと最初に UID2 を確立した時のタイムスタンプ。 | @@ -131,7 +133,7 @@ SDK を使用する際に、復号鍵を保存したり管理したりする必 1. [**Basic Usage**](#basic-usage) は、この SDK の HTTP 実装 (synchronous [OkHttp](https://square.github.io/okhttp/)) を使いたいパブリッシャー向けです。 2. [**Advanced Usage**](#advanced-usage) は、独自の HTTP ライブラリを使用したいパブリッシャー向けです。 -Basic と Advanced 両方の使い方を示すサンプルアプリケーションについては、[Java UID2 Integration Example](https://github.com/UnifiedID2/uid2-examples/tree/main/publisher/uid2-java-test-site#readme) を参照してください。 +Basic と Advanced 両方の使い方を示すサンプルアプリケーションは、[Java UID2 Integration Example](https://github.com/UnifiedID2/uid2-examples/tree/main/publisher/uid2-java-test-site#readme) を参照してください。 ### Basic Usage @@ -145,7 +147,7 @@ SDK の HTTP 実装を使用している場合は、以下の手順に従って 2. ユーザーのメールアドレスまたは電話番号を入力として受け取り、`TokenGenerateResponse` オブジェクトを生成する関数を呼び出します。以下の例では、メールアドレスを使用しています: ```java - TokenGenerateResponse tokenGenerateResponse = publisherUid2Client.generateTokenResponse(TokenGenerateInput.fromEmail(emailAddress).doNotGenerateTokensForOptedOut()); + TokenGenerateResponse tokenGenerateResponse = publisherUid2Client.generateTokenResponse(TokenGenerateInput.fromEmail("user@example.com").doNotGenerateTokensForOptedOut()); ``` :::important @@ -193,7 +195,9 @@ Server-Side Integration ([Publisher Integration Guide, Server-Side](../guides/in 2. ID をリフレッシュできるかどうか (Refresh Token の有効期限が切れていないかどうか) を判断します: ```java - if (identity == null || !identity.isRefreshable()) { we must no longer use this identity (for example, remove this identity from the user's session) } + if (identity == null || !identity.isRefreshable()) { + // we must no longer use this identity (for example, remove this identity from the user's session) + } ``` 3. リフレッシュが必要かどうかを判断します: @@ -220,13 +224,13 @@ 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(emailAddress).doNotGenerateTokensForOptedOut()); + EnvelopeV2 envelope = publisherUid2Helper.createEnvelopeForTokenGenerateRequest(TokenGenerateInput.fromEmail("user@example.com").doNotGenerateTokensForOptedOut()); ``` 3. 選択した HTTP クライアントライブラリを使用して、ヘッダーとボディを含むこのエンベロープを [POST token/generate](../endpoints/post-token-generate.md) エンドポイントにポストします: 1. Headers: HTTP ライブラリによっては、以下のようになります: `.putHeader("Authorization", "Bearer " + UID2_API_KEY)` - `.putHeader("X-UID2-Client-Version", PublisherUid2Helper.getVersionHeader())` + `.putHeader("X-UID2-Client-Version", PublisherUid2Helper.getVersionHttpHeader())` 2. Body: `envelope.getEnvelope()` :::important ## SDK Documentation -UID2 インテグレーションについては、以下の SDK ドキュメントを参照してください。ドキュメンテーションのリンクは最初の欄にあります。 +UID2 インテグレーションは、以下の SDK ドキュメントを参照してください。ドキュメンテーションのリンクは最初の欄にあります。 | SDK/Link to Guide | Description | Audience | :--- | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-best-practices.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-best-practices.md index 27826c552..b67ed2a93 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-best-practices.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-best-practices.md @@ -35,9 +35,9 @@ raw UID2 や UID2 Token を、UID2 の許可を受けた他のユーザーと安 SDK を使用している場合、共有キーの更新スケジュールを設定することはセットアップの一部です。 -長時間/連続して実行されるプロセスの場合、`uid2client.refresh()` 関数を 1 時間ごとに呼び出すことを勧めます。ただし、他の更新頻度を選択することもできます。 +長時間/連続して実行されるプロセスの場合、`uid2client.refresh()` 関数を 1 時間ごとに呼び出すことを推奨します。ただし、他の更新頻度を選択することもできます。 -次の理由から、キーを 1 時間ごとに更新することを勧めます: +次の理由から、キーを 1 時間ごとに更新することを推奨します: - 定期的な更新により、SDK が復号化のために最新のキーを取得できます。新しい共有権限が有効になると、新しい共有送信者が送信したデータを復号化するために必要な追加の暗号キーのセットが、共有受信者が次に `uid2client.refresh()` 関数を呼び出すと返されます。このプロセスは SDK によって管理されます。 - UID2 フレームワークは、定期的に暗号キーをローテーションします。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-overview.md index 931e81ab8..baeb78cf7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-overview.md @@ -24,7 +24,7 @@ UID2 では、Sharing Participant とは、ある UID2 参加者から別の UID いくつかの主な共有シナリオは次の表にまとめられています。 -例については、[Sharing UID2s: Use Cases](sharing-use-cases.md) を参照してください。 +例は、[Sharing UID2s: Use Cases](sharing-use-cases.md) を参照してください。 | Sharing Scenario | Sender | Receiver | Sharing Approach | Sharing Route | Link for Details | :--- | :--- | :--- | :--- | :--- | :--- | @@ -54,7 +54,7 @@ Sharing 参加者が UID2 を他の許可された共有参加者と共有した - raw UID2 を UID2 Token に暗号化します。 3. 受信者は、共有シナリオに適用される指示に従って、UID2 Token を raw UID2 に復号します ([Approved Sharing Scenarios](#approved-sharing-scenarios) を参照)。 -UID2 Token を共有するためのオプションの詳細と説明へのリンクについては、[Tokenized Sharing Overview](sharing-tokenized-overview.md) を参照してください。 +UID2 Token を共有するためのオプションの詳細と説明へのリンクは、[Tokenized Sharing Overview](sharing-tokenized-overview.md) を参照してください。 ### Sharing Raw UID2s diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md index 704560013..fde18e776 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md @@ -84,7 +84,7 @@ Accounting とは、取引の記録があり、必要に応じてその活動を 4. UID2 Participant Authorization: - 指定された検証者は、UID2 参加ポリシーを含む有効で署名された契約が、受信者(またはその組織)と UID2 の間に存在することを検証します。 - このステップについては、UID2 の担当者に尋ねるのも一つの方法です。 + このステップは、UID2 の担当者に尋ねるのも一つの方法です。 5. Post-Verification Authorization: - 検証者が契約の存在と有効性を確認すると、共有参加者は共有されるデータへのアクセスを許可する権限を持ちます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md index a8a98c317..8dc3c9e03 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md @@ -55,7 +55,7 @@ UID2 Portal では、送信者と受信者がアカウントを設定し、送 ## Workflow: Tokenized Sharing in Tracking Pixels :::tip -トラッキングピクセル用のトークンを生成する場合、raw UID2 ではなく、DII から直接 UID2 Token を生成することを勧めます。これはいくつかの方法で行うことができますが、UID2 Token をクライアントサイドで生成することを勧めます。手順については、[Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照してください。 +トラッキングピクセル用のトークンを生成する場合、raw UID2 ではなく、DII から直接 UID2 Token を生成することを推奨します。これはいくつかの方法で行うことができますが、UID2 Token をクライアントサイドで生成することを推奨します。手順は、[Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を参照してください。 ::: ウェブサイトで製品の購入などのアクションが完了したときにトリガーされるトラッキングピクセルを使用している場合、おそらく DII から始めて、UID2 Token に変換して共有します。 @@ -70,7 +70,7 @@ UID2 送信者は、UID2 Token を復号化できる受信者を指定します 2. ユーザーから提供された DII から UID2 Token を直接生成します。これは、[POST /token/generate](../endpoints/post-token-generate.md) エンドポイントまたは UID2 Token を生成する SDK のいずれかを使用して行います。 - オプションの概要については、[SDK Functionality](../sdks/summary-sdks.md#sdk-functionality) を参照してください。JavaScript を使用して UID2 Token を生成する方法については、[Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を勧めます。 + オプションの概要は、[SDK Functionality](../sdks/summary-sdks.md#sdk-functionality) を参照してください。JavaScript を使用して UID2 Token を生成する方法は、[Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) を推奨します。 3. UID2 Tokeb を DSP に安全に送信します。 @@ -84,7 +84,7 @@ UID2 送信者と受信者の両方が、UID2 Portal アカウントを作成す すべての実装ステップは、[raw UID2 からの Tokenized sharing](sharing-tokenized-from-raw.md) と同じです。 -Snowflake を使用してピクセルで Tokenized Sharing を実装する方法の例については、[Snowflake Integration Guide: Usage for UID2 Sharers](../guides/integration-snowflake.md#usage-for-uid2-sharers) を参照してください。 +Snowflake を使用してピクセルで Tokenized Sharing を実装する方法の例は、[Snowflake Integration Guide: Usage for UID2 Sharers](../guides/integration-snowflake.md#usage-for-uid2-sharers) を参照してください。 ## Information for Sharing Receivers diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md index f2fd96107..5a0d29ca4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md @@ -88,7 +88,7 @@ raw UID2 から UID2 Token を生成して、Tokenized Sharing を行うワー 2. 送信者と受信者: 暗号鍵の更新スケジュールを定義します。 - 推奨される更新間隔は1時間です。例については、[Decryption Key Refresh Cadence for Sharing (SDK Only)](#decryption-key-refresh-cadence-for-sharing-sdk-only) を参照してください。 + 推奨される更新間隔は1時間です。例は、[Decryption Key Refresh Cadence for Sharing (SDK Only)](#decryption-key-refresh-cadence-for-sharing-sdk-only) を参照してください。 3. 送信者: 暗号化を設定します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md index 21259284b..d1f8afa71 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md @@ -26,7 +26,7 @@ UID2 では、Tokenized Sharing は、Private Operator を展開することを選択できます。このシナリオでは、自身のためだけのプライベートインスタンスをホストします。 -その他の情報については、次のリソースを確認してください: +その他の情報は、次のリソースを確認してください: - [The UID2 Operator](../ref-info/ref-operators-public-private.md) - [UID2 Private Operator Integration Overview](../guides/integration-options-private-operator.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-upgrade-policy.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-upgrade-policy.mdx index a086589c9..b58410c0a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-upgrade-policy.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-upgrade-policy.mdx @@ -1,7 +1,7 @@ -To maintain security and operational integrity, outdated operator versions will be disabled after 12 months, which may cause affected deployments to shut down or fail to start. Upgrading ensures the use of the latest security and feature enhancements. We recommend upgrading proactively to avoid disruptions. +セキュリティと運用の整合性を維持するため、古いオペレーターのバージョンは12ヶ月後に無効化され、影響を受けるデプロイメントがシャットダウンまたは起動に失敗する可能性があります。最新のセキュリティと機能強化を使用するために、アップグレードを推奨します。中断を避けるために、積極的なアップグレードを推奨します。 :::note -For critical security or operational issues, or where contract terms apply, we reserve the right to enforce tighter upgrade timelines for private operators. +重要なセキュリティまたは運用上の問題、または契約条件が適用される場合、プライベートオペレーターに対してより厳しいアップグレードタイムラインを適用する権利を留保します。 ::: \ No newline at end of file