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
5 changes: 5 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"markdown.validate.ignoredLinks": [
"sharing/sharing-tokenized-from-data-pixel.md"
]
}
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-hashing-and-encoding) 済み電話番号のリストです。 |

### 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,7 +48,25 @@ Used by: このエンドポイントは、主にパブリッシャーが使用

### Request example

詳細といくつかのプログラミング言語でのコードの例は、[Encrypting requests and decrypting responses](../getting-started/gs-encryption-decryption.md) を参照してください。
以下の例は、`curl` を使用してトークンをリフレッシュする例です。`{environment}` を環境のベース URL に置き換え、`{refresh_token}` を前の [POST /token/generate](post-token-generate.md) または `POST /token/refresh` レスポンスの `refresh_token` 値に置き換えます:

```sh
curl -X POST '{environment}/v2/token/refresh' -d '{refresh_token}'
```

例えば、インテグレーション環境を使用する場合:

```sh
curl -X POST 'https://operator-integ.uidapi.com/v2/token/refresh' -d 'AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ'
```

Notes:

- このリクエストは `Authorization` ヘッダー (API key) や暗号化されたリクエストエンベロープを必要としません。POST body は refresh token のみで、JSON ではありません。
- 正常なレスポンス (HTTP ステータスコード 200) は、base64 でエンコードされた暗号化文字列であるため、`curl` ではその内容を表示できません。復号化するには、refresh token と共に返された `refresh_response_key` 値を使用します。[Encrypting requests and decrypting responses](../getting-started/gs-encryption-decryption.md) を参照してください。
- エラーレスポンス (たとえば、HTTP ステータスコード 400) は暗号化されないため、`curl` ではエラーが表示されます。ステータスコード 200 は、オペレーターが到達可能であり、refresh token を受け入れたことを確認します。レスポンスを復号化しなくても、ステータスコード 200 が返されれば、オペレーターが到達可能であり、refresh token を受け入れたことを確認できます。

様々なプログラミング言語でのコード例については、[Encrypting requests and decrypting responses](../getting-started/gs-encryption-decryption.md) を参照してください。

## Decrypted JSON response format

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
Expand Up @@ -7,7 +7,7 @@ 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 を使用する際には、正規化とエンコードが正しく行われることが重要です。

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 hash encoding](#email-address-hashing-and-encoding)または[Phone number hash 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 @@ -141,6 +141,8 @@ Databricks Clean Rooms の `identity_map_v3` [ノートブック](https://docs.d

| Column Name | Data Type | Description |
| :--- | :--- | :--- |
| `INPUT` | string | 入力テーブルまたはビューの `INPUT` カラムからコピーされた元の DII。 |
| `INPUT_TYPE` | string | 入力テーブルまたはビューの `INPUT_TYPE` カラムからコピーされた DII の型。 |
| `UID` | string | 値は以下のいずれかです。<ul><li>**DII が正常にマッピングされた場合**: DII に関連付けられた UID2。</li><li>**それ以外の場合**: `NULL`。</li></ul> |
| `PREV_UID` | string | 値は以下のいずれかです。<ul><li>**DII が正常にマッピングされ、現在の raw UID2 が過去 90 日以内にローテーションされた場合**: 以前の raw UID2。</li><li>**それ以外の場合**: `NULL`。</li></ul> |
| `REFRESH_FROM` | timestamp | 値は以下のいずれかです。<ul><li>**DII が正常にマッピングされた場合**: この UID2 をリフレッシュすべき日時を示すタイムスタンプ。</li><li>**それ以外の場合**: `NULL`。</li></ul> |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ displayed_sidebar: docs
import Link from '@docusaurus/Link';
import SnptIntegratingWithSSO from '../snippets/_snpt-integrating-with-sso.mdx';
import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx';
import SnptExampleClientServerSendUid2ToSdk from '../snippets/_snpt-example-client-server-send-uid2-to-sdk.mdx';
import SnptExampleClientServerSendUid2ToSdk from '../snippets/_snpt-example-client-server-send-uid2-to-sdk.mdx';
import SnptIos27WebkitNote from '../snippets/_snpt-ios27-webkit-note.mdx';
import SnptUidVerifyInspect from '../snippets/_snpt-uid-verify-inspect.mdx';

# Client-server integration guide for JavaScript
Expand Down Expand Up @@ -43,6 +44,12 @@ SDK for JavaScript を使用しないパブリッシャーのインテグレー
Google Ad Manager を使用していて、セキュアシグナル機能を使用したい場合は、まずこのガイドの手順に従った後、[Google Ad Manager Secure Signals integration guide](integration-google-ss.md) の追加手順に従ってください。
:::

:::note
<SnptIos27WebkitNote />

**Action required**: 影響を受けるブラウザでは、Server-Side で UID2 Token を生成およびリフレッシュする必要があります。詳細は、[Publisher integration guide, server-side](integration-publisher-server-side.md) を参照してください。
:::

## Integrating with single sign-on (SSO)

<SnptIntegratingWithSSO />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import SnptIntegratingWithSSO from '../snippets/_snpt-integrating-with-sso.mdx';
import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx';
import SnptIos27WebkitNote from '../snippets/_snpt-ios27-webkit-note.mdx';
import SnptUidVerifyInspect from '../snippets/_snpt-uid-verify-inspect.mdx';

# Client-side integration guide for JavaScript
Expand Down Expand Up @@ -44,6 +45,12 @@ UID2 は JavaScript 用の SDK (詳細は [SDK for JavaScript reference guide](.
3. [Configure the SDK for JavaScript](#configure-the-sdk-for-javascript)
4. [Check that the token was successfully generated](#check-that-the-token-was-successfully-generated)

:::note
<SnptIos27WebkitNote />

**Action required**: 影響を受けるブラウザでは、Client-Side で UID2 Token を生成およびリフレッシュすることはできません。Server-Side で UID2 Token を生成およびリフレッシュする必要があります。詳細は、[Publisher integration guide, server-side](integration-publisher-server-side.md) を参照してください。
:::

## SDK for JavaScript version

Client-Side でのトークン生成は、SDK バージョン 3.4.5 以降でサポートされています。
Expand Down Expand Up @@ -177,7 +184,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 hash encoding](../getting-started/gs-normalization-encoding.md#email-address-hashing-and-encoding) および [Phone number hash encoding](../getting-started/gs-normalization-encoding.md#phone-number-hashing-and-encoding) を参照してください。
:::

以下のセクションでは、各シナリオのコーディング例を示します。
Expand Down
Loading
Loading