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 7fd53d5ba..129ad700f 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 @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # POST /identity/buckets -ソルトバケットのローテーションをモニターします。 +salt buckets のローテーションをモニターします。 Used by: このエンドポイントは、主に広告主とデータプロバイダーによって使用されます。詳細は [Advertiser/Data Provider Integration Guide](../guides/advertiser-dataprovider-guide.md) を参照してください。 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 197813e65..d1ef25a40 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 @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # POST /identity/map -複数のメールアドレス、電話番号、またはそれぞれのハッシュを、raw UID2 とソルトバケット ID にマッピングします。このエンドポイントを使用して、オプトアウト情報の更新をチェックすることもできます +複数のメールアドレス、電話番号、またはそれぞれのハッシュを、raw UID2 と salt bucket IDs にマッピングします。このエンドポイントを使用して、オプトアウト情報の更新をチェックすることもできます Used by: このエンドポイントは、主に広告主やデータプロバイダーが使用します。詳細は [Advertiser/Data Provider Integration Guide](../guides/advertiser-dataprovider-guide.md) を参照してください。 @@ -19,7 +19,7 @@ Used by: このエンドポイントは、主に広告主やデータプロバ - リクエストの最大サイズは 1MB です。 - 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムのバッチサイズで、それらを *連続した* バッチで送信してください。 -- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、1 つの HTTP 接続を使用して、[directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を連続してマッピングしてください。 +- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用して、[directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を連続してマッピングしてください。 - メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする必要がある場合に、処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングのみを再計算することで、毎日更新が必要な raw UID2 の数は約 1/365 となり、総処理時間を短縮できます。[Advertiser/Data Provider Integration Guide](../guides/advertiser-dataprovider-guide.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) も参照してください。 ## Request Format diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md index a321f4558..03a7478b3 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 @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # POST /optout/status -raw UID2 のオプトアウトステータスを確認します。指定された raw UID2 のリストを使用して、このエンドポイントはオプトアウトした raw UID2 とそのオプトアウトが行われた時刻を返します。詳細は [User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +raw UID2s のオプトアウトステータスを確認します。指定された raw UID2 のリストを使用して、このエンドポイントはオプトアウトした raw UID2 とそのオプトアウトが行われた時刻を返します。詳細は [User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 Used by: このエンドポイントは、主に広告主、データプロバイダー、DSP、共有者によって使用されます。一般的には、元のメールアドレスや電話番号にアクセスできないが、オプトアウトステータスを知りたい参加者向けです。 @@ -24,7 +24,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ このエンドポイントへのリクエストのバッチを管理するための主要なガイドラインは次のとおりです: - 多数の UID2 のオプトアウトステータスを確認するには、1 バッチあたりのバッチサイズが最大 5,000 件となるように、順次バッチを送信してください。 -- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、1 つの HTTP 接続を使用して、連続して raw UID2 のバッチを送信してください。 +- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、複数の並列接続を作成せず、単一の HTTP 接続を使用して、連続して raw UID2 のバッチを送信してください。 ## 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 2bec7e762..ff87dd956 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 @@ -28,7 +28,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 このエンドポイントについて知っておくべきことは、以下のとおりです: -- トークン更新のリクエストには暗号化は必要ありません。 +- `POST /token/refresh` えんどぽいんとへのリクエストには暗号化は不要です。 - リクエストが HTTP ステータスコード 200 で成功すると、新しい UID2 Token または Out-Out 情報が返されます。 - 成功したレスポンスは、そのレスポンスに新しいトークンまたは Opt-Out 情報が含まれているかどうかにかかわらず暗号化されます。エラーレスポンスは暗号化されません。 - レスポンスを復号化するには、このトークンに対する最新の `refresh_response_key` 値を使用します。`refresh_response_key` の値は、[POST /token/generate](post-token-generate.md) と `POST /token/refresh` のレスポンスで返されます。トークンがリフレッシュされるたびに、新しい `refresh_response_key` が返されます。現在のレスポンスを復号化するには、必ず最新のものを使用してください。 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 9a67baa31..f9ff84df8 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 @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # UID2 Credentials -UID2 参加者はそれぞれ、固有の認証情報のセットを取得します。取得する認証情報のセットは、次の表に示すように、UID2 にどのように参加しているかによって決まります。 +UID2 参加者はそれぞれ、固有の認証情報のセットを取得します。取得する認証情報のセットは、次の表に示すように、UID2 にどのように参加しているかによって決まります。 | Audience | Credentials | Integration | | :--- | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md index 49898b2cb..4425f6fb7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md @@ -206,6 +206,11 @@ Maven を使用している場合は、以下の最小限の `pom.xml` を使用 このファイルには.NET 7.0が必要です。必要であれば、それ以前のバージョンを使用することもできますが、.NET Core 3.0以降でなければなりません。バージョンを変更するには、[top-level statements](https://learn.microsoft.com/ja-jp/dotnet/csharp/fundamentals/program-structure/top-level-statements) を Main メソッドに、[using 宣言](https://learn.microsoft.com/ja-jp/cpp/cpp/using-declaration?view=msvc-170) を [using ステートメント](https://learn.microsoft.com/ja-jp/dotnet/csharp/language-reference/proposals/csharp-8.0/using) に置き換えてください。 + + + +以下のコード例では、Go を使用してリクエストを暗号化し、レスポンスを復号化します。必要なパラメータはファイルの一番下に記載されています。または、`go run uid2_request.go` を実行して確認できます。 + @@ -574,5 +579,246 @@ else Console.WriteLine(JsonSerializer.Serialize(jDoc, new JsonSerializerOptions { WriteIndented = true })); } ``` + - + + +```go title="uid2_request.go" +package main + +import ( + "bytes" + "crypto/aes" + "crypto/cipher" + "crypto/rand" + "encoding/base64" + "encoding/binary" + "encoding/json" + "fmt" + "io" + "log" + "net/http" + "os" + "strings" + "time" +) + +const ( + nonceLengthBytes = 8 + gcmIVLengthBytes = 12 +) + +func main() { + subArgs := os.Args[1:] + + if len(subArgs) != 3 && len(subArgs) != 4 { + printUsage() + os.Exit(1) + } + + url := subArgs[0] + + response, err := func() (map[string]interface{}, error) { + if subArgs[1] == "--refresh-token" { + return refresh(url, subArgs[2], subArgs[3]) + } else { + return generate(url, subArgs[1], subArgs[2]) + } + }() + + if err != nil { + log.Fatal(err) + } + + prettyPrint(response) +} + +func refresh(url string, refreshToken string, refreshResponseKey string) (map[string]interface{}, error) { + fmt.Printf("Request: Sending refresh_token to %s\n", url) + + response, err := http.Post(url, "", strings.NewReader(refreshToken)) + if err != nil { + return nil, err + } + + return deserializeResponse(response, refreshResponseKey, true) +} + +func generate(url string, apiKey string, secret string) (map[string]interface{}, error) { + payload, err := io.ReadAll(os.Stdin) + if err != nil { + return nil, err + } + + key, err := base64.StdEncoding.DecodeString(secret) + if err != nil { + return nil, err + } + + unencryptedEnvelope, err := makeUnencryptedEnvelope(payload) + if err != nil { + return nil, err + } + + envelope, err := makeEncryptedEnvelope(unencryptedEnvelope, key) + if err != nil { + return nil, err + } + + req, err := http.NewRequest("POST", url, strings.NewReader(base64.StdEncoding.EncodeToString(envelope))) + if err != nil { + return nil, err + } + + req.Header.Add("Authorization", "Bearer "+apiKey) + + response, err := http.DefaultClient.Do(req) + if err != nil { + return nil, err + } + + return deserializeResponse(response, secret, false) +} + +func aesgcm(key []byte) (cipher.AEAD, error) { + block, err := aes.NewCipher(key) + if err != nil { + return nil, err + } + + return cipher.NewGCM(block) +} + +func decryptResponse(ciphertext string, key string) ([]byte, error) { + ciphertextBytes, err := base64.StdEncoding.DecodeString(ciphertext) + if err != nil { + return nil, err + } + + keyBytes, err := base64.StdEncoding.DecodeString(key) + if err != nil { + return nil, err + } + + aesgcm, err := aesgcm(keyBytes) + if err != nil { + return nil, err + } + + iv := ciphertextBytes[:gcmIVLengthBytes] + return aesgcm.Open(nil, iv, ciphertextBytes[gcmIVLengthBytes:], nil) +} + +func deserialize(bytes []byte) (map[string]interface{}, error) { + var anyJson map[string]interface{} + err := json.Unmarshal(bytes, &anyJson) + return anyJson, err +} + +func prettyPrint(obj map[string]interface{}) error { + bytes, err := json.MarshalIndent(obj, "", " ") + if err != nil { + return err + } + + fmt.Println(string(bytes)) + return nil +} + +func checkStatusCode(response *http.Response, body []byte) error { + if response.StatusCode != http.StatusOK { + return fmt.Errorf("Response: Error HTTP status code %d\n%s", response.StatusCode, body) + } + + return nil +} + +func makeUnencryptedEnvelope(payload []byte) ([]byte, error) { + timestamp := make([]byte, 8) + binary.BigEndian.PutUint64(timestamp, uint64(time.Now().UnixMilli())) + + nonce := make([]byte, nonceLengthBytes) + _, err := rand.Read(nonce) + if err != nil { + return nil, err + } + + var body bytes.Buffer + body.Write(timestamp) + body.Write(nonce) + body.Write(payload) + return body.Bytes(), nil +} + +func encrypt(plaintext []byte, iv []byte, key []byte) ([]byte, error) { + aesgcm, err := aesgcm(key) + if err != nil { + return nil, err + } + + return aesgcm.Seal(nil, iv, plaintext, nil), nil +} + +func makeEncryptedEnvelope(payload []byte, key []byte) ([]byte, error) { + iv := make([]byte, gcmIVLengthBytes) + _, err := rand.Read(iv) + if err != nil { + return nil, err + } + + ciphertext, err := encrypt(payload, iv, key) + if err != nil { + return nil, err + } + + var envelope bytes.Buffer + envelope.WriteByte(1) + envelope.Write(iv) + envelope.Write(ciphertext) + return envelope.Bytes(), nil +} + +func deserializeResponse(response *http.Response, key string, isRefresh bool) (map[string]interface{}, error) { + defer response.Body.Close() + + body, err := io.ReadAll(response.Body) + if err != nil { + return nil, err + } + + err = checkStatusCode(response, body) + if err != nil { + return nil, err + } + + plaintext, err := decryptResponse(string(body), key) + if err != nil { + return nil, err + } + + offset := 16 + if isRefresh { + offset = 0 + } + + return deserialize(plaintext[offset:]) +} + +func printUsage() { + fmt.Println(`Usage: + echo '' | go run uid2_request.go + +Example: + echo '{"email": "test@example.com", "optout_check": 1}' | go run uid2_request.go https://prod.uidapi.com/v2/token/generate UID2-C-L-999-fCXrMM.fsR3mDqAXELtWWMS+xG1s7RdgRTMqdOH2qaAo= wJ0hP19QU4hmpB64Y3fV2dAed8t/mupw3sjN5jNRFzg= + + +Refresh Token Usage: + go run uid2_request.go --refresh-token + +Refresh Token Usage example: + go run uid2_request.go https://prod.uidapi.com/v2/token/refresh --refresh-token AAAAAxxJ...(truncated, total 388 chars) v2ixfQv8eaYNBpDsk5ktJ1yT4445eT47iKC66YJfb1s=`) +} +``` + + + \ No newline at end of file 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 7b1f83b5d..2a889c473 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 @@ -20,6 +20,7 @@ UID2 フレームワークに関するよくある質問を紹介します。 - [ユーザーは、自分の UID2 ID に基づいたターゲティング広告をオプトアウトできますか?](#can-users-opt-out-of-targeted-advertising-tied-to-their-uid2) - [UID2 に DII を送信すると、UID2 はその情報を保存しますか?](#when-i-send-dii-to-uid2-does-uid2-store-the-information) - [UID2 は HIPAA で規制されているデータの処理を許可しますか?](#does-uid2-allow-the-processing-of-hipaa-regulated-data) +- [パブリックオペレーターとプライベートオペレーターのどちらを使用すべきですか?](#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) を参照してください。 @@ -33,7 +34,7 @@ EUID インフラのすべてのインテグレーションパートナー(SSP #### Can users opt out of targeted advertising tied to their UID2? ユーザーは、自分の UID2 ID に基づいたターゲティング広告をオプトアウトできますか? -はい。[Transparency and Control Portal](https://www.transparentadvertising.com/) を通して、ユーザーは自分の UID2 ID に関連するターゲティング広告の配信をオプトアウトできます。各リクエストは、UID2 Opt-Opt Service と UID2 Operator を通じて配信され、UID2 Operator はオプトアウト情報を関連するすべての参加者に公開します。 +はい。[Transparency and Control Portal](https://www.transparentadvertising.com/) を通して、ユーザーは自分の UID2 に関連するターゲティング広告の配信をオプトアウトできます。各リクエストは、UID2 Opt-Opt Service と UID2 Operator を通じて配信され、UID2 Operator はオプトアウト情報を関連するすべての参加者に公開します。 #### When I send DII to UID2, does UID2 store the information? UID2 に DII を送信すると、UID2 はその情報を保存しますか? @@ -47,6 +48,17 @@ UID2 は HIPAA で規制されているデータの処理を許可しますか いいえ。UID2 の参加者は、HIPAA (Health Insurance Portability and Accountability Act of 1996;医療保険の携行性と責任に関する法律) で定義されている、保護対象保険情報 (PHI: Protected Health Information) から UID2 を生成してはなりません。 +#### Should I use a Public Operator or a Private Operator? +パブリックオペレーターとプライベートオペレーターのどちらを使用すべきですか? + +ほとんどの参加者にとって、Public Operator が最もシンプルなソリューションです。Public Operator のインテグレーションは、独自の Private Operator をホストするよりも簡単なオプションです。Private Operator インスタンスを持つことにはいくつかの利点がありますが、追加の複雑さとコストがかかります。 + +最適な選択肢は、自身の状況やニーズによって異なります。決定に役立つ情報については、以下を参照してください: + +1. [The UID2 Operator](../ref-info/ref-operators-public-private.md) + +1. [UID2 Private Operator Integration Overview](../guides/integration-options-private-operator.md) + ## FAQs for Publishers UID2 フレームワークを使用するパブリッシャーからのよくある質問です。 @@ -100,7 +112,7 @@ Client-Side からトークンのリフレッシュを呼び出すことはで リフレッシュのタイミングを決定するには、[POST /token/generate](../endpoints/post-token-generate.md) エンドポイントのレスポンスの `refresh_from` フィールドのタイムスタンプを使用します(詳細は [Successful Response](../endpoints/post-token-generate.md#successful-response) を参照してください)。または、[POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントのレスポンスの `refresh_from` フィールドのタイムスタンプを使用します(詳細は [Successful Response With Tokens](../endpoints/post-token-refresh.md#successful-response-with-tokens) を参照してください)。 -トークンのリフレッシュが必要かどうかを確認する機能を持つ SDK のいずれかを使用することもできます。 +Token Refreshが必要かどうかを確認する機能を持つ SDK のいずれかを使用することもできます。 詳細は、[Recommended Token Refresh Frequency](../ref-info/ref-tokens.md#recommended-token-refresh-frequency) および [Managing Token Refresh with an SDK](../ref-info/ref-tokens.md#managing-token-refresh-with-an-sdk) を参照してください。 @@ -158,7 +170,7 @@ UID2 フレームワークを使用する広告主やデータプロバイダー #### How do I know when to refresh the UID2 due to salt bucket rotation? ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには? -UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用されるソルトバケットが含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎的な DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。 +UID2 生成リクエストで提供されるメタデータには、UID2 の生成に使用される salt bucket が含まれます。ソルトバケットは持続し、UID2 の生成に使用された基礎となる DII に対応します。指定されたタイムスタンプ以降にローテーションしたソルトバケットを得るには、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントを使用します。返されたローテーションしたソルトバケットは、どの UID2 をリフレッシュすべきかを教えてくれます。 :::note ローテーションがいつ行われるかについては、いかなる約束もいたしません。可能な限り最新の状態を保つため、1 時間に 1 回のチェックを勧めます。 @@ -190,8 +202,8 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 はい。何百万ものメールアドレスや電話番号をマッピングする必要がある場合、マッピングを保存しないことで処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングだけを再計算すると、毎日更新する必要があるのは UID2 の約 365 分の 1 なので、総処理時間が短縮されます。 -:::info -Private Operator を使用している場合を除き、メールアドレス、電話番号、ハッシュのマッピングは、単一の HTTP 接続を使用して、一度に 5,000件 ずつ連続して行う必要があります。言い換えれば、複数の並列接続を作成せずにマッピングを行うことです。 +:::important +Private Operator を使用していない場合は、単一の HTTP 接続を使用して、バッチあたり最大 5,000 アイテムのバッチサイズで、メールアドレス、電話番号、またはハッシュを連続してマッピングする必要があります。つまり、複数の並行接続を作成せずにマッピングを行ってください。 ::: #### How should I handle user opt-outs? @@ -217,7 +229,7 @@ Private Operator を使用している場合を除き、メールアドレス、 はい、リクエストが raw UID2 に対するものである場合は、同じです。前の FAQ で説明したように、[同じ DII は常に同じ raw UID2 になりますか?](#does-the-same-dii-always-result-in-the-same-raw-uid2)、広告主やデータプロバイダーが同時に同じ DII を UID2 Operator に送信する場合、SDK または [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを使用して、同じ raw UID2 が生成されます。 -Operator に関係なく、また、Private Operator と Public Operator のどちらであっても、結果は同じです。 +Operator に関係なく、また、Private Operator と Public Operator のどちらであっても、結果は同じです。 タイミングが重要なのは、ソルトバケットのローテーションのためです。リクエスト間でソルト値が変化すると、結果は異なる raw 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 7a4b94025..6737080f6 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 @@ -28,7 +28,7 @@ UID2は、以下の種類の DII (direct identifying information) をサポー ## Email Address Normalization -UID2 Operator Service にハッシュ化されていないメールアドレスを送信すると、同サービスはメールアドレスを正規化してからハッシュ化します。メールアドレスを送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に正規化する必要があります。 +UID2 Operator Service にハッシュ化されていないメールアドレスを送信すると、同サービスはメールアドレスを正規化してからハッシュ化します。メールアドレスを送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に正規化する必要があります。 :::important ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md index f50cf3b26..51a8d96c2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/advertiser-dataprovider-guide.md @@ -13,7 +13,7 @@ import Link from '@docusaurus/Link'; このガイドでは、ユーザーデータを収集し、DSP にプッシュする組織のためのインテグレーション手順について説明します。データコレクターには、広告主、データオンボーダー、測定プロバイダー、ID グラフプロバイダー、サードパーティデータプロバイダー、および DSP にデータを送信する他の組織が含まれます。 -Snowflake Data Marketplace でホストされる Open Operator Service を使用する場合は、[Snowflake Integration Guide](../guides/snowflake_integration.md) も参照してください。 +Snowflake Data Marketplace でホストされる Public Operator Service を使用する場合は、[Snowflake Integration Guide](../guides/snowflake_integration.md) も参照してください。 ## Advertiser/Data Provider Routes to Use UID2 @@ -102,7 +102,7 @@ UID2 ベースのオーディエンス情報を正確かつ最新の状態に保 ユーザーのオプトアウトステータスを受け入れることは重要です。最新のオプトアウト情報を確認するために、次の 2 つの方法を使用できます: -- UID2 Operator Service は、広告主やデータプロバイダーに、[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを介してオプトアウト情報を配布します。 +- UID2 Operator Service は、広告主やデータプロバイダーに、[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを介してオプトアウト情報を配布します。 - 広告主やデータプロバイダーは、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、生の UID2 のオプトアウトステータスを確認できます。 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 6d052a198..682663831 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 @@ -42,7 +42,7 @@ SDK for JavaScript を使って UID2 とインテグレーションするため ## Refreshing the UID2 Token -SDK for JavaScript には、トークンの自動リフレッシュ機能があります。 +SDK for JavaScript には、自動の Token Refresh 機能があります。 ## Storing the UID2 Token in the Browser 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 2ff0c78d1..97e98270b 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 @@ -10,14 +10,15 @@ sidebar_position: 04 import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Link from '@docusaurus/Link'; +import ExampleAdvertisingToken from '/docs/snippets/_example-advertising-token.mdx'; import EnableLogging from '/docs/snippets/_mobile-docs-enable-logging.mdx'; import GMAIMA_Plugins from '/docs/snippets/_mobile_docs_gmaima-plugin-gss.mdx'; import PrebidMobileSDK from '/docs/snippets/_mobile_docs_prebid-mobile.mdx'; -import ExampleAdvertisingToken from '/docs/snippets/_example-advertising-token.mdx'; +import ErrorResponseStates from '/docs/snippets/_mobile-docs-error-response-states.mdx'; # UID2 Client-Server Integration Guide for Mobile -このガイドは、Public Operator または Private Operator を介して Server-Side で UID2 Token を生成し、そのトークンとユーザー ID をモバイルアプリに渡して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けです。モバイルアプリは、そのトークンを ビッドストリーム に使用するために渡します。 +このガイドは、Public Operator または Private Operator を介して Server-Side で UID2 Token を生成し、そのトークンとユーザー ID をモバイルアプリに渡して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けです。モバイルアプリは、そのトークンを ビッドストリーム に使用するために渡します。 これは Client-Server インテグレーションと呼ばれます。これは、いくつかのインテグレーションステップがクライアントサイドで行われ、いくつかがサーバーサイドで行われるためです。 @@ -47,10 +48,10 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref ## Mobile SDK Version -このガイドは、次のいずれかの UID2 mobile SDK のバージョン 1.2.0 以上を使用する方法について説明します: +このガイドは、次のいずれかの UID2 mobile SDK を使用する方法について説明します: -- SDK for Android (version 1.6.0 or later) -- SDK for iOS (version 1.7.0 or later) +- 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) を参照してください。 @@ -84,7 +85,7 @@ UID2 は、[Android](../sdks/sdk-ref-android.md) および [iOS](../sdks/sdk-ref ## Server-Side Token Refresh -UID2 mobile SDK では Token Refresh が自動的に有効になっています。Server-Side で明示的に管理する必要はありません。 +UID2 mobile SDK では Token Refresh が自動的に有効になっています。Server-Side で明示的に管理する必要はありません。 モバイルアプリでの変更をできるだけシンプルにしたい場合は、Server-Side で Token Refresh を行うこともできます。 @@ -307,4 +308,8 @@ UID2Manager.shared.automaticRefreshEnabled = false ## Optional: UID2 Prebid Mobile SDK Integration - \ No newline at end of file + + +## Error Response States + + \ No newline at end of file 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 53287027d..1499c8ee1 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 @@ -11,10 +11,10 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Link from '@docusaurus/Link'; import GMAIMA_Plugins from '/docs/snippets/_mobile_docs_gmaima-plugin-gss.mdx'; +import ExampleAdvertisingToken from '/docs/snippets/_example-advertising-token.mdx'; import EnableLogging from '/docs/snippets/_mobile-docs-enable-logging.mdx'; import PrebidMobileSDK from '/docs/snippets/_mobile_docs_prebid-mobile.mdx'; -import ExampleAdvertisingToken from '/docs/snippets/_example-advertising-token.mdx'; - +import ErrorResponseStates from '/docs/snippets/_mobile-docs-error-response-states.mdx'; # UID2 Client-Side Integration Guide for Mobile @@ -49,10 +49,10 @@ UID2 を Client-Side でインテグレーションするには、以下の手 ## Mobile SDK Version -このガイドは、次のいずれかの UID2 mobile SDK のバージョン 1.2.0 以上を使用する方法について説明します: +このガイドは、次のいずれかの UID2 mobile SDK を使用する方法について説明します: -- SDK for Android -- SDK for iOS +- 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) を参照してください。 @@ -67,6 +67,7 @@ Android または iOS 向けの適用可能な手順に従ってください: 1. [SDK for Android source code repository on GitHub](https://github.com/IABTechLab/uid2-android-sdk/tree/main) の main ブランチをチェックアウトします。 1. Android Studio (Jellyfish/v2023.3.1 または SDK for Android リリース時に必要な Android Gradle Plugin バージョンをサポートする将来のバージョン) で、チェックアウトしたディレクトリを開きます。 +1. [AndroidManifest.xml](https://github.com/IABTechLab/uid2-android-sdk/blob/main/dev-app/src/main/AndroidManifest.xml) で、`uid2_environment_euid` を `false` に設定します。 1. **dev-app** アプリを実行します。 1. アプリを起動したら、**Client Side** チェックボックスがチェックされていることを確認します。 1. メールアドレスまたは電話番号を入力し、右側の矢印をクリックします。 @@ -80,6 +81,14 @@ Android または iOS 向けの適用可能な手順に従ってください: ```js Development/UID2SDKDevelopmentApp/UID2SDKDevelopmentApp.xcodeproj ``` +1. Xcode のエディタで、`Development/UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist` の `UID2EnvironmentEUID` キーを `NO` に設定します。または、コマンドラインから `plutil` を使用できます: + ```console + plutil -replace UID2EnvironmentEUID -bool NO Development/UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist + ``` + EUID 環境を使うには、 + ```console + plutil -replace UID2EnvironmentEUID -bool YES Development/UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist + ``` 1. **UID2SDKDevelopmentApp** アプリのスキームを実行します。 1. アプリを起動したら、**Client Side** チェックボックスがチェックされていることを確認します。 1. メールアドレスまたは電話番号を入力し、右側の矢印をクリックします。 @@ -707,7 +716,6 @@ If the response status indicates that the DII has been opted out of UID2, you mi - ## Optional: UID2 Prebid Mobile SDK Integration :::important @@ -715,3 +723,7 @@ UID2 Prebid Mobile SDK インテグレーションは、UID2 SDK for Android ver ::: + +## Error Response States + + \ No newline at end of file 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 0d2da3b45..4deb720ef 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 @@ -28,15 +28,6 @@ UID2 は、Android/iOS 向けの SDK を提供しており、次の機能をサ さらに、UID2 は、一部の機能に対して代替手段を提供し、UID2 Google GMA/IMA プラグインなどの補完製品も提供しています。利用可能なオプションについては、個々のガイドで説明されています: [Integration Overview: High-Level Steps](#integration-overview-high-level-steps) を参照してください。 -## Client-Side or Client-Server Integration - -UID2 mobile SDK を使用して UID2 とインテグレーションするオプションは、次の表にまとめられています。最適なオプションを選択してください。 - -| Scenario | Option | Integration Guide | -| :--- | :--- | :--- | -| Client Side/モバイルアプリ内で DII(メールアドレスまたは電話番号)にアクセスでき、変更をアプリ内だけに留めておきたい場合。 | Client-side integration | [UID2 Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | -| Server-Side でのみ DII にアクセスでき、Server-Side で UID2 Token を生成するために必要な開発ができるか、Private Operatorを使用している場合。 | Client-Server Integration | [UID2 Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) | - ## Integration Overview: High-Level Steps UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレーションするには、次の手順を完了する必要があります: @@ -58,6 +49,72 @@ UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレ - [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) - [Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) +## Mobile Integration Paths + +モバイルシナリオに最適なインテグレーションパスを決定するには、次の点を考慮してください: + +1. UID2 Token を Client-Side または Server-Side で取得しますか? [Generating, Storing, and Refreshing the UID2 Token](#generating-storing-and-refreshing-the-uid2-token) を参照してください。 + +1. UID2 Token の取得とリフレッシュ何を使いますか? [Generating, Storing, and Refreshing the UID2 Token](#generating-storing-and-refreshing-the-uid2-token) を参照してください。 + +1. UID2 Token をどのように使いたいですか? [Sending the Token to the Bidstream](#sending-the-token-to-the-bidstream) を参照してください。 + +### Client-Side or Client-Server Integration? + +UID2 mobile SDK を使用して UID2 とインテグレーションするためのオプションは、次の表にまとめられています。最適な Integration approach を選択してください。 + +| Scenario | Option | Integration Guide | +| :--- | :--- | :--- | +| モバイルアプリ内のクライアントサイドで DII (メールアドレスまたは電話番号) にアクセスでき、変更をアプリ内にのみ保持したい場合。 | Client-Side インテグレーション | [UID2 Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | +| Server-Side でのみ DII にアクセスでき、UID2 Token を生成するための開発を Server-Side で行うことができる場合、または Private Operator を使用している場合。 | Client-Server インテグレーション | [UID2 Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) | + +### Generating, Storing, and Refreshing the UID2 Token + +以下の表は、UID2 Token の管理に関するモバイルインテグレーションオプションをまとめたもので、トークンの生成、保存、およびリフレッシュを含みます。各オプションのドキュメントへのリンクが含まれています。 + +| UID2 Mobile Implementation Option | SDK Doc | Implementation Guide | +| :--- | :---| :---| +| UID2 Android SDK | [SDK for Android Reference Guide](../sdks/sdk-ref-android.md) | 以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
| +| UID2 iOS SDK | [SDK for iOS Reference Guide](../sdks/sdk-ref-ios.md) | 以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
| + +### Sending the Token to the Bidstream + +UID2 Token をビッドストリームに送信する方法はいくつかあります。 + +以下の表は、UID2 がサポートするオプションをまとめたものです。 + +| Scenario | Integration Guide | +| :--- | :--- | +| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を Android アプリに統合したい | 以下の順番で:
  1. [UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md)
  2. 以下のいずれか:
    • Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
    • Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
