Skip to content
Merged
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 @@ -13,7 +13,7 @@ import Link from '@docusaurus/Link';

このガイドは、<Link href="../ref-info/glossary-uid#gl-bidstream">ビッドストリーム</Link>で UID2 の取引を行う DSP を対象としています。

DSP はビッドリクエストで UID2 Token を受け取り、この機能をサポートする Server-Side SDK のいずれかを使用して [UID2 tokens](../ref-info/glossary-uid.md#gl-uid2-token) を復号化し、入札に使用できる [raw UID2s](../ref-info/glossary-uid.md#gl-raw-uid2) を取得します。
DSP はビッドリクエストで UID2 Token を受け取り、この機能をサポートする Server-Side SDK のいずれかを使用して [UID2 Tokens](../ref-info/glossary-uid.md#gl-uid2-token) を復号化し、入札に使用できる [raw UID2s](../ref-info/glossary-uid.md#gl-raw-uid2) を取得します。

利用可能な Server-Side SDK の概要は、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。

Expand All @@ -25,7 +25,7 @@ DSP はビッドリクエストで UID2 Token を受け取り、この機能を

以下は、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)
2. [Decrypt UID2 Tokens for RTB use](#decrypt-uid2-tokens-for-rtb-use)

![DSP Flow](images/dsp-guide-flow-mermaid.png)

Expand All @@ -39,7 +39,7 @@ DSP はビッドリクエストで UID2 Token を受け取り、この機能を
- [POST /optout/status Endpoint](#post-optoutstatus-endpoint)
- [Bidding Opt-Out Logic](#bidding-opt-out-logic)

UID2 Opt-out ワークフローとユーザーがどのように Opt-out できるかの詳細は、[ユーザーオプトアウト](../getting-started/gs-opt-out.md) を参照してください。
UID2 のオプトアウトワークフローとユーザーがどのようにオプトアウトできるかの詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。

#### Opt-Out Webhook

Expand Down Expand Up @@ -68,22 +68,22 @@ DSP は、[POST&nbsp;/optout/status](../endpoints/post-optout-status.md) エン

入札時 (2-b)に以下のロジックを使用し、ユーザーのオプトアウトを受け入れます。

Server-Side SDK のいずれか ([SDKs: Summary](../sdks/summary-sdks.md) を参照) を利用して、受信した UID2 Token を raw UID2 に復号します。decrypt関数へのレスポンスには、raw UID2 が含まれます。
Server-Side SDK のいずれか ([SDKs: Summary](../sdks/summary-sdks.md) を参照) を利用して、受信した UID2 Token を raw UID2 に復号します。decrypt 関数へのレスポンスには、raw UID2 が含まれます。

オプトアウトのロジックを次の図に示します。

![](images/dsp-guide-optout-check-mermaid.png)

ユーザーがオプトアウトして他場合、UID2 は RTB に使用されるべきではありません。このような場合、DSP は入札のために代替 ID を送信するか、入札しないことを選択できます。
ユーザーがオプトアウトした場合、UID2 は RTB に使用されるべきではありません。このような場合、DSP は入札のために代替 ID を送信するか、入札しないことを選択できます。

### Decrypt UID2 Tokens for RTB Use

次の表は、[Integration Steps](#integration-steps) で示したワークフロー図の Step 2 の詳細です。

| Step | SDK | Description |
| :--- | :--- | :--- |
| 2-a | Server-side SDK ([SDKs: Summary](../sdks/summary-sdks.md) を参照) | 提供されている SDK を活用して、入力された UID2 Token を復号化します。レスポンスには `UID2` と UID2 の作成時刻が含まれます。 |
| 2-b | | DSP は UID2 のオプトアウトプロトコルを受け入れることが要求されます。ユーザーオプトアウトの設定と入札時の受け入れは、[ユーザーオプトアウトの受け入れ](#honor-user-opt-outs) を参照してください。 |
| 2-a | Server-Side SDK ([SDKs: Summary](../sdks/summary-sdks.md) を参照) | 提供されている SDK を活用して、入力された UID2 Token を復号化します。レスポンスには `UID2` と UID2 の作成時刻が含まれます。 |
| 2-b | | DSP は UID2 のオプトアウトプロトコルを受け入れることが要求されます。ユーザーオプトアウトの設定と入札時の受け入れは、[Honor User Opt-Outs](#honor-user-opt-outs) を参照してください。 |

## Recommendations for Managing Latency

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@ UID2 とインテグレーションするには、UID2 アカウントが必要

UID2 Portal の [API Keys](../portal/api-keys.md) ページで、次の値を設定する必要があります:

- <Link href="../ref-info/glossary-uid#gl-api-key">API key</Link> (クライアントキーとも呼ばれます)
- <Link href="../ref-info/glossary-uid#gl-client-secret">Client secret</Link> (参加者と UID2 サービスのみに知られている値)
- <Link href="../ref-info/glossary-uid#gl-api-key">API Key</Link> (Client Key とも呼ばれます)
- <Link href="../ref-info/glossary-uid#gl-client-secret">クライアントシークレット</Link> (参加者と UID2 Service のみが知る値です)

:::important
これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。
Expand Down Expand Up @@ -149,7 +149,7 @@ v2 Identity Map API の使用時との主な違いは以下の通りです:

### Integration Diagram (v2)

次の表は、v2 インテグレーションフローを示しています。違いは Step 2(ソルトバケット ID の保存)と Step 5(ソルトバケットのローテーションの監視)です。
次の図は、v2 インテグレーションフローを示しています。違いは Step 2(ソルトバケット ID の保存)と Step 5(ソルトバケットのローテーションの監視)です。

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emai

# Advertiser/Data Provider Integration Overview

このガイドは、ユーザーデータを収集し、他の UID2 参加者に送信する組織向けのインテグレーションオプションの概要を提供します。データ収集者には、広告主、データオンボーダー、測定プロバイダー、ID グラフプロバイダー、サードパーティデータプロバイダー、およびその他のデータを他の参加者に送信する組織が含まれます。
このガイドは、ユーザーデータを収集し、他の UID2 参加者に送信する組織向けのインテグレーションオプションの概要を提供します。データ収集者には、広告主、データオンボーダー、計測プロバイダー、ID グラフプロバイダー、サードパーティデータプロバイダー、およびその他のデータを他の参加者に送信する組織が含まれます。

## Advertiser/Data Provider Routes to Use UID2

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ AWS アカウントにサインアップするか、既存のアカウントを

### Create UID2 Account

UID2 の連絡先に、あなたを UID2 参加者として登録するよう依頼します。依頼先がかわからない場合は、[連絡先情報](../getting-started/gs-account-setup.md#contact-info) を参照してください。
UID2 の連絡先に、あなたを UID2 参加者として登録するよう依頼します。依頼先がわからない場合は、[Contact Info](../getting-started/gs-account-setup.md#contact-info) を参照してください。

UID2 の連絡先に、Entity Resolution での UID2 インテグレーションに使用する AWS アカウント ID を送信してください。

Expand Down Expand Up @@ -156,10 +156,10 @@ UID2 は、UID2 生成のためにメールアドレスまたは電話番号の
|0002|Test 2|test2@gmail.com|1/2/78|

:::note
1レコードにつき、メールアドレスまたは電話番号フィールドは **1** つだけです。メールアドレスが存在する場合、電話番号はパススルーとして扱われます。電話番号を処理するには、別のワークフローを作成してください。詳細はこのセクションの前を参照してください。
1 レコードにつき、メールアドレスまたは電話番号フィールドは **1** つだけです。メールアドレスが存在する場合、電話番号はパススルーとして扱われます。電話番号を処理するには、別のワークフローを作成してください。詳細はこのセクションの前を参照してください。
:::

- **Service access**: Entity Resolution に、指定されたデータにアクセスし、AWS Glue でデータを呼び出し、AWS Data Exchange を呼び出す権限を付与します。新しいサービスロールを作成して、必要なすべての権限を持つ新しいロールを作成することを強く勧めす。既存のサービスロールを使用する場合は、AWS Data Exchange を呼び出す権限を追加してください:
- **Service access**: Entity Resolution に、指定されたデータにアクセスし、AWS Glue でデータを呼び出し、AWS Data Exchange を呼び出す権限を付与します。新しいサービスロールを作成して、必要なすべての権限を持つ新しいロールを作成することを強くお勧めします。既存のサービスロールを使用する場合は、AWS Data Exchange を呼び出す権限を追加してください:

```json
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,8 +49,8 @@ UID2 とインテグレーションするには、UID2 のアカウントが必
設定する具体的な値は、[CTV integration options](#ctv-integration-options) で選択したオプションによって異なります:

- Client-Server または Server-Side の実装の場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで次の値を設定する必要があります:
- <Link href="../ref-info/glossary-uid#gl-api-key">API key</Link>、Client Key とも呼ばれます。
- <Link href="../ref-info/glossary-uid#gl-client-secret">Client secret</Link>、参加者と UID2 Servivce のみが知る値です。
- <Link href="../ref-info/glossary-uid#gl-api-key">API Key</Link>、Client Key とも呼ばれます。
- <Link href="../ref-info/glossary-uid#gl-client-secret">クライアントシークレット</Link>、参加者と UID2 Service のみが知る値です。

:::important
これらの値を安全に保管することは非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Databricks Integration
sidebar_label: Databricks
pagination_label: Databricks Integration
description: Databricks を使用した UID2 とのインテグレーション(連携)に関する情報
description: Databricks を使用した UID2 とのインテグレーションに関する情報
hide_table_of_contents: false
sidebar_position: 04
displayed_sidebar: docs
Expand All @@ -17,7 +17,7 @@ import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emai

## Integration Overview

このソリューションでは、[Databricks Clean Rooms](https://docs.databricks.com/aws/en/clean-rooms/) 機能のインスタンスでデータを処理することにより、<Link href="../ref-info/glossary-uid#gl-dii">DII (直接識別情報)</Link> を公開することなく、コンシューマー識別データを安全に共有できます。この機能は、機密データを扱うための、安全でプライバシーが保護された環境を提供します。
このソリューションでは、[Databricks Clean Rooms](https://docs.databricks.com/aws/en/clean-rooms/) 機能のインスタンスでデータを処理することにより、<Link href="../ref-info/glossary-uid#gl-dii">DII (Directly Identifying Information)</Link> を公開することなく、コンシューマー識別データを安全に共有できます。この機能は、機密データを扱うための、安全でプライバシーが保護された環境を提供します。

Databricks Clean Rooms 環境をセットアップしたら、UID2 サービスとの信頼関係を確立し、クリーンルームで共有したデータを raw UID2 に変換することを許可します。

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

## Overview

DSP が、ターゲティング広告や入札の目的で復号化されたトークンを使用使用できるようにするには、UID2 Token を raw UID2 に復号化し、トークンの有効性を検証できる必要があります。これを行うために、DSP は以下を行う必要があります:
DSP が、ターゲティング広告や入札の目的で復号化されたトークンを使用できるようにするには、UID2 Token を raw UID2 に復号化し、トークンの有効性を検証できる必要があります。これを行うために、DSP は以下を行う必要があります:

- [Retrieve a set of encryption keys](#retrieverefresh-encryption-keys)
- [Decrypt UID2 tokens into raw UID2s](#decrypt-uid2-tokens-into-raw-uid2s)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,8 @@ UID2 とインテグレーションするには、UID2 アカウントが必要
設定する値は、選択した [Publisher Integration Options](#publisher-integration-options) によって異なります:

- Client-Server または Server-Side の実装の場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで次の値を設定する必要があります:
- <Link href="../ref-info/glossary-uid#gl-api-key">API key</Link>、Client key とも呼ばれます。
- <Link href="../ref-info/glossary-uid#gl-client-secret">Client secret</Link>、参加者と UID2 Service のみが知っている値。
- <Link href="../ref-info/glossary-uid#gl-api-key">API Key</Link>、Client Key とも呼ばれます。
- <Link href="../ref-info/glossary-uid#gl-client-secret">クライアントシークレット</Link>、参加者と UID2 Service のみが知っている値。

:::important
これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。
Expand Down
Loading
Loading