-
Notifications
You must be signed in to change notification settings - Fork 50
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #335 from IABTechLab/jpn-translation-update-202308
Jpn translation update 202308
- Loading branch information
Showing
47 changed files
with
918 additions
and
805 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -33,27 +33,31 @@ Used by: このエンドポイントは、主に広告主やデータプロバ | |
| | :-------------- | :-------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ||
| | `{environment}` | string | 必須 | テスト環境: `https://operator-integ.uidapi.com`<br/>本番環境: `https://prod.uidapi.com`<br/>リージョンごとのオペレーターを含む全リストは [Environments](../summary-doc-v2.md#environments) を参照してください。 | | ||
|
|
||
| NOTE: インテグレーション環境と本番環境では、異なる[APIキー](../ref-info/glossary-uid.md#gl-api-key)が必要です。 | ||
| NOTE: インテグレーション環境と本番環境では、異なる [APIキー](../ref-info/glossary-uid.md#gl-api-key) が必要です。 | ||
|
|
||
| ### Unencrypted JSON Body Parameters | ||
|
|
||
| > IMPORTANT: リクエストを暗号化する際、JSON ボディに Key-Value ペアとして以下のパラメータのうち 1 つだけを含める必要があります。 | ||
| > IMPORTANT: リクエストを暗号化するときには、以下の4つの条件付きパラメータのうち **1つ** と、必須パラメータである `policy` の値 `1` のみを、JSON ボディのキーと値のペアとして含める必要があります。 | ||
| | Body Parameter | Data Type | Attribute | Description | | ||
| | :------------- | :----------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | `email` | string array | 条件付きで必要 | マッピングするメールアドレスのリストです。 | | ||
| | `email_hash` | string array | 条件付きで必要 | [正規化](../getting-started/gs-normalization-encoding#email-address-hash-encoding) したメールアドレスを [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding#email-address-normalization) したリストです。 | | ||
| | `phone` | string array | 条件付きで必要 | マッピングする [正規化](../getting-started/gs-normalization-encoding#phone-number-normalization) 済み電話番号のリストです。 | | ||
| | `phone_hash` | string array | 条件付きで必要 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding#phone-number-hash-encoding) した [正規化](../getting-started/gs-normalization-encoding#phone-number-normalization) 済み電話番号のリストです。 | | ||
| | `optout_check` | number | オプション | ユーザー識別子がオプトアウトされたときの ID マップの動作をカスタマイズします。詳しくは、[Identity Map Policy](#identity-map-policy) を参照してください。 | | ||
| | `email_hash` | string array | 条件付きで必要 | マッピングする [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#email-address-normalization) した [正規化](../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 | 条件付きで必要 | マッピングする [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) した [正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号のリストです。 | | ||
| | `policy` | number | 必須 | トークン生成ポリシー ID は、ユーザーがオプトアウトしたかどうかをチェックします。このパラメータは `1` とします。 | | ||
|
|
||
| ### Request Examples | ||
|
|
||
| 以下は、各パラメータの暗号化されていない JSON リクエストボディの例で、このうちの 1 つを ID マッピングリクエストに含める必要があります: | ||
|
|
||
| ```json | ||
| { | ||
| "email": ["[email protected]", "[email protected]"] | ||
| "email": [ | ||
| "[email protected]", | ||
| "[email protected]" | ||
| ], | ||
| "policy":1 | ||
| } | ||
| ``` | ||
|
|
||
|
|
@@ -62,13 +66,18 @@ NOTE: インテグレーション環境と本番環境では、異なる[APIキ | |
| "email_hash": [ | ||
| "eVvLS/Vg+YZ6+z3i0NOpSXYyQAfEXqCZ7BTpAjFUBUc=", | ||
| "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=" | ||
| ] | ||
| ], | ||
| "policy":1 | ||
| } | ||
| ``` | ||
|
|
||
| ```json | ||
| { | ||
| "phone": ["+1111111111", "+2222222222"] | ||
| "phone": [ | ||
| "+1111111111", | ||
| "+2222222222" | ||
| ], | ||
| "policy":1 | ||
| } | ||
| ``` | ||
|
|
||
|
|
@@ -77,14 +86,15 @@ NOTE: インテグレーション環境と本番環境では、異なる[APIキ | |
| "phone_hash": [ | ||
| "eVvLS/Vg+YZ6+z3i0NOpSXYyQAfEXqCZ7BTpAjFUBUc=", | ||
| "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=" | ||
| ] | ||
| ], | ||
| "policy":1 | ||
| } | ||
| ``` | ||
|
|
||
| 以下は、メールアドレスハッシュに対する暗号化された ID マッピングリクエストの例です: | ||
|
|
||
| ```sh | ||
| echo '{"phone": ["+1111111111", "+2222222222"]}' | python3 uid2_request.py https://prod.uidapi.com/v2/identity/map YourTokenBV3tua4BXNw+HVUFpxLlGy8nWN6mtgMlIk= DELPabG/hsJsZk4Xm9Xr10Wb8qoKarg4ochUdY9e+Ow= | ||
| echo '{"phone": ["+1111111111", "+2222222222"], "policy":1}' | python3 uid2_request.py https://prod.uidapi.com/v2/identity/map YourTokenBV3tua4BXNw+HVUFpxLlGy8nWN6mtgMlIk= DELPabG/hsJsZk4Xm9Xr10Wb8qoKarg4ochUdY9e+Ow= | ||
| ``` | ||
|
|
||
| 詳細と Python スクリプトの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 | ||
|
|
@@ -138,7 +148,7 @@ echo '{"phone": ["+1111111111", "+2222222222"]}' | python3 uid2_request.py https | |
| } | ||
| ``` | ||
|
|
||
| リクエストにパラメータ/値 `optout_check=1` が含まれ、一部の識別子が UID2 エコシステムからオプトアウトしている場合、オプトアウトした識別子は、見つかった無効な識別子とともに"unmapped"リストに移動されます。この場合でも、応答ステータスは "success" です。 | ||
| 一部の識別子が UID2 エコシステムからオプトアウトしている場合、オプトアウトした識別子は、見つかった無効な識別子とともに "unmapped" リストに移動されます。この場合でも、応答ステータスは "success" です。 | ||
|
|
||
| ```json | ||
| { | ||
|
|
@@ -177,15 +187,7 @@ echo '{"phone": ["+1111111111", "+2222222222"]}' | python3 uid2_request.py https | |
| | :------------- | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | `success` | 200 | リクエストは成功しました。レスポンスは暗号化されています。 | | ||
| | `client_error` | 400 | リクエストに不足している、または無効なパラメータがありました。 | | ||
| | `unauthorized` | 401 | クエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行するのに許可されていないベアラートークンが含まれていました。 | | ||
| | `unauthorized` | 401 | クエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行するのに許可されていないベアラートークンが含まれていた。 | | ||
|
|
||
| `status` の値が `success` 以外の場合、 `message` フィールドにその問題に関する追加情報が表示されます。 | ||
| `status` の値が `success` 以外であれば、 `message` フィールドにその問題に関する追加情報が表示されます。 | ||
|
|
||
| ### Identity Map Policy | ||
|
|
||
| ID マップポリシーは、トークンを生成するタイミングを呼び出し元が決定できるようにします。これは、リクエストボディに整数値の ID として渡されます (キー 'policy' を使用)。このパラメータが省略された場合、デフォルト値である optout_check = 0 が適用されます。 | ||
|
|
||
| | ID | Description | | ||
| | :-- | :----------------------------------------------------- | | ||
| | 0 | 常にユーザー ID を UID2 にマッピングします。 | | ||
| | 1 | オプトアウトしたユーザーは、マッピングに含まれません。 | | ||
Oops, something went wrong.