| +| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を iOS アプリに統合したい | 以下の順番で:
  1. [UID2 GMA Plugin for iOS Integration Guide](../guides/mobile-plugin-gma-ios.md)
  2. 以下のいずれか:
    • Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
    • Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
| +| Google IMA を使用して、Android アプリにマルチメディア広告を統合したい | 以下の順番で:
  1. [UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md)
  2. 以下のいずれか:
    • Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
    • Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
| +| Google IMA を使用して、iOS アプリにマルチメディア広告を統合したい | 以下の順番で:
  1. [UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios.md)
  2. 以下のいずれか:
    • Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
    • Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)
| +| Prebid Mobile SDKとPrebid Serverを使用して、AndroidまたはiOSアプリから広告リクエストを送信したい | 以下のいずれか:
  • Client-side: [Optional: UID2 Prebid Mobile SDK Integration](../guides/integration-mobile-client-side.md#optional-uid2-prebid-mobile-sdk-integration)
  • Client-server: [Optional: UID2 Prebid Mobile SDK Integration](../guides/integration-mobile-client-server.md#optional-uid2-prebid-mobile-sdk-integration)
| + +### Functionality Summary + +以下の表は、さまざまなインテグレーションオプションで利用可能な機能をまとめたものです。 + +すべてのオプションは、Client-Side または Server-Side インテグレーションをサポートしています。 + +| Implementation Option | Generate Token from DII | Refresh Token | Android/iOS? | Send Token to Bidstream | +| :--- | :--- | :--- | :--- | :--- | +| UID2 SDK for Android | ✅ | ✅ | Android | * | +| UID2 SDK for iOS | ✅| ✅ | iOS | * | +| GMA Plugin for Android
(Requires UID2 SDK for Android) | — | — | Android | ✅** | +| GMA Plugin for iOS
(Requires UID2 SDK for iOS) | — | — | iOS | ✅** | +| IMA Plugin for Android
(Requires UID2 SDK for Android)| — | — | Android | ✅** | +| IMA Plugin for iOS
(Requires UID2 SDK for iOS)| — | — | iOS | ✅** | +| Prebid Mobile SDK | — | — | Either | ✅*** | + +*SDK を IMA/GMA プラグインまたは Prebid Mobile SDK と組み合わせて、Google または Prebid Server を介してトークンをビッドストリームに送信するか、SDK からトークンを手動で取得して別の方法でビッドストリームに渡すことができます。 + +**セットアップ後、Google GMA/IMA はトークンを自動的に収集し、ビッドストリームに送信します。 + +***セットアップ後、Prebid Mobile SDK はトークンを広告リクエストに追加して Prebid Server に送信します。 + + + ## FAQs for Mobile Integrations UID2 モバイルインテグレーションに関する FAQ 情報は次のとおりです: @@ -74,6 +131,7 @@ UID2 Mobile インテグレーションには、UID2 Mobile SDK、UID2 GMA プ - すでに CocoaPods を使用している場合、特に Google Ad Frameworks を自分でインテグレーションしている場合は、UID2 SDK を CocoaPods を使用してインテグレーションすることが最適です。 - 依存関係のインテグレーションが初めての場合、または Swift Package Manager ですでに依存関係がある場合は、UID2 モバイルインテグレーションには Swift Package Manager を使用することを勧めます。 + :::caution すでに CocoaPods を使用している場合、UID2 SDK とプラグインを Swift Package Manager (SPM) を使用してインテグレーションしても、アプリが UID2 SDK とプラグインを使用することを妨げるものではありません。ただし、潜在的な競合があります。すでに CocoaPods で GMA をインストールしている場合、その後 UID2 Mobile SDK を Swift Package Manager でインストールすると、実装に GMA の 2 つのコピーが含まれるため、動作しません。 ::: @@ -85,7 +143,6 @@ Podspec は、CocoaPods 内のファイル名で、アプリにインテグレ ::: ## Troubleshooting Tips for Mobile Integrations - UID2 モバイルインテグレーションのトラブルシューティングに役立つ追加情報です: - [Android SDK が本番環境に接続できない](#android-sdk-cannot-connect-in-production-environment) 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 26cd0a320..980e6c31d 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 @@ -8,7 +8,7 @@ import Link from '@docusaurus/Link'; # UID2 Private Operator Integration Overview -Private Operator をホストする UID2 参加者は、自身のローカル UID2 Operator サービスに、自社のファーストパーティ directly identifying information (DII) を送信します。この Operator は、プライベート環境で実行されます。 +Private Operator をホストする UID2 参加者は、自身のローカル UID2 Operator サービスに、自社のファーストパーティ directly identifying information (DII) を送信します。この Operator は、プライベート環境で実行されます。 Private Operator は enclave—不正アクセスを防ぐための追加のセキュリティ機能を備えた仮想マシンで実行されます。このため、不正な個人は仮想マシンから構成情報やデータをダウンロードできません。 @@ -16,6 +16,10 @@ Private Operator になるには、いくつかの追加ステップが必要で UID2 フレームワークが Private Operator 向けに提供する機能、利点、ホスティング オプション、ドキュメントとその他のリソース、および開始方法について説明します。 +:::note +このページは Private Operator についての情報です。Public Operator についての情報、または Operator が何であるか、Operator の違いがわからない場合は、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 +::: + ## Private Operator Benefits Private Operator に参加するメリットは次のとおりです。 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 2392ea576..1a8c7d2c2 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 @@ -20,7 +20,7 @@ import StoreUID2TokenInBrowser from '/docs/snippets/_prebid-storing-uid2-token-i Prebid.js を使って UID2 とインテグレーションするには、以下が必要です: - サイトの HTML と JavaScript に変更を加えます。 -- トークン生成のためにサーバーサイドを変更します(オプションでトークンのリフレッシュ)。 +- トークン生成のためにサーバーサイドを変更します(オプションで Token Refresh)。 ## Prebid.js Version 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 4c80ca8c3..cf01f369a 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 @@ -17,7 +17,7 @@ UID2 Google Mobile Ads (GMA) Plugin for Android は、[Google Mobile Ads (GMA) S ## Version - + このドキュメントは、UID2 GMA Plugin for Android バージョン 1.6.0 以降用です。 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 83aff32b5..61b660d26 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 @@ -17,7 +17,7 @@ UID2 Interactive Media Ads (IMA) Plugin for Android は、[Google IMA SDK for An ## Version - + このドキュメントは、UID2 IMA Plugin for Android version 1.6.0 以降用です。 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 d88429d21..0d8712b5e 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 @@ -13,7 +13,7 @@ import AttestFailure from '/docs/snippets/_private-operator-attest-failure.mdx'; # UID2 Private Operator for AWS Integration Guide -UID2 Operator は、UID2 エコシステムにおける API サーバーです。AWS Marketplace で稼働する Private Operator Service の場合、UID2 Operator ソリューションは[AWS Nitro](https://aws.amazon.com/ec2/nitro/) Enclave テクノロジーで強化されています。これは、UID2 情報を不正なアクセスから保護するための追加のセキュリティ対策です。 +UID2 Operator は、UID2 エコシステムにおける API サーバーです。AWS Marketplace で稼働する Private Operator Service の場合、UID2 Operator ソリューションは [AWS Nitro](https://aws.amazon.com/ec2/nitro/) Enclave テクノロジーで強化されています。これは、UID2 情報を不正なアクセスから保護するための追加のセキュリティ対策です。 ## UID2 Private Operator for AWS 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 8d031407c..42bbcff3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md @@ -12,7 +12,7 @@ import ReleaseMatrix from '/docs/snippets/_private-operator-release-matrix.mdx'; # UID2 Private Operator for Azure Integration Guide -このガイドでは、Microsoft Azure の機密コンピューティングオプションである [Confidential Containers](https://learn.microsoft.com/en-us/azure/confidential-computing/confidential-containers) のインスタンスで UID2 Operator Service を設定する方法について説明します。Confidential Containers のインスタンスは、データの整合性、データの機密性、コードの整合性などの固有の機能を提供するハードウェアで保護された Trusted Execution Environment (TEE) で実行されます。 +UID2 Operator は、UID2 エコシステムにおける API サーバーです。このガイドでは、Microsoft Azure の機密コンピューティングオプションである [Confidential Containers](https://learn.microsoft.com/en-us/azure/confidential-computing/confidential-containers) のインスタンスで Private Operator として UID2 Operator Service を設定する方法について説明します。Confidential Containers のインスタンスは、データの整合性、データの機密性、コードの整合性などの固有の機能を提供するハードウェアで保護された Trusted Execution Environment (TEE) で実行されます。 UID2 Operator Confidential Containers インスタンスの Docker コンテナが起動すると、UID2 Core Service は Operator Service と Operator Service が実行されているエンクレーブ環境の信頼性を検証ための認証プロセスを完了します。 @@ -267,7 +267,7 @@ 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 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 85ca4babe..72aa0f78d 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 @@ -12,7 +12,7 @@ import ReleaseMatrix from '/docs/snippets/_private-operator-release-matrix.mdx'; # UID2 Private Operator for GCP Integration Guide -このガイドでは、Google Cloud Platform(GCP)の機密コンピューティングオプションである [Confidential Space](https://cloud.google.com/confidential-computing#confidential-space) でUID2 Operator Serviceを設定する情報を提供します。Confidential Spaceは、Trusted Execution Environment(TEE)として知られるセキュアなクラウドベースのエンクレーブ環境で実行される、安全なクラウドベースのエンクレーブ環境です。 +このガイドでは、Google Cloud Platform(GCP)の機密コンピューティングオプションである [Confidential Space](https://cloud.google.com/confidential-computing#confidential-space) で Private Operator として UID2 Operator Service を設定する情報を提供します。Confidential Spaceは、Trusted Execution Environment(TEE)として知られるセキュアなクラウドベースのエンクレーブ環境で実行される、安全なクラウドベースのエンクレーブ環境です。 :::note UID2 Private Operator for GCP は、次の地域ではサポートされていません: ヨーロッパ、中国。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index 6b3ec4d4a..1ebe06f55 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -104,7 +104,7 @@ UID2 とインテグレーションする広告主やデータプロバイダー ## DSP Integrations -The following resources are available for DSPs integrating with UID2. +DSP とインテグレーションする DSP は、以下のリソースを利用できます。 | Integration Guide | Content Description | | :--- | :--- | @@ -113,7 +113,7 @@ The following resources are available for DSPs integrating with UID2. ## Private Operator Service Integrations -Private Operator のインテグレーションは、以下のリソースを利用できます。 +Private Operator のインテグレーションは、以下のリソースを利用できます。 | Integration Guide | Content Description | | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md index c4445a081..2ce0e09b2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md @@ -38,7 +38,7 @@ UID2 フレームワークは、以下の技術原則に基づいて構築され - **Distributed integration**: 複数の認証済みインテグレーションパスにより、パブリッシャー、広告主、サードパーティデータプロバイダーが UID2 Token を管理および交換するためのオプションが提供されます。 -- **Decentralized storage**: このフレームワークでは、個人データのマッピングを一元的に保管することはありません。すべての参加者が自分自身のデータのみを管理します。 +- **Decentralized storage**: このフレームワークでは、個人に関するデータ (DII) のマッピングを一元的に保管することはありません。すべての参加者が自分自身のデータのみを管理します。 - **Lean infrastructure**: UID2 システムは軽量で安価に運用できます。 @@ -61,7 +61,7 @@ UID2 は、メールアドレスや電話番号など、ソルト 値を使用して再度ハッシュ化され、raw UID2 が作成されます。raw UID2を作成するプロセスは、広告主、第三者データプロバイダー、およびデマンドサイドプラットフォーム(DSP)が保存できる安全で不可視の値を作成するように設計されています。
raw UID2 は大文字と小文字を区別します。
例: 架空のメールアドレス `user@example.com` の raw UID2 をリクエストした結果、次の値が得られました: `E2dxEv3oMBzNHPw5iUVmwH2Hv+60D4AXYe+2ge9U0No=` | | **UID2 Token (Advertising Token)** | Yes | Raw UID2 を暗号化したものです。UID2 Token は、ハッシュ化またはハッシュ化されていないメールアドレスや電話番号から生成され、raw UID2 に変換された後、ビッドストリームでの保護を確実にするために暗号化されます。
UID2 Token は、パブリッシャーやパブリッシャーサービスプロバイダーが使用するように設計されています。サプライサイドプラットフォーム(SSP)はビッドストリームで UID2 Token を渡し、DSP はビッドリクエスト時にそれを復号化します。
UID2 Token は大文字と小文字を区別します。
例:`user@example.com`という架空のメールアドレスの UID2 Token をリクエストした結果、次のような値が得られました: `AAAABrexFHvQVhNJqu+y/ua7rsgShF8e9NUXUJOZFmeFRD8TAsJadaLfOlLkwC5iSxcOKWFD9YwMBzbbcPa92CInba+bcPTaAFNmM2ZpIHgGy6lDcNPzvEnPQh/5fyZ3MD44SX/tHyIXa0R2OBAOLBA1A81r3jefhSsxZdyyBF58KtnaX6UbaeOEaguOfMnJdmhaPeWKj33v7vGfROWtxDWmi6wvGL5lHTX9H6iIZ9i1WSsemYPUgmoDOQeT7nzllJK968OECFj5LkCazDN3pCrYSeuJby9o0fMuSZNxzp6EVzi6XVED4ETtzpcaY0AArzzdh0IXV9MgH8jyg7bJSUWXQG+8kMPZzwbs9EB+7ddAUOLZL/GBna8Hm3Im03EjN3sJ` | :::note @@ -75,7 +75,7 @@ UID2 フレームワークは以下のコンポーネントで構成されてお | Component | Description | | :--- | :--- | | **Core Service** |salts暗号化キー、および UID2 エコシステムの他の関連データへのアクセスを管理する一元的なサービスです。 | -| **Operator Service** | UID2 Core Service からの暗号鍵とソルトの管理・保管、ユーザーの個人情報のハッシュ化、raw UID2 の暗号化、UID2 Token の復号を可能にするサービスです。
Open Operator は、オペレーターサービスのパブリックインスタンスを実行し、関連するすべての UID2 参加者が利用できるようにします。また、オペレーターサービスのプライベートなインスタンスを自分たちだけのために実行する Closed Operator も存在します。どのインスタンスも、誰がサービスを運営するかに関わらず、重要な UID2 データを安全に保ち、相互運用できるように保護設計されています。 | +| **Operator Service** | UID2 Core Service からの暗号鍵とソルトの管理・保管、ユーザーの個人情報のハッシュ化、raw UID2 の暗号化、UID2 Token の復号を可能にするサービスです。
Public Operators は、Operator Service のパブリックインスタンスを実行し、関連するすべての UID2 参加者が利用できるようにします。また、オペレーターサービスのプライベートなインスタンスを自分たちだけのために実行する Private Operators も存在します。どのインスタンスも、誰がサービスを運営するかに関わらず、重要な UID2 データを安全に保ち、相互運用できるように保護設計されています。 | | **Opt-Out Service** | ユーザーのオプトアウトリクエストを管理・保存し、パブリッシャー、オペレーターのサービスインスタンス、DSP に配信するグローバルサービスです。 | | **Transparency and Control Portal** | ユーザー向けウェブサイト [https://www.transparentadvertising.com/](https://www.transparentadvertising.com/) では、消費者がいつでも UID2 からの脱退を選択できるようになっています。 | @@ -88,7 +88,7 @@ UID2 は透明で相互運用可能なアプローチにより、広告エコシ | Participant | Role Description | | :--- | :--- | | **Core Administrator** | UID2 Core Service およびその他の [コンポーネント](#components) を管理する組織 (現在は The Trade Desk)。例えば、UID2 Operator に暗号キーとソルトを配布し、Operator や DSP にユーザーのオプトアウトリクエストを送ります。 | -| **Operators** | Operator Service を実行する組織 (UID2 API 経由)。オペレーターは、UID2 Core Service から暗号化キーとソルトを受け取って保管し、個人のデータをソルトおよびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token の復号キーを配布します。
Open Operator は、Operator Service のパブリックインスタンスを実行します。たとえば、The Trade Desk は現在、UID2 Framework の Open Operator として機能しており、すべての参加者が利用できます。
参加者は誰でも、UID2 を生成および管理する Private Operator になることもできます。 | +| **Operators** | Operator Service (UID2 API 経由で) を実行する組織。オペレーターは、定期的に UID2 Core Service から最新の暗号化キーとソルトを受け取り、directly identifying information (DII) をソルトおよびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token の復号キーを配布します。
Public Operator (Open Operator) は、Operator Service のパブリックインスタンスを実行します。例えば、The Trade Desk は現在、UID2 Framework の Public Operator として機能しており、すべての参加者が利用できます。他の Public Operator が利用可能な場合、参加者はどのオペレーターと連携するかを選択できます。
参加者は誰でも、UID2 を生成および管理する Private Operator になることもできます。 | | **DSPs** | DSP は UID2 システムとインテグレーションして、広告主から (ファーストパーティデータとして)、またサードパーティデータプロバイダーから (サードパーティデータとして)UID2 を受け取り、それらを活用してビッドストリーム中の UID2 に対する入札情報を提供します。 | | **Data Providers** | ユーザーデータを収集し、それを他の UID2 参加者—例えば、広告主、ID グラフプロバイダー、サードパーティデータプロバイダー—にプッシュする組織。 | | **Advertisers** | さまざまなパブリッシャーサイトでインプレッションを購入し、DSP を使用して、購入する広告インプレッションとその入札価格を決定している組織です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md index 275702324..9b9155233 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md @@ -105,8 +105,8 @@ Web インテグレーションオプションの詳細は [Web Integration Over | Integration Type| Documentation | Content Description | | :--- | :--- | :--- | | Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡されるUID2 Token を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | -| Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法であるClient-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークンの生成とトークンのリフレッシュ。
  • トークンを RTB ビッドストリームに渡す。
| -| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operator を利用しているパブリッシャーなど。 | +| Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法であるClient-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークンの生成と Token Refresh
  • トークンを RTB ビッドストリームに渡す。
| +| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operator を利用しているパブリッシャーなど。 | | JavaScript (Overview) | [UID2 Integration Overview for JavaScript](../guides/integration-javascript.md) | JavaScript SDK を使って UID2 とインテグレーションしたいパブリッシャー向けのオプションの概要です。 | | JavaScript Client-Side Integration | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | Client-Side の JavaScript の変更だけで UID2 とインテグレーションしたいパブリッシャー向けのガイドで、最も簡単な実装方法です。
SDK for JavaScript は、トークン生成とトークンリフレッシュを自動的に管理します。 | | JavaScript Client-Server Integration | [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) | SDK for JavaScript を使用し、トークンを Server-Side で生成してパブリッシャーのウェブページに渡す必要がある、標準的なWeb インテグレーションシナリオを網羅したパブリッシャーガイドです。 | 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 26b30930f..4986c755f 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 @@ -18,7 +18,7 @@ UID2 Portal の **API Keys** ページでは、UID2 アカウントの API Key ## Overview -API Key とクライアント シークレットを使用すると、UID2 Operator Serviceに接続して API エンドポイントを呼び出すことができます。これらの値は、サービスに対してあなたを識別します。 +API Key とクライアント シークレットを使用すると、UID2 Operator Service に接続して API エンドポイントを呼び出すことができます。これらの値は、サービスに対してあなたを識別します。 UID2 Portal で API Key を追加するときは、キーとそれに対応するシークレットを安全に保存し、これらの値が漏洩しないようにするために必要なすべての措置を講じることが重要です。詳細は [API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/audit-trail.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/audit-trail.md index f60a279e5..e56378679 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/audit-trail.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/audit-trail.md @@ -1,6 +1,6 @@ --- title: Audit Trail -description: View a detailed log of past actions performed in the UID2 Portal. +description: UID2 Portal で過去に実行されたアクションの詳細なログを表示します。 hide_table_of_contents: false sidebar_position: 09 --- @@ -9,21 +9,21 @@ import Link from '@docusaurus/Link'; # Audit Trail -In the UID2 Portal, users who have the Admin role (see [User Roles](team-members.md#user-roles)) can access the **Audit Trail** page to view a detailed log of all past actions performed by or on behalf of the current participant. +UID2 Portal では、Admin 権限を持つユーザー([User Roles](team-members.md#user-roles) を参照)は、**Audit Trail** ページにアクセスして、現在の 参加者 によって実行された過去のすべてのアクションの詳細なログを表示できます。 -The Audit Trail log displays the types of information summarized in the following table. +Audit Trail ログには、以下の表にまとめられた情報が表示されます。 | Column | Details | | :--- | :--- | -| Date | Date/time that the action occurred. | -| User | The user who performed the action. | -| Event | The action performed. For a summary of possible values, see [Audit Trail Event Types](#audit-trail-event-types). | -| Event Data | Details about the action. | -| Succeeded | Indicates whether or not the action was successful. | +| Date | アクションが発生した日時。 | +| User | アクションを実行したユーザー。 | +| Event | 実行したアクションの詳細。 有効な値の概要については、[Audit Trail Event Types](#audit-trail-event-types) を参照してください。 | +| Event Data | アクションの詳細。 | +| Succeeded | アクションが成功したかどうか。 | ## Audit Trail Event Types -The audit trail log reports the following types of activity, listed in the Event column: +Audit trail ログは、以下のアクティビティの種類を報告します。Event 列にリストされています: - Approve Account - Manage API Key diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md index 1b4f410b4..d62357a67 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md @@ -47,15 +47,21 @@ Client-Side インテグレーションページでは、キーペアを設定 - [Changing the Name of a Key Pair](#changing-the-name-of-a-key-pair) - [Deleting a Key Pair](#deleting-a-key-pair) +:::important +キーペアを作成する際には、ルートレベルのドメイン名またはモバイルアプリ ID を追加する必要があります。順序は問いません。キーペアを最初に作成しても問題ありませんが、Client-Side のインテグレーションを構成するには、両方の手順を完了する必要があります。 +::: + ### Adding a Key Pair キーペアを追加するには、次の手順を実行します: 1. UID2 Portal アカウントにログインします。 -1. **Client-Side Integration** ページに移動し、**Add Key Pair** をクリックします。 +1. **Client-Side Integration** ページに移動し、Key Pair セクションにある **Add Key Pair** をクリックします。 1. **Add Key Pair** オーバーレイで名前を入力し、**Add Key Pair** をクリックします。 - **Client-Side Integration** ページに、名前、Subscription ID、Public key、および作成日が表示されます。 + キーペアは自動的に生成されます。**Client-Side Integration** ページで、新しいキーペアが名前、Subscription ID、public key、作成日付とともに表示されます。次の例を参照してください。 + + ![Client-Side Integration page, Key Pairs](images/portal-client-side-integration-key-pairs.png) ### Copying or Viewing a Public Key diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md index d906ac63f..59abc9317 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md @@ -21,7 +21,7 @@ UID2 Portal では、UID2 の最新アップデートやリリースに関する ## Accessing the Email Contacts Page -メール連絡先ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にあるログイン ID が表示されている場所に移動します。下矢印をクリックし、**Email Contacts** を選択します。 +メール連絡先ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にある名前が表示されている場所に移動します。下矢印をクリックし、**Email Contacts** を選択します。 例については [UID2 Portal Structure](portal-overview.md#uid2-portal-structure) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-client-side-integration-key-pairs.png b/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-client-side-integration-key-pairs.png new file mode 100644 index 000000000..0659683c8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-client-side-integration-key-pairs.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-team-members-resend-invitation.png b/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-team-members-resend-invitation.png new file mode 100644 index 000000000..a1cffa611 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/portal/images/portal-team-members-resend-invitation.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/participant-info.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/participant-info.md index 5d4ac604a..25a44b9bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/participant-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/participant-info.md @@ -13,7 +13,7 @@ UID2 Portal アカウントを申請するには、氏名や業種など、あ UID2 Portal では、この情報の一部が表示されます。アクセス権がある場合は、情報が正しいか確認してください。 -ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にあるログイン ID が表示されている場所に移動します。下矢印をクリックし、**Participant Information** を選択します。 +ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にある名前が表示されている場所に移動します。下矢印をクリックし、**Participant Information** を選択します。 例については [UID2 Portal Structure](portal-overview.md#uid2-portal-structure) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md index a10958ab2..95685dfb8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md @@ -23,7 +23,11 @@ UID2 Portal アカウントをリクエストする際には、自分自身と ## Request an Account -アカウントのリクエストを行う際には、次の表に示す情報を UID2 連絡先に提供する必要があります。 +UID2 の連絡先にアカウントのリクエストを行う際には、情報を提供いただく必要があります。次の表に示す詳細情報を含めてください。 + +:::note +UID2 の連絡先をまだお持ちでない場合は、[Request Access to UID2](/request-access) ページに移動し、フォームに記入してください。 +::: | Item | Details | | :--- | :--- | @@ -69,7 +73,7 @@ UID2 Service を使用するには、キーのセットが必要です。Client- ## Change Your Password -**Accept Invitation** リンクをクリックすると、**Set Password** ページに移動します。 +**Accept Invitation** リンクをクリックすると、**Update Password** ページに移動します。 :::tip アカウントが漏洩した可能性があるためにパスワードを変更する場合は、**Sign out from other devices** チェックボックスがチェックされていることを確認してください。 @@ -121,7 +125,7 @@ UID2 Service を使用するには、キーのセットが必要です。Client- | Item | Details | Link to Instructions | | :--- | :--- | :--- | -| Team member information | 以下を提供してください。
- 名
- 姓
- メールアドレス
- 職務 | [Team Members](team-members.md) | +| Team member information | 以下を提供してください。
- 名
- 姓
- メールアドレス
- 職務
- 役割 | [Team Members](team-members.md) | | Email contact information | 以下を提供してください。
- メールグループ名
- メールエイリアス
- 連絡先タイプ | [Email Contacts](email-contacts.md) | ## Reset Password @@ -133,4 +137,14 @@ UID2 Service を使用するには、キーのセットが必要です。Client- アカウントの更新が完了したら、ログアウトすることを忘れないでください。 1. 右上の自分の名前をクリックします。 -1. ドロップダウンリストから **Log Out** をクリックします。 \ No newline at end of file +1. ドロップダウンリストから **Log Out** をクリックします。 + +## Password Change Requirement + +場合によっては、パスワードを変更する必要があるかもしれません。たとえば、パスワードの要件が変更され、現在のパスワードが新しい要件を満たさない場合は、新しいパスワードを選択する必要があります。 + +この場合、ログイン時に **Set Password** ページが表示されます。 + +現在のパスワード要件がページに表示されます。新しいパスワードを選択し、確認のためにもう一度入力し、保存してください。 + +必ず覚えやすいパスワードを選択してください。 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 9ecc75870..e9becbdbf 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 @@ -21,6 +21,8 @@ UID2 Portal は、UID2 アカウントを設定・構成するためのワンス | 個々の共有参加者または共有参加者のグループの権限を構成します。
NOTE: 共有の使用には API Key ([API Keys](api-keys.md) を参照してください) または Client-Side キーペア ([Client-Side Integration](client-side-integration.md) を参照してください) が必要です。共有権限を設定する前にこれらの値を構成してください。 | [Sharing Permissions](sharing-permissions.md) | | アカウントを管理する権限を持つチームメンバーを追加します。 | [Team Members](team-members.md) | | ニュースやアップデートを通知する指定メール連絡先を設定します。 | [Email Contacts](email-contacts.md) | +| 現在の参加者、またはその代理人によって実行された過去のすべてのアクションの詳細なログを表示します。 | [Audit Trail](audit-trail.md) | +| Portal から指示があった場合は、パスワードを変更してください。 | [Password Change Requirement](portal-getting-started.md#password-change-requirement) | ## Access the UID2 Portal @@ -30,29 +32,46 @@ Portal にアクセスするには、UID2 の担当者にアカウントを作 ### UID2 Portal Structure -UID2 Portal は、ナビゲーションが簡単になるように構造化されています。 +UID2 Portal はナビゲーションが簡単になるように構造化されています。 -ページへのアクセス方法は、次の画像に示すように、2つの主要な方法があります: +ページにアクセスするための 2 つの主要な方法が次の画像に示されています: ![UID2 Portal Structure](images/portal-uid2-overview.png) -左のサイドバーから、アカウントの構成に関連する以下のページにアクセスできます: +左サイドバーの上部に、現在の参加者の名前が表示されます。アカウントが複数の参加者にアクセスできる場合、アクセスできる参加者のドロップダウンリストが表示されます。これを使用して、参加者間を切り替えることができます。 + +:::important +UID2 Portal で実行する操作(チームメンバーの追加、ドメイン、API キーの追加など)は、左側に表示されている現在の参加者のコンテキストで行われます。複数の参加者にアクセスできる場合は、正しいコンテキストで操作を実行してください。詳細については、[Participant Switcher](#participant-switcher) を参照してください。 +::: + +左サイドバーをスクロールすると、アカウントの構成に関連する以下のページにアクセスできます: - Home: ホームページへのリンク、常に表示されます。 - [Sharing Permissions](sharing-permissions.md) - [API Keys](api-keys.md) - [Client-Side Integration](client-side-integration.md) -右上のリンクから、個人のアカウント設定と日々のアクティビティにアクセスできます。Gravatar 画像を設定している場合 ([https://gravatar.com/](https://gravatar.com/) を参照してください)、画像が表示されます。Gravatar 画像が設定されていない場合、デフォルト画像が表示されます。 +左のサイドバーの上部に名前が表示されます。 -ここから個人のアカウント設定と日々のアクティビティに関する以下のページにアクセスできます: +ここから、個人のアカウント設定と日常のアクティビティに関連する以下のページにアクセスできます: - [Participant Information](participant-info.md) - [Manage Team Members](team-members.md) - [Email Contacts](email-contacts.md) -- Dark Mode: toggles dark mode on and off +- [Audit Trail](audit-trail.md) (Admin ユーザーのみ) +- Dark Mode: Dark モードをオンまたはオフに切り替えます。Dark モードの設定は、次回のセッションに適用されます。 - [Log Out](portal-getting-started.md#log-out) ## 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 + +ほとんどの場合、各ユーザーは 1 つの UID2 共有参加者のデータにアクセスできます。ただし、個々のユーザーが複数の参加者のチームに所属している場合があります。この場合、ユーザーは参加者間を切り替えることができます。 + +現在の参加者は、左サイドバーの上部に表示されます。現在のユーザーが複数の参加者のチームに所属している場合、矢印が表示され、ユーザーは正しい参加者のコンテキストで操作を実行するために参加者間を切り替えることができます。 + +図については、[UID2 Portal Structure](#uid2-portal-structure) を参照してください。 + +ユーザーがログアウトすると、最新の参加者の選択が保存され、次回ユーザーがログインすると適用されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-team-members-resend-invitation.png b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-team-members-resend-invitation.png new file mode 100644 index 000000000..a1cffa611 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-team-members-resend-invitation.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md index 3ee1b560b..0970895a9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md @@ -1,6 +1,6 @@ --- title: Team Members -description: UID2 Team の設定と管理。 +description: UID2 チームを設定および管理します。 hide_table_of_contents: false sidebar_position: 07 --- @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # Team Members -UID2 Portal の **Team Members** ページでは、以下のようなアカウントへのアクセスを許可する個人の設定に関する操作を実行できます: +UID2 Portal の **Team Members** ページでは、Admin 権限を持つユーザーが、アカウントへのアクセスを許可する個人の設定に関連するすべてのアクティビティを実行できます。これには、次の操作が含まれます: - [Add a Team Member](#add-a-team-member) - [Resend an Invitation to a Team Member](#resend-an-invitation-to-a-team-member) @@ -18,80 +18,107 @@ UID2 Portal の **Team Members** ページでは、以下のようなアカウ ## Accessing the Team Members Page -Team Members ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にあるログイン ID が表示されている場所に移動します。下矢印をクリックし、**Manage Team Members** を選択します。 +Team Member ページにアクセスするには、UID2 Portal ユーザーインターフェースの右上にある名前が表示されている場所に移動し、下矢印をクリックして **Manage Team Members** を選択します。 -例については [UID2 Portal Structure](portal-overview.md#uid2-portal-structure) を参照してください。 +各 Team Member について、次の情報が表示されます: +- Name + + 招待されたがまだ承認されていない場合、名前の後に **Pending** タグが表示されます。 +- Email +- Job Function +- Role +- Actions: + - すべての人が利用可能: ![the Edit icon](images/icon-pencil-solid.png) (Edit) と ![the Delete icon](images/icon-trash-can-solid.png) (Delete)。 + - ユーザーが招待されたがまだ承認されていない場合、**Resend Invitation** リンクも利用可能です。 + +例については、「チームメンバーへの招待状の再送」(#resend-an-invitation-to-a-team-member)を参照してください。 ## User Roles -Each team member has one of the roles shown in the following table. +各 Team Member は、次の表に示す役割のいずれかを担います。 | Role | Actions | | :--- | :--- | -| Admin | Users with the Admin role can perform all activities related to UID2 participation, as summarized in the [UID2 Portal Overview](portal-overview.md), for the current participant organization. | -| Operations | Users with the Operations role can perform most of the same actions as Admin users. However, there are some limitations:
  • They cannot add, modify, or remove team members. Instead, they have read-only access to the [Team Members](team-members.md) page.
  • They cannot view the [Audit Trail](audit-trail.md) page.
| - -User roles can only be modified by users with the Admin role. For details, see [Edit Information for a Team Member](#edit-information-for-a-team-member). - -## Team Member Rights and Responsibilities - -各 **Team Member** はアカウントの管理者となり、以下のようなチームやアカウントの管理に関する設定を行うことができます: +| Admin | Admin 権限を持つユーザーは、[UID2 Portal Overview](portal-overview.md) に記載されているように、現在の参加組織に関連する UID2 参加に関連するすべてのアクティビティを実行できます。 | +| Operations | Operation 権限を持つユーザーは、Admin ユーザーとほぼ同じアクションを実行できます。ただし、いくつかの制限があります:
  • チームメンバーを追加、変更、削除することはできません。代わりに、[Team Members](team-members.md) ページには読み取り専用アクセスがあります。
  • [Audit Trail](audit-trail.md) ページを表示できません。
| -- チームメンバーの追加、変更、削除: [Add a Team Member](#add-a-team-member) を参照してください。 -- メール連絡先の追加、変更、削除: [Email Contacts](email-contacts.md) を参照してください。 -- 共有関係と共有設定の追加と削除: [Sharing Permissions](sharing-permissions.md) を参照してください。 +ユーザー権限は、Admin 権限を持つユーザーのみが変更できます。詳細については、[Edit Information for a Team Member](#edit-information-for-a-team-member) を参照してください。 ## Add a Team Member -チームメンバーを追加するには、以下のステップを完了させます: +Team Member を追加するには、次の手順を実行します: -1. UID2 Portal アカウントにログインします。 -1. 右上の下矢印をクリックし、**Manage Team Members** を選択します。 +1. UID2 Portal アカウントでログインします。 +1. 右上にある下矢印をクリックし、**Manage Team Members** を選択します。 1. **Add Team Member** をクリックします。 -1. 姓、名、メールアドレス、職能を入力します。 +1. 名、姓、メール、職務、および役割を入力します。 1. **Save Team Member** をクリックします。 - チームメンバーがリストに追加され、ステータスが保留になり、招待メールが招待者に送信されます。 + Team Member がリストに追加され、保留中のステータスで、招待メールが招待された人に送信されます。 + +:::note +Team Member は複数の参加者に追加できます。複数の参加者に所属する Team Member は、[UID2 Portal Structure](portal-overview.md#uid2-portal-structure) に示されているように、参加者間を切り替えることができます。 +::: ## Resend an Invitation to a Team Member -チームメンバーを追加した場合、招待状を再送する必要がある場合があります。例えば、チームメンバーが招待状を受け取っていなかったり、誤って削除してしまったり、招待状の有効期限が切れてしまった場合などです。 +Team Member を追加した場合、招待状を再送する必要がある場合があります。たとえば、Team Member が招待状を受け取っていないか、誤って削除したか、招待状の有効期限が切れている場合などです。 + +ユーザーが招待されたがまだ承認されていない場合、Team Members リストには、次の図に示すような追加情報が表示されます: + +- 氏名の後に **Pending** ラベルが表示されます。 +- **Resend Invitation** リンク。 + +![UID2 Portal, Team Members page, pending user](images/portal-team-members-resend-invitation.png) + +Team Member 宛に招待状を再送信するには、次の手順を実行します: -チームメンバーに招待状を再送信するには、以下の手順を実行します: +1. UID2 Portal アカウントでログインします。 +1. 右上にある下矢印をクリックし、**Manage Team Members** を選択します。 +1. リストから Team Member を見つけ、Actions 列で **Resend Invitation** をクリックします。 -1. UID2 Portal アカウントにログインします。 -1. 右上の下矢印をクリックし、**Manage Team Members** を選択します。 -1. リストでチームメンバーを見つけ、Actions 列で **Resend Invitation** をクリックします。 + ステータスが **Invitation Sent** に更新され、新しい招待状が送信されます。 - ステータスが **Invitation Sent** に更新され、新しい招待メールが送信されます。 +:::note +招待状が送信されたがまだ承認されていない場合にのみ、Resend Invitation リンクが表示されます。 +::: ## Edit Information for a Team Member -値を更新することができます: 名、姓、メール、または職能。 +役割に関する注意事項: +- Admin 権限を持つユーザーは、参加組織内の任意の Team Member について、これらの値を更新できます。 +- Operation 権限を持つユーザーは、Team Members ページを表示できますが、情報を変更することはできません。 -チームメンバーの情報を編集するには、以下の手順を実行します: +Team Member の情報を編集するには、次の手順を実行します: -1. UID2 Portal アカウントにログインします。 -1. 右上の下矢印をクリックし、**Manage Team Members** を選択します。 -1. リストでチームメンバーを見つけ、Actions 列で ![the Edit icon](images/icon-pencil-solid.png) (編集アイコン) をクリックします。 -1. 情報を更新し、変更を保存します。 +1. UID2 Portal アカウントでログインします。 +1. 右上にある下矢印をクリックし、**Manage Team Members** を選択します。 +1. リストから Team Member を見つけ、Actions 列で ![the Edit icon](images/icon-pencil-solid.png) (Edit) をクリックします。 +1. 以下の値を更新します: + - 名 + - 姓 + - 職務 + - 役割: 役割についての詳細については、[User Roles](#user-roles) を参照してください。 + + **Note**: 既存の Team Member のメールアドレスを更新することはできません。メールアドレスを変更する必要がある場合は、新しいメールアドレスを使用して新しい Team Member を追加します。これにより、メールアドレスの確認プロセスが正しく実行されます。このシナリオでは、古いメールアドレスの既存エントリも削除することを忘れないでください。 +1. 変更内容を保存します。 ## Remove a Team Member -チームから誰かを外すには、以下の手順に従ってください: +チームから誰かを削除するには、次の手順に従います: -1. UID2 Portal アカウントにログインします。 -1. 右上の下矢印をクリックし、**Manage Team Members** を選択します。 -1. リストでチームメンバーを見つけ、Actions 列で Delete (ゴミ箱) アイコンをクリックします。 +1. UID2 Portal アカウントでログインします。 +1. 右上にある下矢印をクリックし、**Manage Team Members** を選択します。 +1. リストから Team Member を見つけ、Actions 列で ![the Delete icon](images/icon-trash-can-solid.png) (Delete) をクリックします。 1. 確認メッセージで **Remove Team Member** をクリックします。 - チームメンバーがチームから削除されます。 + Team Member がチームから削除されます。 ## Log In for the First Time as a Team Member -誰かがあなたを新しいチームメンバーとして追加した場合、確認メールが送信されます。メールアドレスを確認するための確認メールを送信します。以下の手順に従ってください: +誰かがあなたを新しい Team Member として追加した場合、確認メールを送信します。メールアドレスを確認するために、次の手順に従ってください: -1. メールに記載されている accept the invitation をクリックします。 -1. パスワードを初期設定から更新するには、クリックしてください。 -1. メールアドレスと新しいパスワードを使用して、UID2 Portal にログインします。これでアカウントが確認されます。 -1. 初回ログイン時に、UID2 Sharing Portal 利用規約を確認し、同意します。 +1. メールのリンクをクリックして招待を受け入れます。 +1. 最初のデフォルトからパスワードを更新するためにクリックします。 +1. 新しいパスワードを使用して UID2 Portal にログインします。これにより、アカウントが確認されます。 +1. 最初のログイン時に、UID2 Sharing Portal の利用規約を確認して承認します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md index c77de4619..ab1ef671b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md @@ -99,6 +99,7 @@ import Link from '@docusaurus/Link'; Subscription ID **T** +Token refresh | Tokenized sharing | Transparency and Control Portal @@ -315,7 +316,7 @@ import Link from '@docusaurus/Link';
Operator
Operator とは、UID2の Operator Service を運営する組織や団体のことです。UID2 Operatorは、UID2 エコシステムの API サーバーです。
-
Operators は、UID2 Core Service から 暗号化キーソルト を受け取り、個人のデータをソルト化およびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成生成するなど、複数の機能を実行します。
+
Operators は、UID2 Core Service から 暗号化キーソルト を受け取り、個人に関するデータ (DII) をソルト化およびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成生成するなど、複数の機能を実行します。
参加者は、UID2 API にアクセスし、プライベートインフラ内で raw UID2 と UID2 Token を生成するために、Private Operator になることも選択できます。
詳細は participantsThe UID2 Operator を参照してください。
@@ -383,6 +384,16 @@ import Link from '@docusaurus/Link';
メールアドレスや電話番号を、それ自体では元の値を追跡できない安全で不透明な値に変換するプロセスで使用されます。
UID2 Service は、ハッシュ化および暗号化とともに、プロセスの一部としてソルト(Salt) を使用し、元の値を保護します。ソルトは、ハッシュ化の前に入力値に加えられます。
+
Salt bucket
+
ソルトバケットは、Secret salt の値を長期間管理するために使用されます。各バケットには、約1年間有効な現在のソルト値が含まれており、新しい値にローテーションされる前に更新されます。バケットは互いに独立して更新できます。
+ +
ソルトバケットは、100万以上あり、各メールアドレスまたは電話番号は、特定のバケットに決定論的に割り当てられます。ただし、この割り当ては永続的ではなく、バケットの現在のシークレットソルトが新しい値にローテーションされると変更される可能性があります。
+ +
Salt bucket ID
+
ソルトバケット ID は、特定の ソルトバケット を識別する一意の文字列です。ソルトバケット ID を使用すると、最近ソルト値が更新されたソルトバケットを確認し、どのメールアドレスまたは電話番号が raw UID2 値を再生成する必要があるかを確認できます。
+ +
ソルトバケット ID の例については、`POST /identity/buckets` エンドポイントのレスポンスを参照してください: Decrypted JSON Response Format
+
Salted hash
hash 関数を適用する前に入力文字列に salt 値を追加すると、結果はソルトハッシュとなります。入力値がハッシュ化される前にソルト化されると、ハッシュを持つ攻撃者は、同じ出力に到達するために多くの可能な入力を試して入力値を決定することができなくなります。
@@ -425,6 +436,13 @@ import Link from '@docusaurus/Link';
+
Token refresh
+
UID2 の参加者が UID2 Token をリクエストすると、トークンは UID2 Token と Refresh Token を含む一連の関連値とともに返されます。Refresh Token が有効期限切れになるまで、パブリッシャーは DII を送信することなく新しい UID2 Token をリクエストするために Refresh Token を使用できます。
+
UID2 Token をリクエストする UID2 参加者は、トークンの有効性を維持するためのプロセスを持っている必要があります: リフレッシュ期間を監視し、Refresh Token が期限切れになる前に新しい UID2 Token をリクエストするか、毎回新しい UID2 Token をリクエストするか、DII を送信する必要があります。
+
ほとんどの場合、トークンの更新は、SDK または Prebid.js の実装戦略など、他の実装戦略によって管理されます。
+
Refresh Token が期限切れになった場合、パブリッシャーは DII を送信して UID2 Token を再リクエストする必要があります。
+
詳細は、UID2 Tokens and Refresh Tokens を参照してください。
+
Tokenized sharing
Tokenized sharing とは DII または Raw UID2UID2 Token に暗号化し、許可された受信者とトークンを共有することです。UID2 Token を使用することで、データの送信者と受信者の間で、未承認の関係者をデータが通過する場合も含めて、raw UID2 をエンドツーエンドで保護することができます。Tokenized sharing は、ビッドストリームまたはピクセル経由での共有に必要ですが、どのような共有ユースケースでも使用できます。
詳細は Tokenized Sharing Overview を参照してください。
@@ -466,7 +484,7 @@ import Link from '@docusaurus/Link';
トークンの値は不透明です。文字列のフォーマットや長さについて、推測してはなりません。
トークンの寿命は限られていますが、refresh token を使ってバックグラウンドでリフレッシュすることができます。
パブリッシャーは、ビッドストリームに UID2 Token を送信します。
-
詳細は UID2 Identifier Types を参照してください。
+
詳細は UID2 Identifier TypesUID2 Tokens: Key Information を参照してください。
Unified ID 2.0 (UID2)
"UID2" という用語は、UID2 frameworkUID2 serviceraw UID2、またはUID2 token (Advertising Token) を意味でも使われます。
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 f2bf92fbe..4f43c7708 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 @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # The UID2 Operator -UID2 Operator Service により、UID2 Core Service からの 暗号化キー と [Salt(ソルト)](../ref-info/glossary-uid.md#gl-salt) の管理と保存、ユーザーの個人データ (DII) のハッシュ化、[raw UID2](../ref-info/glossary-uid.md#gl-raw-uid2) の暗号化、UID2 Token の復号化が可能になります。 +UID2 Operator Service により、UID2 Core Service からの 暗号化キー と [Salt(ソルト)](../ref-info/glossary-uid.md#gl-salt) の管理と保存、ユーザーの個人に関するデータ (DII) のハッシュ化、[raw UID2](../ref-info/glossary-uid.md#gl-raw-uid2) の暗号化、UID2 Token の復号化が可能になります。 Operator Service のすべてのインスタンスは、誰がサービスを運営するかにかかわらず、重要な UID2 データを安全に保ち、相互運用できるよう、厳格な保護が施されて設計されています。 @@ -17,7 +17,14 @@ Operator Service のすべてのインスタンスは、誰がサービスを運 複数の参加者によって運営される、複数の Operator Service のインスタンスが存在する可能性があります。これらの参加者はそれぞれ、UID2 Operator と呼ばれます。 -UID2 Operator は、単に Operator Service を実行する組織です。オペレーターは、UID2 Core Service から暗号化キーとソルトを受け取って保管し、個人に関するデータをソルトおよびハッシュ化して UID2 Token を返し、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token の復号キーを配布します。 +UID2 Operator は、Operator Service を実行する組織です。オペレーターは、定期的に以下の複数のタスクを実行します: + +- UID2 Core Service から最新の暗号化キーとソルトを受け取り、保存します。 +- raw UID2 を返すため DII をソルト化およびハッシュ化します。 +- UID2 Token を生成するために raw UID2 を暗号化します。 +- UID2 Token の復号鍵をサーバーサイド SDK に配布します (詳細は [SDKs: Summary](../sdks/summary-sdks.md) を参照してください)。 +- UID2 Opt-Out Service から最新のユーザーオプトアウト情報をダウンロードします。 +- 複数の UID2 エンドポイントをサポートします。詳細は [UID2 Endpoints: Summary](../endpoints/summary-endpoints.md) を参照してください。 UID2 Operator は、次の 2 つのカテゴリに分類されます: @@ -56,10 +63,10 @@ Private Operator は、UID2 Operator のプライベートインスタンスで ## Summary -ほとんどの参加者にとって、Public Operator が最もシンプル解決策です。 +ほとんどの参加者にとって、Public Operator が最もシンプルなソリューションです。 -Private Operator オプションのマイナス面は、構築と維持に継続的なエンジニアリング努力が必要なことです。Private Operator のインスタンスは参加者によって管理されるため、継続的な更新と変更が必要となり、指定された期間内に完了する必要があります。 +Private Operator オプションのデメリットは、構築と維持に継続的なエンジニアリング作業が必要なことです。Private Operator のインスタンスは参加者によって管理されるため、継続的な更新と変更が必要となり、指定された期間内に完了する必要があります。 -Public Operator インテグレーションは、独自のインスタンスを作成するよりもはるかに簡単なオプションです。参加者に費用はかからず、初期設定と構成以外のエンジニアリング作業は事実上必要ありません。 +Public Operator とのインテグレーションは、独自のインスタンスを作成するよりもはるかに簡単なオプションです。参加者に費用はかからず、初期設定と構成以外のエンジニアリング作業は事実上必要ありません。 これらの理由から、Public Operator を選択することを勧めます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md index 3596cbfd9..f0f8abf78 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 @@ -37,13 +37,13 @@ Refresh Token に関する主なポイントは次のとおりです: - 値は、opaque (不透明)な文字列です: 文字列の形式や長さについての仮定をしないでください。 - Refresh Token は、UID2 Token が有効期限切れになる前に、新しい UID2 Token と新しい Refresh Token を生成するために使用できます。 - Refresh Token の使用は任意です: 既存のトークンをリフレッシュする代わりに、毎回 DII から新しいトークンを生成することを選択することもできます。 -- トークンのリフレッシュは、さまざまな方法で管理できます: +- Token Refresh は、さまざまな方法で管理できます: - UID2 SDK ([SDK Functionality](../sdks/summary-sdks.md#sdk-functionality) を参照してください) を使用して。 - [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出して。 - UID2 Prebid.js モジュール ([UID2 Integration Overview for Prebid](../guides/integration-prebid.md) を参照してください) を使用して。 - 新しい UID2 Token が生成され、リフレッシュトークンに対するレスポンスとして返されると、新しい Refresh Token も返されます。 - ほとんどの場合、サーバーサイドで生成されたトークンでも、Client-Side でトークンをリフレッシュできます。各 SDK のリフレッシュ機能についての詳細は、[SDK Functionality](../sdks/summary-sdks.md#sdk-functionality) (*Refresh UID2 Token* 列) を参照してください。 -- UID2 Operator Service が、新しい UID2 Token をリクエエストする際に Refresh Token を受け取ると、ユーザーのオプトアウトを確認します。ユーザーが UID2 からオプトアウトしている場合、新しい UID2 Token は生成されません。詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +- UID2 Operator Service が、新しい UID2 Token をリクエエストする際に Refresh Token を受け取ると、ユーザーのオプトアウトを確認します。ユーザーが UID2 からオプトアウトしている場合、新しい UID2 Token は生成されません。詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 ### Recommended Token Refresh Frequency 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 2ac819a0e..b02555dbb 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 @@ -9,13 +9,9 @@ import Link from '@docusaurus/Link'; # SDK for Android Reference Guide -SDK for Android は、以下の用途に使用できます: +Android SDK を使用すると、UID2 を使用したクライアント ID の生成または確立、bidstream 用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。 -- UID2 を使用して Android アプリでクライアント ID を生成または確立します。 -- ビッドストリーム様に Advertising Token を取得します。 -- UID2 Token の自動リフレッシュ。 - -以下の Android 関連プラグインと関連ドキュメントも利用できます。 +以下の Android 関連プラグインと関連ドキュメントも利用可能です。 | Purpose | Product/Documentation | | :--- | :--- | @@ -47,9 +43,9 @@ SDK が提供する特定の機能の使用許可が与えられ、そのアク ## SDK Version - + -このドキュメントは、SDK for Android バージョン1.6.0以降用です。 +このドキュメントは、SDK for Android バージョン 1.6.0 以降用です。 リリースノートの情報については、[https://github.com/IABTechLab/uid2-android-sdk/releases](https://github.com/IABTechLab/uid2-android-sdk/releases) を参照してください。 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 7efb78ef0..84a2af087 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 @@ -9,13 +9,9 @@ import Link from '@docusaurus/Link'; # SDK for iOS Reference Guide -SDK for iOS は、以下の用途に使用できます: +iOS SDK を使用すると、UID2 を使用したクライアント ID の生成または確立、bidstream 用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。 -- UID2 を使用して iOS アプリでクライアント ID を生成または確立します。 -- ビッドストリーム様に Advertising Token を取得します。 -- UID2 Token の自動リフレッシュ。 - -以下のiOS関連プラグインと関連ドキュメントも利用できます: +以下の iOS 関連プラグインと関連ドキュメントも利用可能です。 | Purpose | Product/Documentation | | :--- | :--- | @@ -44,9 +40,9 @@ SDKが提供する特定の機能を使用する許可が与えられ、その ## SDK Version - + -このドキュメントは、iOS 用 UID2 SDK のバージョン 1.2.0 以降に対応しています。 +このドキュメントは、iOS 用 UID2 SDK のバージョン 1.7.0 以降に対応しています。 リリースノートの情報については、[https://github.com/IABTechLab/uid2-ios-sdk/releases](https://github.com/IABTechLab/uid2-ios-sdk/releases) を参照してください。 @@ -60,10 +56,10 @@ SDKが提供する特定の機能を使用する許可が与えられ、その この SDK の最小要件は以下の通りです: -- Xcode version: 15.0+ -- iOS minimum target version: 13.0+ -- tvOS minimum target version: 13.0+ -- Swift version: 5.0+ +- Xcode バージョン: 15.0+ +- iOS 最低対象バージョン: 13.0+ +- tvOS 最低対象バージョン: 13.0+ +- Swift バージョン: 5.0+ @@ -98,7 +94,7 @@ dependencies: [ `Podfile` に次のエントリを追加します: ``` -pod 'UID2', '~> 1.2' +pod 'UID2', '~> 1.7' ``` ## Usage Guidelines diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md index 390d31a1f..992bd5eec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md @@ -103,8 +103,7 @@ SDKの [initialization](#initopts-object-void) の一部として、ID の Token Token の Auto-refresh について知っておくべきことは以下のとおりです: - -- 一度にアクティブにできる Token refresh call は 1 つだけです。 +- 同時にアクティブにできる [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイント呼び出しは1つだけです。 - [POST /token/refresh](../endpoints/post-token-refresh.md) レスポンスが、ユーザーがオプトアウトしたため、あるいは Refresh Token の有効期限が切れたために失敗した場合、バックグラウンドでの自動更新処理を一時停止します。UID2ベースのターゲティング広告を再び使用するには、ユーザーからメールアドレスまたは電話番号を取得する必要があります([isLoginRequired()](#isloginrequired-boolean)は`true`を返します)。 - SDK の初期化時に指定された [callback function](#callback-function) は、以下の場合に呼び出されます: - リフレッシュが成功するたびに呼び出されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-release-matrix.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-release-matrix.mdx index 91c5fd666..f01090c38 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-release-matrix.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-release-matrix.mdx @@ -2,4 +2,5 @@ | ------- | ------ | ------ | ------ | ------ | ------ | ------ | | Q1 2024 | 5.26.19 | February 13, 2024 | [v5.26.19-56899dc0d7](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.26.19-56899dc0d7) | 5.26.19-56899dc0d7 | [5.26.19-56899dc0d7 GCP ZIP](https://github.com/IABTechLab/uid2-operator/releases/download/v5.26.19-56899dc0d7/uid2-operator-deployment-artifacts-5.26.19-56899dc0d7-gcp-oidc.zip) | [5.26.19-56899dc0d7 Azure ZIP](https://github.com/IABTechLab/uid2-operator/releases/download/v5.26.19-56899dc0d7/uid2-operator-deployment-artifacts-5.26.19-56899dc0d7-azure-cc.zip) | | Q2 2024 | 5.37.12 | June 12, 2024 | [v5.37.12](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.37.12) | 5.37.12 | [gcp-oidc-deployment-files-5.37.12.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.37.12/gcp-oidc-deployment-files-5.37.12.zip) | [azure-cc-deployment-files-5.37.12.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.37.12/azure-cc-deployment-files-5.37.12.zip) | -| Q3 2024 | 5.38.104 | September 12, 2024 | [v5.38.104](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.38.104) | 5.38.104 | [gcp-oidc-deployment-files-5.38.104.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.38.104/gcp-oidc-deployment-files-5.38.104.zip) | [azure-cc-deployment-files-5.38.104.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.38.104/azure-cc-deployment-files-5.38.104.zip) | \ No newline at end of file +| Q3 2024 | 5.38.104 | September 12, 2024 | [v5.38.104](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.38.104) | 5.38.104 | [gcp-oidc-deployment-files-5.38.104.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.38.104/gcp-oidc-deployment-files-5.38.104.zip) | [azure-cc-deployment-files-5.38.104.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.38.104/azure-cc-deployment-files-5.38.104.zip) | +| Q3 2024 Out-of-band | 5.41.0 | October 29, 2024 | [v5.41.0](https://github.com/IABTechLab/uid2-operator/releases/tag/v5.41.0) | 5.41.0 | [gcp-oidc-deployment-files-5.41.0.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.41.0/gcp-oidc-deployment-files-5.41.0.zip) | [azure-cc-deployment-files-5.41.0.zip](https://github.com/IABTechLab/uid2-operator/releases/download/v5.41.0/azure-cc-deployment-files-5.41.0.zip) | \ No newline at end of file