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
4 changes: 2 additions & 2 deletions docs/getting-started/gs-encryption-decryption.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ displayed_sidebar: docs
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import Link from '@docusaurus/Link';
import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@miyaichi we should keep the naming consistent across the boards. This fix in all instances:

import SnptSnpt > import Snpt

I know it doesn't matter as long as the name on the import statement matches where it's referenced, but still, I'd prefer it be consistent across the boards.

FYI we did this just so that it would be easier to find and identify where snippets are imported and referenced.


# Encrypting Requests and Decrypting Responses

Expand Down Expand Up @@ -105,7 +105,7 @@ The following table describes the field layout for response decryption code.

For example, a decrypted response to the [POST /token/generate](../endpoints/post-token-generate.md) request for an email address might look like this:

<SnptIdentityGenerateResponse />
<SnptSnptIdentityGenerateResponse />
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as previous comment


## Encryption and Decryption Code Examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ UID2 のオプトアウト手順とユーザーがオプトアウトする方法

- 最大リクエストサイズは 1MB です。
- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマッピングする場合は、1 バッチあたり最大 5,000 アイテムの *順次* バッチで送信します。
- <Link href="../ref-info/glossary-uid#gl-private-operator">プライベートオペレーター</Link>を使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化または非ハッシュ化された <Link href="../ref-info/glossary-uid#gl-dii">直接識別情報 (DII)</Link> 値のバッチを連続して送信し、複数の並行接続を作成しないでください。
- <Link href="../ref-info/glossary-uid#gl-private-operator">プライベートオペレーター</Link>を使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化またはハッシュされていない <Link href="../ref-info/glossary-uid#gl-dii">直接識別情報 (DII)</Link> 値のバッチを連続して送信し、複数の並行接続を作成しないでください。
- メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。<br/>マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする際に処理時間が大幅に増加する可能性があります。ただし、実際に更新が必要なマッピングのみを再計算すると、UID2 の約 1/365 が毎日更新されるため、総処理時間が短縮されます。詳細は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) と [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。

## Request Format
Expand Down Expand Up @@ -290,11 +290,11 @@ remap_identities(to_remap)
```

### Additional Resources
- [SDK for Java](../sdks/sdk-ref-java.md) Java 実装 (Advertisers/Data Providers section を参照)

<!-- For SDK-specific migration guidance, see:
- [SDK for Python](../sdks/sdk-ref-python.md) for Python implementations -->
Identity mapping の一般的な情報については、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。

<!-- GWH 7/7 Commenting out the above until the SDK docs are available. -->
特定の SDK の移行ガイダンスについては、以下を参照してください:
- SDK for Python Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-python.md#usage-for-advertisersdata-providers) section
- SDK for Java Reference Guide, [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) section

ID マッピングの一般的な情報は、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。
Snowflake に関する情報は、[Snowflake Integration Guide](../guides/integration-snowflake.md) を参照してください。
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ displayed_sidebar: docs
---

import Link from '@docusaurus/Link';
import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment, all instances.


# POST /token/generate

Expand Down Expand Up @@ -108,7 +108,7 @@ echo '{"email_hash": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=","optout_chec

復号化に成功すると、指定されたメールアドレス、電話番号、またはそれぞれのハッシュに対するユーザーの Advertising Token および Refresh Token が返されます。

<SnptIdentityGenerateResponse />
<SnptSnptIdentityGenerateResponse />

#### Optout

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';
import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';

# POST /token/refresh

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

すべての値が有効で、ユーザーが Opt-Out していない場合、レスポンスは成功し、新しい UID2 Token が関連する値とともに返されます。以下の例は、トークンを含む成功したレスポンスを復号したものです:

<SnptIdentityGenerateResponse />
<SnptSnptIdentityGenerateResponse />

#### Successful Response With Opt-Out

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import Link from '@docusaurus/Link';

# POST /token/validate

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

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

Expand Down Expand Up @@ -129,7 +129,7 @@ echo '{"token": "AdvertisingTokenmZ4dZgeuXXl6DhoXqbRXQbHlHhA96leN94U1uavZVspwKXl

このエンドポイントを使用して、[POST&nbsp;/token/generate](../endpoints/post-token-generate.md) で送信する <Link href="../ref-info/glossary-uid#gl-dii">DII</Link> が有効かどうかをテストできます。以下の手順に従ってください。

1. DII がハッシュ化されたメールアドレスか、ハッシュ化されていないメールアドレスか、電話番号かに応じて、[Unencrypted JSON Body Parameters](#unencrypted-json-body-parameters) の表に記載されている4つの有効なオプションのいずれかを使用して、[POST&nbsp;/token/generate](../endpoints/post-token-generate.md) リクエストを送信します。表に記載されている対応する値 - `email`、`email_hash`、`phone`、`phone_hash` - を使用します。
1. DII がハッシュ化されたメールアドレスか、ハッシュされていないメールアドレスか、電話番号かに応じて、[Unencrypted JSON Body Parameters](#unencrypted-json-body-parameters) の表に記載されている4つの有効なオプションのいずれかを使用して、[POST&nbsp;/token/generate](../endpoints/post-token-generate.md) リクエストを送信します。表に記載されている対応する値 - `email`、`email_hash`、`phone`、`phone_hash` - を使用します。

2. 返された `advertising_token` の値を次のステップで使用するために保存します。
3. Step 1 で送信した `email`、`email_hash`、`phone`、`phone_hash` の値と、Step 2 で保存した `advertising_token` を `token` プロパティの値として、`POST /token/validate` リクエストを送信します。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,18 @@ import Link from '@docusaurus/Link';

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

## UID2 Endpoints by Audience

以下の表は、UID2 エンドポイントと各エンドポイントの対象ユーザーを示しています。詳細については、該当するセクションをクリックしてください。

| Endpoint | Audience | Details |
| :--- | :--- | :--- |
| [POST&nbsp;/token/generate](post-token-generate.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) |
| [POST&nbsp;/token/validate](post-token-validate.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) |
| [POST&nbsp;/token/refresh](post-token-refresh.md) | パブリッシャー | [UID2 Tokens](#uid2-tokens) |
| [POST&nbsp;/identity/map](post-identity-map.md) | 広告主、データプロバイダー | [Identity Map](#identity-map) |
| [POST&nbsp;/optout/status](post-optout-status.md) | 広告主、データプロバイダー、DSP、共有者 | [Opt-Out Status](#opt-out-status)|

## UID2 Tokens

以下のエンドポイントは、UID2 Token (identity tokens, advertising tokens) を取得および管理するためのもので、主にパブリッシャーが使用します。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ displayed_sidebar: docs
import Link from '@docusaurus/Link';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import SnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';
import SnptSnptIdentityGenerateResponse from '../snippets/_snpt-example-identity-generate-response.mdx';

# Encrypting Requests and Decrypting Responses

Expand Down Expand Up @@ -105,7 +105,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス

たとえば、先行例 のメールアドレスに対する [POST&nbsp;/token/generate](../endpoints/post-token-generate.md) リクエストに対する復号されたレスポンスは、次のようになります:

<SnptIdentityGenerateResponse />
<SnptSnptIdentityGenerateResponse />

## Encryption and Decryption Code Examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ Notes:
- すべての UID2 エンドポイントは同じベース URL を使用します。
- インテグレーション環境と本番環境では、異なる <Link href="../ref-info/glossary-uid#gl-api-key">API Key</Link> が必要です。各環境用の認証情報の取得方法は、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。
- [POST&nbsp;/token/generate](../endpoints/post-token-generate.md) エンドポイントまたは [POST&nbsp;/token/refresh](../endpoints/post-token-refresh.md) エンドポイントで返される <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 Token</Link> の有効期限は変更される可能性がありますが、常にインテグレーション環境では本番環境よりもはるかに短くなります。
- インテグレーション環境と本番環境では異なる UID2 値が生成されます。相互に使用することはできません。インテグレーション環境はテスト専用に使用してください。本番稼働の準備ができたら、ビッドストリームで使用する UID2 を生成してください。

## Getting Credentials for Each Environment

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';
import SnptExampleTokenInBidstream from '../snippets/_snpt-example-token-in-bidstream.mdx';
import SnptSnptExampleTokenInBidstream from '../snippets/_snpt-example-token-in-bidstream.mdx';

# Frequently Asked Questions

Expand Down Expand Up @@ -82,6 +82,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ
- [UID2 Token の一意性とローテーションポリシーは何ですか?](#what-is-the-uniqueness-and-rotation-policy-for-uid2-tokens)
- [UID2 Token は、ビッドストリームではどのように見えますか?](#what-does-a-uid2-token-look-like-in-the-bidstream)
- [UID2 をシングルサインオン (SSO) とインテグレーションすることはできますか?](#can-i-integrate-uid2-with-single-sign-on-sso)
- [Prebid をモバイル SDK と一緒に使用しています&#8212;atype 値は何を使用すればよいですか?](#im-using-prebid-with-a-mobile-sdkwhat-atype-value-should-i-use)

#### How can I test that the DII sent and the returned token match up?
送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか?
Expand Down Expand Up @@ -168,14 +169,25 @@ UID2 Token は、ビッドストリームではどのように見えますか?

UID2 実装のアプローチにはさまざまな方法があります。以下は、UID2 Token が<Link href="../ref-info/glossary-uid#gl-bidstream">ビッドストリーム</Link>でどのように渡されるかを示すコードスニペットの一例です:

<SnptExampleTokenInBidstream />
<SnptSnptExampleTokenInBidstream />

#### Can I integrate UID2 with Single Sign-On (SSO)?
UID2 をシングルサインオン (SSO) とインテグレーションすることはできますか?

はい。Google、Facebook ログイン、Apple ログイン、または OpenPass などの人気のある SSO インテグレーションオプションを使用すると、メールアドレスを取得して UID2 を生成できます。
詳細は、[Publisher Integration with SSO Providers](../ref-info/ref-integration-sso-providers.md) を参照してください。

#### I'm using Prebid with a Mobile SDK&#8212;what atype value should I use?
Prebid をモバイル SDK と一緒に使用しています&#8212;atype 値は何を使用すればよいですか?

IAB のドキュメントによると、`atype` (エージェントタイプ) 値は、マッチがどのタイプのユーザーエージェントからのものであるかを示します。IAB はこのプロパティを定義することを推奨しています。

Prebid を [SDK for Android](../sdks/sdk-ref-android.md) または [SDK for iOS](../sdks/sdk-ref-ios.md) と一緒に使用している場合、`atype` 値として `3` を使用します。これは、個人ベースの ID を示します。

詳細は、以下の IAB ドキュメントのセクションを参照してください:
- [Object: Extended Identifier UIDs](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#object_eid_uids)
- [List: Agent Types](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list_agenttypes)

## FAQs for Advertisers and Data Providers

UID2 フレームワークを使用する広告主やデータプロバイダーによくある質問を紹介します。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -192,9 +192,9 @@ SDK は、特定のユーザーに対して、4 つの DII フォーマットの

以下のセクションでは、UID2 SDK を構成するさまざまな方法を示し、SDK に渡される DII の要件を示します:

- メールアドレス, ハッシュ化されていない
- メールアドレス, ハッシュされていない
- メールアドレス, 正規化とハッシュ化
- 電話番号, ハッシュ化されていない
- 電話番号, ハッシュされていない
- 電話番号, 正規化とハッシュ化

SDK が複数回設定された場合、最新の設定値が使用されます。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@ UID2 は、以下の値を提供します。これらは、UID2 Token を Client

これらの値は、アカウントセットアップ時に受け取ります。インテグレーション環境用の 1 つのセットと、本番環境用の別のセットがあります。

SDK を構成するには、アカウントセットアップ時に受け取った Subscription ID と public key、およびユーザーのハッシュ化またはハッシュ化されていない直接識別情報 (<Link href="../ref-info/glossary-uid#gl-dii">DII</Link>) (メールアドレスまたは電話番号) を次のメソッドコールに渡す必要があります:
SDK を構成するには、アカウントセットアップ時に受け取った Subscription ID と public key、およびユーザーのハッシュ化またはハッシュされていない直接識別情報 (<Link href="../ref-info/glossary-uid#gl-dii">DII</Link>) (メールアドレスまたは電話番号) を次のメソッドコールに渡す必要があります:

<Tabs groupId="language-selection">
<TabItem value='android' label='Android'>
Expand Down Expand Up @@ -343,7 +343,7 @@ UID2Manager.shared.generateIdentity(
- アプリが開いている間、必要に応じてトークンを自動的にリフレッシュします。

:::tip
ユーザーの <Link href="../ref-info/glossary-uid#gl-dii">DII</Link> を UID2 mobile SDK に渡す際、ハッシュ化またはハッシュ化されていない DII を渡すことができます。DII をハッシュ化されていない状態で渡す場合、SDK がハッシュ化します。ハッシュ化された DII を SDK に渡す場合、ハッシュ化する前に正規化する必要があります。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
ユーザーの <Link href="../ref-info/glossary-uid#gl-dii">DII</Link> を UID2 mobile SDK に渡す際、ハッシュ化またはハッシュされていない DII を渡すことができます。DII をハッシュされていない状態で渡す場合、SDK がハッシュ化します。ハッシュ化された DII を SDK に渡す場合、ハッシュ化する前に正規化する必要があります。詳細は [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) を参照してください。
:::

### Format Examples for DII
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ displayed_sidebar: docs

import Link from '@docusaurus/Link';
import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx';
import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx';

# UID2 Private Operator Integration Overview

Expand Down Expand Up @@ -93,6 +94,10 @@ Private Operator にはいくつかの制限があります:

<SnptUpgradePolicy />

## Keeping the Operator Key Secure

<SnptRotatingTheKeys />

## Getting Started

Private Operator を開始するには、次の手順に従います:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ When account setup is complete, you'll receive a client keypair consisting of tw

### Configure the UID2 Module

UID2 module を設定するには、アカウント設定時に受け取った **Public Key** と **Subscription ID**、およびユーザーのハッシュ化された、またはハッシュ化されていないメールアドレスまたは電話番号を含むオブジェクトを使用して `pbjs.setConfig` を呼び出します。
UID2 module を設定するには、アカウント設定時に受け取った **Public Key** と **Subscription ID**、およびユーザーのハッシュ化された、またはハッシュされていないメールアドレスまたは電話番号を含むオブジェクトを使用して `pbjs.setConfig` を呼び出します。

いったん設定されると、UID2 module はユーザー用の UID2 Token を生成し、それをユーザーのブラウザに保存します。このモジュールは、あなたのサイトがユーザーのブラウザで開かれている限り、必要に応じてトークンを自動的にリフレッシュします。

Expand Down
Loading
Loading