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 @@ -27,4 +27,4 @@ UID2 エコシステムには、特定のアクティビティを完了するた
| Generator | パブリッシャー | [POST&nbsp;/token/generate](../endpoints/post-token-generate.md), [POST&nbsp;/token/validate](../endpoints/post-token-validate.md)、[POST&nbsp;/token/refresh](../endpoints/post-token-refresh.md) の各エンドポイントを呼び出して、<Link href="../ref-info/glossary-uid#gl-dii">DII</Link> から UID2 Token を生成/リフレッシュする権限:<ul><li>Prebid インテグレーション</li><li>The SDK for JavaScript</li><li>UID2 Token の取得と管理のために、該当する API エンドポイントを直接呼び出すインテグレーション</li></ul> |
| Bidder | DSP | パブリッシャーからの<Link href="../ref-info/glossary-uid#gl-bidstream">ビッドストリーム</Link>で送られてくる UID2 Token を、入札目的で raw UID2 に復号化する権限。 |
| Sharer | UID2 sharing に参加するすべての参加者タイプ。<br/>詳細は [UID2 sharing: Overview](../sharing/sharing-overview.md) を参照してください。 | 以下両方の権限:<ul><li>UID2 SDK または Snowflake を使用して、raw UID2 を UID2 Token に暗号化し、許可された別の共有参加者と共有します。</li><li>他の許可された共有参加者から受け取った UID2 Token を raw UID2 に復号します。</li></ul> |
| Mapper | 広告主<br/>データプロバイダー | 複数のメールアドレス、電話番号、またはそのハッシュを、raw UID2、以前の raw UID2、およびリフレッシュタイムスタンプにマッピングするために、以下のエンドポイントを呼び出す権限:<ul><li>[POST&nbsp;/identity/map](../endpoints/post-identity-map.md) (最新バージョン)</li><li>以前の v2 identity mapping エンドポイント: [POST&nbsp;/identity/map (v2)](../endpoints/post-identity-map-v2.md) および [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md)</li></ul> |
| Mapper | 広告主<br/>データプロバイダー | 複数のメールアドレス、電話番号、またはそのハッシュを、raw UID2、以前の raw UID2、およびリフレッシュタイムスタンプにマッピングするために、以下のエンドポイントを呼び出す権限:<ul><li>[POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) (最新バージョン)</li><li>以前の v2 identity mapping エンドポイント: [POST&nbsp;/v2/identity/map](../endpoints/post-identity-map-v2.md) および [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md)</li></ul> |
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ UID2 とインテグレーションする広告主とデータプロバイダー
6. [Monitor for opt-out status](#6-monitor-for-opt-out-status)

:::note
[POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) エンドポイントのバージョン 3 より前のバージョンを使用している場合は、[Using POST /v2/identity/map](#using-post-v2identitymap) を参照してください。このバージョンを使用している場合は、強化された機能を利用するためにできるだけ早くアップグレードすることを推奨します。
[POST&nbsp;/identity/map](../endpoints/post-identity-map.md) エンドポイントのバージョン 3 より前のバージョンを使用している場合は、[Using POST /v2/identity/map](#using-post-v2identitymap) を参照してください。このバージョンを使用している場合は、強化された機能を利用するためにできるだけ早くアップグレードすることを推奨します。
:::

## Summary of implementation options
Expand All @@ -58,11 +58,11 @@ UID2 とインテグレーションする広告主とデータプロバイダー

| High-Level Step | Implementation Options |
| --- | --- |
| [1: Generate raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | DII を raw UID2 にマップするには、次のいずれかのオプションを利用します:<ul><li>UID2 SDK のいずれか:<ul><li>Python SDK: [Map DII to raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s)</li><li>Java SDK: [Usage for advertisers/data providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers)</li></ul></li><li>Snowflake: [Map DII](integration-snowflake.md#map-dii)</li><li>Databricks: [Map DII](integration-databricks.md#map-dii)</li><li>AWS Entity Resolution: [AWS Entity Resolution integration guide](integration-aws-entity-resolution.md)</li><li>HTTP endpoints: [POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md)</li></ul> |
| [1: Generate raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | DII を raw UID2 にマップするには、次のいずれかのオプションを利用します:<ul><li>UID2 SDK のいずれか:<ul><li>Python SDK: [Map DII to raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s)</li><li>Java SDK: [Usage for advertisers/data providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers)</li></ul></li><li>Snowflake: [Map DII](integration-snowflake.md#map-dii)</li><li>Databricks: [Map DII](integration-databricks.md#map-dii)</li><li>AWS Entity Resolution: [AWS Entity Resolution integration guide](integration-aws-entity-resolution.md)</li><li>HTTP endpoints: [POST&nbsp;/identity/map](../endpoints/post-identity-map.md)</li></ul> |
| [2: Store raw UID2s and refresh timestamps](#2-store-raw-uid2s-and-refresh-timestamps) | カスタム(必要に応じて) |
| [3: Manipulate or combine raw UID2s](#3-manipulate-or-combine-raw-uid2s) | カスタム(必要に応じて) |
| [4: Send stored raw UID2s to DSPs to create audiences or conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) | カスタム(必要に応じて) |
| [5: Monitor for raw UID2 refresh](#5-monitor-for-raw-uid2-refresh) | [POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) エンドポイントから返されるリフレッシュタイムスタンプ(`r` フィールド)を使用して、raw UID2 を更新するタイミングを判断します。 |
| [5: Monitor for raw UID2 refresh](#5-monitor-for-raw-uid2-refresh) | [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) エンドポイントから返されるリフレッシュタイムスタンプ(`r` フィールド)を使用して、raw UID2 を更新するタイミングを判断します。 |
| [6: Monitor for opt-out status](#6-monitor-for-opt-out-status) | [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントへの API コール。 |

## Integration diagram
Expand Down Expand Up @@ -96,7 +96,7 @@ raw UID2 を生成するには、次のいずれかのオプションを使用

- AWS Entity Resolution: [AWS Entity Resolution integration guide](integration-aws-entity-resolution.md) を参照してください。

- HTTP endpoints: [POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) を参照してください。詳細は、[Advertiser/data provider integration to HTTP endpoints](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii) を参照してください。
- HTTP endpoints: [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) を参照してください。詳細は、[Advertiser/data provider integration to HTTP endpoints](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii) を参照してください。

### 2: Store raw UID2s and refresh timestamps

Expand Down Expand Up @@ -134,9 +134,9 @@ raw UID2 は、更新タイムスタンプ以降の時間には変更されま

リフレッシュのタイミングを毎日確認することを推奨します。raw UID2 をリフレッシュするかどうかを判断するには、次の手順に従います:

1. 現在の時刻と[POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) レスポンスから保存したリフレッシュタイムスタンプ (`r` フィールド) を比較します。
1. 現在の時刻と[POST&nbsp;/identity/map](../endpoints/post-identity-map.md) レスポンスから保存したリフレッシュタイムスタンプ (`r` フィールド) を比較します。

2. 現在の時刻がリフレッシュタイムスタンプ以降である場合、同じ DII で [POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) を再度呼び出して raw UID2 を再生成します。
2. 現在の時刻がリフレッシュタイムスタンプ以降である場合、同じ DII で [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) を再度呼び出して raw UID2 を再生成します。

このアプローチにより、raw UID2 が最新かつ有効であり、オーディエンスのターゲティングや測定に使用できることが保証されます。

Expand All @@ -146,7 +146,7 @@ raw UID2 は、更新タイムスタンプ以降の時間には変更されま

UID2 <Link href="../ref-info/glossary-uid#gl-operator-service">Operator Service</Link> で最新のオプトアウト情報を確認するには、次の 2 つの方法があります:

- [POST&nbsp;/v3/identity/map](../endpoints/post-identity-map.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。
- [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。

- [POST&nbsp;/optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して raw UID2 のオプトアウトステータスを確認します。

Expand Down