Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jpn translation update 202401 late #442

Merged
merged 9 commits into from
Feb 6, 2024
2 changes: 1 addition & 1 deletion api-ja/v2/upgrades/upgrade-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ SDK を使用せず、 サーバーサイドまたはクライアントサイド

UID2 API v2 へのアップグレードについて知っておくべきことは、以下のとおりです:

- 単一ユーザーの個人を識別できる情報(DII)を UID2 にマッピングする v1 `GET /identity/map` エンドポイントは、単一および複数ユーザーの DII をマッピングする v2 [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントに置き換えられました。
- 単一ユーザーの個人を識別できる情報(DII) を UID2 にマッピングする v1 `GET /identity/map` エンドポイントは、単一および複数ユーザーの DII をマッピングする v2 [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントに置き換えられました。
- v2 [POST /identity/map](../endpoints/post-identity-map.md) および [POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントが返す UID2 とバケット ID は、対応する v1 エンドポイントが返すものと同じものです。
- [Snowflake Integration Guide](../guides/snowflake_integration.md) は、UID2 v2 API へのアップグレードの影響を受けないので、変更は必要ありません。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Used by: このエンドポイントは、主に広告主やデータプロバ

NOTE: インテグレーション環境と本番環境では、異なる [APIキー](../ref-info/glossary-uid.md#gl-api-key) が必要です。

### Unencrypted JSON Body Parameters
### Unencrypted JSON Body Parameters

> IMPORTANT: リクエストを暗号化するときは、以下の 4 つの条件パラメータのうち、 **1つ** だけをリクエストの JSON ボディにキーと値のペアとして含める必要がります。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用

> IMPORTANT: このエンドポイントは、ユーザーの [directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) をターゲティング広告用の UID2 Token に変換する法的根拠を得た場合にのみ呼び出すようにしてください。`optout_check` パラメータは値 `1` が必須で、ユーザーがオプトアウトしたかどうかをチェックします。

## Request Format
## Request Format

`POST '{environment}/v2/token/generate'`

Expand Down Expand Up @@ -76,7 +76,7 @@ echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_chec
```
詳細と Python スクリプトの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。

## Decrypted JSON Response Format
## Decrypted JSON Response Format

> NOTE: レスポンスは、HTTP ステータスコードが 200 の場合のみ暗号化されます。それ以外の場合、レスポンスは暗号化されません。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,13 @@ sidebar_position: 04
---

# POST /token/refresh

[POST /token/generate](post-token-generate.md) エンドポイントから返された、対応する未使用のリフレッシュトークンを送信して、新しい [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を生成します。

Used by: このエンドポイントは、主にパブリッシャーが使用します。

> NOTE: このエンドポイントは、API Key を使用する必要がないため、Client-Side (例えば、ブラウザやモバイルアプリなど) から呼び出せます。

## Request Format
## Request Format

`POST '{environment}/v2/token/refresh'`

Expand Down Expand Up @@ -118,4 +117,4 @@ Used by: このエンドポイントは、主にパブリッシャーが使用
| `expired_token` | 400 | リクエストで指定された `refresh_token` 値は期限切れのトークンです。 |
| `unauthorized` | 401 | クエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行するのに許可されていないベアラートークンが含まれていました。 |

`status` の値が `success` または `optout` 以外であれば、 `message` フィールドにその問題に関する追加情報が表示されます。
`status` の値が `success` または `optout` 以外であれば、 `message` フィールドにその問題に関する追加情報が表示されます。
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@ sidebar_position: 03
---

# POST /token/validate

Advertising Token が指定されたハッシュ化された、またはハッシュ化されていないメールアドレスまたは電話番号と一致するかどうかを検証します。

Used by: このエンドポイントは、主にパブリッシャーが使用します。

> NOTE: このエンドポイントは、主に新しいインテグレーションのテストとトラブルシューティングのために用意されています。

## Request Format
## Request Format

`POST '{environment}/v2/token/validate'`

> IMPORTANT: すべてのリクエストは、秘密鍵を使用して暗号化する必要があります。詳細と Python スクリプトの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。


### Path Parameters

| Path Parameter | Data Type | Attribute | Description |
Expand All @@ -27,6 +27,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用

NOTE: インテグレーション環境と本番環境では、異なる [APIキー](../ref-info/glossary-uid.md#gl-api-key) が必要です。


### Unencrypted JSON Body Parameters

- Body Parameter の表にあるように、以下の4つの有効なオプションのうち1つだけを含めます: `email`、`email_hash`、`phone`、`phone_hash` のいずれかです。テストするパラメータには、リストされている値を正確に指定してください。
Expand All @@ -52,27 +53,25 @@ NOTE: インテグレーション環境と本番環境では、異なる [APIキ
"email": "[email protected]"
}
```

```json
{
"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXlfWETZ3b%2FbesPFFvJxNLLySg4QEYHUAiyUrNncgnm7ppu0mi6wU2CW6hssiuEkKfstbo9XWgRUbWNTM%2BewMzXXM8G9j8Q%3D",
"email_hash": "ntI244ZRTXwAwpki6/M5cyBYW7h/Wq576lnN3l9+W/c="
}
```

```json
{
"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXlfWETZ3b%2FbesPFFvJxNLLySg4QEYHUAiyUrNncgnm7ppu0mi6wU2CW6hssiuEkKfstbo9XWgRUbWNTM%2BewMzXXM8G9j8Q%3D",
"phone": "+12345678901"
}
```

```json
{
"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXlfWETZ3b%2FbesPFFvJxNLLySg4QEYHUAiyUrNncgnm7ppu0mi6wU2CW6hssiuEkKfstbo9XWgRUbWNTM%2BewMzXXM8G9j8Q%3D",
"phone_hash": "EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4="
}
```

以下は、メールアドレスハッシュの暗号化トークン検証リクエストの例です:

```sh
Expand Down Expand Up @@ -122,4 +121,4 @@ echo '{"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXl
3. Step 1 で送信した `email`、`email_hash`、`phone`、`phone_hash` の値と、Step 2 で保存した `advertising_token` を `token` プロパティの値として、`POST /token/validate` リクエストを送信します。
4. `POST /token/validate` リクエストに対するレスポンスを確認します。結果は以下のように、処理の成功を示しています:
- `true` のレスポンスは、Step 1 でリクエストとして送った DII が、Step 1 のレスポンスで受け取ったトークンと一致していることを示します。
- `false` のレスポンスは、メールアドレス、電話番号、またはそれぞれのハッシュを送信する方法に問題があるかもしれないことを示します。
- `false` のレスポンスは、メールアドレス、電話番号、またはそれぞれのハッシュを送信する方法に問題があるかもしれないことを示します。
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ hide_table_of_contents: false
sidebar_position: 01
---

# UID2 Endpoints
# UID2 Endpoints: Summary

すべての UID2 エンドポイントでは、API リクエストの暗号化([POST /token/refresh](post-token-refresh.md) を除く) とレスポンスの復号化にクライアントシークレットが必要です。詳細と Python スクリプトの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,6 @@ API Key とクライアントシークレットは、認証情報が漏洩する
## Subscription ID and Public Key

Client-Side の実装([UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) または [Client-Side Integration Guide for JavaScript](../guides/publisher-client-side.md) を参照) を使用している場合は、以下の認証情報を受け取ります:

- **Subscription ID**: UID2 Service に対してサイトを識別する値です。
- **Public key**: この値は暗号化に使用されます。

Expand All @@ -63,7 +62,7 @@ Notes:

- これらの値は特定の [Environment](gs-environments.md) に対して有効です。テスト環境と本番環境の両方を使用している場合、それぞれの環境用の認証情報のセットを取得します。

- Subscription ID と Public Key の認証情報は、Client-Side トークンの生成にのみ使用できます。追加のロールが必要な場合は ([API Permissions](gs-permissions.md)を参照してください)、そのロールの API Key と Client Secret をリクエストしてください。 <!-- (**GWH_KT added last bullet to this GS article based on work on Publisher Options page. Review please.**) -->
- Subscription ID と Public Key の認証情報は、Client-Side トークンの生成にのみ使用できます。追加のロールが必要な場合は ([API Permissions](gs-permissions.md) を参照してください)、そのロールの API Key と Client Secret をリクエストしてください。 <!-- (**GWH_KT added last bullet to this GS article based on work on Publisher Options page. Review please.**) -->

## Refreshing Credentials

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,8 +73,8 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ
#### トークン生成の呼び出しは、Server-Side とClient-Side のどちらで行うべきですか?

UID2 Token は、Client-Side、Server-Sideのどちらでも生成できます。詳細については、以下を参照してください:
- Prebid.js を使用して Client-Side からトークンを生成する: [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md).
- Prebid.js を使用して Server-Side からトークンを生成する: [UID2 Server-Side Integration Guide for Prebid.js](../guides/integration-prebid-server-side.md).
- Prebid.js を使用して Client-Side からトークンを生成します: [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md).
- Prebid.js を使用して Server-Side からトークンを生成します: [UID2 Server-Side Integration Guide for Prebid.js](../guides/integration-prebid-server-side.md).
- その他の Server-Side オプション: [Publisher Integrations](../guides/summary-guides.md#publisher-integrations).

#### Client-Side からトークンのリフレッシュを呼び出すことはできますか?
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ UID2 Operator Service にハッシュ化されていないメールアドレス
| :--- | :--- | :--- |
| 正規化メールアドレス | `[email protected]` | 正規化は常に最初のステップです。 |
| 正規化されたメールアドレスのSHA-256ハッシュ | `b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514` | この 64 文字の文字列は、32 バイトの SHA-256 を 16 進符号化したものです。 |
| 正規化されたメールアドレスの 16 進数から Base64 SHA-256 エンコーディングへの変換 | `tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=` | この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。<br/>WARNING: 上の例の SHA-256 ハッシュ文字列は、ハッシュ値を 16 進符号化したものです。ハッシュの Raw バイトを Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用する必要があります。<br/>リクエストボディに送られる `email_hash` 値にはこのエンコーディングを使用します。 |
| 正規化されたメールアドレスの 16 進数から Base64 SHA-256 エンコーディングへの変換 | `tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=` | この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。<br/>WARNING: 上の例の SHA-256 ハッシュ文字列は、ハッシュ値を 16 進符号化したものです。ハッシュの Raw バイトを Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用する必要があります。<br/>リクエストボディに送られる `email_hash` 値にはこのエンコーディングを使用します。 |

>WARNING: Base64 エンコードを適用する場合、ハッシュの Raw バイトを必ず Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用してください。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,9 @@ Snowflake Data Marketplace でホストされる Open Operator Service を使用

DII とは、正規化されたメールアドレスや電話番号、あるいは正規化され SHA-256 ハッシュ化されたメールアドレスや電話番号のことです。

![](images/advertiser-flow-mermaid.png)
![Advertiser Flow](images/advertiser-flow-mermaid.png)

<!-- diagram source: resource/advertiser-flow-mermaid.md -->

図の各部の詳細については、以下のセクションを参照してください:
1. [Retrieve a raw UID2 for DII using the identity map endpoints](#1-retrieve-a-raw-uid2-for-dii-using-the-identity-map-endpoint)
Expand All @@ -46,7 +48,6 @@ DII とは、正規化されたメールアドレスや電話番号、あるい
Step 1-b で返された `advertising_id` (raw UID2) を、オーディエンスを構築しながら DSP に送信します。各 DSP はオーディエンスを構築するための独自のインテグレーションプロセスを持っています。raw UID2 を送信してオーディエンスを構築するには、DSP が提供するインテグレーションガイダンスに従ってください。

### 3: Monitor for salt bucket rotations related to your stored raw UID2s

raw UID2 は、特定の時点のユーザーに対する識別子です。特定のユーザーの raw UID2 は、ソルトのローテーションの結果、少なくとも 1 年に 1 回は変化します。

ソルトバケットの更新は 1 年に 1 回程度ですが、個々のバケットの更新は 1 年に分散しています。全ソルトバケットの約 1/365 を毎日ローテーションしています。
Expand All @@ -71,7 +72,6 @@ UID2 ベースのオーディエンス情報を正確かつ最新の状態に保

次に、Step 2の[send raw UID2 to a DSP](#2-send-stored-raw-uid2s-to-dsps-to-create-audiences) に従って、リフレッシュされた UID2 を使ってオーディエンスを更新します。


## FAQs

UID2 フレームワークを使用する広告主およびデータプロバイダー向けのよくある質問は、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ sidebar_position: 03

ワークフローを示すサンプルアプリケーションもあります。[サンプルアプリケーション](#sample-application) を参照してください。

> TIP: UID2 を使用してクライアントの identity を確立し、UID2 Token を取得するプロセスを容易にするには、UID2 SDK for JavaScript の使用を検討してください。詳細については、[Server-Side Integration Guide for JavaScript](integration-javascript-server-side.md)を参照してください。
> TIP: UID2 を使用してクライアントの identity を確立し、UID2 Token を取得するプロセスを容易にするには、UID2 SDK for JavaScript の使用を検討してください。詳細については、[Server-Side Integration Guide for JavaScript](integration-javascript-server-side.md) を参照してください。

## Integration Steps

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,12 @@ DSP はビッドリクエストで UID2 Token を受け取り、この機能を

* [Integration Steps](#integration-steps)
- [Honor User Opt-Outs](#honor-user-opt-outs)
* [FAQs](#faqs) -->

## Integration Steps
* [FAQs](#faqs) -->

以下は、RTB で UID2 をサポートするための DSP のインテグレーションワークフローで、大きく 2 つのステップで構成されています:
## Integration Steps

以下は、RTB で UID2 をサポートするための DSP のインテグレーションワークフローで、大きく 2 つのステップで構成されています:
1. [Honor user opt-outs](#honor-user-opt-outs)
2. [Decrypt UID2 tokens for RTB use](#decrypt-uid2-tokens-for-rtb-use)

Expand All @@ -47,7 +47,6 @@ UID2 Service は、ユーザーがオプトアウトしてから数秒以内に
```html
https://dsp.example.com/optout?user=%%identity%%&optouttime=%%timestamp%%
```

#### Bidding Opt-Out Logic

入札時 (2-b)に以下のロジックを使用し、ユーザーのオプトアウトを受け入れます。
Expand All @@ -71,4 +70,4 @@ Server-Side SDK のいずれか ([SDKs: Summary](../sdks/summary-sdks.md) を参

## FAQs

DSP に関するよくある質問は、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。
DSP に関するよくある質問は、[FAQs for DSPs](../getting-started/gs-faqs.md#faqs-for-dsps) を参照してください。
Loading
Loading