Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,9 @@ UID2 のオプトアウトワークフローとユーザーがオプトアウト
| Body Parameter | Data Type | Attribute | Description |
|:---|:---|:---|:---|
| `email` | string array | 条件付きで必須 | マッピングするメールアドレスのリストです。 |
| `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) 済みメールアドレスのリストです。 |
| `email_hash` | string array | 条件付きで必須 | マッピングする [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#email-address-normalization) した [正規化](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-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) 済み電話番号のリストです。 |
| `phone_hash` | string array | 条件付きで必須 | マッピングする [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) した [正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号のリストです。 |

### Request examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,9 @@ UID2 のオプトアウト手順とユーザーがオプトアウトする方法
| Body Parameter | Data Type | Attribute | Description |
|:---------------|:----------------------------|:-----------------------| :--- |
| `email` | string array | 条件付きで必須 | マッピングするメールアドレスのリスト。 |
| `email_hash` | string array | 条件付きで必須 | マッピングする [正規化済み](../getting-started/gs-normalization-encoding.md#email-address-normalization) メールアドレスの [Base64 エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) ハッシュのリスト。 |
| `email_hash` | string array | 条件付きで必須 | マッピングする [正規化済み](../getting-started/gs-normalization-encoding.md#email-address-normalization) メールアドレスの [Base64 エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding) ハッシュのリスト。 |
| `phone` | string array | 条件付きで必須 | マッピングする [正規化済み](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 電話番号のリスト。 |
| `phone_hash` | string array | 条件付きで必須 | マッピングする [正規化済み](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 電話番号の [Base64 エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) ハッシュのリスト。 |
| `phone_hash` | string array | 条件付きで必須 | マッピングする [正規化済み](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 電話番号の [Base64 エンコードされた SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) ハッシュのリスト。 |


### Request examples
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,9 @@ Used by: このエンドポイントは、主にパブリッシャーが使用
| Body Parameter | Data Type | Attribute | Description |
| :--- | :--- | :--- | :--- |
| `email` | string | 条件付きで必須 | トークンを生成するメールアドレスです。 |
| `email_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) した [正規化](../getting-started/gs-normalization-encoding.md#email-address-normalization) 済みメールアドレスです。 |
| `email_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding) した [正規化](../getting-started/gs-normalization-encoding.md#email-address-normalization) 済みメールアドレスです。 |
| `phone` | string | 条件付きで必須 | トークンを生成する [正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号です。 |
| `phone_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) した、[正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号です。 |
| `phone_hash` | string | 条件付きで必須 | [SHA-256 ハッシュし、Base64 エンコード](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) した、[正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 済み電話番号です。 |

### Request examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,9 @@ Used by: このエンドポイントは、主にパブリッシャーが使用
| :--- | :--- | :--- | :--- |
| `token` | string | 必須 | [POST&nbsp;/token/generate](post-token-generate.md) レスポンスによって返された Advertising Token です。<br/>自身の認証情報で生成された Advertising Token のみを検証できます。 |
| `email` | string | 条件付きで必須 | トークン検証用のメールアドレスです。正規化されているかどうかに関わらず、有効なメールアドレス値を使用できます。 |
| `email_hash` | string | 条件付きで必須 | 有効な [正規化された](../getting-started/gs-normalization-encoding.md#email-address-normalization) メールアドレスの [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) ハッシュです。 |
| `email_hash` | string | 条件付きで必須 | 有効な [正規化された](../getting-started/gs-normalization-encoding.md#email-address-normalization) メールアドレスの [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding) ハッシュです。 |
| `phone` | string | 条件付きで必須 | トークン検証用の電話番号です。有効な電話番号値を使用できますが、[正規化](../getting-started/gs-normalization-encoding.md#phone-number-normalization)されている必要があります。 |
| `phone_hash` | string | 条件付きで必須 | 有効な [正規化された](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 電話番号の [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) ハッシュです。 |
| `phone_hash` | string | 条件付きで必須 | 有効な [正規化された](../getting-started/gs-normalization-encoding.md#phone-number-normalization) 電話番号の [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) ハッシュです。 |

### Request examples

Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Normalization and encoding
description: 情報を正規化およびエンコードして、安全にデコードできるようにする方法。
title: Normalization, hashing, and encoding
description: メールアドレスおよび電話番号の正規化、ハッシュ化、エンコードに関する手順。
hide_table_of_contents: false
displayed_sidebar: docs
---

import Link from '@docusaurus/Link';

# Normalization and encoding
# Normalization, hashing, and encoding

このページでは、<Link href="../ref-info/glossary-uid#gl-dii">DII</Link> の正規化とエンコードに関する情報を提供します。UID2 を使用する際には、正規化とエンコードが正しく行われることが重要です。
このページでは、<Link href="../ref-info/glossary-uid#gl-dii">DII</Link> の正規化、ハッシュ化、エンコードに関する情報を提供します。UID2 を使用する際には、正規化とエンコードが正しく行われることが重要です。

## Introduction

Expand Down Expand Up @@ -53,7 +53,7 @@ UID2 <Link href="../ref-info/glossary-uid#gl-operator-service">Operator Service<

様々なシナリオの例は、[Normalization examples for email](#normalization-examples-for-email) を参照してください。

## Email address hash encoding
## Email address hashing and encoding

メールアドレスのハッシュは、正規化されたメールアドレスの Base64 エンコードされた <Link href="../ref-info/glossary-uid#gl-sha-256">SHA-256</Link> ハッシュです。メールアドレスは最初に正規化され、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化され、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16 進数でエンコードされた文字列表現ではないことに注意してください。

Expand Down Expand Up @@ -140,7 +140,7 @@ UID2 Operator Service へのリクエストで電話番号を送信する前に
正規化された電話番号が UTF-8 であることを確認してください。他のエンコーディングシステム(例: UTF-16)ではありません。
:::

## Phone number hash encoding
## Phone number hashing and encoding

電話番号のハッシュは、正規化された電話番号の Base64 エンコードされた SHA-256 ハッシュです。電話番号は最初に正規化し、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化し、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16 進数でエンコードされた文字列表現ではないことに注意してください。

Expand Down Expand Up @@ -213,4 +213,4 @@ Email または Phone Number を選択し、値を入力または貼り付けて

- **Use the Base64-encoded value**: このプロセスには、ハッシュ値のバイト列を正規化、ハッシュ化、Base64 エンコードする手順が含まれます。UID2 を生成する際の入力は、この Base64 エンコードされた値です。必ずこの 44 文字の文字列値を使用してください。

- 以下のエラーメッセージが表示される場合があります:「The hashing value must be 44 characters. (ハッシュ値は 44 文字でなければなりません)」。この場合、使用しているハッシュ関数に問題があります。SHA-256 ハッシュの 16 進数から Base64 へのエンコードを使用してください。詳細は[Email address hash encoding](#email-address-hash-encoding)または[Phone number hash encoding](#phone-number-hash-encoding)を参照してください。確認のため、[UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) でテストしてください。
- 以下のエラーメッセージが表示される場合があります:「The hashing value must be 44 characters. (ハッシュ値は 44 文字でなければなりません)」。この場合、使用しているハッシュ関数に問題があります。SHA-256 ハッシュの 16 進数から Base64 へのエンコードを使用してください。詳細は[Email address hashing and encoding](#email-address-hashing-and-encoding)または[Phone number hashing and encoding](#phone-number-hashing-and-encoding)を参照してください。確認のため、[UID2 hashing tool](https://hashing-tool.samples.uidapi.com/) でテストしてください。
Original file line number Diff line number Diff line change
Expand Up @@ -177,7 +177,7 @@ SDK を設定するには、アカウント設定時に受け取った **Public
* `__uid2.setIdentityFromPhoneHash`

:::important
`__uid2.setIdentityFromEmailHash` または `__uid2.setIdentityFromPhoneHash` の場合、`emailHash` または `PhoneHash` 引数は Base64 エンコードされた値である必要があります。詳細は [Email address hash encoding](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) および [Phone number hash encoding](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) を参照してください。
`__uid2.setIdentityFromEmailHash` または `__uid2.setIdentityFromPhoneHash` の場合、`emailHash` または `PhoneHash` 引数は Base64 エンコードされた値である必要があります。詳細は [Email address hashing and encoding](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding) および [Phone number hashing and encoding](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) を参照してください。
:::

以下のセクションでは、各シナリオのコーディング例を示します。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ import Link from '@docusaurus/Link';
<td>2</td>
<td>正規化されたメールアドレスに <Link href="../ref-info/glossary-uid#gl-sha-256">SHA-256</Link> ハッシュを適用</td>
<td>パブリッシャーまたは UID2 Operator</td>
<td>[Email address hash encoding](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding)<br/>[Phone number hash encoding](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding)</td>
<td>[Email address hashing and encoding](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding)<br/>[Phone number hashing and encoding](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding)</td>
</tr>
<tr>
<td>3</td>
<td>SHA-256 ハッシュに Base64 エンコーディングを適用</td>
<td>パブリッシャーまたは UID2 Operator</td>
<td>[Email address hash encoding](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding)<br/>[Phone number hash encoding](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding)</td>
<td>[Email address hashing and encoding](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding)<br/>[Phone number hashing and encoding](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding)</td>
</tr>
<tr>
<td>4</td>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,13 @@ UID2 SDK、または Prebid.js インテグレーション、Android/iOS イン
<tbody>
<tr>
<td>Email</td>
<td>以下のいずれかでなければなりません:<ul><li>生のメールアドレス</li><li>正規化されたメールアドレス</li><li>正規化され、ハッシュ化され、Base64 エンコードされたもの</li></ul></td>
<td>[Email address normalization](../getting-started/gs-normalization-encoding#email-address-normalization)<br/>[Email address hash encoding](../getting-started/gs-normalization-encoding#email-address-hash-encoding)</td>
<td>以下のいずれかでなければなりません:<ul><li>平文(ハッシュ化・エンコードされていない状態)のメールアドレス</li><li>正規化されたメールアドレス</li><li>正規化され、ハッシュ化され、Base64 エンコードされたもの</li></ul></td>
<td>[Email address normalization](../getting-started/gs-normalization-encoding#email-address-normalization)<br/>[Email address hashing and encoding](../getting-started/gs-normalization-encoding#email-address-hashing-and-encoding)</td>
</tr>
<tr>
<td>Phone Number</td>
<td>以下のいずれかでなければなりません:<ul><li>国番号を含む正規化されたもの</li><li>正規化され、ハッシュ化され、Base64 エンコードされたもの</li></ul></td>
<td>[Phone number normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)<br/>[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding)</td>
<td>Phone Number</td>
<td>以下のいずれかでなければなりません:<ul><li>国番号を含む正規化された平文(ハッシュ化・エンコードされていない状態)の電話番号</li><li>正規化され、ハッシュ化され、さらにBase64エンコードされたもの</li></ul></td>
<td>[Phone number normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)<br/>[Phone number hashing and encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding)</td>
</tr>
</tbody>
</table>
Original file line number Diff line number Diff line change
Expand Up @@ -805,8 +805,8 @@ September 7, 2023

詳細は:

- [Email address hash encoding](../getting-started/gs-normalization-encoding#email-address-hash-encoding)
- [Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding)
- [Email address hashing and encoding](../getting-started/gs-normalization-encoding#email-address-hashing-and-encoding)
- [Phone number hashing and encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding)

</CustomTagsContainer>

Expand Down
Loading