Skip to content

Commit 1a26fbb

Browse files
authored
Merge pull request #1006 from IABTechLab/jpn-translation-update-966-1002
Jpn translation update 996 1002
2 parents d26ceb5 + 577435f commit 1a26fbb

3 files changed

Lines changed: 48 additions & 38 deletions

File tree

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,14 @@ Email または Phone Number を選択し、値を入力または貼り付けて
192192

193193
このツールを使用して、内部プロセスが UID2 の正規化、ハッシュ化、およびエンコードされた値を正しく作成するように設定されていることを確認できます。
194194

195+
## UID2 Token Validator
196+
197+
:::note
198+
このセクションはパブリッシャー向けです。パブリッシャーは、直接識別可能な情報(DII)を使用して [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を生成する唯一の参加者です。
199+
:::
200+
201+
エンドツーエンドで完全なトークン生成パイプラインを検証し、正規化、ハッシュ化、およびエンコードされた値から生成された <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 Token</Link> が正しいことを確認するには、[UID2 Token Validator](../ref-info/ref-token-validator.md) を使用してください。
202+
195203
## Troubleshooting
196204

197205
いずれの場合も、自身で DII を処理準備するための手順を実行し、その後 [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) を使用して結果値を確認してください。結果が一致しない場合は、各手順を確認してエラー箇所を特定してください。
Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: UID2 Token Validator
3-
description: How to use the UID2 Token Validator to validate UID2 tokens against source DII and confirm that your token generation workflow is correct.
3+
description: UID2 Token Validator を使用して、UID2 Token をソースの DII に対して検証し、Token 生成ワークフローが正しいことを確認する方法。
44
hide_table_of_contents: false
55
sidebar_position: 02
66
displayed_sidebar: docs
@@ -10,72 +10,72 @@ import Link from '@docusaurus/Link';
1010

1111
# UID2 Token Validator
1212

13-
The [UID2 Token Validator](https://token-validator.uidapi.com/) is a web-based tool that validates <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 tokens</Link> against their source <Link href="../ref-info/glossary-uid#gl-dii">directly identifying information (DII)</Link> to confirm that your token generation process is correct.
13+
[UID2 Token Validator](https://token-validator.uidapi.com/) は、<Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 Token</Link> をその元となる <Link href="../ref-info/glossary-uid#gl-dii">DII (directly identifying information)</Link> と照合し、トークン生成プロセスが正しいかどうかを確認するためのウェブベースのツールです。
1414

1515
## Overview
1616

17-
Publishers who generate UID2 tokens by providing DII sometimes receive tokens that appear valid but are unusable in the UID2 ecosystem. This happens when the normalization or hashing steps are not performed correctly. Because UID2 uses the normalized and hashed form of DII to derive the token, an error in either step produces a <Link href="../ref-info/glossary-uid#gl-raw-uid2">raw UID2</Link> that is unique to that publisher. This mismatched raw UID2 will not correspond to the one used by other participants for the same DII, meaning the publisher's tokens will not match up with those from other publishers, data providers, or advertisers' CRM uploads.
17+
DII を提供することで UID2 Token を生成するパブリッシャーは、有効に見えるにもかかわらず UID2 エコシステムで使用できないトークンを受け取ることがあります。これは、正規化またはハッシュ化のステップが正しく実行されなかった場合に発生します。UID2 はトークンの導出に DII の正規化・ハッシュ化された形式を使用するため、いずれかのステップでエラーが発生すると、そのパブリッシャー固有の <Link href="../ref-info/glossary-uid#gl-raw-uid2">raw UID2</Link> が生成されます。この不一致な raw UID2 は、他の参加者が同じ DII に対して使用するものと一致しないため、そのパブリッシャーのトークンは、他のパブリッシャー、データプロバイダー、または広告主の CRM アップロードによるトークンと一致しません。
1818

1919
## Prerequisites
2020

21-
To use the UID2 Token Validator, you need:
21+
UID2 Token Validator を使用するには、以下が必要です:
2222

23-
- A **UID2 API Key** (Client Key)
24-
- A **UID2 Client Secret**
23+
- **UID2 API Key** (Client Key)
24+
- **UID2 Client Secret**
2525

26-
If you do not have these, see [API Keys](../portal/api-keys.md) for instructions on creating them in the UID2 Portal.
26+
これらをお持ちでない場合は、UID2 Portal での作成手順について [API Keys](../portal/api-keys.md) を参照してください。
2727

2828
## Using the Token Validator
2929

30-
Enter your **API Key** (Client Key) and **Client Secret** in the fields at the top of the Token Validation section.
30+
Token Validation セクションの上部にあるフィールドに **API Key** (Client Key) **Client Secret** を入力します。
3131

32-
Select the **Operator** (environment) you want to validate against. For information about UID2 environments, see [Environments](../getting-started/gs-environments.md).
32+
検証対象の **Operator**(環境)を選択します。UID2 の環境については、[Environments](../getting-started/gs-environments.md) を参照してください。
3333

3434
### Validate a Single Token
3535

36-
1. Under **Input Mode**, select **Single Validation**.
37-
2. In the **Identifier** field, enter the DII you used to generate the token. This can be:
38-
- A raw email address
39-
- A raw phone number
40-
- A Base64-encoded email hash
41-
- A Base64-encoded phone hash
42-
3. Select the identifier type that matches your input.
43-
4. In the **Token** field, paste the UID2 token you want to validate.
44-
5. Click **Validate Tokens**.
36+
1. **Input Mode** **Single Validation** を選択します。
37+
2. **Identifier** フィールドに、トークンの生成に使用した DII を入力します。以下のいずれかを入力できます:
38+
- 生のメールアドレス
39+
- 生の電話番号
40+
- Base64 エンコードされたメールアドレスハッシュ
41+
- Base64 エンコードされた電話番号ハッシュ
42+
3. 入力内容に一致する識別子タイプを選択します。
43+
4. **Token** フィールドに、検証する UID2 Token を貼り付けます。
44+
5. **Validate Tokens** をクリックします。
4545

4646
### Validate Multiple Tokens (CSV)
4747

48-
To validate a batch of token-identifier pairs:
48+
トークンと識別子のペアを一括検証するには:
4949

50-
1. Under **Input Mode**, select **CSV**.
51-
2. Prepare a CSV file with the following columns:
52-
- `identifier`: The DII (raw email, raw phone, email hash, or phone hash).
53-
- `identifier_type`: Either `email`, `phone`, `email_hash` or `phone_hash`.
54-
- `token`: The UID2 token to validate.
55-
3. Upload the CSV file.
56-
4. Click **Validate Tokens**.
50+
1. **Input Mode** **CSV** を選択します。
51+
2. 次の列を持つ CSV ファイルを用意します:
52+
- `identifier`: DII(生のメールアドレス、生の電話番号、メールアドレスハッシュ、または電話番号ハッシュ)。
53+
- `identifier_type`: `email``phone``email_hash`、または `phone_hash` のいずれか。
54+
- `token`: 検証する UID2 Token。
55+
3. CSV ファイルをアップロードします。
56+
4. **Validate Tokens** をクリックします。
5757

5858
## Interpret Validation Results
5959

60-
When you click **Validate Tokens**, the **Validation Results** table displays a row for each token-identifier pair, in the format shown in the following table.
60+
**Validate Tokens** をクリックすると、**Validation Results** テーブルにトークンと識別子の各ペアの行が、以下の表に示す形式で表示されます。
6161

6262
| Column | Description |
6363
|---|---|
64-
| Identifier | The DII you entered. |
65-
| Identifier Type | `email`, `phone`, `email_hash` or `phone_hash`. |
66-
| Normalized Hash | The Base64-encoded SHA-256 hash of the normalized DII. |
67-
| Token | The token you submitted. |
68-
| Validation | The result of the validation. For details, see the following table. |
64+
| Identifier | 入力した DII |
65+
| Identifier Type | `email``phone``email_hash`、または `phone_hash` |
66+
| Normalized Hash | 正規化された DII の Base64 エンコードされた SHA-256 ハッシュ。 |
67+
| Token | 送信したトークン。 |
68+
| Validation | 検証の結果。詳細については、以下の表を参照してください。 |
6969

70-
The **Validation** column reflects the response from the [POST&nbsp;/token/validate](../endpoints/post-token-validate.md) endpoint.
70+
**Validation** 列には [POST&nbsp;/token/validate](../endpoints/post-token-validate.md) エンドポイントからのレスポンスが反映されます。
7171

7272
| Validation Result | Meaning |
7373
|---|---|
74-
| `Token matches identifier` | The token matches the provided DII. This means that the token was generated from the correct normalized hash. |
75-
| `Failed: Token does not match identifier` | The token does not match the provided DII. The most likely cause is incorrect normalization or hashing. |
76-
| `Failed: Invalid token` | The token is malformed and cannot be parsed. |
77-
| `Failed: {"status":"unauthorized"}` | The API credentials provided are invalid or unauthorized. |
74+
| `Token matches identifier` | トークンが提供された DII と一致しています。これは、トークンが正しい正規化ハッシュから生成されたことを意味します。 |
75+
| `Failed: Token does not match identifier` | トークンが提供された DII と一致しません。最も可能性の高い原因は、正規化またはハッシュ化の誤りです。 |
76+
| `Failed: Invalid token` | トークンの形式が不正で、解析できません。 |
77+
| `Failed: {"status":"unauthorized"}` | 提供された API 認証情報が無効または許可されていません。 |
7878

7979
:::tip
80-
If the result is **Failed: Token does not match identifier**, compare the **Normalized Hash** shown in the results with the value your own implementation produced for the same DII. If they differ, the issue is in your normalization or hashing steps. For details, see [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) and [Preparing Emails and Phone Numbers for Processing](ref-preparing-emails-and-phone-numbers-for-processing.md).
80+
結果が **Failed: Token does not match identifier** の場合、結果に表示される **Normalized Hash** と、同じ DII に対して自身の実装で生成した値を比較してください。異なる場合は、正規化またはハッシュ化のステップに問題があります。詳細については、[Normalization and Encoding](../getting-started/gs-normalization-encoding.md) および [Preparing Emails and Phone Numbers for Processing](ref-preparing-emails-and-phone-numbers-for-processing.md) を参照してください。
8181
:::

i18n/ja/docusaurus-plugin-content-docs/current/snippets/_snpt-preparing-emails-and-phone-numbers.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,5 @@ import Link from "@docusaurus/Link";
33
UID2 に変換する入力データが許容可能な形式であることは非常に重要です。そうでない場合、期待される結果は得られません。たとえば、[Phone Number Normalization](../getting-started/gs-normalization-encoding.md#phone-number-normalization) で説明されているように、電話番号には国コードを含めるように正規化する必要があります。
44

55
詳細は、[Preparing Emails and Phone Numbers for Processing](../ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md) を参照してください。
6+
7+
フルトークン生成パイプラインをエンドツーエンドで検証し、正規化・ハッシュ化・エンコードされた値から生成されたトークンが正確であることを確認するためには、[UID2 Token Validator](../ref-info/ref-token-validator.md)を使用してください。

0 commit comments

Comments
 (0)