diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md index 1340f80d2..7276f6f58 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-buckets.md @@ -17,7 +17,7 @@ Used by: このエンドポイントは、主に広告主とデータプロバ `POST '{environment}/v2/identity/buckets'` -認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 +認証の詳細は、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 @@ -30,7 +30,7 @@ Used by: このエンドポイントは、主に広告主とデータプロバ | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md index 2e3baac75..3fec46ef5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-identity-map.md @@ -13,7 +13,7 @@ import Link from '@docusaurus/Link'; Used by: このエンドポイントは、主に広告主やデータプロバイダーが使用します。詳細は [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 -UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 ## Batch Size and Request Parallelization Requirements @@ -28,7 +28,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳 `POST '{environment}/v2/identity/map'` -認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 +認証の詳細は、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 @@ -41,7 +41,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳 | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters @@ -59,7 +59,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳 ### Request Examples -以下は、各パラメータの暗号化されていない JSON リクエストボディの例で、このうちの 1 つを ID マッピングリクエストに含める必要があります: +以下は、各パラメータの暗号化されていない JSON リクエストボディの例です。このうちの 1 つを、`POST /identity/map` エンドポイントへのリクエストに含める必要があります: ```json { @@ -94,7 +94,7 @@ UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳 } ``` -以下は、メールアドレスハッシュに対する暗号化された ID マッピングリクエストの例です: +以下は、電話番号に対する `POST /identity/map` エンドポイントへの暗号化リクエストの例です: ```sh echo '{"phone": ["+12345678901", "+441234567890"]}' | python3 uid2_request.py https://prod.uidapi.com/v2/identity/map [Your-Client-API-Key] [Your-Client-Secret] diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md index d96b4bf1e..ca3e03c91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-optout-status.md @@ -13,7 +13,7 @@ import Link from '@docusaurus/Link'; Used by: このエンドポイントは、主に広告主、データプロバイダー、DSP、共有者によって使用されます。一般的には、元のメールアドレスや電話番号にアクセスできないが、オプトアウトステータスを知りたい参加者向けです。 -詳細については、役割に応じて以下のドキュメントを参照してください: +詳細は、役割に応じて以下のドキュメントを参照してください: - [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) - [DSP Integration Guide](../guides/dsp-guide.md) @@ -30,7 +30,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ `POST '{environment}/v2/optout/status'` -認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 +認証の詳細は、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[Encrypting Requests and Decrypting Responses](../getting-started/gs-encryption-decryption.md) を参照してください。 @@ -43,7 +43,7 @@ Used by: このエンドポイントは、主に広告主、データプロバ | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md index 118ad627f..593bea9b4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-generate.md @@ -26,7 +26,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 `POST '{environment}/v2/token/generate'` -認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 +認証の詳細は、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 このエンドポイントリクエストについて知っておくべきことは、以下のとおりです: - サービスにアクセスする際に使用する API key を秘密にするため、 UID2 Token は認証後に Server-Side でのみ生成する必要があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md index d886cfa64..5c0a1fb10 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-refresh.md @@ -14,7 +14,7 @@ import IdentityGenerateResponse from '../snippets/_example-identity-generate-res Used by: このエンドポイントは、主にパブリッシャーが使用します。 -このエンドポイントは、Client-Side (例えば、ブラウザやモバイルアプリ) から呼び出すことができます。それは、API key を使用する必要がないためです。 +このエンドポイントは、Client-Side (たとえば、ブラウザやモバイルアプリ) から呼び出すことができます。それは、API key を使用する必要がないためです。 :::note このエンドポイントを直接呼び出す代わりに、UID2 SDK のいずれかを使用して管理することができます。オプションの概要については、[SDKs: Summary](../sdks/summary-sdks.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md index 00a138c69..2ee10f59c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/post-token-validate.md @@ -21,7 +21,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 `POST '{environment}/v2/token/validate'` -認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 +認証の詳細は、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。 :::important すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、[リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。 @@ -34,7 +34,7 @@ Used by: このエンドポイントは、主にパブリッシャーが使用 | `{environment}` | string | 必須 | テスト (インテグレーション) 環境: `https://operator-integ.uidapi.com`
本番環境: `https://prod.uidapi.com`
リージョンごとのオペレーターを含む全リストは [Environments](../getting-started/gs-environments.md) を参照してください。 | :::note -インテグレーション環境と本番環境では、異なる API Key が必要です。 +インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Unencrypted JSON Body Parameters diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md index dc1074625..19fe3a91e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/endpoints/summary-endpoints.md @@ -35,7 +35,7 @@ import Link from '@docusaurus/Link'; 以下のエンドポイントは、広告主、サードパーティのデータプロバイダー、DSP、共有者が使用できます。パブリッシャーは、このエンドポイントを使用する必要はありません。 -UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 | Endpoint | Description | Request Encryption | Response Decryption | | :--- | :--- | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-account-setup.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-account-setup.md index 669caefbe..d3aad37a8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-account-setup.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-account-setup.md @@ -30,11 +30,14 @@ The Trade Desk のアクセス依頼は一時的なものです。システム UID2 に関心を示すと、詳細を調整するために担当者が連絡から連絡があります。 -アカウント設定の一環として、以下の情報を提供してください。: -* 氏名 -* メールアドレス -* 会社名 -* 契約書に署名できる正式な個人の名前と連絡先 +アカウント設定の一環として、以下の情報を提供してください: + +* 会社名: UID2 契約で使用される法的会社名。 + +* 主な連絡先。この個人はアカウントの主な管理者になります。以下の値を含めます: + * 氏名 + * メールアドレス + * 役職 ### Client-Side Web Integrations diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md index 8546c600b..1025c5d1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-auth.md @@ -11,7 +11,7 @@ import Link from '@docusaurus/Link'; UID2 エンドポイントの認証には、以下が必要です: -- クライアントの [API Key](gs-credentials.md#api-key-and-client-secret)。API Key はベアラートークンとしてリクエストのAuthorizationヘッダに含めます。例えば:
+- クライアントの [API Key](gs-credentials.md#api-key-and-client-secret)。API Key はベアラートークンとしてリクエストのAuthorizationヘッダに含めます。たとえば:
`Authorization: Bearer YourTokenBV3tua4BXNw+HVUFpxLlGy8nWN6mtgMlIk=` - API リクエストを暗号化し、API レスポンスを復号化するためのクライアントシークレット。これは、[POST /token/refresh](../endpoints/post-token-refresh.md) を除くすべてのエンドポイントで必要です。
詳細と、いくつかのプログラミング言語での暗号化/復号化の例については、[Encrypting Requests and Decrypting Responses](gs-encryption-decryption.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md index d8a6d38b1..66e46790b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-credentials.md @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link'; # UID2 Credentials -UID2 参加者はそれぞれ、固有の認証情報のセットを取得します。取得する認証情報のセットは、次の表に示すように、UID2 にどのように参加しているかによって決まります。 +UID2 の 参加者は、UID2 にどのように参加しているかによって、少なくとも 1 つの固有の認証情報のセットが必要です。必要な認証情報のセットは、次の表に示すように、UID2 にどのように参加しているかによって異なります。 | Audience | Credentials | Integration | | :--- | :--- | :--- | @@ -17,7 +17,64 @@ UID2 参加者はそれぞれ、固有の認 | Client-Server 実装を使用する参加者 | 次の両方: | 次のいずれかを使用したインテグレーション: | | Server-Side 実装を使用する参加者 | 次の両方: | 次のいずれかを使用したインテグレーション: | -本番環境だけでなくインテグレーション環境も使用している場合は、それぞれの環境用に別々の認証情報を取得します。 +## Separate Credentials Per Environment/Role + +インテグレーション環境 と本番環境の両方を使用している場合、それぞれの環境用に別々の認証情報が提供されます。詳細は [Getting Your Credentials](#getting-your-credentials) を参照してください。 + +さらに、いくつかのケースでは、異なるシナリオに対して異なるセットの認証情報を持つことを勧めますが、必須ではありません。たとえば: +- UID2 Token を生成する Publisher である場合([POST /token/generate](../endpoints/post-token-generate.md) または他の方法で)、または自分のために UID2 を生成/マッピングする場合([POST /identity/map](../endpoints/post-identity-map.md) を参照)、それぞれの活動に対して異なる認証情報を持つことがあります。 +- 広告主の場合、広告主キーを使用して複数のサービスプロバイダが運用するシナリオで、各サービスプロバイダに対して異なる認証情報割り当てることができます。 + +## Getting Your Credentials + +以下の表は、各 [integration approach](../ref-info/ref-integration-approaches.md) と各 [environment](../getting-started/gs-environments.md) に対して、認証情報を取得する方法を示しています。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
EnvironmentIntegration TypeGetting Credentials


Prod		Client-SideUID2 Portal > [Client-Side Integration](../portal/client-side-integration.md)
Client-ServerUID2 Portal > [API Keys](../portal/api-keys.md)
Server-SideUID2 Portal > [API Keys](../portal/api-keys.md)


Integ		Client-Side

Ask your UID2 contact.
Client-Server
Server-Side
+ + ## Subscription ID and Public Key @@ -33,7 +90,7 @@ Notes: - API Key とクライアントシークレットとは異なり、Subscription ID と Public key は安全に保管する必要はありません。 -- これらの値は特定の [Environment](gs-environments.md) に対して有効です。インテグレーション環境と本番環境の両方を使用している場合、それぞれの環境用の認証情報のセットを取得します。 +- 値は特定の [Environment](gs-environments.md) で有効です。インテグレーション環境と本番環境の両方を使っている場合、それぞれの環境用にセットの認証情報を取得します。 - Subscription ID と Public Key の認証情報は、Client-Side トークンの生成にのみ使用できます。追加のロールが必要な場合は ([API Permissions](gs-permissions.md) を参照してください)、そのロールの API Key と Client Secret をリクエストしてください。 @@ -47,7 +104,7 @@ Client-Side または Server-Side の実装を使用している場合([UID2 Cli - 各キーには、それを使用できるエンドポイントを決定する [Permissions](gs-permissions.md) のセットがあります。 - 各キーには対応するクライアントシークレットがあります。 - ほとんどの API エンドポイントは、認証のために API Key とクライアントシークレットの両方を必要とします。詳細は [Authentication and Authorizatio](gs-auth.md) を参照してください。 -- 本番環境だけでなくインテグレーション環境も利用する場合は、それぞれの環境で別々の API Key が必要になります。 +- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 - クライアントシークレットは特定の [Environment](gs-environments.md) で有効です。インテグレーション環境と本番環境の両方を使っている場合、それぞれの環境用のクライアントシークレットを取得します。 UID2 アカウントのセットアップの一環として、1つ以上の API Key が発行され、それぞれに対応するクライアントシークレットが割り当てられます。相談相手の詳細は [Contact Info](gs-account-setup.md#contact-info) を参照してください。 @@ -60,8 +117,17 @@ UID2 アカウントのセットアップの一環として、1つ以上の API - これらの値が保存され使用されているすべての場所を追跡しておき、キーをローテーションする必要がある場合にすぐに実行できるようにしておいてください。 - 既存のキーとシークレットが漏洩した場合、新しいキーとシークレットに置き換えるプロセスを確立してください。 -API Key とクライアントシークレットは、認証情報が漏洩するリスクを減らすために、定期的に(例えば1年ごとに)更新するのがベストです。 +API Key とクライアントシークレットは、認証情報が漏洩するリスクを減らすために、定期的に(たとえば1年ごとに)更新するのがベストです。 ## Refreshing Credentials -新しいクレデンシャルをリクエストするには、いつでも UID2 の連絡先に連絡してください。 +To request new credentials at any time, do one of the following: +新しい認証情報をリクエストするには、次のいずれかを行います: + +- UID2 Portal にアクセスできる場合、新しい本番環境の認証情報が必要な場合: [Getting Your Credentials](#getting-your-credentials) に記載されているページに移動します。 +- UID2 Portal へのアクセス権がない場合、またはインテグレーション環境用の新しい認証情報が必要な場合は、UID2 の担当者に問い合わせてください。 + + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md index df29ff3a9..56f64b604 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-encryption-decryption.md @@ -102,7 +102,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス ### Response Example -例えば、先行例 のメールアドレスに対する [POST /token/generate](../endpoints/post-token-generate.md) リクエストに対する復号されたレスポンスは、次のようになります: +たとえば、先行例 のメールアドレスに対する [POST /token/generate](../endpoints/post-token-generate.md) リクエストに対する復号されたレスポンスは、次のようになります: @@ -113,7 +113,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントでは、[POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) へのコールで事前に取得した `refresh_token` と `refresh_response_key` の値を使用します。 :::note -Windows の場合、PowerShell の代わりに Windows コマンドプロンプトを使用している場合は、JSON を囲むシングルクォートも削除する必要があります。例えば、`echo {"email": "test@example.com", "optout_check": 1}` とします。 +Windows の場合、PowerShell の代わりに Windows コマンドプロンプトを使用している場合は、JSON を囲むシングルクォートも削除する必要があります。たとえば、`echo {"email": "test@example.com", "optout_check": 1}` とします。 ::: ### Prerequisites and Notes diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md index 14738b6ff..c6bf83090 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-environments.md @@ -11,13 +11,13 @@ import Link from '@docusaurus/Link'; 利用可能な異なる環境と、インテグレーションのための最適なベース URL を選択するためのヒントについて説明します。 -## UID2 Testing and Production Environments +## UID2 Integration and Production Environments -次の表は、UID2 の現在のインテグレーション環境と本番環境の一覧です。 +次の表は、UID2 のすべての現在のインテグレーション(テスト)環境と本番環境を示しています。 | Environment | Cloud Region | Code | Base URL | | :--- | :--- | :--- | :--- | -| インテグレーション環境 | AWS US East (Ohio) | `us-east-2` | `https://operator-integ.uidapi.com` | +| インテグレーション環境 (テスト様) | AWS US East (Ohio) | `us-east-2` | `https://operator-integ.uidapi.com` | | 本番環境 | AWS Global Accelerator によるリージョンルーティングの自動最適化 | `n/a` | `https://global.prod.uidapi.com` | | 本番環境 | AWS US East (Ohio) | `us-east-2` | `https://prod.uidapi.com` | | 本番環境 | AWS US West (Oregon) | `us-west-2` | `https://usw.prod.uidapi.com` | @@ -25,19 +25,25 @@ import Link from '@docusaurus/Link'; | 本番環境 | AWS Asia Pacific (Tokyo) | `ap-northeast-1` | `https://jp.prod.uidapi.com` | | 本番環境 | AWS Asia Pacific (Singapore) | `ap-southeast-1` | `https://sg.prod.uidapi.com` | -例えば、`https://operator-integ.uidapi.com/v2/token/generate` +たとえば、`https://operator-integ.uidapi.com/v2/token/generate` Notes: - すべての UID2 エンドポイントは同じベース URL を使用します。 -- インテグレーション環境と本番環境では異なる API Key が必要です。 +- インテグレーション環境と本番環境では、異なる API Key が必要です。各環境用の認証情報の取得方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 - [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントまたは [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントで返される UID2 Token の有効期限は変更される可能性がありますが、常にインテグレーション環境では本番環境よりもはるかに短くなります。 +## Getting Credentials for Each Environment + +インテグレーション環境と本番環境の両方を使用している場合は、それぞれの環境用に別々の認証情報が必要です。 + +各環境にアクセスするために必要な値を取得する方法については、[Getting Your Credentials](gs-credentials.md#getting-your-credentials) を参照してください。 + ## Specifying the Base URL to Reduce Latency クライアントと UID2 サーバーの近接性に依存して API コールのレイテンシが決まります。特に消費者デバイスから API コールを行う場合、ユーザーに近いサーバーを選択することでレイテンシを低減できます。 -例えば、シンガポールのパブリッシャーは、ベース URL を `https://sg.prod.uidapi.com` に設定できます。これは UID2 の本番環境ですが、サーバーはシンガポールにあります。 +たとえば、シンガポールのパブリッシャーは、ベース URL を `https://sg.prod.uidapi.com` に設定できます。これは UID2 の本番環境ですが、サーバーはシンガポールにあります。 ベース URL を明示的に設定することで、すべてのリクエストを特定の国または地域内で処理するように指示できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md index 79f6383d0..81fe31a5a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md @@ -72,6 +72,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ - [Refresh Token のワークフローをテストするにはどうすればよいですか？](#how-can-i-test-the-refresh-token-workflow) - [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) #### How can I test that the DII sent and the returned token match up? 送信した DII と返されたトークンが一致していることをテストするにはどうすればよいですか？ @@ -95,7 +96,7 @@ UID2 フレームワークを使用するパブリッシャーからのよくあ #### Where should I make token generation calls—from the server side or the client side? トークン生成の呼び出しは、Server-Side と Client-Side のどちらで行うべきですか？ -UID2 Token は、Client-Side、Server-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 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md). - その他の Server-Side オプション: [Publisher Integrations](../guides/summary-guides.md#publisher-integrations). @@ -103,7 +104,7 @@ UID2 Token は、Client-Side、Server-Sideのどちらでも生成できます #### Can I make token refresh calls from the client side? Client-Side からトークンのリフレッシュを呼び出すことはできますか？ -はい。[POST /token/refresh](../endpoints/post-token-refresh.md) は、API Key を使用する必要がないため、Client-Side (例えば、ブラウザやモバイルアプリ) から呼び出すことができます。 +はい。[POST /token/refresh](../endpoints/post-token-refresh.md) は、API Key を使用する必要がないため、Client-Side (たとえば、ブラウザやモバイルアプリ) から呼び出すことができます。 #### If I choose to manually refresh the token, how will I know when to refresh the token? トークンを手動でリフレッシュする場合、リフレッシュのタイミングをどう判断すればよいですか？ @@ -160,6 +161,12 @@ UID2 実装のアプローチにはさまざまな方法があります。以下 +#### 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) を参照してください。 + ## FAQs for Advertisers and Data Providers UID2 フレームワークを使用する広告主やデータプロバイダーによくある質問を紹介します。 @@ -185,7 +192,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 #### Do refreshed emails get assigned to the same bucket with which they were previously associated? 更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか？ -必ずしもそうとは限りません。特定のバケット ID に関連付けられたメールアドレスを再マッピングした後、そのメールが異なるバケット ID に割り当てられる可能性があります。バケット ID を確認するには、[マッピング関数を呼び出す](../guides/integration-advertiser-dataprovider-overview.md#1-generate-raw-uid2s-from-dii) そして返された UID2 とバケット ID を再び保存してください。 +必ずしもそうとは限りません。特定のバケット ID に関連付けられたメールアドレスを再マッピングした後、そのメールが異なるバケット ID に割り当てられる可能性があります。バケット ID を確認するには、[マッピング関数を呼び出す](../guides/integration-advertiser-dataprovider-overview.md#1-generate-raw-uid2s-from-dii) そして返された raw UID2 とバケット ID を再び保存してください。 :::info メールアドレスのマッピングや再マッピングを行う際には、バケットの数やローテーションする日、メールアドレスが割り当てられる特定のバケットについて、いかなる仮定も行わないようにしてください。 @@ -196,7 +203,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 オーディエンスの更新は、毎日行うことが推奨されています。 -ソルトバケットは 1 年に 1 回程度更新されますが、個々のバケットの更新は 1 年に分散して行われます。これは、全バケットの約 1/365 が毎日ローテーションされることを意味します。もし忠実さが重要であれば、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントをもっと頻繁に、例えば 1 時間ごとに呼び出すことを検討してください。 +ソルトバケットは 1 年に 1 回程度更新されますが、個々のバケットの更新は 1 年に分散して行われます。これは、全バケットの約 1/365 が毎日ローテーションされることを意味します。もし忠実さが重要であれば、[POST /identity/buckets](../endpoints/post-identity-buckets.md) エンドポイントをもっと頻繁に、たとえば 1 時間ごとに呼び出すことを検討してください。 #### How should I generate the SHA-256 of DII for mapping? マッピング用の DII の SHA-256 はどのように生成すればよいですか？ @@ -228,7 +235,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生 ただし、raw UID2 の生成に使用される [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細は [How often should UID2s be refreshed for incremental updates?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)) を参照してください)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。 -詳細については、*Advertiser/Data Provider Integration Guide*の [Monitor for salt bucket rotations related to your stored raw UID2s](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。 +詳細は、*Advertiser/Data Provider Integration Guide*の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。 #### If two operators process the same DII, are the results the same? 2 つの Operator が同じ DII を処理した場合、結果は同じになりますか？ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md index c812a00e5..9fb452a7b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-normalization-encoding.md @@ -17,7 +17,7 @@ import Link from '@docusaurus/Link'; :::important - Raw UID2 とそれに関連する UID2 Token は、大文字と小文字を区別します。UID2 を扱う際には、大文字小文字を変えずにすべての ID とトークンを渡すことが重要です。ID が不一致の場合、ID の解析やトークンの復号化でエラーが発生する可能性があります。 -- 必要なステップのどれかを欠いた場合—たとえば、最初に正規化せずにハッシュした場合—その結果は有効な UID2 値にはなりません。
例えば、データプロバイダが `Jane.Saoirse@gmail.com` から UID2 を生成したいとします。これは `janesaoirse@gmail.com` に正規化され、ハッシュ化されて Base64 エンコードされた値は `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` となります。
同じメールアドレスを持つパブリッシャーは誤って正規化しませんでした。メールアドレス `Jane.Saoirse@gmail.com` をハッシュ化し Base64 エンコードした値は `f8upG1hJazYKK8aEtAMq3j7loeAf5aA4lSq6qYOBR/w=` です。これら2つの異なる値は、2つの異なる UID2 になります。最初のものは正しく処理され、同じ元データから生成された他のインスタンスと一致すします。2つ目は正しく処理されていないため、一致しません。
このシナリオでは、UID2 が同じユーザーの他のインスタンスと一致しないため、パブリッシャーはターゲティング広告から利益を得る機会を逃してしまいます。 +- 必要なステップのどれかを欠いた場合—たとえば、最初に正規化せずにハッシュした場合—その結果は有効な UID2 値にはなりません。
たとえば、データプロバイダが `Jane.Saoirse@gmail.com` から UID2 を生成したいとします。これは `janesaoirse@gmail.com` に正規化され、ハッシュ化されて Base64 エンコードされた値は `ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=` となります。
同じメールアドレスを持つパブリッシャーは誤って正規化しませんでした。メールアドレス `Jane.Saoirse@gmail.com` をハッシュ化し Base64 エンコードした値は `f8upG1hJazYKK8aEtAMq3j7loeAf5aA4lSq6qYOBR/w=` です。これら2つの異なる値は、2つの異なる UID2 になります。最初のものは正しく処理され、同じ元データから生成された他のインスタンスと一致すします。2つ目は正しく処理されていないため、一致しません。
このシナリオでは、UID2 が同じユーザーの他のインスタンスと一致しないため、パブリッシャーはターゲティング広告から利益を得る機会を逃してしまいます。 ::: ## Types of Directly Identifying Information @@ -41,11 +41,11 @@ UID2 Operator Service< 3. `gmail.com` アドレスのみ: 1. アドレスの中にピリオド(`.`)(ASCII 10 進コード 46 / UTF-8 16 進コード 2E) があれば、それを削除します。 - 例えば、`jane.doe@gmail.com` を `janedoe@gmail.com` に正規化します。 + たとえば、`jane.doe@gmail.com` を `janedoe@gmail.com` に正規化します。 2. プラス記号(`+`)とその後ろに追加文字列がある場合、`@gmail.com` の前にあるプラス記号 (`+`)(ASCII 10 進コード 43 / UTF-8 16 進コード 2B)とそれに続くすべての文字を削除します。 - 例えば、`janedoe+home@gmail.com` を `janedoe@gmail.com` に正規化します。 + たとえば、`janedoe+home@gmail.com` を `janedoe@gmail.com` に正規化します。 :::warning 正規化されたメールアドレスが UTF-16 のような他のエンコーディングシステムではなく、UTF-8 であることを確認してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md index 409c8fe83..e0e790c80 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-opt-out.md @@ -19,7 +19,7 @@ UID2 エコシステムには、2 種類のオプトアウトがあります: 各参加者には独自のオプトアウトワークフローがあるため、参加者はユーザーのオプトアウトステータスを受け入れ、したがって参加者からオプトアウトしたユーザーの UID2 を作成しないことが義務付けられています。 -例えば、あるユーザーがパブリッシャーのサイトからオプトアウトしたが、UID2 からオプトアウトしていない場合、パブリッシャーはそのユーザーの UID2 Token を生成すべきではありません。 +たとえば、あるユーザーがパブリッシャーのサイトからオプトアウトしたが、UID2 からオプトアウトしていない場合、パブリッシャーはそのユーザーの UID2 Token を生成すべきではありません。 消費者はいつでも、[Transparency and Control Portal](https://www.transparentadvertising.com/) で UID2 を完全にオプトアウトすることができます。メールアドレスまたは電話番号を選択し、データを入力し、プロンプトに従ってください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md index d52d4f685..2bcec7612 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/dsp-guide.md @@ -38,7 +38,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 の Opt-out ワークフローとユーザーがどのように Opt-out できるかの詳細は、[ユーザーオプトアウト](../getting-started/gs-opt-out.md) を参照してください。 #### Opt-Out Webhook diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid.png index 6b9d3ee9d..ee38f47df 100644 Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid.png and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-endpoints-mermaid.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid.png b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid.png index f1b258069..f94b6d136 100644 Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid.png and b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/advertiser-flow-overview-mermaid.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak index 6223664e3..f7ec8b548 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-endpoints-mermaid.md.bak @@ -4,68 +4,39 @@ participant ADP as Advertiser/Data Provider participant UID as UID2 Operator participant DSP - Note over ADP,DSP: 1. Generate a raw UID2 from DII using the identity map endpoint. + Note over ADP,DSP: 1. ID マップエンドポイントを利用して DII から raw UID2 を生成します。 loop - ADP->>UID: 1-a. Send a request containing DII to the POST /identity/map endpoint. - UID->>ADP: 1-b. Store the raw UID2 and salt bucket ID returned from the POST /identity/map endpoint. + ADP->>UID: 1-a. POST /identity/map エンドポイントに DII を含むリクエストを送信します。 + UID->>ADP: 1-b. POST /identity/map エンドポイントから返される raw UID2 とソルトバケット ID を保存します。 end - Note over ADP,DSP: 2. Store raw UID2s and salt bucket IDs. - Note over ADP,DSP: 3. Manipulate or combine raw UID2s. - Note over ADP,DSP: 4. Send raw UID2s to DSPs. - ADP-->>DSP: Send stored raw UID2s to DSPs to create audiences and conversions, or use them for measurement. - Note over ADP,DSP: 5. Monitor for salt bucket rotation. + Note over ADP,DSP: 2. raw UID2 とソルトバケット ID を保存します。 + Note over ADP,DSP: 3. raw UID2 を操作または結合します。 + Note over ADP,DSP: 4. raw UID2 を DSP に送信します。 + ADP-->>DSP: 保存された raw UID2 を DSP に送信してオーディエンスやコンバージョンを作成したり、測定に使用したりします。 + Note over ADP,DSP: 5. ソルトバケットのローテーションを監視します。 loop - ADP->>UID: 5-a. Monitor salt bucket rotations using the POST /identity/buckets endpoint. - UID->>ADP: 5-b. Return salt buckets rotated since a specified timestamp. - ADP->>UID: 5-c. Compare the rotated salt buckets to the stored UID2 salt buckets.
If rotated, resend DII to the POST /identity/map endpoint for a new raw UID2. - UID->>ADP: 5-d. Store the raw UID2 and the salt bucket ID returned from the POST /identity/map endpoint. + ADP->>UID: 5-a. POST /identity/buckets エンドポイントを使用して、ソルトバケットのローテーションを監視します。 + UID->>ADP: 5-b. 指定したタイムスタンプ以降にローテーションしたソルトバケットを返します。 + ADP->>UID: 5-c. ローテーションしたソルトバケットと保存された UID2 ソルトバケットを比較します。
ローテーションした場合は、新しい raw UID2 を取得するために DII を POST /identity/map エンドポイントに再送信します。 + UID->>ADP: 5-d. POST /identity/map エンドポイントから返された raw UID2 とソルトバケット ID を保存します。 end - Note over ADP,DSP: 6. Monitor for opt-out status. Remove all opt-outs from local storage and do not use. + Note over ADP,DSP: 6. オプトアウトステータスを監視します。ローカルストレージからすべてのオプトアウトを削除し、使用しないでください。 loop - ADP->>UID: 6-a. Monitor for optout status using the POST optout/status endpoint. - UID->>ADP: 6-b. Return optout status. + ADP->>UID: 6-a. POST optout/status エンドポイントを使用して、オプトアウトステータスを監視します。 + UID->>ADP: 6-b. オプトアウトステータスを返します。 end --> - - - - - - sequenceDiagram - participant DP as Data Provider - participant UID2 as UID2 Operator - participant DSP - loop 1. Retrieve a UID2 for DII using the identity map endpoint. - DP->>UID2: 1-a. Send a request containing DII to the identity mapping endpoints. - UID2->>DP: 1-b. Store the raw UID2 and salt bucket returned from the POST /identity/map endpoint. - end - DP-->>DSP: 2. Send stored UID2s to DSPs to create audiences and conversions. - - loop 3. Monitor for salt bucket rotations related to your stored raw UID2s. - DP->>UID2: 3-a. Monitor salt bucket rotations using the bucket service. - UID2->>DP: 3-b. Return salt buckets rotated since a specified timestamp. - DP->>UID2: 3-c. Compare the rotated salt buckets to the stored UID2 salt buckets.
If rotated, resend DII to the POST /identity/map endpoint for a new raw UID2. - UID2->>DP: 3-d. Store the raw UID2 and the salt bucket returned from the POST /identity/map endpoint. - end - - - - diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak index 597c99596..efb62a68f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/images/resource/advertiser-flow-overview-mermaid.md.bak @@ -6,109 +6,39 @@ participant ADP as Advertiser/Data Provider participant UID as UID2 Operator participant DSP - Note over ADP,DSP: 1. Generate a raw UID2 from DII. + Note over ADP,DSP: 1. DII から raw UID2 を生成します。 loop - ADP->>UID: 1-a. Send a request containing DII using an SDK, Snowflake, AWS Entity Resolution, or raw HTTP endpoint. - UID->>ADP: 1-b. Receive the raw UID2 and salt bucket ID. - end - Note over ADP,DSP: 2. Store raw UID2s and salt bucket IDs. - Note over ADP,DSP: 3. Manipulate or combine raw UID2s. - Note over ADP,DSP: 4. Send raw UID2s to DSPs. - ADP-->>DSP: Send stored raw UID2s to DSPs to create audiences and conversions, or use them for measurement. - Note over ADP,DSP: 5. Monitor for salt bucket rotation. + ADP->>UID: 1-a. SDK、Snowflake、AWS Entity Resolution、または HTTP エンドポイントを使用して、DII を含むリクエストを送信します。 + UID->>ADP: 1-b. raw UID2 とソルトバケット ID を受け取ります。 + end + Note over ADP,DSP: 2. raw UID2 とソルトバケット ID を保存します。 + Note over ADP,DSP: 3. raw UID2 を操作または結合します。 + Note over ADP,DSP: 4. raw UID2 を DSP に送ります。 + ADP-->>DSP: 保存された raw UID2 を DSP に送信してオーディエンスやコンバージョンを作成したり、測定に使用したりします。 + Note over ADP,DSP: 5. ソルトバケットのローテーションを監視します。 loop - ADP->>UID: 5-a. Monitor salt bucket rotations using the Python SDK, Snowflake, or HTTP endpoints. - UID->>ADP: 5-b. Return salt buckets rotated since a specified timestamp. - ADP->>UID: 5-c. Compare the rotated salt buckets to the stored UID2 salt buckets.
If rotated, resend DII to the option you're using in Step 1 to get a new raw UID2. - UID->>ADP: 5-d. Store the raw UID2 and the salt bucket that are returned. + ADP->>UID: 5-a. Python SDK、Snowflake、または HTTP エンドポイントを使用して、ソルトバケットのローテーションを監視します。 + UID->>ADP: 5-b. 指定したタイムスタンプ以降にローテーションしたソルトバケットを返します。 + ADP->>UID: 5-c. ローテーションしたソルトバケットと保存された UID2 ソルトバケットを比較します。
ローテーションした場合、Step 1 で使用したオプションに DII を再送信して、新しい raw UID2 を取得します。 + UID->>ADP: 5-d. 返された raw UID2 とソルトバケットを保存します。 end - Note over ADP,DSP: 6. Monitor for opt-out status. Remove all opt-outs from local storage and do not use. + Note over ADP,DSP: 6. オプトアウトステータスを監視します。ローカルストレージからすべてのオプトアウトを削除し、使用しないでください。 loop - ADP->>UID: 6-a. Monitor for optout status using the POST optout/status endpoint. - UID->>ADP: 6-b. Return optout status. + ADP->>UID: 6-a. POST optout/status エンドポイントを使用して、オプトアウトステータスを監視します。 + UID->>ADP: 6-b. オプトアウトステータスを返します。 end --> - ->DSP: Send stored raw UID2s to DSPs to create audiences and conversions, or use them for measurement. - Note over ADP,DSP: 5. Monitor for salt bucket rotation. - loop - ADP->>UID: 5-a. Monitor salt bucket rotations using the bucket service. - UID->>ADP: 5-b. Return salt buckets rotated since a specified timestamp. - ADP->>UID: 5-c. Compare the rotated salt buckets to the stored UID2 salt buckets.
If rotated, resend DII to identity mapping service for a new raw UID2. - UID->>ADP: 5-d. Store the raw UID2 and the salt bucket returned from the identity mapping service. - end - Note over ADP,DSP: 6. Monitor for opt-out status. Remove all opt-outs from local storage and do not use. - loop - ADP->>UID: 6-a. Monitor for optout status using the POST optout/status endpoint. - UID->>ADP: 6-b. Return optout status. - end +https://mermaid-js.github.io/mermaid-live-editor/edit#pako:eNqtVl1PE0EU_SuTea5rt3QrbQwJSU0kRm0sxsT0ZW0HaaQ7dTsFkZB0Z42CSqiIICoBRZFQFY0aJYr9MdMW-BfemX7Y2gXRyAvzdc89e-6505nASZoiOIITFkI5cj1PrCSJps2rtpmRSwhlTZulk-msaTHUH40hM4f6U6MEFnPEPh41mYliNh1Np4jdHXBxICoD4F8Anc8S22TU41Q0HqsvnqOMIArgMpMPliNI11B0YAAJ557g08g2x-pggs_tzq_UporCWRTOD-EsiQKvg8i_EUqzqD4FpGN9fRAEWMdMDcWjZ0TBiVt0bGjEvEZg3H8pjk5ZLM3G0QWSoyN5lqYWrCvcFeFsodODgzFIuSHcj8KdFu6y4C_VeAp4VHbKu_Mbisc6RCm2fK5aLAleEO6m4Fsykm_XT-8XnEr5eTdrIAg0gaykeUVr-1IHgneEW5LxblHwD8J1YYxAWplnFpAeVGcXBL_7GySxUgfKGjh6hkp5ufr2cTdjD9QeraNCtYczlZ1nLRl3PxerxSmPgnkgBTuRpEWAZwnU6_5OWWHQTsU1yT4S_D5kPQikWYJ1wTeF-124dwRfaxQYKsVvCf5RFbgod_lX4b5WW1DsZ03TrUgmBaf29U313ROAbfOB2jqKYIaGPKUXzjvhvlXMbisGX1oMdp-u7a0vdKNLy7caoM30hjR9bJwNU8vD-__m8f_FudP3hvR97f4dJWddxbIisapqUlZsFivfXu0vzYDe3skagV78-Nxeed6TRIdcSajJ30I7G78br2E6bx61rfm97247lZNX7L5DslZXP8nWgdoxkkU6uPh1p93AxYttMSXUvIZuz3TYHfy68F6Nb3X0Blwg1R-Lf65QSkNKxO7-OuASOeQCOex-CsnGUB8lIV4Ivq4G2011ysoSHsZqiMhLkkr90nXfNJpY_YbIY8621AL86pFirjp9d3_ppcQE4X6JvAmSgezCmRXOqhQApn_qvZDqvfPxQUSzjObZ8RwzWT539Db7FwW8CheSrXUUOM8OUYVKWNiHM8TOmOkUvBcm5FYCs2GSIQkcgeEQtUmOJeAlMQknzTyj8XEriSPMzhMfzmdTJmu-LHBkyBzJtVZPpdLwLmgtEjU9W3-XqOeJD9s0f3W4dQJeDZcpzbTPcWQC38CRHiOkBfTgiXDIrxu6HjB8eBxHjIBmhMLBniBsBcN-vXfSh28qAL_WGwwEjRO9Yb-h-w0jrE_-BG0RloM --> - - - - - - - - sequenceDiagram - participant DP as Data Provider - participant UID2 as UID2 Operator - participant DSP - loop 1. Retrieve a UID2 for DII using the identity map endpoint. - DP->>UID2: 1-a. Send a request containing DII to the identity mapping endpoints. - UID2->>DP: 1-b. Store the raw UID2 and salt bucket returned from the identity mapping service. - end - DP-->>DSP: 2. Send stored UID2s to DSPs to create audiences and conversions. - - loop 3. Monitor for salt bucket rotations related to your stored raw UID2s. - DP->>UID2: 3-a. Monitor salt bucket rotations using the bucket service. - UID2->>DP: 3-b. Return salt buckets rotated since a specified timestamp. - DP->>UID2: 3-c. Compare the rotated salt buckets to the stored UID2 salt buckets.
If rotated, resend DII to identity mapping service for a new raw UID2. - UID2->>DP: 3-d. Store the raw UID2 and the salt bucket returned from the identity mapping service. - end - - - - - diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md index f5fb94518..5c6171711 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-endpoints.md @@ -1,7 +1,7 @@ --- title: Advertiser/Data Provider Integration to HTTP Endpoints sidebar_label: HTTP Endpoints -description: Integration for organizations that collect user data and push it to other participants, coding to HTTP endpoints rather than an SDK or Snowflake. +description: ユーザーデータを収集し、他の参加者へプッシュする組織向けのインテグレーション、SDK や Snowflake ではなく HTTP エンドポイントへのコーディング。 hide_table_of_contents: false sidebar_position: 07 --- @@ -10,15 +10,30 @@ import Link from '@docusaurus/Link'; # Advertiser/Data Provider Integration to HTTP Endpoints -This guide covers integration steps for advertisers and data providers to integrate with UID2 by writing code to call UID2 HTTP endpoints, rather than using another implementation option such as an SDK, Snowflake, or AWS Entity Resolution. +このガイドでは、広告主およびデータプロバイダが、UID2 とインテグレーションするために、SDK、Snowflake、または AWS Entity Resolution などの他の実装オプションを使用せずに、UID2 HTTP エンドポイントを呼び出すためのコードを記述する手順について説明します。 :::tip -For a summary of all integration options and steps for advertisers and data providers, see [Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md). +広告主とデータプロバイダー向けのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +::: + +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[UID2 Portal での開始](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal の [API Keys](../portal/api-keys.md) ページで、以下の値を設定する必要があります: + +- API key、Client Key とも呼ばれます。 +- Client secret、参加者と UID2 Servivce のみが知る値です。 + +:::important +これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: ## High-Level Steps -At a high level, the steps for advertisers and data providers integrating with UID2 are as follows: +広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです: 1. [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) @@ -34,9 +49,9 @@ At a high level, the steps for advertisers and data providers integrating with U ## Integration Diagram -The following diagram outlines the steps that data collectors must complete to map DII to raw UID2s for audience building and targeting. +以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了する必要がある手順を示しています。 -DII refers to a user's normalized email address or phone number, or the normalized and SHA-256-hashed email address or phone number. +DII は、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化され、SHA-256 ハッシュされたメールアドレスまたは電話番号を指します。 ![Advertiser Flow](images/advertiser-flow-endpoints-mermaid.png) @@ -46,72 +61,72 @@ DII refers to a user's normalized email address or phone number, or the normaliz | Step | Endpoint | Description | | --- | --- | --- | -| 1-a | [POST /identity/map](../endpoints/post-identity-map.md) request | Send a request containing DII to the identity mapping endpoint. | -| 1-b | [POST /identity/map](../endpoints/post-identity-map.md) response | The `advertising_id` (raw UID2) returned in the response can be used to target audiences on relevant DSPs.
The response returns a user's raw UID2 and the corresponding `bucket_id` for the salt bucket. The salt assigned to the bucket rotates annually, which impacts the generated raw UID2. For details on how to check for salt bucket rotation, see [5: Monitor for salt bucket rotations related to your stored raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s). | +| 1-a | [POST /identity/map](../endpoints/post-identity-map.md) request | DII を含むリクエストを ID マッピングエンドポイントに送信します。 | +| 1-b | [POST /identity/map](../endpoints/post-identity-map.md) response | レスポンスで返される `advertising_id` (raw UID2) は、関連する DSP でオーディエンスをターゲットするために使用できます。
レスポンスは、ユーザーの raw UID2 と、それに対応するソルトバケットの `bucket_id` を返します。バケットに割り当てられたソルトは年に一度ローテーションし、生成された raw UID2 に影響を与えます。ソルトバケットのローテーションを確認する方法の詳細は、[5: Monitor for salt bucket rotations related to your stored raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。 | ### 2: Store Raw UID2s and Salt Bucket IDs -The response from Step 1, [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii), contains mapping information. We recommend that you store the following information returned in Step 1: +Step 1 のレスポンス [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) には、マッピング情報が含まれています。以下の情報を保存することを勧めます: -- Cache the mapping between DII (`identifier`), raw UID2 (`advertising_id`), and salt bucket (`bucket_id`). -- Store the timestamp for when you received the response data. Later, you can compare this timestamp with the `last_updated` timestamp returned in Step 5, [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s). +- DII (`identifier`) と raw UID2 (`advertising_id`)、ソルトバケット (`bucket_id`) のマッピングをキャッシュします。 +- レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) で返される `last_updated` タイムスタンプと比較できます。 ### 3: Manipulate or Combine Raw UID2s -Use the UID2s you received in Step 1. For example, you might do one or more of the following: +Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます: -- Do some manipulation: for example, combine UID2s you generated from DII and UID2s received from another participant such as an advertiser or data provider. -- Add new UID2s into an existing audience. +- 操作を行う: たとえば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。 +- 既存のオーディエンスに新しい UID2 を追加する。 ### 4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions -Use the raw UID2s for some purpose such as: +raw UID2 を以下の目的で使用します: - - Sending stored raw UID2s to DSPs to create audiences and conversions. - - Using the raw UID2s for measurement. + - 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。 + - 計測のために raw UID2 を使用する。 -For example, you could send the `advertising_id` (raw UID2) returned in Step 1-b to a DSP while building your audiences. Each DSP has a unique integration process for building audiences; follow the integration guidance provided by the DSP for sending raw UID2s to build an audience. +たとえば、Step 1-b で返された `advertising_id` (raw UID2) を DSP に送信してオーディエンスを構築します。各 DSP は、オーディエンスを構築するための独自のインテグレーションプロセスを持っています。オーディエンスを構築するために raw UID2 を送信するための DSP から提供されるインテグレーションガイダンスに従ってください。 -You could also send conversion information via API or pixels for measurement (attribution) or for retargeting. +また、計測（アトリビューション）やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。 ### 5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s -A raw UID2 is an identifier for a user at a specific moment in time. The raw UID2 for a specific user changes at least once per year, as a result of the salt bucket rotation. +raw UID2 は、特定の時点におけるユーザーの識別子です。raw UID2 は、ソルトバケット のローテーションにより、少なくとも年に一度変更されます。 -Even though each salt bucket is updated approximately once per year, individual bucket updates are spread over the year. Approximately 1/365th of all salt buckets are rotated daily. Based on this, we recommend checking salt bucket rotation regularly, on a cadence that aligns with your audience refreshes. For example, if you refresh weekly, check for salt bucket updates weekly. +各ソルトバケットは、約1年に1回更新されますが、個々のバケットの更新は年間を通じて分散されます。約 1/365 のソルトバケットが毎日ローテーションされます。このため、ソルトバケットのローテーションを定期的にチェックすることを勧めます。これは、オーディエンスの更新に合わせた頻度で行うことが望ましいです。たとえば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。 -If the salt bucket has been rotated, regenerate the raw UID2. For details, see [Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated). +ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated) を参照してください。 -The following table shows the steps for checking for salt bucket rotation. +以下の表は、ソルトバケットのローテーションを確認するための手順を示しています。 | Step | Endpoint | Description | | --- | --- | --- | -| 5-a | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | Send a request to the `POST /identity/buckets` endpoint for all salt buckets that have changed since a specific timestamp. | -| 5-b | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | UID2 service: The `POST /identity/buckets` endpoint returns a list of `bucket_id` and `last_updated` timestamps. | -| 5-c | [POST /identity/map](../endpoints/post-identity-map.md) | Compare the returned `bucket_id` to the salt buckets of raw UID2s that you've cached.
If you find that the salt bucket was updated for one or more raw UID2s, re-send the DII to the `POST /identity/map` endpoint for a new raw UID2. | -| 5-d | [POST /identity/map](../endpoints/post-identity-map.md) | Store the new values returned for `advertising_id` and `bucket_id`. | +| 5-a | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | 特定のタイムスタンプ以降に変更されたすべてのソルトバケットに対して、`POST /identity/buckets` エンドポイントにリクエストを送信します。 | +| 5-b | [POST /identity/buckets](../endpoints/post-identity-buckets.md) | UID2 Service: `POST /identity/buckets` エンドポイントは、`bucket_id` と `last_updated` タイムスタンプのリストを返します。 | +| 5-c | [POST /identity/map](../endpoints/post-identity-map.md) | 返された `bucket_id` をキャッシュした raw UID2 のソルトバケットと比較します。
1 つ以上の raw UID2 のソルトバケットが更新された場合は、新しい raw UID2 用に DII を `POST /identity/map` エンドポイントに再送信します。 | +| 5-d | [POST /identity/map](../endpoints/post-identity-map.md) | `advertising_id` と `bucket_id` の新しい値を保存します。 | #### Determine whether the salt bucket has been rotated -To determine whether the salt bucket ID for a specific raw UID2 has changed, follow these steps. +特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。 -1. Compare these two values: +1. 以下の 2 つの値を比較します: - - The `last_updated` timestamp of each `bucket_id` returned as part of monitoring the salt bucket rotations. + - ソルトバケットのローテーション時に返された、同じ `bucket_id` の raw UID2 の `last_updated` タイムスタンプ。 - - The timestamp of the raw UID2 generation of the same `bucket_id`, which was returned in Step 1 and stored in Step 2. + - Step 1 で返され、Step 2 で保存された、同じ `bucket_id` の raw UID2 生成時のタイムスタンプ。 -1. If the `last_updated` timestamp is more recent than the timestamp you recorded earlier, the salt bucket has been rotated. As a result, you'll need to regenerate any raw UID2s associated with this `bucket_id`, following Step 1, [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii). +1. `last_updated` タイムスタンプが、以前に記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その場合、この `bucket_id` に関連するすべての raw UID2 を再生成する必要があります。この場合は、Step 1 の [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従ってください。 ### 6: Monitor for Opt-Out Status -It's important to honor user opt-out status. Periodically, monitor for opt-out status, to be sure that you don't continue using UID2s for users that have recently opted out. +ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの UID2 を引き続き使用しないようにしてください。 -There are two ways that you can check with the UID2 Operator Service to make sure you have the latest opt-out information: +UID2 Operator Service に最新のオプトアウト情報があるかを確認する方法は 2 つあります: -- Call the [POST /identity/map](../endpoints/post-identity-map.md) endpoint to check for opt-outs. If the DII has been opted out, no raw UID2 is generated. +- [POST /identity/map](../endpoints/post-identity-map.md) エンドポイントを呼び出してオプトアウトを確認します。DII がオプトアウトされている場合、raw UID2 は生成されません。 -- Check the opt-out status of raw UID2s using the [POST /optout/status](../endpoints/post-optout-status.md) endpoint. +- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認します。 -For details about the UID2 opt-out workflow and how users can opt out, see [User Opt-Out](../getting-started/gs-opt-out.md). +UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法についての詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md index 7d256dd36..31ab32485 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-advertiser-dataprovider-overview.md @@ -1,7 +1,7 @@ --- title: Advertiser/Data Provider Integration Overview sidebar_label: Advertiser/Data Provider Integration Overview -description: Overview of integration options for organizations that collect user data and push it to other participants. +description: ユーザーデータを収集し、他の参加者へプッシュする組織向けのインテグレーションの概要。 hide_table_of_contents: false sidebar_position: 07 --- @@ -10,25 +10,25 @@ import Link from '@docusaurus/Link'; # Advertiser/Data Provider Integration Overview -This guide provides an overview of integration options for organizations that collect user data and push it to other UID2 participants. Data collectors include advertisers, data on-boarders, measurement providers, identity graph providers, third-party data providers, and any other organizations that send data to other participants. +このガイドでは、ユーザーデータを収集し、他の UID2 参加者へプッシュする組織向けのインテグレーションオプションの概要を提供します。データコレクターには、広告主、データオンボーダー、計測プロバイダー、アイデンティティグラフプロバイダー、サードパーティデータプロバイダー、および他のデータを他の参加者に送信する組織が含まれます。 ## Advertiser/Data Provider Routes to Use UID2 -Within the ad tech industry, advertisers use identity to build audiences, track conversions, and generate their graphs. As an advertiser, or as a data provider acting on behalf of an advertiser, the following table shows some examples of how you can accomplish some of these goals with UID2. +アドテク業界では、広告主は ID を使用してオーディエンスを構築し、コンバージョンを追跡し、グラフを生成します。広告主または広告主を代表してデータプロバイダーとして、UID2 を使用してこれらの目標を達成する方法の一部の例を次の表に示します。 :::note -There are other ways that you can use UID2, outside these use cases. These are just some examples. +これらのユースケース以外にも、UID2 を使用する方法があります。以下に、いくつかの例を示します。 ::: | Send/Receive? | Action | Advantage/Result | | --- | --- | --- | -| Send in audiences | Send UID2s via API or pixels | Create audiences. | -| Send in conversions | Send UID2s as conversion information | Use conversion information for measurement (attribution) or for retargeting via API or pixels. | -| Receive graph data | Receive UID2s from graph/data providers via API or pixels | Build graph data. | +| オーディエンスを送信 | API またはピクセルを介して UID2 を送信 | オーディエンスを作成します。 | +| コンバージョンを送信 | UID2 をコンバージョン情報として送信 | 測定（アトリビューション）またはリターゲティングのためにコンバージョン情報を使用します。 | +| グラフデータを受信 | API またはピクセルを介してグラフ/データプロバイダーから UID2 を受信 | グラフデータを構築します。 | ## High-Level Steps -At a high level, the steps for advertisers and data providers integrating with UID2 are as follows: +広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです: 1. [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) @@ -44,82 +44,82 @@ At a high level, the steps for advertisers and data providers integrating with U ## Summary of Implementation Options -The following table shows the implementation options that are available for advertisers and data providers, for each of the high-level steps. Some steps are managed solely as part of your own custom implementation; some steps can be managed by one or more of the UID2 implementation options available. For details, click the link on each step. +以下の表は、広告主およびデータプロバイダーが利用できる実装オプションを、各ステップごとに示しています。一部のステップは、独自のカスタム実装の一部としてのみ管理されます。一部のステップは、利用可能な UID2 実装オプションのいずれかを使用して管理できます。詳細は、各ステップのリンクをクリックしてください。 | High-Level Step | Implementation Options | | --- | --- | -| [1: Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | Use any of the following options to map DII to raw UID2s: | -| [2: Store Raw UID2s and Salt Bucket IDs](#2-store-raw-uid2s-and-salt-bucket-ids) | Custom (your choice). | -| [3: Manipulate or Combine Raw UID2s](#3-manipulate-or-combine-raw-uid2s) | Custom (your choice). | -| [4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions](#4-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) | Custom (your choice). | -| [5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) | Any of the following options: | -| [6: Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) | API call to the [POST /optout/status](../endpoints/post-optout-status.md) endpoint. | +| [1: Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) | DII を raw UID2 にマッピングするには、以下のオプションのいずれかをします: | +| [2: Store Raw UID2s and Salt Bucket IDs](#2-store-raw-uid2s-and-salt-bucket-ids) | カスタム（適切な方法で）。 | +| [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 Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) | 以下のいずれかのオプションを使用してください: | +| [6: Monitor for Opt-Out Status](#6-monitor-for-opt-out-status) | API コールを使用して、[POST /optout/status](../endpoints/post-optout-status.md) エンドポイントにアクセスします。 | ## Integration Diagram -The following diagram outlines the steps that data collectors must complete to map DII to raw UID2s for audience building and targeting. +以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了しなければならない手順を示しています。 -DII refers to a user's normalized email address or phone number, or the normalized and SHA-256-hashed email address or phone number. +DII とは、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化され、SHA-256 ハッシュされたメールアドレスまたは電話番号を指します。 -To keep your UID2-based audience information accurate and up to date, follow these integration steps every day. +UID2 に基づくオーディエンス情報を正確かつ最新の状態に保つために、毎日以下のインテグレーション手順に従ってください。 ![Advertiser Flow](images/advertiser-flow-overview-mermaid.png) -For details about the different parts of the diagram, refer to the following sections. +図の各部分の詳細は、次のセクションを参照してください。 ### 1: Generate Raw UID2s from DII -You can generate raw UID2s from directly identifying information (DII), or receive UID2s from another UID2 participant such as a data provider acting on your behalf. +raw UID2 は、直接識別情報 (DII) から生成するか、広告主を代表してデータプロバイダーなどの他の UID2 参加者から UID2 を受け取ることができます。 -To generate raw UID2s, use one of the following options: +raw UID2 を生成するには、以下のオプションのいずれかを使用します: -- One of the UID2 SDKs: +- UID2 SDK のいずれか: - - Python SDK: See [Map DII to Raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s). - - Java SDK: See [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers). + - Python SDK: [Map DII to Raw UID2s](../sdks/sdk-ref-python.md#map-dii-to-raw-uid2s) を参照してください。 + - Java SDK: [Usage for Advertisers/Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) を参照してください。 -- Snowflake: See [Map DII](integration-snowflake.md#map-dii). +- Snowflake: [Map DII](integration-snowflake.md#map-dii) を参照してください。 -- AWS Entity Resolution: See [AWS Entity Resolution Integration Guide](integration-aws-entity-resolution.md). +- AWS Entity Resolution: [AWS Entity Resolution Integration Guide](integration-aws-entity-resolution.md) を参照してください。 -- HTTP endpoints: [POST /identity/map](../endpoints/post-identity-map.md). For details, see [Generate Raw UID2s from DII](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii). +- HTTP endpoints: [POST /identity/map](../endpoints/post-identity-map.md). 詳細は、[Generate Raw UID2s from DII](integration-advertiser-dataprovider-endpoints.md#1-generate-raw-uid2s-from-dii) を参照してください。 ### 2: Store Raw UID2s and Salt Bucket IDs -The response from Step 1, [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii), contains mapping information. We recommend that you store the following information returned in Step 1: +Step 1 のレスポンス [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) には、マッピング情報が含まれています。以下の情報を保存することを勧めます: -- Cache the mapping between DII (`identifier`), raw UID2 (`advertising_id`), and salt bucket (`bucket_id`). -- Store the timestamp for when you received the response data. Later, you can compare this timestamp with the `last_updated` timestamp returned in Step 5, [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s). +- DII (`identifier`) と raw UID2 (`advertising_id`)、ソルトバケット (`bucket_id`) のマッピングをキャッシュします。 +- レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) で返される `last_updated` タイムスタンプと比較できます。 ### 3: Manipulate or Combine Raw UID2s -Use the UID2s you received in Step 1. For example, you might do one or more of the following: +Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます: -- Do some manipulation: for example, combine UID2s you generated from DII and UID2s received from another participant such as an advertiser or data provider. -- Add new UID2s into an existing audience. +- 操作する: たとえば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。 +- 既存のオーディエンスに新しい UID2 を追加する。 ### 4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions -Use the raw UID2s for some purpose such as: +UID2 を以下の目的で使用します: - - Sending stored raw UID2s to DSPs to create audiences and conversions. - - Using the raw UID2s for measurement. + - 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。 + - 計測のために raw UID2 を使用する。 -For example, you could send the `advertising_id` (raw UID2) returned in Step 1-b to a DSP while building your audiences. Each DSP has a unique integration process for building audiences; follow the integration guidance provided by the DSP for sending raw UID2s to build an audience. +たとえば、Step 1-b で返された `advertising_id` (raw UID2) を DSP に送信してオーディエンスを構築します。各 DSP は、オーディエンスを構築するための独自のインテグレーションプロセスを持っています。オーディエンスを構築するために raw UID2 を送信するための DSP から提供されるインテグレーションガイダンスに従ってください。 -You could also send conversion information via API or pixels for measurement (attribution) or for retargeting. +また、計測（アトリビューション）やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。 ### 5: Monitor for Salt Bucket Rotations for Your Stored Raw UID2s -A raw UID2 is an identifier for a user at a specific moment in time. The raw UID2 for a specific user changes at least once per year, as a result of the salt bucket rotation. +raw UID2 は、特定の時点におけるユーザーの識別子です。raw UID2 は、ソルトバケットのローテーションにより、少なくとも年に一度変更されます。 -Even though each salt bucket is updated approximately once per year, individual bucket updates are spread over the year. Approximately 1/365th of all salt buckets are rotated daily. Based on this, we recommend checking salt bucket rotation regularly, on a cadence that aligns with your audience refreshes. For example, if you refresh weekly, check for salt bucket updates weekly. +各ソルトバケットは、約1年に1回更新されますが、個々のバケットの更新は年間を通じて分散されます。約 1/365 のソルトバケットが毎日ローテーションされます。このため、ソルトバケットのローテーションを定期的にチェックすることを勧めます。これは、オーディエンスの更新に合わせた頻度で行うことが望ましいです。たとえば、週ごとに更新する場合は、週ごとにソルトバケットの更新を確認してください。 -If the salt bucket has been rotated, regenerate the raw UID2. For details, see [Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated). +ソルトバケットがローテーションされた場合は、raw UID2 を再生成します。詳細は、[Determine whether the salt bucket has been rotated](#determine-whether-the-salt-bucket-has-been-rotated) を参照してください。 -For instructions for monitoring for salt bucket rotations, refer to one of the following: +ソルトバケットのローテーションを監視する場合については、次のいずれかを参照してください: - Python SDK: [Monitor Rotated Salt Buckets](../sdks/sdk-ref-python.md#monitor-rotated-salt-buckets). @@ -128,33 +128,33 @@ For instructions for monitoring for salt bucket rotations, refer to one of the f - HTTP endpoints: [Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](integration-advertiser-dataprovider-endpoints.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s). :::note -For AWS Entity Resolution, there is no way to do salt bucket monitoring. As an alternative, you could regenerate raw UID2s periodically using the AWS Entity Resolution service. +AWS Entity Resolution では、ソルトバケットの監視方法はありません。代わりに、AWS Entity Resolution サービスを使用して定期的に raw UID2 を再生成することができます。 ::: #### Determine whether the salt bucket has been rotated -To determine whether the salt bucket ID for a specific raw UID2 has changed, follow these steps. +特定の raw UID2 のソルトバケット ID が変更されたかどうかを判断するには、次の手順に従います。 -1. Compare these two values: +1. 2 つの値を比較します: - - The `last_updated` timestamp of each `bucket_id` returned as part of monitoring the salt bucket rotations (whatever option you choose). + - ソルトバケットのローテーション時に返された、同じ `bucket_id` の raw UID2 の `last_updated` タイムスタンプ。(選択したオプションによって返されたもの) - - The timestamp of the raw UID2 generation of the same `bucket_id`, which was returned in Step 1 and stored in Step 2. + - 同じ `bucket_id` の raw UID2 生成時のタイムスタンプ。Step 1 で返され、Step 2 で保存されたもの。 -1. If the `last_updated` timestamp is more recent than the timestamp you recorded earlier, the salt bucket has been rotated. As a result, you'll need to regenerate any raw UID2s associated with this `bucket_id`, following Step 1, [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii). +1. `last_updated` タイムスタンプが、以前に記録したタイムスタンプよりも新しい場合、ソルトバケットがローテーションされています。その場合、この `bucket_id` に関連するすべての raw UID2 を再生成する必要があります。これには、Step 1 の [Generate Raw UID2s from DII](#1-generate-raw-uid2s-from-dii) に従います。 ### 6: Monitor for Opt-Out Status -It's important to honor user opt-out status. Periodically, monitor for opt-out status, to be sure that you don't continue using UID2s for users that have recently opted out. +ユーザーのオプトアウトステータスを受け入れることは重要です。定期的にオプトアウトステータスを監視し、最近オプトアウトしたユーザーの UID2 を引き続き使用しないようにしてください。 -There are two ways that you can check with the UID2 Operator Service to make sure you have the latest opt-out information: +UID2 Operator Service で最新のオプトアウト情報があるかを確認する方法は 2 つあります: -- Call the [POST /identity/map](../endpoints/post-identity-map.md) endpoint to check for opt-outs. If the DII has been opted out, no raw UID2 is generated. +- [POST /identity/map](../endpoints/post-identity-map.md) エンドポイイントを使用して、raw UID2 のオプトアウトステータスを確認します。オプトアウトされた DII には、raw UID2 は生成されません。 -- Check the opt-out status of raw UID2s using the [POST /optout/status](../endpoints/post-optout-status.md) endpoint. +- [POST /optout/status](../endpoints/post-optout-status.md) エンドポイントを使用して、raw UID2 のオプトアウトステータスを確認します。 -For details about the UID2 opt-out workflow and how users can opt out, see [User Opt-Out](../getting-started/gs-opt-out.md). +UID2 のオプトアウトワークフローとユーザーがオプトアウトする方法についての詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 ## FAQs -For a list of frequently asked questions for advertisers and data providers using the UID2 framework, see [FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers). +UID2 のフレームワークを使用する広告主およびデータプロバイダー向けのよくある質問のリストについては、[FAQs for Advertisers and Data Providers](../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md index b78afac57..0776dceff 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-aws-entity-resolution.md @@ -21,6 +21,10 @@ import Link from '@docusaurus/Link'; AWS Entity Resolution を使用して UID2 とインテグレーションに関するビデオプレゼンテーションとデモについては、YouTube の [Getting Started with AWS Entity Resolution Integration with Unified ID 2.0](https://www.youtube.com/watch?v=ORbSsKMgVj8) を参照してください。 +:::tip +広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +::: + ## Functionality 次の表は、AWS Entity Resolution インテグレーションで利用可能な機能をまとめたものです。 @@ -136,7 +140,7 @@ UID2 は、UID2 生成のためにメールアドレスまたは電話番号の マッチングワークフローを作成するには、まず AWS Management コンソールにサインインし、**AWS Entity Resolution** ページを開き、**Workflows** > **Matching workflows** > **Create matching workflow** を選択します。次に、マッチングワークフローの以下のステップを完了します。 1. 一致するワークフローについて、以下の詳細を指定します: - - **Name**: この値は必須です。短く、わかりやすく、直感的な名前を勧めます。例えば、会社名を指定する場合: `CompanyName_UID2_Daily_Matching`。 + - **Name**: この値は必須です。短く、わかりやすく、直感的な名前を勧めます。たとえば、会社名を指定する場合: `CompanyName_UID2_Daily_Matching`。 - **Description**: マッチングワークフローの説明(オプション)。 - **Data input**: AWS のデータソース。ドロップダウンリストから、AWS Glue データベース、AWS Glue テーブル、スキーママッピングの順に選択します。データ入力は複数指定できます。以下の例では、メールアドレスのみを指定しています: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md index 9ce5427ab..800c547d9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-ctv-guide.md @@ -8,6 +8,7 @@ sidebar_position: 04 --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # CTV Integration Guide @@ -22,6 +23,30 @@ UID2 とインテグレーションするには、次の 3 つの主要なステ これらのステップをどのように実装するかを決定するには、[CTV Integration Options](#ctv-integration-options) から選択してください。 +## Integrating with Single Sign-On (SSO) + + + +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[UID2 Portal での開始](../portal/portal-getting-started.md) を参照してください。 + +設定する具体的な値は、[CTV integration options](#ctv-integration-options) で選択したオプションによって異なります: + +- Client-Server または Server-Side の実装の場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで次の値を設定する必要があります: + - API key、Client Key とも呼ばれます。 + - Client secret、参加者と UID2 Servivce のみが知る値です。 + + :::important + これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 + ::: +- Client-Side の実装には、UID2 Portal の [Client-Side Integration](../portal/client-side-integration.md) ページで次の値を設定する必要があります: + - Subscription ID と Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 + - この SDK を使用するすべてのサイトの **domain names** のリスト: [Adding and Managing Root-Level Domains](../portal/client-side-integration.md#adding-and-managing-root-level-domains) を参照してください。 + - モバイルアプリ ID (適用される場合): [モバイルアプリ ID の追加と管理](../portal/client-side-integration.md#adding-and-managing-mobile-app-ids) を参照してください。 + ## CTV Integration Options UID2 Token の生成とリフレッシュをどこで行うかに基づいて、最適なインテグレーションオプションを選択できます。次の 3 つのオプションがあります: @@ -30,7 +55,7 @@ UID2 Token の生成とリフレッシュをどこで行うかに基づいて、 - [Server-Side Integration](#server-side-integration-for-ctv-apps) (UID2 Token は Server-Side で生成とリフレッシュされます) - [Client-Server Integration](#client-server-integration-for-ctv-apps) (UID2 Token は Server-Side で生成され、Client-Side でリフレッシュされます) -## Client-Side Integration for CTV Apps +### Client-Side Integration for CTV Apps Client-Side オプションは、UID2 Token を完全に Client-Side で管理したいパブリッシャー向けです: @@ -48,7 +73,7 @@ Client-Side オプションは、UID2 Token を完全に Client-Side で管理 | [Apple tvOS](https://developer.apple.com/tvos/) | [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) | [SDK for iOS Reference Guide](../sdks/sdk-ref-ios.md) | | [Android TV](https://www.android.com/tv/) | [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md) | [SDK for Android Reference Guide](../sdks/sdk-ref-android.md) | -## Server-Side Integration for CTV Apps +### Server-Side Integration for CTV Apps Server-Side オプションは、UID2 Token を完全に Server-Side で管理したいパブリッシャー向けです: @@ -66,7 +91,7 @@ Server-Side コードが Java または Python である場合、UID2 SDK のい - [SDK for Java Reference Guide: Usage for Publishers](../sdks/sdk-ref-java.md#usage-for-publishers) - [SDK for Python Reference Guide: Usage for Publishers](../sdks/sdk-ref-python.md#usage-for-publishers) -## Client-Server Integration for CTV Apps +### Client-Server Integration for CTV Apps このオプションは UID2 Token を Client-Server で管理したいパブリッシャー向けです: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md index 11eb37124..1145faa87 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-google-ss.md @@ -8,6 +8,7 @@ sidebar_position: 10 --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # Google Ad Manager Secure Signals Integration Guide @@ -27,11 +28,31 @@ Google secure signals は、パブリッシャーが [Google Ad Manager](https:/ 2. セキュアシグナル機能は、Client-Side でそれらをキャッシュし、Google Ad Manager に透過的に渡します。 3. Google Ad Manager は UID2 Token を使ってビッドリクエストを行い、パブリッシャーの設定に基づき Google AdX 内の承認済み入札者にトークンを転送します。 +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +設定する値は、選択した [Publisher Integration Options](#publisher-integration-options) によって異なります: + +- Client-Server または Server-Side の実装の場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで次の値を設定する必要があります: + - API key、Client key とも呼ばれます。 + - Client secret、参加者と UID2 Service のみが知っている値。 + + :::important + これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 + ::: +- Client-Side の実装の場合、UID2 Portal の [Client-Side Integration](../portal/client-side-integration.md) ページで次の値を設定する必要があります: + - Subscription ID と Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 + - この SDK を使用するサイトの **domain names** のリスト: [Adding and Managing Root-Level Domains](../portal/client-side-integration.md#adding-and-managing-root-level-domains) を参照してください。 + - モバイルアプリ ID (適用される場合): [Adding and Managing Mobile App IDs](../portal/client-side-integration.md#adding-and-managing-mobile-app-ids) を参照してください。 + ## Allow Secure Signals Sharing Google Ad Manager アカウントで暗号化 UID2 Token を受け取るには、暗号化されたシグナルが Google Ad Manager アカウントで第三者の入札者と適切に共有されていることを確認する必要があります。 -詳しくは、Google ドキュメントの [Share encrypted signals with bidders](https://support.google.com/admanager/answer/10488752) を確認し、[Use a third-party signal provider](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/securesignals) の手順に従って、シグナルプロバイダーとして UID2 をオンに設定してください。 +詳細は、Google ドキュメントの [Share encrypted signals with bidders](https://support.google.com/admanager/answer/10488752) を確認し、[Use a third-party signal provider](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/securesignals) の手順に従って、シグナルプロバイダーとして UID2 をオンに設定してください。 :::important 手順に従う際、[Select allowed secure signals](https://support.google.com/admanager/answer/10488752#select-signals) の **Web Signal Deploy Option** で **Google Deploy** を選択してください。Prebid.js を使用している場合は、[Optional: Enable Secure Signals in Prebid.js](#optional-enable-secure-signals-in-prebidjs) を参照してください。 @@ -60,6 +81,10 @@ Prebid.js で Secure Signals を使用する場合は、UID2 が正しく処理 For details, see [ESP Configurations](https://docs.prebid.org/dev-docs/modules/userId.html#esp-configurations) in the Prebid documentation. +## Integrating with Single Sign-On (SSO) + + + ## Publisher Integration 暗号化されたシグナルがキャッシュされると、セキュアシグナル機能は、新しいシグナルを生成するためのハンドラを実行しません。このため、データキャプチャの前後にキャッシュをクリアする必要があります。 @@ -77,6 +102,13 @@ window.googletag.cmd.push(function () { }); ``` +## Publisher Integration Options + +Google Secure Signals パブリッシャーインテグレーションには、UID2 との 3 つのインテグレーションオプションがあります: +- [Server-Side Integration](#server-side-integration) +- [SDK for JavaScript Client-Server Integration](#sdk-for-javascript-client-server-integration) +- [SDK for JavaScript Client-Side Integration](#sdk-for-javascript-client-side-integration) + ### Server-Side Integration 暗号化されたシグナルを共有できるように、ホストされ、自動ロードされたセキュアシグナルスクリプトは `window.getUid2AdvertisingToken` 関数を非同期に呼び出し、そのレスポンスとして `advertising_token` を文字列として受け取れるようにしなければなりません。 @@ -93,10 +125,20 @@ window.getUid2AdvertisingToken = async () => { } ``` -詳しくは、[Server-Only UID2 Integration Guide](integration-publisher-server-side.md) を参照してください。 +詳細は、[Server-Only UID2 Integration Guide](integration-publisher-server-side.md) を参照してください。 Server Only インテグレーションのためのサンプルアプリケーションも用意されています。[Sample Implementations](#sample-implementations) を参照してください。 +### SDK for JavaScript Client-Server Integration + +Javascript SDK Version 3.0.0 以降を使用している場合、UID2 セキュアシグナルスクリプトは、SDK で提供されている `getAdvertisingTokenAsync` 関数を使用して新しい Advertising Token を取得し、そのトークンを Google Ad Manager にプッシュします。 + +このスクリプトは CDN でホストされており、GPT はセキュアシグナル機能で自動的にロードします。 + +詳細は、[Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md) を参照してください。 + +JavaScript SDK を使用したインテグレーションのためのサンプルアプリケーションも用意されています。[Sample Implementations](#sample-implementations) を参照してください。 + ### SDK for JavaScript Client-Side Integration SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID2 セキュアシグナルスクリプトは、SDKで提供されている `getAdvertisingTokenAsync` 関数を使用して新しい Advertising Token を取得し、そのトークンを Google Ad Manager にプッシュします。 @@ -105,23 +147,23 @@ SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID 詳しくは [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) を参照してください。 -SDK for JavaScript を使用したインテグレーションのためのサンプルアプリケーションも用意されています。[Sample Implementations](#sample-implementations) を参照してください。 + ## Sample Implementations Google Ad Manager のセキュアシグナル機能との連携方法については、以下のサンプルアプリケーションを参照してください: -- Server-side integration example using the UID2 JavaScript SDK with Google secure signals: +- UID2 JavaScript SDK と Google secure signals を使用した Server-Side インテグレーションのサンプル: - [Sample implementation](https://secure-signals-server-side-integ.uidapi.com/) - [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_side) -- Client-server integration example using the UID2 JavaScript SDK with Google secure signals: +- UID2 JavaScript SDK と Google secure signals を使用した Client-Server インテグレーションのサンプル: - [Sample implementation](https://secure-signals-client-server-integ.uidapi.com/) - [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) -- Client-side integration example using the UID2 JavaScript SDK with Google secure signals: +- UID2 JavaScript SDK と Google secure signals を使用した Client-Side インテグレーションのサンプル: - [Sample implementation](https://secure-signals-client-side-integ.uidapi.com/) - [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/client_side) -各サンプルアプリケーションには独自のインストラクションがあります。 +各サンプル実装には、それぞれのの手順があります。 ## Troubleshooting diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md index 24a4ceff3..5a5b835f1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-server.md @@ -9,7 +9,7 @@ sidebar_position: 02 import Link from '@docusaurus/Link'; import ExampleClientServerSendUid2ToSdk from '../snippets/_example-client-server-send-uid2-to-sdk.mdx'; -import IntegratingWithSSO from '/docs/snippets/_integrating-with-sso.mdx'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # Client-Server Integration Guide for JavaScript @@ -23,17 +23,17 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re ## Sample Implementation -実装例については、次の UID2 SDK 統合例を参照してください。 +実装例については、次の UID2 SDK インテグレーション例を参照してください。 - [Client-Server UID2 SDK Integration Example](https://example-jssdk-integ.uidapi.com/) - [Code Repository with Readme](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) ## Introduction -このガイドでは、SDK を使用せずにインテグレーションを行う場合に考慮すべき基本的な手順を説明します。例えば、ユーザー認証とデータ取得の実装方法、UID2 ID 情報の管理方法とターゲティング広告への使用方法、トークンのリフレッシュ方法、紛失した ID の処理方法、ユーザーのオプトアウトの処理方法などを決定する必要があります。 +このガイドでは、SDK を使用せずにインテグレーションを行う場合に考慮すべき基本的な手順を説明します。たとえば、ユーザー認証とデータ取得の実装方法、UID2 ID 情報の管理方法とターゲティング広告への使用方法、トークンのリフレッシュ方法、紛失した ID の処理方法、ユーザーのオプトアウトの処理方法などを決定する必要があります。 ワークフロー図は、[Integration Steps](#integration-steps) を参照してください。また、[FAQ](#faqs) も参照してください。 -UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 UID2 を使用してクライアントの ID を確立し、Advertising Token を取得するプロセスを容易にするために、このガイドで提供する Web インテグレーション手順は、JavaScript 用の UID2 SDK に依存しています。このガイドに記載されているインテグレーションステップと SDK の使用方法(現在はメールアドレスのみ) を示す [example application](https://example-jssdk-integ.uidapi.com/) を以下に示します。アプリケーションのドキュメントについては、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) を参照してください。 @@ -47,6 +47,25 @@ SDK for JavaScript を使用しないパブリッシャーのインテグレー Google Ad Managerを使用していて、セキュアシグナル機能を使用したい場合は、まずこのガイドの手順に従った後、[Google Ad Manager Secure Signals Integration Guide](integration-google-ss.md) の追加手順に従ってください。 ::: +## Integrating with Single Sign-On (SSO) + + + +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できる [UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +Client-Server インテグレーションを行う場合は、UID2 Portal の [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: + + - API key、Client Key とも呼ばれます。 + - Client secret、参加者と UID2 Servivce のみが知る値です。 + +:::important +これらの値を安全に保管することは非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +::: + ## Integration Steps 以下の図は、ユーザーの UID2 Token をパブリッシャーと確立するために必要なステップと、UID2 Token が RTB ビッドストリームとどのようにインテグレーションされるかを説明しています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md index e92f441b5..44d8a61e7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript-client-side.md @@ -10,6 +10,7 @@ sidebar_position: 04 import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # Client-Side Integration Guide for JavaScript @@ -63,15 +64,30 @@ SDK のデバッグビルドを使用したい場合は、代わりに以下の +## Integrating with Single Sign-On (SSO) + + ## Complete UID2 Account Setup and Configure Account -アカウント設定ページに記載されている手順に従って、UID2 アカウントの設定を完了してください。アカウント設定プロセスの一環として、この SDK for JavaScript で使用するサイトの**ドメイン名**のリストを提供する必要があります。 +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +Client-Side インテグレーションでは、UID2 Portal の [Client-Side Integration](../portal/client-side-integration.md) ページで以下の値を設定する必要があります: + +- Subscription ID and Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 -アカウントのセットアップが完了すると、UID2 サーバーがユーザーを識別するために使用する 2 つの値であるクライアントキーペアが発行されます: Subscription ID と Public key。これらの値はあなたに固有で、UID2 モジュールの設定に使用します。詳細は [Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key) を参照してください。 +- この SDK を使用するサイトの **ドメイン名** のリスト: [Adding and Managing Root-Level Domains](../portal/client-side-integration.md#adding-and-managing-root-level-domains) を参照してください。 + +- モバイルアプリ ID (適用される場合): [Adding and Managing Mobile App IDs](../portal/client-side-integration.md#adding-and-managing-mobile-app-ids) を参照してください。 + + :::tip -アカウント設定に必要なのは、ルートレベルのドメインだけです。例えば、JavaScript 用の UID2 SDK を example.com、shop.example.com、example.org で使用する場合、ドメイン名 example.com と example.org を指定するだけです。 +アカウント設定に必要なのは、ルートレベルのドメインだけです。たとえば、JavaScript 用の UID2 SDK を example.com、shop.example.com、example.org で使用する場合、ドメイン名 example.com と example.org を指定するだけです。 ::: ## Add SDK for JavaScript to Your Site @@ -117,7 +133,7 @@ SDK の詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript ### Using the UID2 Integration Environment -デフォルトでは、SDK は UID2 本番環境 `https://prod.uidapi.com` で動作するように設定されています。代わりに UID2 インテグレーション環境を使用したい場合は、`init` を呼び出す際に以下の URL を指定してください: +デフォルトでは、この SDK は UID2 本番環境 `https://prod.uidapi.com` で動作するように設定されています。代わりに UID2 インテグレーション環境を使用する場合 (資格情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください)、`init` に以下の URL を指定します: ```js __uid2.init({ @@ -125,7 +141,7 @@ __uid2.init({ }); ``` :::note -UID2 インテグレーション環境からのトークンは、ビッドストリームに渡しても無効です。インテグレーション環境では、**Subscription ID** と **public key** の値が異なります。 +UID2 インテグレーション環境からのトークンは、ビッドストリームに渡しても無効です。インテグレーション環境では、**Subscription ID** と **public key** の値が異なります。各環境の認証情報を取得すr方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 ::: ### Optional: Specifying the API Base URL to Reduce Latency @@ -276,7 +292,7 @@ await __uid2.setIdentityFromPhoneHash( パブリッシャーで、identity がない状態で最初のページをロードする場合、トークン生成の呼び出しを開始するには、DII で `setIdentity` メソッドのいずれかを呼び出す必要があります。ID が生成されると、SDK からの `IdentityUpdated` イベントを待つことで、ビッドストリームに送信する Advertiser Token (UID2 token) を利用できるようになります。例として、`advertising_token_to_use` の値がどのように設定されるかを以下のコードスニペットで示します。 -場合によっては、ユーザーの DII はページロード時に利用できず、DII の取得には何らかの関連コストがかかります。例えば、DII を取得するために API コールが必要な場合や、DII 情報を提供するためにユーザーにプロンプトが表示される場合があります。 +場合によっては、ユーザーの DII はページロード時に利用できず、DII の取得には何らかの関連コストがかかります。たとえば、DII を取得するために API コールが必要な場合や、DII 情報を提供するためにユーザーにプロンプトが表示される場合があります。 既存のトークンをチェックし、使用またはリフレッシュすることで、このコストを回避できる可能性があります。これを行うには [__uid2.isLoginRequired](../sdks/sdk-ref-javascript#isloginrequired-boolean) を呼び出し、ブール値を受け取ります。これが `true` の場合、UID2 SDK は既存のリソースで新しい Advertising Token を作成できず、DII はまったく新しい UID2 Token を生成する必要があることを意味します。 @@ -385,4 +401,4 @@ function bytesToBase64(bytes) { const binString = Array.from(bytes, (x) => String.fromCodePoint(x)).join(""); return btoa(binString); } -``` \ No newline at end of file +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md index 682663831..46974704a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-javascript.md @@ -8,6 +8,7 @@ sidebar_position: 04 --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # UID2 Integration Overview for JavaScript @@ -25,6 +26,10 @@ UID2 は、以下をサポートする JavaScript 用の SDK を提供してい さらに柔軟性を高めるため、UID2 は、Prebid インテグレーションなど、一部の機能や補完的な製品の代替方法も提供しています。 +## Integrating with Single Sign-On (SSO) + + + ## Client-Side or Client-Server Integration SDK for JavaScript を使って UID2 とインテグレーションするためのオプションを、次の表にまとめました。最適なオプションを選択してください。 @@ -34,6 +39,14 @@ SDK for JavaScript を使って UID2 とインテグレーションするため | Client-Side で DII にアクセスでき、フロントエンド開発のみを行いたい。 | Client-side integration | [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) | | Server-Side で DII にアクセスでき、Server-Side の開発が可能であるか、Private Operator を使用している。 | Server-side integration | [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md) | +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、最初に[Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal で行う手順は、実装が Client-Side、Client-Server、または Server-Side であるかによって異なります。各実装ガイドに具体的な手順が記載されています。 + ## Generating the UID2 Token DII へのアクセスに応じて、SDK for JavaScript を使用して UID2 Token を生成するには、Client-Side または Server-Side の2つの方法があります。 @@ -47,7 +60,7 @@ SDK for JavaScript には、自動の API key、Client key とも呼ばれます +- Client secret、参加者と UID2 Service のみが知っている値 + +:::important +これらの値を安全に保管することが非常に重要です。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +::: ## Client-Server Mobile Integration Data Flow Overview @@ -109,7 +123,9 @@ Token Refresh を Server-Side で管理し、クライアント/モバイルサ ### Using the UID2 Integration Environment -デフォルトでは、SDK は UID2 本番環境で動作するように構成されています: `https://prod.uidapi.com`。代わりに UID2 インテグレーション環境を使用する場合は、UID2Manager の初期化に次の URL を指定してください: +デフォルトでは、この SDK は UID2 本番環境: `https://prod.uidapi.com` で動作するように構成されています。代わりに UID2 インテグレーション環境を使用する場合は、UID2Manager の初期化時に次の URL を指定してください。 + +各環境の認証情報を取得する方法については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください。 @@ -241,7 +257,7 @@ UID2Manager への ID の追加が成功した場合、このメソッドは次 - **Android Java**: `UID2Manager.getInstance().getCurrentIdentityStatus()` - **Android Kotlin**: `UID2Manager.getInstance().currentIdentityStatus()` - **iOS**: `UID2Manager.shared.identityStatus` -- ロギングを有効にして詳細情報を取得します: [Enable Logging](#enable-logging) を参照してください。 +- ロギングを有効 (`isLoggingEnabled` を `true` に設定する) にして詳細情報を取得します: [Enable Logging](#enable-logging) を参照してください。 - UID2 identity 内の Advertising Token の有効期限が切れていて、Refresh Token も有効期限が切れているため、SDK がトークンをリフレッシュできません。 ID が無効の場合、[Implement Server-Side Token Generation](#implement-server-side-token-generation) に従って新しい identity を生成し、その結果をモバイルアプリの UID2Manager に再度渡してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md index 319bc0f21..655c954c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-client-side.md @@ -15,6 +15,7 @@ import ExampleAdvertisingToken from '../snippets/_example-advertising-token.mdx' import EnableLogging from '../snippets/_mobile-docs-enable-logging.mdx'; import PrebidMobileSDK from '../snippets/_mobile_docs_prebid-mobile.mdx'; import ErrorResponseStates from '../snippets/_mobile-docs-error-response-states.mdx'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # UID2 Client-Side Integration Guide for Mobile @@ -190,15 +191,31 @@ see UID2SDKDevelopmentApp/UID2SDKDevelopmentApp/Info.plist 必要に応じて、デフォルトの Subscription ID と public key を割り当てられた値に変更し、UID2 本番環境に接続することもできます。詳細は [Optional: Specifying the API Base URL to Reduce Latency](#optional-specifying-the-api-base-url-to-reduce-latency) を参照してください。 +## Integrating with Single Sign-On (SSO) + + + ## Complete UID2 Account Setup and Configure Account -アカウントをセットアップするには、[Account Setup](../getting-started/gs-account-setup.md) に記載されている手順に従ってください。アカウントセットアッププロセスの一環として、UID2 mobile SDK とインテグレーションするすべてのモバイルアプリの app names のリストを提供する必要があります。これには、以下の値が該当します: +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +モバイル Client-Side インテグレーションには、UID2 Portal の [Client-Side Integration](../portal/client-side-integration.md) ページで以下の値を設定する必要があります: -- Android Application ID -- iOS Bundle Identifier -- iOS App Store ID +- Subscription ID と Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 -アカウントのセットアップが完了すると、UID2 サーバーがユーザーを識別するために使用する 2 つの値であるクライアントキーペアが発行されます: Subscription ID と Public key。これらの値はあなたに固有で、UID2 モジュールの設定に使用します。詳細は [Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key) を参照してください。 +- モバイルアプリ ID : 該当する以下の値のいずれか: + + - Android Application ID + - iOS Bundle Identifier + - iOS App Store ID + + 詳細は、[Adding and Managing Mobile App IDs](../portal/client-side-integration.md#adding-and-managing-mobile-app-ids) を参照してください。 + + ## Add the UID2 Mobile SDK to Your Mobile App @@ -211,7 +228,7 @@ SDK をアプリに追加したら、SDK を使用して UID2 Token を生成す ### Using the UID2 Integration Environment -デフォルトでは、SDK は UID2 本番環境で動作するように構成されています: `https://prod.uidapi.com`。代わりにインテグレーション環境を使用する場合は、`UID2Manager` の初期化に次の URL を指定してください: +デフォルトでは、この SDK は UID2 本番環境: `https://prod.uidapi.com` で動作するように構成されています。UID2 インテグレーション環境を使用する場合は、(認証情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)、`UID2Manager` の初期化する際に次の URL を指定してください: @@ -593,12 +610,12 @@ UID2Manager.shared.getAdvertisingToken() - **iOS**: `UID2Manager.shared.identityStatus` UID2 から DII がオプトアウトされている可能性があります: 詳細については [When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk) を参照してください。 -- ロギングを有効にして詳細情報を取得できます: [Enable Logging](#enable-logging) を参照してください。 +- ロギングを有効 (`isLoggingEnabled` を `true` に設定する) にして詳細情報を取得できます: [Enable Logging](#enable-logging) を参照してください。 - UID2 identity 内の Advertising Token の有効期限が切れていて、Refresh Token も有効期限が切れているため、SDK がトークンをリフレッシュできません。 Identity が無い場合は、`generateIdentity` メソッドを再度呼び出す必要があります: 詳細については [Configure the UID2 Mobile SDK](#configure-the-uid2-mobile-sdk) を参照してください。 -詳しくは、[When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk)(次項) を参照してください。 +詳細は、[When to Pass DII into the SDK](#when-to-pass-dii-into-the-sdk)(次項) を参照してください。 ## When to Pass DII into the SDK diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md index 117b33e2d..e8b7e309f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-mobile-overview.md @@ -9,10 +9,11 @@ displayed_sidebar: sidebarPublishers --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # UID2 Mobile Integration Overview for Android and iOS -このガイドは、SDK for Android または SDK for iOS を使用して UID2 と統合したいモバイルアプリのパブリッシャー向けのインテグレーションオプションの概要です。 +このガイドは、SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションオプションの概要です。 :::note このガイドの、**UID2 mobile SDKs** は、SDK for Android と SDK for iOS の両方を含むグループ用語です。 @@ -28,6 +29,10 @@ UID2 は、Android/iOS 向けの SDK を提供しており、次の機能をサ さらに、UID2 は、一部の機能に対して代替手段を提供し、UID2 Google GMA/IMA プラグインなどの補完製品も提供しています。利用可能なオプションについては、個々のガイドで説明されています: [Integration Overview: High-Level Steps](#integration-overview-high-level-steps) を参照してください。 +## Integrating with Single Sign-On (SSO) + + + ## Integration Overview: High-Level Steps UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレーションするには、次の手順を完了する必要があります: @@ -44,7 +49,7 @@ UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレ 1. オプションで、[Google GMA SDK](https://developers.google.com/ad-manager/mobile-ads-sdk) および [Google IMA SDK](https://developers.google.com/interactive-media-ads/) とのインテグレーションに UID2 GMA/IMA プラグインを構成します。 -詳細については、次のガイドを参照してください: +詳細は、次のガイドを参照してください: - [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) - [Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) @@ -59,6 +64,14 @@ UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレ 1. UID2 Token をどのように使いたいですか？ [Sending the Token to the Bidstream](#sending-the-token-to-the-bidstream) を参照してください。 +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションんするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントのセットアップが完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするためのリンクと手順が送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細は、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal での手順は、実装が Client-Side、Client-Server、または Server-Side であるかによって異なります。各インテグレーションガイドに具体的な手順が記載されています。概要は、[Client-Side or Client-Server Integration?](#client-side-or-client-server-integration) を参照してください。 + ### Client-Side or Client-Server Integration? UID2 mobile SDK を使用して UID2 とインテグレーションするためのオプションは、次の表にまとめられています。最適な Integration approach を選択してください。 @@ -72,12 +85,29 @@ UID2 mobile SDK を使用して UID2 とインテグレーションするため ### Generating, Storing, and Refreshing the UID2 Token -以下の表は、UID2 Token の管理に関するモバイルインテグレーションオプションをまとめたもので、トークンの生成、保存、およびリフレッシュを含みます。各オプションのドキュメントへのリンクが含まれています。 - -| UID2 Mobile Implementation Option | SDK Doc | Implementation Guide | -| :--- | :---| :---| -| UID2 Android SDK | [SDK for Android Reference Guide](../sdks/sdk-ref-android.md) | 以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
| -| UID2 iOS SDK | [SDK for iOS Reference Guide](../sdks/sdk-ref-ios.md) | 以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
| +以下の表は、UID2 Token の生成、保存、リフレッシュを管理するためのモバイルインテグレーションオプションをまとめたものです。各オプションのドキュメントへのリンクが含まれています。 + + + + + + + + + + + + + + + + + + + + + +
UID2 Mobile Implementation OptionSDK DocImplementation Guide
UID2 Android SDK[SDK for Android Reference Guide](../sdks/sdk-ref-android.md)以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
UID2 iOS SDK[SDK for iOS Reference Guide](../sdks/sdk-ref-ios.md)以下のいずれか:
  • [UID2 Client-Side Integration Guide for Mobile](../guides/integration-mobile-client-side.md)
  • [UID2 Client-Server Integration Guide for Mobile](../guides/integration-mobile-client-server.md)
### Sending the Token to the Bidstream @@ -169,4 +199,4 @@ https://prod.uidapi.com/ops/healthcheck SDK はバックグラウンドで UID2 Token をリフレッシュしようとします。IOException などのエラーが発生した場合、SDK は複数回リトライします。リトライが成功しない場合、この例外が表示されます。 -ログを有効にすると、別のトラブルシューティングステップが可能になります。詳細については、[Enable Logging](integration-mobile-client-side.md#enable-logging) を参照してください。 +ログを有効にすると、別のトラブルシューティングステップが可能になります。詳細は、[Enable Logging](integration-mobile-client-side.md#enable-logging) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md index 980e6c31d..e8eb05e3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-private-operator.md @@ -60,7 +60,7 @@ Private Operator の基本的なワークフローは次のとおりです: 1. Operator が認証プロセスに合格すると、Core Service は、起動に必要な情報を取得するための安全な S3 URL を Private Operator に提供します。 -1. Private Operator は、UID2 の処理に必要な情報 (ソルト、暗号化キー、およびユーザーのオプトアウトレコードなど) を Amazon S3 から取得します。セキュリティの詳細については、[Private Operator Security](#private-operator-security) を参照してください。 +1. Private Operator は、UID2 の処理に必要な情報 (ソルト、暗号化キー、およびユーザーのオプトアウトレコードなど) を Amazon S3 から取得します。セキュリティの詳細は、[Private Operator Security](#private-operator-security) を参照してください。 1. Operator が再起動されると、再度認証プロセスを実行し、新しいセキュリティ情報を取得します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md index 952018b1a..fc760efda 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-options-publisher-web.md @@ -72,7 +72,7 @@ Client-Side で UID2 Token を生成することには、次のような利点 - コードは消費者のウェブページ上の Client-Side で実行され、Server-Side のコーディングは必要ありません。 - Prebid.js のインテグレーションにより、すべての機能が処理されます—トークンの生成、トークンのリフレッシュ、トークンのビッドストリームへの受け渡しなど。Prebid.js 8.21.0 以降を使用している場合、これが最もシンプルで高速な実装オプションです。 -Client-Side のインテグレーションを選択した場合、アカウント設定の一環として、セキュリティのためにルートレベルドメインのリストを提供する必要があります。詳細については、アカウント設定ページの [Client-Side Web Integrations](../getting-started/gs-account-setup.md#client-side-web-integrations) を参照してください。 +Client-Side のインテグレーションを選択した場合、アカウント設定の一環として、セキュリティのためにルートレベルドメインのリストを提供する必要があります。詳細は、アカウント設定ページの [Client-Side Web Integrations](../getting-started/gs-account-setup.md#client-side-web-integrations) を参照してください。 次の表は、Client-Side で UID2 Token を生成したいパブリッシャーが、ウェブページから UID2 Token を生成するためのオプションと、それに対応するドキュメントリソースをまとめたものです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md index 21f14122d..d01b77aab 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-server.md @@ -2,7 +2,7 @@ title: UID2 Client-Server Integration Guide for Prebid.js sidebar_label: Client-Server Integration for Prebid.js pagination_label: UID2 Client-Server Integration for Prebid.js -description: Client-Server の Prebid.js インテグレーションの設定に関する情報。 +description: Client-Server での Prebid.js インテグレーションの設定に関する情報。 hide_table_of_contents: false sidebar_position: 04 --- @@ -10,6 +10,7 @@ sidebar_position: 04 import Link from '@docusaurus/Link'; import AddPrebidjsToYourSite from '../snippets/_prebid-add-prebidjs-to-your-site.mdx'; import StoreUID2TokenInBrowser from '../snippets/_prebid-storing-uid2-token-in-browser.mdx'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # UID2 Client-Server Integration Guide for Prebid.js @@ -38,6 +39,10 @@ Prebid と UID2 のインテグレーション方法に関する情報は、以 GWH note 12/14/23 updated 2/7/25: we have a client-side example for Prebid.js but no client-server example. --> +## Integrating with Single Sign-On (SSO) + + + ## Integration Overview: High-Level Steps 以下のステップを完了する必要があります: @@ -48,9 +53,22 @@ GWH note 12/14/23 updated 2/7/25: we have a client-side example for Prebid.js bu ## Complete UID2 Account Setup and Configure Account -[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了します。 +Prebid.js を使用して UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントがまだ作成されていない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +Client-Server インテグレーションの場合、UID2 Portal の [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: + +- API key、Client Key とも呼ばれます。 +- Client secret、参加者と UID2 Service のみが知る値。 + +:::important +これらの値を安全に保管することが非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +::: -アカウントのセットアップが完了すると、固有の API Key と クライアントシークレットが発行されます。ここれらの値はアカウント独自のもので、安全に管理することが重要です。詳細は [API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 + ## Add Prebid.js to Your Site @@ -69,7 +87,7 @@ UID2 Prebid モジュールを設定して、以下の2つのアクションを Prebid の Client-Server インテグレーションの場合、最初のステップは、サーバー上で UID2 Token を生成することです。その後、トークンを Prebid に渡して RTB ビッドストリームに送信します。 -手順や例を含む詳細については、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 +手順や例を含む詳細は、[Server-Side Token Generation](../ref-info/ref-server-side-token-generation.md) を参照してください。 トークンを生成するには、いずれかの SDK または [POST /token/generate](../endpoints/post-token-generate.md) エンドポイントを呼び出します。トークンを示す API レスポンスの例については、[Sample Token Response Object](#sample-token-response-object) を参照してください。`Identity` レスポンスを Prebid に渡す必要があります。 @@ -239,7 +257,7 @@ Prebid の実施を計画する際には、以下を考慮してください: - リフレッシュされたトークンを生成するために使用された元のトークンと一致しない新しいトークンを提供した場合、モジュールは保存されているすべてのトークンを破棄し、代わりに新しいトークンを使用し、リフレッシュされた状態を維持します。 -- インテグレーションテストでは、`params.uid2ApiBase` を `"https://operator-integ.uidapi.com"` に設定します。この値は、トークンを生成する環境と同じ環境 (本番環境またはインテグレーション環境) に設定しなければなりません。 +- インテグレーションテストでは、`params.uid2ApiBase` を `"https://operator-integ.uidapi.com"` に設定します。トークンの生成に使用する環境(本番環境またはインテグレーション環境)と同じ値に設定する必要があります(資格情報については、[Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照してください)。 - Prebid.js client-server インテグレーションの場合、クライアントサイドインテグレーション機能を無効にして、より小さな Prebid.js ビルドを作成できます。これを行うには、`--disable UID2_CSTG` フラグを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md index 13107fcea..1390c95da 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid-client-side.md @@ -2,7 +2,7 @@ title: UID2 Client-Side Integration Guide for Prebid.js sidebar_label: Client-Side Integration for Prebid.js pagination_label: UID2 Client-Side Integration for Prebid.js -description: Client-Side の Prebid.js インテグレーションの設定に関する情報。 +description: Client-Side での Prebid.js インテグレーションの設定に関する情報。 hide_table_of_contents: false sidebar_position: 04 --- @@ -10,6 +10,7 @@ sidebar_position: 04 import Link from '@docusaurus/Link'; import AddPrebidjsToYourSite from '../snippets/_prebid-add-prebidjs-to-your-site.mdx'; import StoreUID2TokenInBrowser from '../snippets/_prebid-storing-uid2-token-in-browser.mdx'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # UID2 Client-Side Integration Guide for Prebid.js @@ -32,6 +33,10 @@ UID2 Prebid.js Client-Side インテグレーション例は、以下のリン - コード: [Example Prebid.js UID2 Integration](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example) - ランニングサイト: [UID2 Prebid.js Client-Side Integration Example](https://unifiedid.com/examples/cstg-prebid-example/) +## Integrating with Single Sign-On (SSO) + + + ## Integration Overview: High-Level Steps 以下のステップを完了する必要があります: @@ -42,14 +47,24 @@ UID2 Prebid.js Client-Side インテグレーション例は、以下のリン ### Complete UID2 Account Setup and Configure Account -[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了します。Client-Side 実装のアカウント設定プロセスの一環として、Prebid.js で使用するサイトのドメイン名のリストを提供する必要があります。 +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、UID2 ポータルにアクセスするための手順とリンクが送信されます。UID2 ポータルでは、本番環境のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +Client-Side インテグレーションには、UID2 ポータルの [Client-Side Integration](../portal/client-side-integration.md) ページで以下の値を設定する必要があります: + +- Subscription ID と Public Key: [Adding and Managing Key Pairs](../portal/client-side-integration.md#adding-and-managing-key-pairs) を参照してください。 + +- Prebid.js を使用するサイトの **domain names** のリスト: [Adding and Managing Root-Level Domains](../portal/client-side-integration.md#adding-and-managing-root-level-domains) を参照してください。 + + :::tip アカウント設定に必要なのは、ルートレベルのドメインだけです。たとえば、Prebid.js で UID2 を example.com、shop.example.com、example.org で使用する場合、ドメイン名 example.com と example.org だけを指定します。 ::: -アカウントのセットアップが完了すると、UID2 サーバーがユーザーを識別するために使用する 2 つの値であるクライアントキーペアが発行されます: Subscription ID と Public key。これらの値はあなたに固有で、UID2 モジュールの設定に使用します。詳細は [Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key) を参照してください。 - ### Add Prebid.js to Your Site @@ -103,7 +118,7 @@ const baseConfig = { ``` :::note -この例では、UID2 本番環境を使用することを想定しています。インテグレーションテストでは、`params.uid2ApiBase` を `'https://operator-integ.uidapi.com'` に設定して UID2 インテグレーション環境を使用します。UID2 インテグレーション環境のトークンはビッドストリームに渡すには無効です。インテグレーション環境では、**Subscription ID** と **public key** の値が異なります。 +この例では、UID2 本番環境を使用していると仮定しています。インテグレーションテスト中は、`params.uid2ApiBase` を `'https://operator-integ.uidapi.com'` に設定して UID2 インテグレーション環境を使用してください (資格情報については [Getting Your Credentials](../getting-started/gs-credentials.md#getting-your-credentials) を参照)。UID2 インテグレーション環境からのトークンはビッドストリームに渡すために有効ではありません。インテグレーション環境では、異なる **Subscription ID** と **public key** の値があります。 ::: ## Storing the UID2 Token in the Browser diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md index 11445453f..56bb6b551 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-prebid.md @@ -9,6 +9,7 @@ displayed_sidebar: sidebarPublishers --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; import StoreUID2TokenInBrowser from '../snippets/_prebid-storing-uid2-token-in-browser.mdx'; # UID2 Integration Overview for Prebid @@ -27,11 +28,15 @@ UID2 は、以下をサポートする Prebid.js module を提供しています さらに柔軟性を高めるため、UID2 は JavaScript SDK など、一部の機能や補完的なプロダクトの代替手段も提供しています。 :::caution -UID2 は GDPR が適用される場所では使用しないように設計されています。このモジュールは渡された同意データをチェックし、`gdprApplies` フラグが `true` に設定されている場合は動作しません。 +UID2 は GDPR が適用される場所では使用しないように設計されています。このモジュールは渡された同意データをチェックし、`gdprApplies` フラグが `true` に設定されている場合は動作しません。 ::: +## Integrating with Single Sign-On (SSO) + + + ### Generating the UID2 Token DII へのアクセスに応じて、Prebid.js で使用する UID2 Token を生成する方法は次の表のように 2 種類あります 。 @@ -53,14 +58,14 @@ Prebid.js UID2 Module は、UID2 Token を自動的にリフレッシュする ### Passing the UID2 Token to the Bidstream -UID2 module を設定するには `pbjs.setConfig` を呼び出します。サポートされているパラメータの詳細については、実装に適用されるガイドを参照してください: +UID2 module を設定するには `pbjs.setConfig` を呼び出します。サポートされているパラメータの詳細は、実装に適用されるガイドを参照してください: - [UID2 Client-Side Integration Guide for Prebid.js](integration-prebid-client-side.md) - [UID2 Client-Server Integration Guide for Prebid.js](integration-prebid-client-server.md) UID2 module が設定されると、ユーザーの UID2 Token を管理し、ユーザーのブラウザに保存します。 -Client-Side または Server-Side でクライアントリフレッシュモードを使用してトークンを生成する場合、ユーザーのブラウザでサイトが開いている間は、モジュールが自動的にトークンをリフレッシュします。しかし、Server-Side でトークンのリフレッシュを管理するオプションもあります。詳細については、Server-Side インテグレーションガイドの [Refreshing a UID2 Token](integration-prebid-client-server.md#refreshing-a-uid2-token) を参照してください。Client-Side のインテグレーションソリューションには、トークンの自動リフレッシュが含まれています。 +Client-Side または Server-Side でクライアントリフレッシュモードを使用してトークンを生成する場合、ユーザーのブラウザでサイトが開いている間は、モジュールが自動的にトークンをリフレッシュします。しかし、Server-Side でトークンのリフレッシュを管理するオプションもあります。詳細は、Server-Side インテグレーションガイドの [Refreshing a UID2 Token](integration-prebid-client-server.md#refreshing-a-uid2-token) を参照してください。Client-Side のインテグレーションソリューションには、トークンの自動リフレッシュが含まれています。 ### Integration Overview: High-Level Steps diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md index e18570fe1..9d2293fc0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-publisher-server-side.md @@ -8,6 +8,7 @@ sidebar_position: 03 --- import Link from '@docusaurus/Link'; +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; # Publisher Integration Guide, Server-Side @@ -29,9 +30,9 @@ UID2 と UID2 Token を使用してクライアントのアイデンティティ ## Introduction -このガイドでは、Client-Side または Server-Side SDK を使用せずインテグレーションを行う場合に考慮する必要がある [basic steps](#integration-steps) について説明します。例えば、以下のようなことを決定する必要があります: +このガイドでは、Client-Side または Server-Side SDK を使用せずインテグレーションを行う場合に考慮する必要がある [basic steps](#integration-steps) について説明します。たとえば、以下のようなことを決定する必要があります: -- メールアドレスまたは電話番号を取得する機会を実装する: 例えば、プロモーションの交換、サインアップとサブスクリプション、またはマーケティングフォームの記入。 +- メールアドレスまたは電話番号を取得する機会を実装する: たとえば、プロモーションの交換、サインアップとサブスクリプション、またはマーケティングフォームの記入。 - UID2 ID 情報を管理し、ターゲティング広告に使用する - UID2 Token をリフレッシュする - ID が欠落している場合の処理 @@ -39,11 +40,30 @@ UID2 と UID2 Token を使用してクライアントのアイデンティティ [FAQs](#faqs) も参照してください。 +## Integrating with Single Sign-On (SSO) + + + +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、UID2 ポータルにアクセスするための手順とリンクが送信されます。UID2 ポータルでは、本番環境のための [credentials](../getting-started/gs-credentials.md) を作成し、提供する必要がある追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +Server-Side インテグレーションの場合、UID2 ポータルの [API Keys](../portal/api-keys.md) ページで以下の値を設定する必要があります: + +- API key、Client Key とも呼ばれます、 +- Client secret、参加者と UID2 Service のみが知る値。 + +:::important +これらの値を安全に保管することが非常に重要です。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +::: + ## Integration Steps 以下の図は、ユーザーがパブリッシャーと UID2 Token を確立するために必要なステップと、UID2 Token が RTB ビッドストリームとどのようにインテグレーションされるかを概説したものです。 -Server-Side SDK を使用している場合、SDK はエンドポイントに関連するすべてのステップを処理します。例えば、Step 1-d では、発行者はユーザーの DII をトークン生成サービスに送信します。 +Server-Side SDK を使用している場合、SDK はエンドポイントに関連するすべてのステップを処理します。たとえば、Step 1-d では、発行者はユーザーの DII をトークン生成サービスに送信します。 ![Publisher Flow](images/integration-publisher-server-side-mermaid.png) @@ -72,7 +92,7 @@ Step 1-c で認証が行われい、パブリッシャーがユーザーのメ ### Bid Using a UID2 Token -UID2 ID 情報をどのように管理し、ターゲティング広告に使用したいかを検討する必要があります。例えば、返された UID2 token を SSP に渡す等。 +UID2 ID 情報をどのように管理し、ターゲティング広告に使用したいかを検討する必要があります。たとえば、返された UID2 token を SSP に渡す等。 | Step | Endpoint | Description | | :--- | :--- | :--- | @@ -86,7 +106,7 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー `POST /token/refresh` エンドポイントを使用して、常に有効で最新の UID2 Token を持つようにします。UID2 ローテーションと同期させるには、UID2 Token をリフレッシュする必要があります。さらに、トークンリフレッシュプロセスではユーザーのオプトアウトステータスをチェックし、ユーザーがオプトアウトしている場合は新しいトークンを送信しません。これによりトークンリフレッシュチェーンが終了します。その UID2 Token を二度と使用してはなりません。 -UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細については、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 +UID2 の Opt-out ワークフローとユーザーが Opt-out する方法の詳細は、[User Opt-Out](../getting-started/gs-opt-out.md) を参照してください。 | Step | Endpoint | Description | | :--- | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md index cad14481c..540c8b1cf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-snowflake.md @@ -17,6 +17,10 @@ UID2 の以下のリストが Snowflake marketplace で入手可能です: - 広告主向け: [Unified ID 2.0: Advertiser Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTMV/unified-id-2-0-unified-id-2-0-advertiser-identity-solution?originTab=provider&providerName=Unified+ID+2.0) - データプロバイダー向け: [Unified ID 2.0: Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN0/unified-id-2-0-unified-id-2-0-data-provider-identity-solution?originTab=provider&providerName=Unified+ID+2.0) +:::tip +広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要については、[Advertiser/Data Provider Integration Overview](integration-advertiser-dataprovider-overview.md) を参照してください。 +::: + ## Functionality 次の表は、UID2 Snowflake インテグレーション で利用可能な機能をまとめたものです。 @@ -82,7 +86,7 @@ UID2 Share へのアクセスを要求するには、次の手順を実行しま 非推奨の関数を使用していて、新しい関数への移行の手助けが必要な場合は、[Migration Guide](#migration-guide) を参照してください。 ::: -再生成が必要な UID2 を特定するには、UID Share から `UID2_SALT_BUCKETS` ビューを使用します。詳しくは、[Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s) を参照してください。 +再生成が必要な UID2 を特定するには、UID Share から `UID2_SALT_BUCKETS` ビューを使用します。詳細は、[Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s) を参照してください。 UID2 Sharing 参加者には、以下の機能も利用できます: - `FN_T_UID2_ENCRYPT` (See [Encrypt Tokens](#encrypt-tokens)) @@ -562,7 +566,7 @@ raw UID2 を UID2 Token に暗号化するには、関数 `FN_T_UID2_ENCRYPT` | `NULL` | The raw UID2 was successfully encrypted. | | `MISSING_OR_INVALID_RAW_UID2` | raw UID2 の暗号化に成功しました。 | | `INVALID_RAW_UID2` | raw UID2 が無効です。 | -| `MISMATCHING_IDENTITY_SCOPE` | raw UID2 が不正な ID スコープに属している。例えば、UID2 が期待されているところに EUID が渡されているなど。| +| `MISMATCHING_IDENTITY_SCOPE` | raw UID2 が不正な ID スコープに属している。たとえば、UID2 が期待されているところに EUID が渡されているなど。| | `NOT_AUTHORIZED_FOR_MASTER_KEY` | 呼び出し元が必要な 暗号化キー にアクセスできません。UID2 の管理者に連絡してください。 | | `NOT_AUTHORIZED_FOR_SITE_KEY` | 呼び出し元が必要な暗号化キーにアクセスできません。UID2 の管理者に連絡してください。 | @@ -638,7 +642,7 @@ UID2 Token を raw UID2 に復号するには、関数 `FN_T_UID2_DECRYPT` を | :--- | :--- | :--- | | `UID2` | TEXT | 値は次のいずれかです:
  • 復号化成功: UID2 Token に対応する raw UID2。
  • 復号化失敗: `NULL`.
| | `SITE_ID` | INT | 値は次のいずれかです:
  • 復号化成功: トークンを暗号化した UID2 参加者の識別子。
  • 復号化失敗: `NULL`.
| -| `DECRYPTION_STATUS` | TEXT | 値は次のいずれかです:
  • 復号化成功: `NULL`.
  • 暗号化失敗: UID2 Token が復号化されなかった理由。例えば、`EXPIRED_TOKEN` です。
    詳細は [Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column) を参照してください。
| +| `DECRYPTION_STATUS` | TEXT | 値は次のいずれかです:
  • 復号化成功: `NULL`.
  • 暗号化失敗: UID2 Token が復号化されなかった理由。たとえば、`EXPIRED_TOKEN` です。
    詳細は [Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column) を参照してください。
| :::note UID2 Token がうまく復号化できない場合、この関数は行を返しません。 @@ -725,7 +729,7 @@ select a.ID, b.UID2, b.SITE_ID, CASE WHEN b.UID2 IS NULL THEN 'DECRYPT_FAILED' E #### Sender Instructions 1. `AUDIENCE_WITH_UID2_TOKENS` という名前の新しいテーブルを作成します。 - 2. `AUDIENCE_WITH_UID2S` テーブルの raw UID2 を暗号化し、その結果を `AUDIENCE_WITH_UID2_TOKENS` テーブルに格納します。例えば、以下のクエリはこのタスクを達成するのに役立ちます: + 2. `AUDIENCE_WITH_UID2S` テーブルの raw UID2 を暗号化し、その結果を `AUDIENCE_WITH_UID2_TOKENS` テーブルに格納します。たとえば、以下のクエリはこのタスクを達成するのに役立ちます: ``` insert into AUDIENCE_WITH_UID2_TOKENS select a.ID, t.UID2_TOKEN from AUDIENCE_WITH_UID2S a, lateral UID2_PROD_ADV_SH.ADV.FN_T_UID2_ENCRYPT(a.RAW_UID2) t; ``` @@ -740,7 +744,7 @@ select a.ID, b.UID2, b.SITE_ID, CASE WHEN b.UID2 IS NULL THEN 'DECRYPT_FAILED' E 1. 送信者がアクセス権を提供した安全な共有からデータベースを作成します。 2. `RECEIVED_AUDIENCE_WITH_UID2` という新しいテーブルを作成します。 - 3. 共有された `AUDIENCE_WITH_UID2_TOKENS` テーブルからトークンを復号化し、その結果を `RECEIVED_AUDIENCE_WITH_UID2` テーブルに格納します。例えば、以下のようなクエリが考えられます: + 3. 共有された `AUDIENCE_WITH_UID2_TOKENS` テーブルからトークンを復号化し、その結果を `RECEIVED_AUDIENCE_WITH_UID2` テーブルに格納します。たとえば、以下のようなクエリが考えられます: ``` insert into RECEIVED_AUDIENCE_WITH_UID2 select a.ID, b.UID2, CASE WHEN b.UID2 IS NULL THEN 'DECRYPT_FAILED' ELSE b.DECRYPTION_STATUS END as DECRYPTION_STATUS diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md index c42ca5fc4..a5f976251 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-android.md @@ -27,6 +27,14 @@ UID2 Google Mobile Ads (GMA) Plugin for Android は、[Google Mobile Ads (GMA) S - [https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-gma](https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-gma) +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side or Client-Server Integration?](integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + ## Requirements このプラグインを実行するには、以下をインストールします: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md index 558f35c70..2e09f982c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md @@ -27,6 +27,14 @@ UID2 Google Mobile Ads (GMA) Plugin for iOS は、[Google Mobile Ads (GMA) SDK]( - [https://github.com/IABTechLab/uid2-ios-plugin-google-gma](https://github.com/IABTechLab/uid2-ios-plugin-google-gma) +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side or Client-Server Integration?](integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + ## Requirements このプラグインを実行するには、以下をインストールします: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md index f6f085531..899242da5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-android.md @@ -27,6 +27,14 @@ UID2 Interactive Media Ads (IMA) Plugin for Android は、[Google IMA SDK for An - [https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-ima](https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-ima) +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side or Client-Server Integration?](integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + ## Requirements このプラグインを実行するには、以下をインストールします: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md index 1cfb71df1..be5bb00f6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-ima-ios.md @@ -27,6 +27,14 @@ UID2 Interactive Media Ads (IMA) Plugin for iOS は、[Google IMA SDK for iOS](h - [https://github.com/IABTechLab/uid2-ios-plugin-google-ima](https://github.com/IABTechLab/uid2-ios-plugin-google-ima) +## Complete UID2 Account Setup and Configure Account + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + +アカウントの初期設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。ここで、本番環境用の [credentials](../getting-started/gs-credentials.md) を作成し、必要に応じて追加の値を設定できます。詳細については、[Getting Started with the UID2 Portal](../portal/portal-getting-started.md) を参照してください。 + +UID2 Portal で実行する手順は、実装が　Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、[Client-Side or Client-Server Integration?](integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + ## Requirements このプラグインを実行するには、以下をインストールします: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md index 52b8c7112..be2e7fc89 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-aws-marketplace.md @@ -13,7 +13,7 @@ import AttestFailure from '../snippets/_private-operator-attest-failure.mdx'; # UID2 Private Operator for AWS Integration Guide -UID2 Operator は、UID2 エコシステム内の API サーバーです。詳細については、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 +UID2 Operator は、UID2 エコシステム内の API サーバーです。詳細は、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 AWS Marketplace で稼働する Private Operator Service の場合、UID2 Operator ソリューションは [AWS Nitro](https://aws.amazon.com/ec2/nitro/) Enclave テクノロジーで強化されています。これは、UID2 情報を不正なアクセスから保護するための追加のセキュリティ対策です。 @@ -108,10 +108,10 @@ AWS で 1 つまたは複数の UID2 Operator をサブスクライブしてデ | Name | Type | Description | |:------|:------|:-------------| -| `KMSKey` | `AWS::KMS::Key` | 秘密暗号化用のキー (設定文字列用) です。 | +| `KMSKey` | `AWS::KMS::Key` | AWS Secrets Managerで秘密暗号化に使う Custom KMS key です。 | | `SSMKeyAlias` | `AWS::KMS::Alias` | [KMS](https://aws.amazon.com/kms/)キーに簡単にアクセスする方法を提供するエイリアスです。 | -| `TokenSecret` | `AWS::SecretsManager::Secret` | Operator Key を含む暗号化されたコンフィギュレーションです。 | -| `WorkerRole` | `AWS::IAM::Role` | UID2 Operator が実行する IAM ロールです。ロールは、設定キーへのアクセスを提供します。 | +| `TokenSecret` | `AWS::SecretsManager::Secret` | Operator Key を保存するための Secrets Manager のシークレットです。 | +| `WorkerRole` | `AWS::IAM::Role` | UID2 Operator が実行する IAM ロールです。このローづで AWS Secrets manager にアクセスして Operator Key を取得できます。 | | `WorkerInstanceProfile` | `AWS::IAM::InstanceProfile` | Operator EC2 インスタンスにアタッチする Worker Role を持つインスタンスプロファイルです。 | | `SecurityGroup` | `AWS::EC2::SecurityGroup` | オペレーターインスタンスに対するルールを提供するセキュリティグループポリシーです。[Security Group Policy](#security-group-policy) を参照してください。| | `LaunchTemplate` | `AWS::EC2::LaunchTemplate` | すべての設定が配置された起動テンプレートです。このテンプレートから新しい UID2 Operator インスタンスを起動できます。| @@ -134,9 +134,9 @@ AWS で 1 つまたは複数の UID2 Operator をサブスクライブしてデ | Port Number | Direction | Protocol | Description | | ----------- | --------- | -------- | ------ | -| 80 | Inbound | HTTP | Healthcheck エンドポイント `/ops/healthcheck` を含むすべての UID2 API を提供します。
すべてが稼働している場合、エンドポイントは HTTP 200 を返し、レスポンスボディは `OK` となります。詳しくは、[Checking UID2 Operator Status](#checking-uid2-operator-status) を参照してください。 | +| 80 | Inbound | HTTP | Healthcheck エンドポイント `/ops/healthcheck` を含むすべての UID2 API を提供します。
すべてが稼働している場合、エンドポイントは HTTP 200 を返し、レスポンスボディは `OK` となります。詳細は、[Checking UID2 Operator Status](#checking-uid2-operator-status) を参照してください。 | | 9080 | Inbound | HTTP | Prometheus metrics サービス (`/metrics`)。 | -| 443 | Outbound | HTTPS | UID2 Core Service を呼び出し、オプトアウトデータとキーストアを更新します。 | +| 443 | Outbound | HTTPS | UID2 Core Service、AWS S3 を呼び出し、オプトアウトデータとキーストア用のファイルをダウンロードします。 | ### VPC Chart @@ -216,7 +216,7 @@ UID2 Operator を AWS Marketplace にデプロイするには、以下の手順 2. **Create Load Balancer** をクリックします。 3. Load balancer typesページの **Application Load Balancer** セクションで、**Create** をクリックします。 4. UID2 **Load balancer name** を入力します。パブリックインターネットから UID2 API にアクセスする必要があるかどうかに応じて、**Internet-facing** または **Internal** スキームを選択します。 -5. ターゲットの **VPC** と、CloudFormationスタックで使用する少なくとも2つのサブネットを選択します。 +5. CloudFormation スタックを作成する際に使用した **VPC** を選択し、少なくとも2つのサブネットを選択します。 6. **Security groups** の下にある **Create new security group** をクリックし、以下を実行します: 1. `UID2SGALB` を **Security group name** として入力し、関連する **Description** も入力します。 2. **Inbound rules** の下で、**Add rule** をクリックし、要件に応じて **HTTPS** タイプと適切な **Source** を選択します。 @@ -252,7 +252,7 @@ UID2 Operator を AWS Marketplace にデプロイするには、以下の手順 ここでは、アップグレードについて紹介します: - 新しいバージョンの提供に関する情報は、[UID2 Operator on AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-wdbccsarov5la) のページで提供されます。 -- UID2 Operator をアップグレードするには、新しい CloudFormation スタックを作成します。詳しくは、[デプロイ](#deployment) を参照してください。 +- UID2 Operator をアップグレードするには、新しい CloudFormation スタックを作成します。詳細は、[デプロイ](#deployment) を参照してください。 :::tip スムーズな移行を行うには、まず新しいスタックを作成します。新しいスタックが起動し、サービスを提供する準備ができたら、古いスタックを削除してください。ロードバランサーを使用している場合は、まず新しいインスタンスを立ち上げて実行してから、DNS 名を以前のものから新しいものに変換してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md index 527c4ec45..a2ef5b274 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-guide-azure-enclave.md @@ -12,7 +12,7 @@ import ReleaseMatrix from '../snippets/_private-operator-release-matrix.mdx'; # UID2 Private Operator for Azure Integration Guide -UID2 Operator は、UID2 エコシステム内の API サーバーです。詳細については、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 +UID2 Operator は、UID2 エコシステム内の API サーバーです。詳細は、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 このガイドでは、Microsoft Azureの機密コンピューティングオプションである [Confidential Containers](https://learn.microsoft.com/en-us/azure/confidential-computing/confidential-containers) のインスタンスで、Private Operator として UID2 Operator Service をセットアップするための情報を提供します。Confidential Containers インスタンスは、データ整合性、データ機密性、およびコード整合性などの本質的な機能を提供する、ハードウェアでバックアップされた信頼できる実行環境（Trusted Execution Environment：TEE）で実行されます。 @@ -44,7 +44,7 @@ UID2 Private Operator をデプロイする前に、UID2 Service の Private Ope ### Install Azure CLI -Azure CLI をインストールします。詳細については、Azure ドキュメントの [Azure CLI のインストール方法](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) を参照してください。 +Azure CLI をインストールします。詳細は、Azure ドキュメントの [Azure CLI のインストール方法](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) を参照してください。 ### Get the Required Azure Permissions @@ -52,7 +52,7 @@ Azure CLI をインストールします。詳細については、Azure ドキ これが完了したら、リソースグループレベルでのコントリビューター権限のみが必要です。 -詳細については、Azure ドキュメントの [Azure roles](https://learn.microsoft.com/en-us/azure/role-based-access-control/rbac-and-directory-admin-roles#azure-roles) を参照してください。 +詳細は、Azure ドキュメントの [Azure roles](https://learn.microsoft.com/en-us/azure/role-based-access-control/rbac-and-directory-admin-roles#azure-roles) を参照してください。 前提条件のすべての手順が完了したら、UID2 Private Operator をデプロイする準備が整います。[Deployment](#deployment) を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md index 25a4d38e9..24f3df8f9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/operator-private-gcp-confidential-space.md @@ -12,7 +12,7 @@ import ReleaseMatrix from '../snippets/_private-operator-release-matrix.mdx'; # UID2 Private Operator for GCP Integration Guide -UID2 Operator は、UID2 エコシステムの API サーバーです。詳細については、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 +UID2 Operator は、UID2 エコシステムの API サーバーです。詳細は、[UID2 Operator](../ref-info/ref-operators-public-private.md) を参照してください。 このガイドでは、Google Cloud Platform（GCP）の機密コンピューティングオプションである [Confidential Space](https://cloud.google.com/confidential-computing#confidential-space) で　Private Operator　として UID2 Operator Service を設定する情報を提供します。Confidential Spaceは、Trusted Execution Environment（TEE）として知られるセキュアなクラウドベースのエンクレーブ環境で実行される、安全なクラウドベースのエンクレーブ環境です。 @@ -97,7 +97,7 @@ UID2 アカウント登録が完了し、gcloud CLI をインストールした 以下の環境が利用可能で、[deployment options](#deployment-options) の両方が両方の環境をサポートしています。 -ベストプラクティスは、本番環境にデプロイする前に、統合環境で実装をテストして検証することをです。 +ベストプラクティスは、本番環境にデプロイする前に、インテグレーション環境で実装をテストして検証することをです。 :::note 各環境ごとに個別の `{OPERATOR_KEY}` 値を受け取ります。正しいものを使用してください。`{OPERATOR_IMAGE}` 値は、両方の環境で同じです。 @@ -192,7 +192,7 @@ Terraform がインストールされていない場合は、[terraform.io](http | Name | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | - | `project_id` | `string` | `uid2-test` | yes | UID2 Operator を実行する GCP プロジェクトの ID。例えば、`UID2-Operator-Production`。 | + | `project_id` | `string` | `uid2-test` | yes | UID2 Operator を実行する GCP プロジェクトの ID。たとえば、`UID2-Operator-Production`。 | | `service_account_name` | `string` | `tf-test` | yes | GCP Confidential Space の UID2 Operator インスタンスに使用するサービスアカウントの名前。 | | `uid_operator_image` | `string` | `us-docker.pkg.dev/uid2-prod-project/iabtechlab/uid2-operator:{version_number}` | yes | コンフィギュレーションで使用する UID2 Private Operator for GCP の Docker イメージ URL。バージョン番号は、デプロイされるバージョンによって変わります。 | | `uid_operator_key` | `string` | n/a | yes | UID2 Operator Keyは、[UID2 Operator Account Setup](#uid2-operator-account-setup) で受け取ったものです。 | @@ -205,8 +205,8 @@ Terraform がインストールされていない場合は、[terraform.io](http | Name | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | | `ssl` | `bool` | `false`| no | ロードバランサが HTTPS を使うように設定するには、このフラグを `true` に設定します。
HTTPSを使う場合は `certificate` と `private_key` パラメータにも値を指定する必要があります。 | - | `certificate` | `string` | n/a | no | HTTPS 証明書の内容。証明書は PEM 形式でなければなりません。
例えば: `file('path/to/certificate.pem')`.
`ssl` が `true` に設定されている場合は必須です。
詳細は Terraform ドキュメントの [google_compute_ssl_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_ssl_certificate#certificate) を参照してください。 | - | `private_key` | `string` | n/a | no | HTTPS 証明書の秘密鍵の内容。秘密鍵は PEM 形式でなければならなりません
例えば: `file('path/to/private_key.pem')`.
`ssl` が `true` に設定されている場合は必須です。
詳細は Terraform ドキュメントの [google_compute_ssl_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_ssl_certificate#private_key) を参照してください。 | + | `certificate` | `string` | n/a | no | HTTPS 証明書の内容。証明書は PEM 形式でなければなりません。
たとえば: `file('path/to/certificate.pem')`.
`ssl` が `true` に設定されている場合は必須です。
詳細は Terraform ドキュメントの [google_compute_ssl_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_ssl_certificate#certificate) を参照してください。 | + | `private_key` | `string` | n/a | no | HTTPS 証明書の秘密鍵の内容。秘密鍵は PEM 形式でなければならなりません
たとえば: `file('path/to/private_key.pem')`.
`ssl` が `true` に設定されている場合は必須です。
詳細は Terraform ドキュメントの [google_compute_ssl_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_ssl_certificate#private_key) を参照してください。 | 3. (オプション) 次の表に示す追加の入力パラメータの名前と値を提供します。これらのパラメータは常にオプションですが、デフォルト値を変更して、より適切な要件に合わせることができます。 @@ -230,7 +230,7 @@ terraform apply `terraform apply` を実行すると、同じフォルダに次のファイルが生成されます: `terraform.tfstate`。このファイルは、マネージドインフラストラクチャと構成に関する状態情報を保存し、将来のメンテナンスに使用されます。 :::note -Terraform の `state` ファイルに関する推奨に従ってください: デプロイされたインフラストラクチャを維持するために必要であり、機密情報を含む可能性があります。詳細については、Terraform ドキュメントの [state](https://developer.hashicorp.com/terraform/language/state) を参照してください。 +Terraform の `state` ファイルに関する推奨に従ってください: デプロイされたインフラストラクチャを維持するために必要であり、機密情報を含む可能性があります。詳細は、Terraform ドキュメントの [state](https://developer.hashicorp.com/terraform/language/state) を参照してください。 ::: #### Test Terraform Using the Health Check Endpoint @@ -402,7 +402,7 @@ UID2 Operator には、Operator Key が必要です。UID2 アカウントの設 | `{IMAGE_FAMILY}` | `confidential-space` はインテグレーションと本番で使用し、`confidential-space-debug` はインテグレーションでのみデバッグ用に使用します。`confidential-space-debug` は本番では動作しないことに注意してください。 | | `{SERVICE_ACCOUNT}` | アカウント作成時に作成したサービスアカウントのメールアドレス: `{SERVICE_ACCOUNT_NAME}@{PROJECT_ID}.iam.gserviceaccount.com`.
詳細は [Set Up Service Account Rules and Permissions](#set-up-service-account-rules-and-permissions) (Step 4) を参照してください。| | `{OPERATOR_IMAGE}` | コンフィギュレーションで使用するUID2 Private Operator for GCPのDockerイメージURL。
これは、GCPダウンロードファイルの`terraform.tfvars`ファイルにあります。([Operator Versions](#operator-versions) を参照してください) | -| `{OPERATOR_KEY_SECRET_FULL_NAME}` | Operator Key secret に指定したフルネーム ([Create Secret for the Operator Key in Secret Manager](#create-secret-for-the-operator-key-in-secret-manager) を参照してください)。パスを含め `projects//secrets//versions/` の形式でしています。例えば: `projects/111111111111/secrets/uid2-operator-operator-key-secret-integ/versions/1` | +| `{OPERATOR_KEY_SECRET_FULL_NAME}` | Operator Key secret に指定したフルネーム ([Create Secret for the Operator Key in Secret Manager](#create-secret-for-the-operator-key-in-secret-manager) を参照してください)。パスを含め `projects//secrets//versions/` の形式でしています。たとえば: `projects/111111111111/secrets/uid2-operator-operator-key-secret-integ/versions/1` | ##### Sample Deployment Script—Integ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index 0bc2d2cbb..0db1261ee 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -33,7 +33,7 @@ import Link from '@docusaurus/Link'; ### Web Integrations -以下のリソースは、パブリッシャーの Web インテグレーションに利用できます。 +パブリッシャーの Web インテグレーションには、以下のドキュメントリソースが利用できます。 :::tip Web インテグレーションオプションの詳細は [Web Integration Overview](integration-options-publisher-web.md) を参照してください。 @@ -52,17 +52,17 @@ Web インテグレーションオプションの詳細は [Web Integration Over ### Mobile Integrations -Android または iOS デバイスとインテグレーションするパブリッシャーは、以下のリソースを利用できます。 +Android または iOS デバイスとインテグレーションするパブリッシャーは、以下のドキュメントリソースを利用できます。 | Integration Guide | Content Description | | :--- | :--- | | [Mobile Integration Overview for Android and iOS](integration-mobile-overview.md) | SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのオプションの概要です。 | -| [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | モバイルアプリ内のみの変更で UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けの統合ガイドです (Server-Side の変更はありません)。 | +| [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md) | モバイルアプリ内のみの変更で UID2 とインテグレーションしたいモバイルアプリパブリッシャー向けのインテグレーションガイドです (Server-Side の変更はありません)。 | | [Client-Server Integration Guide for Mobile](integration-mobile-client-server.md) | UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションガイドです:
  1. UID2 Token を Server-Side で生成するには、PublicまたはPrivate Operatorを使用します。
  2. その結果、identities をモバイルアプリに渡し、ビッドストリームに渡します。
| ### CTV Integrations -CTV とインテグレーションするパブリッシャー向けには、以下のリソースが利用できます。 +CTV とインテグレーションするパブリッシャー向けには、以下のドキュメントリソースが利用できます。 | Integration Guide | Content Description | | :--- | :--- | @@ -93,18 +93,19 @@ Google Ad Managerとインテグレーションするパブリッシャーは、 ## Advertiser/Data Provider Integrations -UID2 とインテグレーションする広告主やデータプロバイダーは、以下のリソースを利用できます。 +UID2 とインテグレーションする広告主やデータプロバイダーは、以下のドキュメントリソースを利用できます。 | Integration Guide | Content Description | | :--- | :--- | -| [Advertiser/Data Provider](./integration-advertiser-dataprovider-overview.md) | この広告主やデータプロバイダー向けのインテグレーションガイドは、オーディエンスの構築とターゲティングのためのアイデンティティマッピングのためのインテグレーションワークフローをカバーしています。 | -| [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) | トラッキングピクセルに UID2 Token を追加するためにこの SDK を使用したい広告主やデータプロバイダー向けのガイドです。 | +| [Advertiser/Data Provider Overview](integration-advertiser-dataprovider-overview.md) | このガイドでは、ユーザーデータを収集し、他の UID2 参加者にプッシュする組織向けのインテグレーションオプションの概要を提供します。 | | [Snowflake Integration Guide](integration-snowflake.md) | Snowflake 内でメールアドレスから UID2 を生成する手順です。| | [AWS Entity Resolution Integration Guide](integration-aws-entity-resolution.md) | AWS Entity Resolution を使用して UID2 フレームワークとインテグレーションする手順です。 | +| [Advertiser/Data Provider Integration to HTTP Endpoints](integration-advertiser-dataprovider-endpoints.md) | このガイドでは、広告主やデータプロバイダーが UID2 とインテグレーションするための手順を説明します。この手順では、SDK、Snowflake、AWS Entity Resolution などの他の実装オプションではなく、コードを書いて UID2 HTTP エンドポイントを呼び出す方法を説明します。 | +| [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) | トラッキングピクセルに UID2 Token を追加するためにこの SDK を使用したい広告主やデータプロバイダー向けのガイドです。 | ## DSP Integrations -DSP とインテグレーションする DSP は、以下のリソースを利用できます。 +UID2 とインテグレーションする DSP は、以下のドキュメントリソースを利用できます。 | Integration Guide | Content Description | | :--- | :--- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md index 2ce0e09b2..2f57ffe6c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/intro.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/intro.md @@ -87,12 +87,12 @@ UID2 は透明で相互運用可能なアプローチにより、広告エコシ | Participant | Role Description | | :--- | :--- | -| **Core Administrator** | UID2 Core Service およびその他の [コンポーネント](#components) を管理する組織 (現在は The Trade Desk)。例えば、UID2 Operator に暗号キーとソルトを配布し、Operator や DSP にユーザーのオプトアウトリクエストを送ります。 | -| **Operators** | Operator Service (UID2 API 経由で) を実行する組織。オペレーターは、定期的に UID2 Core Service から最新の暗号化キーとソルトを受け取り、directly identifying information (DII) をソルトおよびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token の復号キーを配布します。
Public Operator (Open Operator) は、Operator Service のパブリックインスタンスを実行します。例えば、The Trade Desk は現在、UID2 Framework の Public Operator として機能しており、すべての参加者が利用できます。他の Public Operator が利用可能な場合、参加者はどのオペレーターと連携するかを選択できます。
参加者は誰でも、UID2 を生成および管理する Private Operator になることもできます。 | +| **Core Administrator** | UID2 Core Service およびその他の [コンポーネント](#components) を管理する組織 (現在は The Trade Desk)。たとえば、UID2 Operator に暗号キーとソルトを配布し、Operator や DSP にユーザーのオプトアウトリクエストを送ります。 | +| **Operators** | Operator Service (UID2 API 経由で) を実行する組織。オペレーターは、定期的に UID2 Core Service から最新の暗号化キーとソルトを受け取り、directly identifying information (DII) をソルトおよびハッシュ化して raw UID2 を返し、raw UID2 を暗号化して UID2 Token を生成し、UID2 Token の復号キーを配布します。
Public Operator (Open Operator) は、Operator Service のパブリックインスタンスを実行します。たとえば、The Trade Desk は現在、UID2 Framework の Public Operator として機能しており、すべての参加者が利用できます。他の Public Operator が利用可能な場合、参加者はどのオペレーターと連携するかを選択できます。
参加者は誰でも、UID2 を生成および管理する Private Operator になることもできます。 | | **DSPs** | DSP は UID2 システムとインテグレーションして、広告主から (ファーストパーティデータとして)、またサードパーティデータプロバイダーから (サードパーティデータとして)UID2 を受け取り、それらを活用してビッドストリーム中の UID2 に対する入札情報を提供します。 | -| **Data Providers** | ユーザーデータを収集し、それを他の UID2 参加者—例えば、広告主、ID グラフプロバイダー、サードパーティデータプロバイダー—にプッシュする組織。 | +| **Data Providers** | ユーザーデータを収集し、それを他の UID2 参加者—たとえば、広告主、ID グラフプロバイダー、サードパーティデータプロバイダー—にプッシュする組織。 | | **Advertisers** | さまざまなパブリッシャーサイトでインプレッションを購入し、DSP を使用して、購入する広告インプレッションとその入札価格を決定している組織です。 | -| **Publishers** | UID2 Token を SSP 経由でビッドストリームに伝達する組織 - 例えば、ID プロバイダー、パブリッシャー、SSO プロバイダーなど。パブリッシャーは、SSO プロバイダーか、UID2 と相互運用可能な独立系 ID プロバイダーのいずれかと連携することを選択できます。独立系 ID プロバイダーは、パブリッシャーに代わって UID2 インテグレーションを行えます。 | +| **Publishers** | UID2 Token を SSP 経由でビッドストリームに伝達する組織 - たとえば、ID プロバイダー、パブリッシャー、SSO プロバイダーなど。パブリッシャーは、SSO プロバイダーか、UID2 と相互運用可能な独立系 ID プロバイダーのいずれかと連携することを選択できます。独立系 ID プロバイダーは、パブリッシャーに代わって UID2 インテグレーションを行えます。 | | **Consumers** | メールアドレスや電話番号から UID2 Token または raw UID2 を生成したユーザー。消費者は [Transparency and Control Portal](https://www.transparentadvertising.com/) で UID2 をオプトアウトできます。 | ### Workflows diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md index e56caf3e2..02fe56b05 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-advertisers.md @@ -6,6 +6,7 @@ sidebar_position: 04 use_banner: true banner_title: 広告主向け UID2 の概要 banner_description: Unified ID 2.0 でキャンペーンのアクティベーションをアップグレードしましょう。 +banner_icon: 'advertisers' banner_text_color: 'white' banner_text_color_dark: 'black' banner_background_color: '#7085D4' @@ -73,10 +74,11 @@ UID2 のドキュメント一式に左サイドバーからアクセスしたい | Integration Type| Documentation | Content Description | | :--- | :--- | :--- | -| ユーザーデータを収集し、他の UID2 参加者にプッシュする組織のためのインテグレーション手順 | [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) | このガイドでは、オーディエンスの構築とターゲティングのために ID をマッピングするインテグレーションワークフローについて説明します。 | -| トラッキングピクセルに UID2 Token を追加する広告主およびデータプロバイダー向けのインテグレーション手順 | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | このガイドでは、JavaScript クライアントサイドの変更のみを使用して、Advertising Token を追加するための JavaScript SDK を使用する広告主およびデータプロバイダー向けのインテグレーション手順を提供します。 | +| ユーザーデータを収集し、他の EUID 参加者にプッシュする組織向けのインテグレーションオプションの概要 | [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) | このガイドでは、オーディエンス構築およびターゲティングのための ID マッピングのインテグレーションワークフローについて説明します。 | | Snowflake | [Snowflake Integration Guide](../guides/integration-snowflake.md) | このガイドでは、Snowflake を使ってメールアドレスから UID2 を生成する手順を説明します。 | | AWS Entity Resolution | [AWS Entity Resolution Integration Guide](../guides/integration-aws-entity-resolution.md) | このガイドでは、AWS Entity Resolution を使用して UID2 とインテグレーションする手順を説明します。 | +| UID2 HTTP エンドポイントのみを使用して、ユーザーデータを収集し、他の EUID 参加者に送信する組織向けのインテグレーション手順 | [Advertiser/Data Provider Integration to HTTP Endpoints](../guides/integration-advertiser-dataprovider-endpoints.md) | このガイドでは、広告主やデータプロバイダーが UID2 HTTP エンドポイントを呼び出すためのコードを記述して UID2 とインテグレーションする手順について説明します。SDK、Snowflake、AWS Entity Resolution などの他の実装オプションを使用せずに UID2 とインテグレーションする広告主やデータプロバイダー向けのインテグレーション手順をカバーします。 | +| Client-Side JavaScript SDK を使用してトラッキングピクセルに UID2 Token を追加する広告主やデータプロバイダー向けのインテグレーション手順 | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | このガイドでは、JavaScript Client-Side の変更のみを使用して UID2 Token (Advertising Token) を生成する手順について説明します。 | ## FAQs for Advertisers diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md index b66600348..4607d0c5a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-data-providers.md @@ -6,6 +6,7 @@ sidebar_position: 08 use_banner: true banner_title: データプロバイダー向け UID2 の概要 banner_description: 未来のためのIDソリューション。 +banner_icon: 'dataProviders' banner_text_color: 'white' banner_text_color_dark: 'black' banner_background_color: '#10692E' @@ -78,10 +79,11 @@ UID2 を使用することで、データプロバイダーとして得られる | Integration Type| Documentation | Content Description | | :--- | :--- | :--- | -| ユーザーデータを収集し、他の UID2 参加者にプッシュする組織のためのインテグレーション手順 | [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) | このガイドでは、オーディエンスの構築とターゲティングのために ID をマッピングするインテグレーションワークフローについて説明します。 | -| トラッキングピクセルに UID2 Token を追加する広告主およびデータプロバイダー向けのインテグレーション手順 | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | このガイドでは、JavaScript クライアントサイドの変更のみを使用して、Advertising Token を追加するための JavaScript SDK を使用する広告主およびデータプロバイダー向けのインテグレーション手順を提供します。 | +| ユーザーデータを収集し、他の EUID 参加者にプッシュする組織向けのインテグレーションオプションの概要 | [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) | このガイドでは、オーディエンス構築およびターゲティングのための ID マッピングのインテグレーションワークフローについて説明します。 | | Snowflake | [Snowflake Integration Guide](../guides/integration-snowflake.md) | このガイドでは、Snowflake を使ってメールアドレスから UID2 を生成する手順を説明します。 | | AWS Entity Resolution | [AWS Entity Resolution Integration Guide](../guides/integration-aws-entity-resolution.md) | このガイドでは、AWS Entity Resolution を使用して UID2 とインテグレーションする手順を説明します。 | +| UID2 HTTP エンドポイントのみを使用して、ユーザーデータを収集し、他の EUID 参加者に送信する組織向けのインテグレーション手順 | [Advertiser/Data Provider Integration to HTTP Endpoints](../guides/integration-advertiser-dataprovider-endpoints.md) | このガイドでは、広告主やデータプロバイダーが UID2 HTTP エンドポイントを呼び出すためのコードを記述して UID2 とインテグレーションする手順について説明します。SDK、Snowflake、AWS Entity Resolution などの他の実装オプションを使用せずに UID2 とインテグレーションする広告主やデータプロバイダー向けのインテグレーション手順をカバーします。 | +| Client-Side JavaScript SDK を使用してトラッキングピクセルに UID2 Token を追加する広告主やデータプロバイダー向けのインテグレーション手順 | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | このガイドでは、JavaScript Client-Side の変更のみを使用して UID2 Token (Advertising Token) を生成する手順について説明します。 | ## FAQs for Data Providers diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md index 94490431d..14b2f67ea 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-dsps.md @@ -6,6 +6,7 @@ sidebar_position: 06 use_banner: true banner_title: UID2 Overview for DSPs banner_description: より耐久性のある識別子でデータ戦略を可能に。 +banner_icon: 'dsps' banner_text_color: 'white' banner_text_color_dark: 'black' banner_background_color: '#0459FC' diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md index 047656a96..874a45fe3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/overviews/overview-publishers.md @@ -6,6 +6,7 @@ sidebar_position: 02 use_banner: true banner_title: パブリッシャー向け UID2 概要 banner_description: 変化し続ける広告業界においてオーディエンスターゲティングを維持し、より良いインプレッション収益化と関連性の向上を実現。 +banner_icon: 'publishers' banner_text_color: 'white' banner_text_color_dark: 'black' banner_background_color: '#035959' @@ -13,6 +14,8 @@ banner_background_color_dark: '#DCDEE1' displayed_sidebar: sidebarPublishers --- +import IntegratingWithSSO from '../snippets/_integrating-with-sso.mdx'; + import Link from '@docusaurus/Link'; パブリッシャーとして、Unified ID 2.0 (UID2) のクロスデバイスプレゼンスの恩恵を受け、すべてのインベントリで一貫した ID ファブリックを活用することができます。 @@ -64,6 +67,10 @@ UID2 とインテグレーションすることで得られるメリットの一 ![Publisher Workflow](images/UID2PublisherAndSSPWorkflow.jpg) +## Integrating with Single Sign-On (SSO) + + + ## Getting Started 次の手順で始めます: @@ -110,7 +117,7 @@ Web インテグレーションオプションの詳細は [Web Integration Over | :--- | :--- | :--- | | Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡される UID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。 | | Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法であるClient-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークンの生成と Token Refresh。
  • トークンを RTB ビッドストリームに渡す。
| -| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operator を利用しているパブリッシャーなど。 | +| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: たとえば、Private Operator を利用しているパブリッシャーなど。 | | JavaScript (Overview) | [UID2 Integration Overview for JavaScript](../guides/integration-javascript.md) | JavaScript SDK を使って UID2 とインテグレーションしたいパブリッシャー向けのオプションの概要です。 | | JavaScript Client-Side Integration | [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) | Client-Side の JavaScript の変更だけで UID2 とインテグレーションしたいパブリッシャー向けのガイドで、最も簡単な実装方法です。
SDK for JavaScript は、トークン生成とトークンリフレッシュを自動的に管理します。 | | JavaScript Client-Server Integration | [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) | SDK for JavaScript を使用し、トークンを Server-Side で生成してパブリッシャーのウェブページに渡す必要がある、標準的なWeb インテグレーションシナリオを網羅したパブリッシャーガイドです。 | @@ -145,7 +152,7 @@ Prebid とインテグレーションするパブリッシャーには、以下 | :--- | :--- | :--- | | Prebid (Overview) | [UID2 Integration Overview for Prebid](../guides/integration-prebid.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js または Prebid Mobile SDK から渡される UID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要。 | | Prebid.js Client-Side Integration | [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) | 最も簡単な実装方法である Client-Side で UID2 Token をリクエストし、Prebid.js に以下を管理させることを選択したいパブリッシャー向けのガイドです:
  • トークン生成とトークンリフレッシュ。
  • トークンを RTB ビッドストリームに渡す。
| -| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: 例えば、Private Operatorを使用しているパブリッシャーなどです。 | +| Prebid.js Client-Server Integration | [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md) | UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js から渡される UID2 Token を生成したいが、トークンを Server-Side で生成したいパブリッシャー向けのガイドです: たとえば、Private Operatorを使用しているパブリッシャーなどです。 | | Prebid.js on Mobile | [UID2 Mobile Integration for Prebid.js](../guides/integration-prebid-mobile-summary.md) | モバイルデバイス上の Prebid.js と UID2 のインテグレーションに関する情報リソースのまとめです。 | ### Google Ad Manager Integrations diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md index dda6731d7..e5eceaa9e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/api-keys.md @@ -10,7 +10,7 @@ import Link from '@docusaurus/Link'; # API Keys :::note -いずれも、Client-Server または Server-Side の実装についての手順です。UID2 の実装が Client-Side であるか、一般に公開される場合は、異なる値を設定する必要があります。詳細については、[Client-Side Integration](client-side-integration.md) を参照してください。 +いずれも、Client-Server または Server-Side の実装についての手順です。UID2 の実装が Client-Side であるか、一般に公開される場合は、異なる値を設定する必要があります。詳細は、[Client-Side Integration](client-side-integration.md) を参照してください。 ::: UID2 Portal の **API Keys** ページでは、UID2 アカウントの API Key を管理するためのすべての操作を実行できます: @@ -25,7 +25,7 @@ UID2 Portal の **API Keys** ページでは、UID2 アカウントの API Key API Key とクライアント シークレットを使用すると、UID2 Operator Service に接続して API エンドポイントを呼び出すことができます。これらの値は、サービスに対してあなたを識別します。 :::important -UID2 Portal で API Key を追加するときは、キーとそれに対応するシークレットを安全に保存し、これらの値が漏洩しないようにするために必要な措置をすべて講じる必要があります。詳細については、[API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 +UID2 Portal で API Key を追加するときは、キーとそれに対応するシークレットを安全に保存し、これらの値が漏洩しないようにするために必要な措置をすべて講じる必要があります。詳細は、[API Key and Client Secret](../getting-started/gs-credentials.md#api-key-and-client-secret) を参照してください。 ::: 各 API Keyは、1 年ごとにローテーションすることを勧めます。 @@ -101,7 +101,7 @@ API Key を削除するには、次の手順を実行します: ## Rotating an API Key -API Key をローテーションすることをお勧めします。API Key をローテーションするには、次の手順を実行します: +API Key をローテーションすることを勧めます。API Key をローテーションするには、次の手順を実行します: 1. UID2 Portal で **API Keys** ページに移動します。 1. リストでローテーションする Key を見つけます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md index 6c76a58ba..d67f7d170 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/client-side-integration.md @@ -8,7 +8,7 @@ sidebar_position: 09 # Client-Side Integration :::note -これらの手順は Client-Side の実装向けです。UID2 の実装が Client-Server または Server-Side である場合は、異なる値を設定する必要があります。詳細については、[API Keys](api-keys.md) を参照してください。 +これらの手順は Client-Side の実装向けです。UID2 の実装が Client-Server または Server-Side である場合は、異なる値を設定する必要があります。詳細は、[API Keys](api-keys.md) を参照してください。 ::: UID2 Portal では、Client-Side でトークンを生成する実装オプションを使用する場合、実装タイプに該当する以下の値を定義する必要があります: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md index 59abc9317..a27f73fd5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/email-contacts.md @@ -44,12 +44,12 @@ Email Contacts ページでは、UID2 の更新について通知を受ける個 - Email Group Name: 以下のいずれかを入力します: - 個人の場合: メールアドレスに関連付けられた名前または役割。 - - メールアドレスグループの場合: グループのテキスト名。例えば、`Engineering`。 + - メールアドレスグループの場合: グループのテキスト名。たとえば、`Engineering`。 - Email Alias: 以下のいずれかを入力してください: - 個人の場合: メールアドレス。 - - グループの場合: グループに有効なメールアドレス。例えば、`engineering@example.com`。 - - Contact Type: コンタクトタイプのドロップダウンリストから選択します。例えば、`Business` または `Technical` を選択します。 + - グループの場合: グループに有効なメールアドレス。たとえば、`engineering@example.com`。 + - Contact Type: コンタクトタイプのドロップダウンリストから選択します。たとえば、`Business` または `Technical` を選択します。 3. **Save Email Contact** をクリックします。エントリーがリストに追加されます。 :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md index 71874d859..8f6f848f3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-getting-started.md @@ -60,7 +60,7 @@ UID2 Service を使用するには、キーのセットが必要です。Client- | Client-Side インテグレーション | **広告主** はトラッキングピクセル用に Client-Side で UID2 Token を生成します。
**パブリッシャー** は bidstream 用に Client-Side で UID2 Token を生成します。| **Client-Side Integration** ページに移動し、キーペアとルートレベルドメインを設定します。
詳細は [Client-Side Integration](client-side-integration.md) を参照してください。 | | Server-Side インテグレーション | **広告主** はオーディエンスターゲティングのために配信される raw UID2 を生成します。
**パブリッシャー** はビッドストリームように Server-Side で UID2 Token を生成します。| **API Keys** ページに移動し、少なくとも1組の認証情報を生成します。API Key を追加すると、シークレットとキーの2つの値が割り当てられます。
詳細は [API Keys](api-keys.md) を参照してください。 | -参加者の中には、Client-Side と Server-Side の両方のインテグレーションを使用するかもしれません。例えば、広告主はピクセルのために Client-Side で UID2 Token を生成 ([Client-Side Integration](client-side-integration.md)) し、raw UID2 の生成は、Server-Side でインテグレーションします ([API Keys](api-keys.md))。 +参加者の中には、Client-Side と Server-Side の両方のインテグレーションを使用するかもしれません。たとえば、広告主はピクセルのために Client-Side で UID2 Token を生成 ([Client-Side Integration](client-side-integration.md)) し、raw UID2 の生成は、Server-Side でインテグレーションします ([API Keys](api-keys.md))。 ## Log In for the First Time diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md index 7947c2778..dd725d014 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/portal-overview.md @@ -10,7 +10,7 @@ import Link from '@docusaurus/Link'; # UID2 Portal: Overview -UID2 Portal は、UID2 アカウントを設定・構成するためのワンストップショップです。このセルフサービスポータルでは、UID2 参加のための基本的な設定手順をすべて完了することができます。各アクティビティの詳細については、以下のリンクをクリックしてください: +UID2 Portal は、UID2 アカウントを設定・構成するためのワンストップショップです。このセルフサービスポータルでは、UID2 参加のための基本的な設定手順をすべて完了することができます。各アクティビティの詳細は、以下のリンクをクリックしてください: | Activity | Documentation Link | | :--- | :--- | @@ -41,7 +41,7 @@ UID2 Portal はナビゲーションが簡単になるように構造化され 左サイドバーの上部に、現在の参加者の名前が表示されます。アカウントが複数の参加者にアクセスできる場合、アクセスできる参加者のドロップダウンリストが表示されます。これを使用して、参加者間を切り替えることができます。 :::important -UID2 Portal で実行する操作（チームメンバーの追加、ドメイン、API キーの追加など）は、左側に表示されている現在の参加者のコンテキストで行われます。複数の参加者にアクセスできる場合は、正しいコンテキストで操作を実行してください。詳細については、[Participant Switcher](#participant-switcher) を参照してください。 +UID2 Portal で実行する操作（チームメンバーの追加、ドメイン、API キーの追加など）は、左側に表示されている現在の参加者のコンテキストで行われます。複数の参加者にアクセスできる場合は、正しいコンテキストで操作を実行してください。詳細は、[Participant Switcher](#participant-switcher) を参照してください。 ::: 左サイドバーをスクロールすると、アカウントの構成に関連する以下のページにアクセスできます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md index 7dcccc5f8..327fb5da4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/sharing-permissions.md @@ -12,7 +12,7 @@ import Link from '@docusaurus/Link'; 共有権限を設定することで、他の UID2 共有参加者 と UID2 を共有できるようになります。 :::tip -UID Portal での共有権限の設定は、tokenized sharing のためであり、raw UID2 の共有ではありません。詳細については、[UID2 Sharing Approaches](../sharing/sharing-overview.md#uid2-sharing-approaches) を参照してください。 +UID Portal での共有権限の設定は、tokenized sharing のためであり、raw UID2 の共有ではありません。詳細は、[UID2 Sharing Approaches](../sharing/sharing-overview.md#uid2-sharing-approaches) を参照してください。 ::: 適切な共有関係を作成するのに役立つ多くのオプションがあります: @@ -41,7 +41,7 @@ Sharing の使用には API Key (詳細は [API Keys](api-keys.md) を参照) UID2 Portal では、以下の共有オプションを利用できます。これらのオプションは相互に排他的なものではありません—必要に応じて組み合わせることができます: -- すべてのパブリッシャー、広告主、DSP、データプロバイダーなど、特定のタイプの参加者全員に自動的に許可を与えることができます。例えば、パブリッシャーはすべての DSP に共有許可を与えることを勧めます。 +- すべてのパブリッシャー、広告主、DSP、データプロバイダーなど、特定のタイプの参加者全員に自動的に許可を与えることができます。たとえば、パブリッシャーはすべての DSP に共有許可を与えることを勧めます。 このオプションを選択すると、選択した参加者タイプのすべての新規参加者に、送信したデータを復号化する権限が自動的に付与されます。[Add Sharing Permissions—Bulk](#add-sharing-permissionsbulk) を参照してください。 @@ -51,21 +51,27 @@ UID2 Portal では、以下の共有オプションを利用できます。こ ## Add Sharing Permissions—Bulk -UID2 Portal は、あなたの役割に基づいて推奨を行います。例えば: -- パブリッシャーであれば、すべてのDSP (現在および将来) と共有できます。 -- 広告主であれば、すべてのデータプロバイダー (現在および将来) と共有できます。 -- DSP であれば、すべての広告主とすべてのデータプロバイダー (現在および将来) と共有できます。 -- データプロバイダーであれば、すべての広告主、すべてのパブリッシャー、すべてのDSP (現在および将来) と共有できます。 +UID2 Portal は、役割に基づいて、以下の推奨事項を示します: + +- 広告主: DSP およびデータプロバイダーと共有 +- データプロバイダー: パブリッシャー、広告主、DSP と共有 +- パブリッシャー: DSP と共有 + + 以下の図は、広告主向けの推奨事項を示しています。 ![UID2 Portal, Sharing Permissions page, Recommendations (Advertiser)](images/portal-sharing-permissions.png) -推奨を受け入れることが、共有オプションを設定する最も速く簡単な方法です。 +推奨事項を受け入れることは、共有オプションを設定する最も迅速かつ簡単な方法です。 -例えば、既存の 20 の DSP すべてと共有することを選択したとします。翌日、DSP 21 が共有にサインアップすると、DSP 21 は自動的に、あなたが送信したデータを復号化する権限を持つことになります。DSP 21 と共有するには、1つ以上の UID2 Token を送信するだけで、DSP 21 はトークンを復号化して raw UID2 に変換できるようになります。自動共有を選択したため、ログインして共有権限を明示的に更新する必要はありません。 +たとえば、既存の DSP 20社すべてと共有することを選択したとします。次の日、DSP 21 が共有の等速を行うと、DSP 21 は送信したデータを復号化する権限が自動的に付与されます。DSP 21 と共有するには、1つ以上の UID2 Token を送信するだけで、DSP 21 はその Token を raw UID2 に復号化できるようになります。自動共有を選択したため、DSP 21 または将来の DSP が UID2 エコシステムにサインアップした場合、DSP 21 を含めるために明示的に共有許可を更新する必要はありません。 -必要に応じて、1 つ以上の共有参加者と個別の共有関係を設定すできます。 +要望がある場合は、1つ以上の共有参加者との個別の共有関係を設定できます。 ## Using Search to Add Sharing Relationships @@ -118,5 +124,5 @@ UID2 Portal で共有許可を与えるだけでなく、SDK または Snowflake この操作は、以前に作成した個別の共有許可にのみ適用されます。一括共有を介して共有許可を追加した場合、個別の共有許可を削除することはできません。共有許可を削除するには、追加した方法と同じ方法で削除する必要があります。 :::note -共有許可を削除すると、次回参加者が復号鍵を更新すると、その参加者との共有が解除されます。即時ではありませんが、迅速に行われます。詳細については、[Decryption Key Refresh Cadence for Sharing](../sharing/sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) を参照してください。 +共有許可を削除すると、次回参加者が復号鍵を更新すると、その参加者との共有が解除されます。即時ではありませんが、迅速に行われます。詳細は、[Decryption Key Refresh Cadence for Sharing](../sharing/sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md b/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md index 0970895a9..bb37e1933 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/portal/team-members.md @@ -42,7 +42,7 @@ Team Member ページにアクセスするには、UID2 Portal ユーザーイ | Admin | Admin 権限を持つユーザーは、[UID2 Portal Overview](portal-overview.md) に記載されているように、現在の参加組織に関連する UID2 参加に関連するすべてのアクティビティを実行できます。 | | Operations | Operation 権限を持つユーザーは、Admin ユーザーとほぼ同じアクションを実行できます。ただし、いくつかの制限があります:
  • チームメンバーを追加、変更、削除することはできません。代わりに、[Team Members](team-members.md) ページには読み取り専用アクセスがあります。
  • [Audit Trail](audit-trail.md) ページを表示できません。
| -ユーザー権限は、Admin 権限を持つユーザーのみが変更できます。詳細については、[Edit Information for a Team Member](#edit-information-for-a-team-member) を参照してください。 +ユーザー権限は、Admin 権限を持つユーザーのみが変更できます。詳細は、[Edit Information for a Team Member](#edit-information-for-a-team-member) を参照してください。 ## Add a Team Member @@ -98,7 +98,7 @@ Team Member の情報を編集するには、次の手順を実行します: - 名 - 姓 - 職務 - - 役割: 役割についての詳細については、[User Roles](#user-roles) を参照してください。 + - 役割: 役割についての詳細は、[User Roles](#user-roles) を参照してください。 **Note**: 既存の Team Member のメールアドレスを更新することはできません。メールアドレスを変更する必要がある場合は、新しいメールアドレスを使用して新しい Team Member を追加します。これにより、メールアドレスの確認プロセスが正しく実行されます。このシナリオでは、古いメールアドレスの既存エントリも削除することを忘れないでください。 1. 変更内容を保存します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md index bf73531a3..02e106f3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/glossary-uid.md @@ -51,6 +51,9 @@ import Link from '@docusaurus/Link'; **F** First-level hash +**G** +GDPR + **H** Hash @@ -68,6 +71,8 @@ import Link from '@docusaurus/Link'; Normalize **O** +OpenID Connect (OIDC) | +Opaque | Open Operator | Operator | Operator key | @@ -124,8 +129,8 @@ import Link from '@docusaurus/Link';
Advertising token は UID2 token の別名です。.
API key
-
UID2 参加者 はそれぞれ、API Key (クライアントキー) と、そのキーに関連付けられた Client Secret (APIシークレット) と呼ばれる秘密の値を持っています。Client Secretは、参加者と UID Service だけが知っています。
-
詳細は UID2 Credentials を参照してください。
+
UID2 参加者 はそれぞれ、API Key (Client Key) と、そのキーに関連付けられた Client Secret (APIシークレット) と呼ばれる秘密の値を持っています。Client Secretは、参加者と UID Service だけが知っています。
+
詳細は UID2 Credentials を参照してください。
API secret
client secret を参照してください。
@@ -135,7 +140,7 @@ import Link from '@docusaurus/Link';
Authorization header
Authorization header は、UID2 Service に対してクライアントを認証する方法です。
-
詳細については、HTTP 仕様の RFC 9110 11.6.2. Authorization を参照してください。
+
詳細は、HTTP 仕様の RFC 9110 11.6.2. Authorization を参照してください。
@@ -144,7 +149,7 @@ import Link from '@docusaurus/Link';
Bearer token
-
Bearer token はクライアントを識別する特別な文字列です。認証のために、いくつかのUID2 エンドポイントはリクエストの Authorization header で client key を Beare token として指定する必要があります。例えば、POST /token/generate です。
+
Bearer token はクライアントを識別する特別な文字列です。認証のために、いくつかのUID2 エンドポイントはリクエストの Authorization header で client key を Beare token として指定する必要があります。たとえば、POST /token/generate です。
Bidstream
広告スポットに広告を配置するためのリクエスト (ビッドリクエスト) を行うために、パブリッシャーは異なる情報を送信します。広告主が入札するために、通常は広告交換または DSP を介して、広告主が入札するための異なる情報を送信します。入札データの流れは、ビッドストリームです。
@@ -164,18 +169,18 @@ import Link from '@docusaurus/Link';
詳細は　Subscription ID and Public Key を参照してください。
Client secret
-
各 UID2 参加者は、API Key (クライアントキー) と、そのキーに関連付けられた秘密値 (Client secret (API シークレット)) を持っています。Client secretは、参加者と UID2 Service だけが知っています。
-
詳細については、UID2 Credentials を参照してください。
+
各 UID2 参加者は、API Key (Client Key) と、そのキーに関連付けられた秘密値 (Client secret (API シークレット)) を持っています。Client secretは、参加者と UID2 Service だけが知っています。
+
詳細は、UID2 Credentials を参照してください。
Client-server integration
UID2の インテグレーションアプローチ の1つは、Client-Side と Server-Side の両方でインテグレーションする方法です (Client-Server)。
-
例えば、パブリッシャーの Client-Server インテグレーションでは、UID2 Token は Server-Side で生成され、Client-Side でリフレッシュされます。
+
たとえば、パブリッシャーの Client-Server インテグレーションでは、UID2 Token は Server-Side で生成され、Client-Side でリフレッシュされます。
パブリッシャーの Client-Server インテグレーションに関するドキュメントの例: UID2 Client-Server Integration Guide for Prebid.js, Client-Server Integration Guide for JavaScript, UID2 Client-Server Integration Guide for Mobile.
Client-side integration
UID2の インテグレーションアプローチ の1つは、完全に Client-Side でインテグレーションする方法です。
Client-Side インテグレーションでは、UID2 Token はクライアントサイドで生成およびリフレッシュされます。
-
例えば、広告主は、トラッキングピクセルのために Client-Side で UID2 Token を生成し、パブリッシャーは、ビッドストリームのために Client-Side で UID2 Token を生成し、トークンをリフレッシュします。
+
たとえば、広告主は、トラッキングピクセルのために Client-Side で UID2 Token を生成し、パブリッシャーは、ビッドストリームのために Client-Side で UID2 Token を生成し、トークンをリフレッシュします。
パブリッシャーの Client-Side インテグレーションに関するドキュメントの例:: UID2 Client-Side Integration Guide for Prebid.js, Client-Side Integration Guide for JavaScript, UID2 Client-Side Integration Guide for Mobile.
Closed Operator
@@ -200,7 +205,7 @@ import Link from '@docusaurus/Link';
Core Service
UID2 Core Serviceは、UID2 エコシステムの salts、暗号化キー、その他の関連データへのアクセスを管理する一元的なサービスです。
-
すべてのUID2 Service の概要については、Components を参照してください。
+
すべてのUID2 Service の概要については、Components を参照してください。
@@ -210,7 +215,7 @@ import Link from '@docusaurus/Link';
Data provider
UID2 のコンテキストでは、データプロバイダーは、データパートナー、測定パートナー、オフライン測定プロバイダーなど、広告に関連するデータおよび測定サービスを提供する事業社を指します。
-
詳細は participant (Data Providers) を参照してください。
+
詳細は participant (Data Providers) を参照してください。
Demand-side platform (DSP)
デマンドサイドプラットフォーム (DSP)は、広告主、ブランド、メディアエージェンシーなど、デジタル広告を購入したい企業にサービスを提供するプラットフォームです。
@@ -237,6 +242,11 @@ import Link from '@docusaurus/Link';
Encryption key
各 UID2 Token は、リクエストしたパブリッシャーに固有の暗号化キーを使用して暗号化されます。このキーはパブリッシャーを識別し、トークンを復号化するために必要です。これにより、UID2 Token を不正な個人が復号化できないようになります。
+
Environment
+
UID2 は、インテグレーション環境と本番環境の2つの環境を提供しています。
+
両方を使用する場合は、それぞれの環境に対して別々の資格情報を取得する必要があります。
+
詳細は、[Environments](../getting-started/gs-environments.md) を参照してください。
+
EUID framework
European Unified ID (EUID) フレームワークは、広告エコシステム全体の多くの参加者に対し、オープンインターネット上の広告機会に対する決定論的な ID を提供します。これにより、パブリッシャーウェブサイト、モバイルアプリ、Connected TV (CTV) アプリがプログラマティックワークフローを通じて収益化できます。独自の名前空間を持つオープンソースのスタンドアロンソリューションとして構築されたフレームワークは、参加者が地域の要件を満たすのに役立つプライバシーコントロールを提供します。
EUID は、フランス、イタリア、スペインなどのヨーロッパ諸国、アイスランドなどの非ヨーロッパ諸国、アゾレス諸島、マルティニーク、イギリスなどのその他の地域を含むヨーロッパ地域で運用されています。これは、EU プライバシー法の遵守を念頭に置いて設計されています。
@@ -254,6 +264,15 @@ import Link from '@docusaurus/Link'; +### G + +
+ +
GDPR
+
GDPR (一般データ保護規則) は、ヨーロッパ連合 (EU) の居住者に関連するデータを対象とするか収集する方法を規制するヨーロッパのプライバシーおよびセキュリティに関する法律です。
+ +
+ ### H
@@ -300,7 +319,7 @@ import Link from '@docusaurus/Link';
Normalize
データセットを Normalize (正規化)するとは、それを標準的な状態 (Condition) や状態 (State)にすることを意味します。
-
UID2 には特定の正規化規則があります。詳細については、Email Address Normalization と Phone Number Normalization を参照してください。
+
UID2 には特定の正規化規則があります。詳細は、Email Address Normalization と Phone Number Normalization を参照してください。
@@ -308,10 +327,14 @@ import Link from '@docusaurus/Link';
+
OpenID Connect (OIDC)
+
OpebID Connect (OIDC) は、OAuth 2.0 プロトコルの上に構築された ID レイヤーで、クライアントが認可サーバーによる認証に基づいてエンドユーザーの ID を検証できるようにします。
+
詳細は、[OpenID Connect Basic Client Implementer's Guide 1.0 - draft 40](https://openid.net/specs/openid-connect-basic-1_0.html) (specification) を参照してください。
+
Opaque
UID2 Token が不透明な文字列であるというのは、トークンが計算される方法やそのフォーマットが UID2 参加者に伝えられず、変更される可能性があるためです。文字列のフォーマットや長さ、その他の側面については、何も前提を立てるべきではありません。
-
Open Operator
+
Open Operator
Open Operator は、Public Operator の別名です。
Operator
@@ -330,7 +353,7 @@ import Link from '@docusaurus/Link';
Opt-Out
UID2 エコシステムに参加しているエンドユーザーは、Transparency and Control Portal にアクセスすることで、いつでもオプトアウトすることができます。
-
UID2 の Opt-out のワークフローと、ユーザーが Opt-out する方法の詳細については、User Opt-Out を参照してください。
+
UID2 の Opt-out のワークフローと、ユーザーが Opt-out する方法の詳細は、User Opt-Out を参照してください。
Opt-Out Service
Opt-Out Service は、ユーザーのオプトアウト要求を管理・保存するグローバルな UID2 Service です。
@@ -344,7 +367,7 @@ import Link from '@docusaurus/Link';
Participant
UID2 において重要な役割を果たすエンティティです。参加者には以下が含まれます: Core Administrator、Operator、DSP、データプロバイダー、広告主、パブリッシャー、消費者。
-
詳細については、参加者 を参照してください。
+
詳細は、参加者 を参照してください。
Private Operator
Private operator は、Operator Service のプライベートインスタンスを実行する事業社です。Private Operator は、安全な環境で独自のリソース (ハードウェアなど) を使用して、自身のために UID2 を生成および管理します。
@@ -383,11 +406,11 @@ import Link from '@docusaurus/Link';
Salt
-
メールアドレスや電話番号を、それ自体では元の値を追跡できない安全で不透明な値に変換するプロセスで使用されます。
+
メールアドレスや電話番号を、それ自体では元の値 (raw UID2 や UID2 Token) を追跡できない安全で不透明な値に変換するプロセスで使用されます。
UID2 Service は、ハッシュ化および暗号化とともに、プロセスの一部としてソルト(Salt) を使用し、元の値を保護します。ソルトは、ハッシュ化の前に入力値に加えられます。
Salt bucket
-
ソルトバケットは、Secret salt の値を長期間管理するために使用されます。各バケットには、約1年間有効な現在のソルト値が含まれており、新しい値にローテーションされる前に更新されます。バケットは互いに独立して更新できます。
+
ソルトバケットは、raw UID2 や UID2 Token を生成するために使用される秘密の salt の値を長期間管理するために使用されます。各バケットには、約1年間有効な現在のソルト値が含まれており、新しい値にローテーションされる前に更新されます。バケットは互いに独立して更新できます。
ソルトバケットは、100万以上あり、各メールアドレスまたは電話番号は、特定のバケットに決定論的に割り当てられます。ただし、この割り当ては永続的ではなく、バケットの現在のシークレットソルトが新しい値にローテーションされると変更される可能性があります。
Salt bucket ID
@@ -402,14 +425,14 @@ import Link from '@docusaurus/Link';
Secure signals
Google Ad Managerの機能。セキュアシグナル機能 (旧称: Encrypted Signals for Publishers、略称: ESP)により、パブリッシャーは信頼できるサードパーティのバイイングパートナーとシグナルを安全に共有することができます。パブリッシャーは、Google Ad Manager と Google Ad Manager Ad Exchange (AdX) を介して、Googleが承認した入札者に「暗号化された」ユーザーIDを渡すことができます。
-
詳しくは、Share secure signals with your trusted partners (2番目のセクション) と Share secure signals with bidders (いずれもGoogle) を参照してください。
-
Google Secure signals の UID2 サポートの詳細については、Google Ad Manager Secure Signals Integration Guide を参照してください。
+
詳細は、Share secure signals with your trusted partners (2番目のセクション) と Share secure signals with bidders (いずれもGoogle) を参照してください。
+
Google Secure signals の UID2 サポートの詳細は、Google Ad Manager Secure Signals Integration Guide を参照してください。
Server-side integration
UID2 の インテグレーションアプローチ の一つは、完全に Server-Side でインテグレーションすることです。
Server-Side インテグレーションでは、raw YUD2 または UID2 Token がサーバーサイドで生成およびリフレッシュされます。
-
例えば、Server-Side インテグレーションでは、広告主は、広告ターゲティングのために Server-Side で raw UID2 を生成し、パブリッシャーは、ビッドストリームのために Server-Side で UID2 Token を生成し、リフレッシュします。
-
パブリッシャーサーバーサイドの統合に関するドキュメントの例は、Publisher Integration Guide, Server-Side です。
+
たとえば、Server-Side インテグレーションでは、広告主は、広告ターゲティングのために Server-Side で raw UID2 を生成し、パブリッシャーは、ビッドストリームのために Server-Side で UID2 Token を生成し、リフレッシュします。
+
パブリッシャーサーバーサイドのインテグレーションに関するドキュメントの例は、Publisher Integration Guide, Server-Side です。
SHA-256
SHA-256 (SHA256 とも呼ばれます) は、UID2 が使用する安全なハッシュアルゴリズムです。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-approaches.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-approaches.md index 4ce7dcef6..f42dd68ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-approaches.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-approaches.md @@ -9,9 +9,9 @@ import Link from '@docusaurus/Link'; # Integration Approaches -パブリッシャーがワークフローに UID2 をインテグレーションする場合、または広告主が UID2 サポートをインテグレーションする場合、3 つの広範な統合アプローチがあります。UID2 インテグレーションは、Client-Side で完全に実装される場合、Server-Side で完全に実装される場合、または Client-Side と Server-Side 側の両方で部分的に実装される場合 (Client-Server) があります。 +パブリッシャーがワークフローに UID2 をインテグレーションする場合、または広告主が UID2 サポートをインテグレーションする場合、3 つの広範なインテグレーションアプローチがあります。UID2 インテグレーションは、Client-Side で完全に実装される場合、Server-Side で完全に実装される場合、または Client-Side と Server-Side 側の両方で部分的に実装される場合 (Client-Server) があります。 -詳細については、以下を参照してください: +詳細は、以下を参照してください: - [Client-side integration](#client-side-integration) - [Client-server integration](#client-server-integration) @@ -38,7 +38,7 @@ Client-Side でインテグレーションする広告主は、JavaScript SDK ### Client-Side Integration: Security Values -Client-Side インテグレーションを選択する場合、UID2 サーバーに対してあなたを識別する 2 つの値からなるクライアントキーペアが提供されます: **Subscription ID** と **Public Key**。 +Client-Side インテグレーションを選択する場合、UID2 サーバーに対してあなたを識別する 2 つの値からなるClient Key ペアが提供されます: **Subscription ID** と **Public Key**。 詳細は[Subscription ID and Public Key](../getting-started/gs-credentials.md#subscription-id-and-public-key)を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-sso-providers.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-sso-providers.md index e600ce1a6..f93ab4c6a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-sso-providers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-integration-sso-providers.md @@ -1,7 +1,7 @@ --- title: Publisher Integration with SSO Providers sidebar_label: Publisher SSO Integration -description: Information for publishers for using single sign-on (SSO) providers with UID2. +description: UID2 と組み合わせてシングルサインオン (SSO) プロバイダーを使用するためのパブリッシャー向け情報。 hide_table_of_contents: false sidebar_position: 06 --- @@ -10,33 +10,33 @@ import Link from '@docusaurus/Link'; # Publisher Integration with SSO Providers -If you integrate with one or more SSO providers to offer SSO login, you might be able to retrieve the logged-in user's email address from the SSO provider to generate UID2 tokens. +SSO ログインを提供するために 1 つ以上の SSO プロバイダーとインテグレーションしている場合、SSO プロバイダーからログインユーザーのメールアドレスを取得して UID2 Token を生成できるかもしれません。 -This guide provides technical information about how to do this, for publisher integrations with several popular SSO providers. +このガイドでは、いくつかの一般的な SSO プロバイダーとのパブリッシャー インテグレーションについて、技術情報を提供します。 :::important -You are responsible for ensuring that your use of email addresses to create UID2s is consistent with your UID2 agreement, your company’s privacy policy, and any other platform or third-party terms to which your company is subject. +UID2 の作成に使用するメールアドレスが、UID2 契約、会社のプライバシーポリシー、および会社が適用されるその他のプラットフォームまたはサードパーティの条件に一貫していることを確認する責任があります。 ::: ## High-Level Steps -To integrate with a single sign-on solution, the general steps are as follows: +シングルサインオン ソリューションとインテグレーションする一般的な手順は次のとおりです: -1. Get an identity token from the SSO provider. +1. SSO プロバイダーからユーザーのアイデンティティ トークンを取得します。 -2. Extract the user's email address from the identity token. +2. アイデンティティ トークンからユーザーのメールアドレスを抽出します。 -3. Pass the user's email address to the [UID2 publisher integration](../guides/summary-guides.md#publisher-integrations) of your choice. +3. ユーザーのメールアドレスを選択した [UID2 publisher integration](../guides/summary-guides.md#publisher-integrations) に渡します。 :::note -To find out whether you have to apply [normalization and encoding](../getting-started/gs-normalization-encoding.md) to the email address, or the integration does it for you, check the documentation for your UID2 publisher integration. +メールアドレスに [正規化とエンコード](../getting-started/gs-normalization-encoding.md) を適用する必要があるか、またはインテグレーションで自動的に適用されるかを確認するには、UID2 publisher integration のドキュメントを参照してください。 ::: ## Sign in with Google -The following options are available for implementing [Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=en): +[Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=ja) を実装するための次のオプションが利用可能です: - [Sign in with Google for Android](#sign-in-with-google-for-android) - [Sign in with Google for iOS and macOS](#sign-in-with-google-for-ios-and-macos) @@ -44,39 +44,39 @@ The following options are available for implementing [Sign in with Google](https ### Sign in with Google for Android -Follow the instructions in [Create the Sign in with Google flow](https://developer.android.com/identity/sign-in/credential-manager-siwg#create-sign). Once the token has been validated, you can retrieve the email address by using the [getEmail() method](https://cloud.google.com/java/docs/reference/google-api-client/latest/com.google.api.client.googleapis.auth.oauth2.GoogleIdToken.Payload#com_google_api_client_googleapis_auth_oauth2_GoogleIdToken_Payload_getEmail__) of the identity token payload. +[Create the Sign in with Google flow](https://developer.android.com/identity/sign-in/credential-manager-siwg#create-sign) の手順に従います。トークンが検証された後、アイデンティティ トークンのペイロードの [getEmail() メソッド](https://cloud.google.com/java/docs/reference/google-api-client/latest/com.google.api.client.googleapis.auth.oauth2.GoogleIdToken.Payload#com_google_api_client_googleapis_auth_oauth2_GoogleIdToken_Payload_getEmail__) を使用してメールアドレスを取得できます。 ### Sign in with Google for iOS and macOS -To get an email address from [Sign in with Google](https://developers.google.com/identity/sign-in/ios/start-integrating) on iOS or macOS, retrieve it from the `GIDGoogleUser` object. For details, see [Getting profile information](https://developers.google.com/identity/sign-in/ios/people). +iOS または macOS で [Sign in with Google](https://developers.google.com/identity/sign-in/ios/start-integrating) からメールアドレスを取得するには、`GIDGoogleUser` オブジェクトから取得します。詳細は、[プロファイル情報の取得](https://developers.google.com/identity/sign-in/ios/people)を参照してください。 ### Sign in with Google for Web -Follow the instructions to [verify the Google ID token on your server side](https://developers.google.com/identity/gsi/web/guides/verify-google-id-token), and then retrieve the user's email address from the email field of the ID token. +[verify the Google ID token on your server side](https://developers.google.com/identity/gsi/web/guides/verify-google-id-token) の手順に従い、ID トークンの `email` フィールドからユーザーのメールアドレスを取得します。 ## Facebook Login -There are two ways to integrate Facebook Login with UID2: with an OpenID Connect (OIDC) token or without. +UID2 と Facebook Login を組み合わせる方法は、OpenID Connect (OIDC) トークンを使用するか、使用しないかの 2 つの方法があります。 ### Facebook Login Using an OIDC Token on iOS -To get an email address from [Facebook Login](https://developers.facebook.com/docs/facebook-login/) using an [OIDC token](https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-oidc/) on iOS: +iOS で [Facebook Login](https://developers.facebook.com/docs/facebook-login/) から¥[OIDC token](https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-oidc/) を使用してメールアドレスを取得するには: -1. Implement Facebook Login (for details, see [Use Facebook Login in Your iOS App](https://developers.facebook.com/docs/ios/use-facebook-login)) and request the `email` permission. +1. Facebook Login を実装し (詳細は、[Use Facebook Login in Your iOS App](https://developers.facebook.com/docs/ios/use-facebook-login) を参照)、`email` パーミッションをリクエストします。 -1. Extract the user's email address from the OIDC authentication token: for example, by using the `Profile` helper class. For details, see [OIDC Tokens in Facebook Login for iOS](https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-oidc). +1. OIDC token からユーザーのメールアドレスを抽出します。たとえば、`Profile` ヘルパー クラスを使用して抽出します。詳細は、[OIDC Tokens in Facebook Login for iOS](https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-oidc) を参照してください。 ### Facebook Login Without an OIDC Token -To get an email address from [Facebook Login](https://developers.facebook.com/docs/facebook-login/) without using an OIDC token: +OICD token を使用せずに [Facebook Login](https://developers.facebook.com/docs/facebook-login/) からメールアドレスを取得するには: -1. Request a [user access token](https://developers.facebook.com/docs/facebook-login/guides/access-tokens#usertokens), specifying the `email` permission. +1. `email` パーミッションを指定して、[user access token](https://developers.facebook.com/docs/facebook-login/guides/access-tokens#usertokens) をリクエストします。 -1. If the user has granted the `email` permission, make a Graph API call to the [`/me` endpoint](https://developers.facebook.com/docs/graph-api/overview#me), using the user access token, and specify `email` as one of the fields. +1. ユーザーが `email` パーミッションを許可した場合、ユーザーアクセストークンを使用して、`email` をフィールドとして指定して、[`/me` endpoint](https://developers.facebook.com/docs/graph-api/overview#me) に対して Graph API コールを行います。 ### Sample Applications -The following applications demonstrate how to integrate with Facebook Login: +以下のアプリケーションは、Facebook Login とのインテグレーション方法を示しています: - [Facebook Login sample application for Android](https://github.com/facebook/facebook-android-sdk/tree/main/samples/FBLoginSample) @@ -84,22 +84,23 @@ The following applications demonstrate how to integrate with Facebook Login: ## Sign In with Apple -The instructions for signing in with Apple are different for apps and websites. +Apple ID でサインインする方法は、アプリとウェブサイトで異なります。 ### Sign In with Apple in an App -Request authorization, making sure to request the `email` scope. For details, see [Request Authorization with Apple ID](https://developer.apple.com/documentation/sign_in_with_apple/implementing_user_authentication_with_sign_in_with_apple#3546458). +`email` スコープをリクエストして認証をリクエストします。詳細は、[Request Authorization with Apple ID](https://developer.apple.com/documentation/sign_in_with_apple/implementing_user_authentication_with_sign_in_with_apple#3546458) を参照してください。 -If authentication succeeds, retrieve the user's email address from the `email` property of the `ASAuthorizationAppleIDCredential` object. +承認に成功した場合、`ASAuthorizationAppleIDCredential` オブジェクトの `email` プロパティからユーザーのメールアドレスを取得します。 ### Sign In with Apple JS on a Webpage -Refer to the section [Handle the Authorization Response](https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple#3331292) of the page [Configure your webpage for Sign in with Apple](https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple). +[Configure your webpage for Sign in with Apple](https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple) ページの [Handle the Authorization Response](https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple#3331292) を参照してください。 ## Sign In with OpenPass -To get an email address from an [OpenPass](https://openpass.thetradedesk.com/en) integration: +[OpenPass](https://openpass.thetradedesk.com/en) インテグレーションからメールアドレスを取得するには: -1. Use the [OpenPass API](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassQuickstartsServerSide) or one of the [OpenPass SDKs](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassSDKs) to get an identity token. -1. Extract the user's email address from the `email` claim of the identity token. For details, see [OpenPass Authentication Tokens](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassTokensAuth). +1. [OpenPass API](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassQuickstartsServerSide) または [OpenPass SDKs](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassSDKs) のいずれかを使用して、アイデンティティ トークンを取得します。 + +1. アイデンティティ トークンの `email` クレームからユーザーのメールアドレスを抽出します。詳細は、[OpenPass Authentication Tokens](https://partner.thetradedesk.com/v3/portal/openpass/doc/OpenPassTokensAuth) を参照してください。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md index 4f43c7708..32f656c6f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-operators-public-private.md @@ -22,7 +22,7 @@ UID2 Operator は、Operator Service を実行する組織です。オペレー - UID2 Core Service から最新の暗号化キーとソルトを受け取り、保存します。 - raw UID2 を返すため DII をソルト化およびハッシュ化します。 - UID2 Token を生成するために raw UID2 を暗号化します。 -- UID2 Token の復号鍵をサーバーサイド SDK に配布します (詳細は [SDKs: Summary](../sdks/summary-sdks.md) を参照してください)。 +- UID2 Token の復号鍵を Server-Side SDK に配布します (詳細は [SDKs: Summary](../sdks/summary-sdks.md) を参照してください)。 - UID2 Opt-Out Service から最新のユーザーオプトアウト情報をダウンロードします。 - 複数の UID2 エンドポイントをサポートします。詳細は [UID2 Endpoints: Summary](../endpoints/summary-endpoints.md) を参照してください。 @@ -39,7 +39,7 @@ Public Operator は、関連するすべての UID2 参加者が利用できる ほとんどの場合、UID2 参加者は Public Operator を使用します。 -Public Operator は、UID2 administration が所有し管理します。例えば、現在 The Trade Desk は UID2 フレームワークの Public Operator として機能しており、すべての参加者が利用できます。他の Public Operator が利用可能な場合、参加者はどのオペレーターと連携するかを選択できます。 +Public Operator は、UID2 administration が所有し管理します。たとえば、現在 The Trade Desk は UID2 フレームワークの Public Operator として機能しており、すべての参加者が利用できます。他の Public Operator が利用可能な場合、参加者はどのオペレーターと連携するかを選択できます。 ## Public Operator: Benefits diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md index 086a9e755..98ca8bcfe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-server-side-token-generation.md @@ -19,7 +19,7 @@ import Link from '@docusaurus/Link'; - API エンドポイントへのダイレクトインテグレーション :::warning -セキュリティ上の理由により、トークン生成に使用される API キーとシークレットは Server-Side で呼び出す必要があります。これらの値を Web ページ、モバイルアプリ、または Prebid に保存しないでください。詳細については、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 +セキュリティ上の理由により、トークン生成に使用される API キーとシークレットは Server-Side で呼び出す必要があります。これらの値を Web ページ、モバイルアプリ、または Prebid に保存しないでください。詳細は、[Security of API Key and Client Secret](../getting-started/gs-credentials.md#security-of-api-key-and-client-secret) を参照してください。 ::: オプションは次の表にまとめられています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md index be97e0536..8a56d6eaa 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/ref-tokens.md @@ -101,7 +101,7 @@ Refresh Token に関する主なポイントは次のとおりです: -コード例を使用する前に、使用している言語の前提条件と注意事項を確認してください。詳細については、該当する SDK のドキュメントを参照してください: +コード例を使用する前に、使用している言語の前提条件と注意事項を確認してください。詳細は、該当する SDK のドキュメントを参照してください: - [SDK for Java, Usage for Publishers, Basic Usage Server-Side Integration section](../sdks/sdk-ref-java.md#basic-usage-server-side-integration) - [SDK for Python, Usage for Publishers, Server-Side Integration section](../sdks/sdk-ref-python.md#server-side-integration) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md index f54b9b0a0..6b17081f2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/updates-doc.md @@ -11,6 +11,46 @@ import Link from '@docusaurus/Link'; UID2 ドキュメンテーションリソースの最新アップデートを確認してください。 +### Updated: Instructions for Using the UID2 Portal + +February 10, 2025 + +UID2 インテグレーションガイド、SDK ドキュメント、エンドポイントドキュメントに、UID2 Portal でのアカウント設定に関する情報を追加しました。 + +詳細は、実装ガイドを参照してください: たとえば、[Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md#complete-uid2-account-setup-and-configure-account) または [SDK for Android Reference Guide](../sdks/sdk-ref-android.md#api-permissions)。 + +また、これらの変更により、環境によって認証情報を取得する手順が異なることが明確になりました: [Credentials](../getting-started/gs-credentials.md) および [Environments](../getting-started/gs-environments.md) ページで詳細を確認してください。 + + + +### New: Expanded and Restructured Advertiser/Data Provider Doc + +January 10, 2025 + +広告主とデータプロバイダーのドキュメントを大幅に拡充し、再構築しました。新しい概要ドキュメントと、Snowflake、AWS Entity Resolution、HTTP エンドポイントの 3 つの主要なインテグレーションオプションに関する個別のドキュメントがあります: + +広告主とデータプロバイダー向けのすべてのインテグレーションオプションの概要については、[Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md) を参照してください。 + + + +### New: Publisher SSO Integration Page + +January 8, 2025 + +SSO ログインを提供するために SSO プロバイダーとインテグレーションし、SSO プロバイダーからログインユーザーのメールアドレスを取得して UID2 Token を生成したいパブリッシャー向けの新しいリファレンスページを追加しました。 + +詳細は、[Publisher Integration with SSO Providers](ref-integration-sso-providers.md) を参照してください。 + + + + + + + ### New: Zoom-In Tool for Images December 15, 2024 @@ -85,7 +125,7 @@ For details, see [UID2 Tokens and Refresh Tokens]. --> July 23, 2024 -Client-Side、Client-Server、Server-Side の異なる統合アプローチに関する情報を含む新しいページを追加しました。 +Client-Side、Client-Server、Server-Side の異なるインテグレーションアプローチに関する情報を含む新しいページを追加しました。 詳細は [Integration Approaches](ref-integration-approaches.md) を参照してください。 @@ -194,7 +234,7 @@ February 28, 2024 Java SDKは、[POST /identity/map](../endpoints/post-identity-map.md) エンドポイントの使用を希望する広告主およびデータプロバイダーをサポートするようになりました。 -詳細については、*SDK for Javaリファレンスガイド*: [Usage for Advertisers and Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) の更新されたドキュメントを参照してください。 +詳細は、*SDK for Javaリファレンスガイド*: [Usage for Advertisers and Data Providers](../sdks/sdk-ref-java.md#usage-for-advertisersdata-providers) の更新されたドキュメントを参照してください。 @@ -430,7 +470,7 @@ August 3, 2023 UID2 のウェブサイト全体が、英語だけでなく日本語でも利用できるようになりました。 -詳細については、各サイトのページ上部にある言語ドロップダウンを使うか、直接 [Unified ID 2.0 in Japanese](https://unifiedid.com/ja/docs/intro) にアクセスしてください。 +詳細は、各サイトのページ上部にある言語ドロップダウンを使うか、直接 [Unified ID 2.0 in Japanese](https://unifiedid.com/ja/docs/intro) にアクセスしてください。 ### New: UID2 Portal Documentation diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md index b5f5993b2..6dc4d5bf5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-android.md @@ -36,10 +36,20 @@ SDK for Android は、Android アプリに代わって UID2 ID を生成また デフォルトでは、SDK は有効期限に基づいて UID2 ID を自動的にリフレッシュします。ただし、これを無効にして、実装アプリが UID2 ID のライフサイクルを手動で管理できるようにすることもできます。 +## UID2 Account Setup + +UID2 とのインテグレーションを行うには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。 +初期アカウント設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作を行うことができます: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 + +UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションオプションの概要については、[Client-Side or Client-Server Integration?](../guides/integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + + ## SDK Version @@ -175,7 +185,7 @@ UID2Manager API の一部として利用可能な関数は次のとおりです: #### setIdentity() -SDK が管理する、Server-Side で作成された UID2 Identity を設定します。詳細については、*Client-Server Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-server.md#configure-the-uid2-mobile-sdk) を参照してください。 +SDK が管理する、Server-Side で作成された UID2 Identity を設定します。詳細は、*Client-Server Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-server.md#configure-the-uid2-mobile-sdk) を参照してください。 #### resetIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md index 5ba2f3b30..f3b806fe7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-cplusplus.md @@ -23,13 +23,19 @@ UID2 Server-Side SDK を使用すると、UID2 Token を復号化して raw UID2 | :--- | :--- | :--- | :--- | :--- | :--- | | ✅ | ✅ | — | — | — | — | +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +アカウントの初期設定が完了すると、パブリッシャー、広告主、またはデータプロバイダーの場合、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作が可能です: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 -詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 +DSP の場合は、資格情報を送信します。 ## Version diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md index 65b15bb7a..3c6e45924 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-csharp-dotnet.md @@ -23,13 +23,19 @@ Server-Side では、C# / .NET SDK を使用して、raw UID2 を暗号化して | :--- | :--- | :--- | :--- | :--- | :--- | | ✅ | ✅ | — | — | — | — | +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +アカウントの初期設定が完了すると、パブリッシャー、広告主、またはデータプロバイダーの場合、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作が可能です: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 -詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 +DSP の場合は、資格情報を送信します。 ## Version @@ -130,7 +136,7 @@ client.Refresh(); ``` 3. トークンを raw UID2 に復号化します。トークンを渡し、次のいずれかを行います: - * ビッドリクエストがパブリッシャーのウェブサイトから発信された場合、ドメイン名を渡します。ドメイン名は、すべて小文字で、スペースなし、サブドメインなしである必要があります。例えば、`Subdomain.DOMAIN.com` の場合、`domain.com` を渡します。 + * ビッドリクエストがパブリッシャーのウェブサイトから発信された場合、ドメイン名を渡します。ドメイン名は、すべて小文字で、スペースなし、サブドメインなしである必要があります。たとえば、`Subdomain.DOMAIN.com` の場合、`domain.com` を渡します。 * ビッドリクエストがモバイルアプリから発信された場合、app name を渡します。 * それ以外の場合は、`null` を渡します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md index 2c14047ed..ef817c14e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-ios.md @@ -33,10 +33,20 @@ SDK for iOS は、iOS アプリケーションに代わって UID2 ID を生成 デフォルトでは、SDK は有効期限に基づいて UID2 ID を自動的にリフレッシュします。ただし、これを無効にして、アプリが UID2 IDのライフサイクルを手動で管理できるように実装することもできます。 +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って UID2 アカウントのセットアップを完了する必要があります。 -SDKが提供する特定の機能を使用する許可が与えられ、そのアクセス用の認証情報が与えられます。 +初期アカウント設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作が可能です: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 + +UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションのオプションの概要については、[Client-Side or Client-Server Integration?](../guides/integration-mobile-overview#client-side-or-client-server-integration) を参照してください。 + + ## SDK Version @@ -156,11 +166,11 @@ UID2Manager API の一部として利用可能な関数は次のとおりです: #### generateIdentity() -直接識別情報 (DII) を使用して UID2 Identity を生成します。詳細については、*Client-Side Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 +直接識別情報 (DII) を使用して UID2 Identity を生成します。詳細は、*Client-Side Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-side.md#configure-the-uid2-mobile-sdk) を参照してください。 #### setIdentity() -SDK が管理する、Server-Side で作成された UID2 Identity を設定します。詳細については、*Client-Server Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-server.md#configure-the-uid2-mobile-sdk) を参照してください。 +SDK が管理する、Server-Side で作成された UID2 Identity を設定します。詳細は、*Client-Server Integration Guide for Mobile* の [Configure the UID2 Mobile SDK](../guides/integration-mobile-client-server.md#configure-the-uid2-mobile-sdk) を参照してください。 #### resetIdentity() diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md index 833f24d31..70b69652e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-java.md @@ -19,13 +19,19 @@ Server-Side で Java SDK を使用すると、UID2 を使用してクライア | :--- | :--- | :--- | :--- | :--- | :--- | | ✅ | ✅ | ✅ | ✅ | ✅ | — | +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、最初に [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +アカウントの初期設定が完了すると、パブリッシャー、広告主、またはデータプロバイダーの場合、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作が可能です: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 -詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 +DSP の場合は、資格情報を送信します。 ## Version @@ -342,7 +348,7 @@ client.refresh(); ``` 3. トークンを raw UID2に復号します。トークンを渡し、以下のいずれかを実行します: -* ビッドリクエスト元がパブリッシャーのウェブサイトである場合は、ドメイン名を渡します。ドメイン名はすべて小文字で、スペースを入れず、サブドメインを含まないものでなければなりません。例えば、`Subdomain.DOMAIN.com` は `domain.com` を代わりに渡します。 +* ビッドリクエスト元がパブリッシャーのウェブサイトである場合は、ドメイン名を渡します。ドメイン名はすべて小文字で、スペースを入れず、サブドメインを含まないものでなければなりません。たとえば、`Subdomain.DOMAIN.com` は `domain.com` を代わりに渡します。 *ビッドリクエストがモバイルアプリから発生した場合は、app name を渡します。 * 上記以外は `null` を渡します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md index d7395fd39..a0638beaf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript-v2.md @@ -17,8 +17,9 @@ import ExampleJavaScriptV2Init from '../snippets/_example-javascript-v2-init.mdx この SDK を使用して、UID2 を使用してクライアントの ID を確立し、広告トークンを取得するプロセスを容易にします。以下のセクションでは、UID2 を確立するための [workflow](#workflow-overview) について説明し、SDK の [API reference](#api-reference) を提供し、[UID2 cookie format](#uid2-cookie-format) について説明します。 -- コンテンツパブリッシャーのインテグレーション手順については、[Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) を参照してください。 -- [example application](https://example-jssdk-integ.uidapi.com/) と関連ドキュメントについては、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) ガイドを参照してください。 +コンテンツパブリッシャー向けのインテグレーション手順については、[Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) を参照してください。 + +関連ドキュメントと [example application](https://example-jssdk-integ.uidapi.com/) については、[UID2 SDK Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) を参照してください。 ## Functionality @@ -30,9 +31,9 @@ import ExampleJavaScriptV2Init from '../snippets/_example-javascript-v2-init.mdx ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページの手順に従って、UID2 アカウントの設定を完了する必要があります。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。 詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 @@ -90,7 +91,7 @@ Web インテグレーションの詳細は [Client-Server Integration Guide for | :--- | :--- | :---| :---| :---| | Initialization | `undefined`| `undefined`| コールバックが呼び出されるまでの初期状態です。 | N/A | | Identity Is Available | available |`false` | 有効な ID が正常に確立または更新されました。ターゲティング広告で Advertising Toke を使用できます。 |`ESTABLISHED` or `REFRESHED` | -| Identity Is Temporarily Unavailable |`undefined` | `false`| Advertising Token の有効期限が切れたため、自動更新に失敗しました。[Background auto-refresh](#background-token-auto-refresh) は、Refresh Token の有効期限が切れるか、ユーザーがオプトアウトするまで続きます。
以下のいずれかを行ってください:
- ユーザーをリダイレクトし、メールアドレスまたは電話番号の入力を求める。
- ターゲティングしない広告を使用する。
NOTE: ID は後で正常にリフレッシュされるかもしれません。—例えば、UID2 Serviceが一時的に利用できなくなった場合などです。 | `EXPIRED` | +| Identity Is Temporarily Unavailable |`undefined` | `false`| Advertising Token の有効期限が切れたため、自動更新に失敗しました。[Background auto-refresh](#background-token-auto-refresh) は、Refresh Token の有効期限が切れるか、ユーザーがオプトアウトするまで続きます。
以下のいずれかを行ってください:
- ユーザーをリダイレクトし、メールアドレスまたは電話番号の入力を求める。
- ターゲティングしない広告を使用する。
NOTE: ID は後で正常にリフレッシュされるかもしれません。—たとえば、UID2 Serviceが一時的に利用できなくなった場合などです。 | `EXPIRED` | | Identity Is Not Available | `undefined`| `false`| ID が利用できず、リフレッシュできません。SDK はファーストパーティクッキーをクリアします。
UID2 ベースのターゲティング広告を再度使用するには、UID2 を取得できるログインまたはフォーム入力にユーザーをリダイレクトする必要があります。 | `INVALID`, `NO_IDENTITY`, `REFRESH_EXPIRED`, or `OPTOUT` | 次の図は、対応する ID の [status values](#identity-status-values) を含む 4 つの状態と、それらの間で可能な遷移を示しています。SDK は各遷移で [callback function](#callback-function) を呼び出します。 @@ -108,7 +109,7 @@ Token の Auto-refresh について知っておくべきことは以下のとお - SDK の初期化時に指定された [callback function](#callback-function) は、以下の場合に呼び出されます: - リフレッシュが成功するたびに呼び出されます。 - 有効期限が切れた Advertising Token のリフレッシュに最初に失敗した場合。 - - 例えば、ユーザーがオプトアウトした場合などです。
NOTE: ID が一時的に利用できず、自動更新が失敗し続ける場合、コールバックは呼び出されません。この場合、SDK は既存の Advertising Token を使用し続けます。 + - たとえば、ユーザーがオプトアウトした場合などです。
NOTE: ID が一時的に利用できず、自動更新が失敗し続ける場合、コールバックは呼び出されません。この場合、SDK は既存の Advertising Token を使用し続けます。 - [disconnect()](#disconnect-void) 呼び出しはアクティブなタイマーをキャンセルします。 ## API Reference @@ -154,7 +155,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 ``` -例えば: +たとえば: @@ -176,9 +177,9 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 | :--- | :--- | :--- | :--- | :--- | | `callback` | `function(object): void` | 必須 | 渡された ID を検証した後に SDK が呼び出す関数です。[Callback Function](#callback-function) を参照してください。 | N/A | | `identity` | object | オプション | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) 呼び出しが成功したときの `body` プロパティ値です。
[ファーストパーティクッキー](#uid2-cookie-format) からの ID を使用するには、このプロパティを空にしておきます。 | N/A | -| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
例えば: `https://my.operator.com`. | `https://prod.uidapi.com`. | +| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | | `refreshRetryPeriod` | number | オプション | 断続的なエラーが発生した場合に、トークンのリフレッシュを再試行する秒数です。 | 5 | -| `cookieDomain` | string | オプション | [UID2 cookie](#uid2-cookie-format) に適用するドメイン名文字列です。
例えば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | +| `cookieDomain` | string | オプション | [UID2 cookie](#uid2-cookie-format) に適用するドメイン名文字列です。
たとえば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | | `cookiePath` | string | オプション | [UID2 cookie](#uid2-cookie-format) に適用する Path 文字列です。 | `/` | @@ -241,7 +242,7 @@ ID が利用できない場合は、[isLoginRequired()](#isloginrequired-boolean - [callback function](#callback-function) はまだ呼び出されていません。これは SDK の初期化が完了していないことを意味します。 - SDK の初期化は完了していますが、使用する有効な ID がありません。 -- SDK の初期化は完了しましたが、自動更新により ID がクリアされました—例えば、ユーザーがオプトアウトした場合などです。 +- SDK の初期化は完了しましたが、自動更新により ID がクリアされました—たとえば、ユーザーがオプトアウトした場合などです。 ID が利用できない場合は、[isLoginRequired()](#isloginrequired-boolean) 関数を使用して最良の対処法を決定します。 @@ -309,7 +310,7 @@ UID2 [POST /token/generate](../endpoints/post-token-generate.md) 呼び出 バックグラウンドのタイマーやリクエストを終了します。UID2 オブジェクトは指定されていない状態のままで、これ以上使用することはできません。 -この関数は、既存の UID2 オブジェクトを新しいインスタンスで置き換えるような高度なシナリオで使用することを想定しています。例えば、シングルページのアプリケーションでこれを使用すると、[POST /token/generate](../endpoints/post-token-generate.md) レスポンスでサーバーから新しい ID を受け取った後に、現在の UID2 オブジェクトをクリアして新しいオブジェクトを作成したり初期化したりすることができます。 +この関数は、既存の UID2 オブジェクトを新しいインスタンスで置き換えるような高度なシナリオで使用することを想定しています。たとえば、シングルページのアプリケーションでこれを使用すると、[POST /token/generate](../endpoints/post-token-generate.md) レスポンスでサーバーから新しい ID を受け取った後に、現在の UID2 オブジェクトをクリアして新しいオブジェクトを作成したり初期化したりすることができます。 ## UID2 Cookie Format diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md index 297040882..36abc1331 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-javascript.md @@ -30,10 +30,10 @@ export const Deprecated3100 = () => ( 以下のセクションでは、UID2 ID の確立のための高レベルな [ワークフロー](#workflow-overview)、SDK [API リファレンス](#api-reference)、および UID2 [ストレージフォーマット](#uid2-storage-format) を説明します。 :::tip -UID2 Identify Module、または UID2 サポートのある他の製品と Prebid.js を使用している場合、SDK を使用する必要はありません。Prebid.js モジュールがすべてを管理します。詳細については、[UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください。 +UID2 Identify Module、または UID2 サポートのある他の製品と Prebid.js を使用している場合、SDK を使用する必要はありません。Prebid.js モジュールがすべてを管理します。詳細は、[UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) を参照してください。 ::: -このページでは、SDK のバージョン 3 について説明します。以前のバージョンを使用している場合は、[移行ガイド](#migration-guide) を使用してインテグレーションをアップグレードすることをお勧めします。必要に応じて、[SDK の以前のバージョン](./sdk-ref-javascript-v2.md) のドキュメントも利用できます。 +このページでは、SDK のバージョン 3 について説明します。以前のバージョンを使用している場合は、[移行ガイド](#migration-guide) を使用してインテグレーションをアップグレードすることを勧めます。必要に応じて、[SDK の以前のバージョン](./sdk-ref-javascript-v2.md) のドキュメントも利用できます。 コンテンツパブリッシャー向けのインテグレーション手順は、以下のガイドを参照してください: - [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) @@ -55,13 +55,18 @@ UID2 Identify Module、または UID2 サポートのある他の製品と Prebi - Running site: [Client-Side UID2 SDK Integration Example](https://secure-signals-client-server-integ.uidapi.com/) - The example of JavaScript client-side integration: [Code](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) and running site ([Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)). -## API Permissions +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +## API Permissions -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +初期アカウント設定が完了すると、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作を行うことができます: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。 ## SDK Version @@ -158,7 +163,7 @@ Token の Auto-refresh について知っておくべきことは以下のとお ### Callback Function [Array Push Pattern](#array-push-pattern) を使用して、UID2 SDK からイベントを受信する関数を登録できます。現在利用可能なイベントはいくつかあります: -- `SdkLoaded` は SDK がパースされ、グローバルな `__uid2` オブジェクトが構築された後に発生します。これは `init()` を呼び出す際に便利で、特にスクリプトのロード順序が保証されていない場合に便利です (例えば、スクリプトのロードに `async` や `defer` を使用している場合など)。 +- `SdkLoaded` は SDK がパースされ、グローバルな `__uid2` オブジェクトが構築された後に発生します。これは `init()` を呼び出す際に便利で、特にスクリプトのロード順序が保証されていない場合に便利です (たとえば、スクリプトのロードに `async` や `defer` を使用している場合など)。 - `init()` が終了し、SDK を使用できる状態になると `InitCompleted` が発生します。`init` 呼び出しで ID が提供された場合、または SDK が以前に提供された ID をロードできた場合、その ID がペイロードに含まれます。 - `IdentityUpdated` は、新しいIDが利用可能になるか、既存の ID が利用できなくなるたびに発生します。 @@ -227,7 +232,7 @@ Token の Auto-refresh について知っておくべきことは以下のとお #### Array Push Pattern -順番にロードされることが保証されていないスクリプトタグ (例えば、`async` や `defer` スクリプトタグを使用している場合など) を最適にサポートするために、コールバックを登録するには以下のパターンを使用します: +順番にロードされることが保証されていないスクリプトタグ (たとえば、`async` や `defer` スクリプトタグを使用している場合など) を最適にサポートするために、コールバックを登録するには以下のパターンを使用します: ```js window.__uid2 = window.__uid2 || {}; @@ -323,16 +328,16 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 | Property | Data Type | Attribute | Description | Default Value | | :--- | :--- | :--- | :--- | :--- | | `identity` | object | オプション | [POST /token/generate](../endpoints/post-token-generate.md) または [POST /token/refresh](../endpoints/post-token-refresh.md) 呼び出しが成功したときの `body` プロパティ値です。
[ファーストパーティクッキー](sdk-ref-javascript-v2.md#uid2-cookie-format) からの ID を使用するには、このプロパティを空にしておきます。 | N/A | -| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
例えば: `https://my.operator.com`. | `https://prod.uidapi.com`. | +| `baseUrl` | string | オプション | [POST /token/refresh](../endpoints/post-token-refresh.md) エンドポイントを呼び出す際に使用する UID2 Operator のカスタム Base URLです。
たとえば: `https://my.operator.com`. | `https://prod.uidapi.com`. | | `refreshRetryPeriod` | number | オプション | 断続的なエラーが発生した場合に、トークンのリフレッシュを再試行するミリ秒数です。
この値は 1000 以上でなければなりません。 | 5000 | -| `cookieDomain` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用するドメイン名文字列です。
例えば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | +| `cookieDomain` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用するドメイン名文字列です。
たとえば、`baseUrl` が `https://my.operator.com` の場合、`cookieDomain` の値は `operator.com` となります。 | `undefined` | | `cookiePath` | string | オプション | [UID2 cookie](sdk-ref-javascript-v2.md#uid2-cookie-format) に適用する Path 文字列です。 | `/` | | `useCookie` | `boolean` | オプション | この値を `true` に設定すると、SDK はローカルストレージではなくクッキーに ID を保存します。この値がfalseであるか、提供されていない場合でも、ファーストパーティクッキーを使用して ID を提供することができます。 | | `callback` | `function(object): void` | 非推奨 | 渡された ID を検証した後に SDK が呼び出す関数です。新しいインテグレーションには使用しないでください。 | N/A | #### Multiple Init Calls -`init()` 関数は何度でも呼び出すことができます。ほとんどの場合、特定の [init parameter](#init-parameters) の最新の値を受け入れます。例えば、`baseUrl` が 2 回呼び出され、それぞれ異なる `baseUrl` が渡された場合、`baseUrl` 変数は 2 回目の呼び出しからの値に更新されます。 +`init()` 関数は何度でも呼び出すことができます。ほとんどの場合、特定の [init parameter](#init-parameters) の最新の値を受け入れます。たとえば、`baseUrl` が 2 回呼び出され、それぞれ異なる `baseUrl` が渡された場合、`baseUrl` 変数は 2 回目の呼び出しからの値に更新されます。 この機能には 2 つの例外があります: @@ -340,7 +345,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 2. 移行、渡されたコールバック関数のすべてに対し、[Array Push Pattern](#array-push-pattern) を使用して既存のコールバック配列に関数が追加されます。 :::note -`useCookie` が更新されると、identity の場所が変わります。例えば、値が `true` から `false` に更新されると、ファーストパーティクッキーが削除され、identity がローカルストレージに追加されます。 +`useCookie` が更新されると、identity の場所が変わります。たとえば、値が `true` から `false` に更新されると、ファーストパーティクッキーが削除され、identity がローカルストレージに追加されます。 ::: ### Init Config @@ -364,7 +369,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 これは後方互換性のためだけに提供されています。新しいインテグレーションでは、新しいスタイルの [callback function](#callback-function) を使う必要があります。レガシーコールバックは [Array Push Pattern](#array-push-pattern) を使って登録することができません。また、新スタイルのコールバックは `init` に渡すことができません。 -詳細については、以前のバージョンの SDK のドキュメントの[Legacy Callback Function](./sdk-ref-javascript-v2#callback-function) を参照してください。 +詳細は、以前のバージョンの SDK のドキュメントの[Legacy Callback Function](./sdk-ref-javascript-v2#callback-function) を参照してください。 すでにレガシーコールバック関数を使用してインテグレーションを構築している場合は、現在のバージョンの SDK で変更なく使用できます。ただし、この機能は SDK の将来のバージョンで削除される予定です。新しいスタイルの [callback function](#callback-function) を使用するようにインテグレーションを更新することを強く勧めます。 @@ -383,7 +388,7 @@ SDK を初期化し、ターゲティング広告用のユーザー ID を確立 この関数は、以下の条件のいずれかに該当する場合、`undefined` を返します: - SDK の初期化は完了していますが、使用する有効な Identity がありません。 -- SDK の初期化は完了しましたが、自動更新により Identity がクリアされました—例えば、ユーザーがオプトアウトした場合などです。 +- SDK の初期化は完了しましたが、自動更新により Identity がクリアされました—たとえば、ユーザーがオプトアウトした場合などです。 ID が利用できない場合は、[isLoginRequired()](#isloginrequired-boolean) 関数を使用して最良の対処法を決定します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md index 341403ad9..fd38bfe49 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sdks/sdk-ref-python.md @@ -19,13 +19,19 @@ Server-Side で Python SDK を使用すると、UID2 を使用してクライア | :--- | :--- | :--- | :--- | :--- | :--- | | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +## UID2 Account Setup + +UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず [Account Setup](../getting-started/gs-account-setup.md) ページの手順に従ってください。 + ## API Permissions -この SDK を使用するには、[Account Setup](../getting-started/gs-account-setup.md) ページに記載されている手順に従って、UID2 アカウントのセットアップを完了する必要があります。 +アカウントの初期設定が完了すると、パブリッシャー、広告主、またはデータプロバイダーの場合、[UID2 Portal](../portal/portal-overview.md) にアクセスするための手順とリンクが送信されます。以下の操作が可能です: +- アカウント用の [credentials](../getting-started/gs-credentials.md) を生成します。 +- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。 -SDK が提供する特定の機能の使用許可が与えられ、そのアクセス用の認証情報が与えられます。SDK には、使用する権限を持たない機能があるかもしれないことに留意してください。例えば、パブリッシャーはトークンの生成と更新のために特定の API Permissions を取得しますが、SDK は共有などの他のアクティビティをサポートするかもしれません。 +SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。SDK には使用権限がない機能がある可能性があることに注意してください。詳細については、[API Permissions](../getting-started/gs-permissions.md) を参照してください。 -詳細は [API Permissions](../getting-started/gs-permissions.md) を参照してください。 +DSP の場合は、資格情報を送信します。 ## Version @@ -297,7 +303,7 @@ client.refresh() ``` 3. トークンを raw UID2 に復号化します。トークンを渡し、次のいずれかを行います: -* ビッドリクエストがパブリッシャーのウェブサイトから発信された場合、ドメイン名を渡します。ドメイン名は、すべて小文字で、スペースなし、サブドメインなしである必要があります。例えば、`Subdomain.DOMAIN.com` の場合、`domain.com` を渡します。 +* ビッドリクエストがパブリッシャーのウェブサイトから発信された場合、ドメイン名を渡します。ドメイン名は、すべて小文字で、スペースなし、サブドメインなしである必要があります。たとえば、`Subdomain.DOMAIN.com` の場合、`domain.com` を渡します。 * ビッドリクエストがモバイルアプリから発信された場合、app name を渡します。 * それ以外の場合は、`null` を渡します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md index bbc0bf009..6cd2ed28c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-security.md @@ -95,7 +95,7 @@ Accounting とは、取引の記録があり、必要に応じてその活動を システムはまた、アクセス時間、持続時間、リソースの使用量などの使用指標を記録し、契約条件の遵守を確認し、該当する場合は課金目的に使用します。 7. Feedback and Notification: - - 承認プロセスが完了すると、受信者はアクセス状況に関する通知を受け取ります。アクセスが許可された場合は、その旨が通知され、次に進むことができます。アクセスが拒否された場合は、説明や次のアクションの手順を受け取ります。例えば、共有の受信者は、ダウンロードの準備ができたというメール通知を受け取るかもしれません。 + - 承認プロセスが完了すると、受信者はアクセス状況に関する通知を受け取ります。アクセスが許可された場合は、その旨が通知され、次に進むことができます。アクセスが拒否された場合は、説明や次のアクションの手順を受け取ります。たとえば、共有の受信者は、ダウンロードの準備ができたというメール通知を受け取るかもしれません。 - 検証者は、自分の介入が正常に記録され、対処されたことを確認する通知を受け取ることもあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-bid-stream.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-bid-stream.md index 7b7f8298f..69cb7bf17 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-bid-stream.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-bid-stream.md @@ -13,7 +13,7 @@ import Link from '@docusaurus/Link'; パブリッシャーは、[implementation options](#implementation-options-for-senders) のいずれかを使用して DII を UID2 Token に暗号化し、UID2 Token をビッドストリームに送信できます。 -他の共有参加者も、このトークン化された共有形態を使用する可能性があります。例えば、広告主がトラッキングピクセル用の UID2 Token を作成するために使用するかもしれません。 +他の共有参加者も、このトークン化された共有形態を使用する可能性があります。たとえば、広告主がトラッキングピクセル用の UID2 Token を作成するために使用するかもしれません。 :::caution ビッドストリーム内のデータは不正にアクセスされる可能性があるため、raw UID2 をビッドストリームで共有することは決して許されません。ビッドストリームで共有する場合は、Tokenized Sharing が必要です。 @@ -143,7 +143,7 @@ UID2 Token を raw UID2 に復号するには、許可された共有者であ 暗号鍵の更新を定期的に行い、UID2 Token を速やかに復号化することが重要です。 -詳細については、*UID2 Sharing: Best Practices*の以下のセクションを参照してください: +詳細は、*UID2 Sharing: Best Practices*の以下のセクションを参照してください: - [Decryption Key Refresh Cadence for Sharing](sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) - [Best Practices for Managing Raw UID2s and UID2 Tokens](sharing-best-practices.md#best-practices-for-managing-raw-uid2s-and-uid2-tokens) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md index 9c372f95a..f4deb89a4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-data-pixel.md @@ -93,7 +93,7 @@ For details, see [Receiving UID2 Tokens from Another Sharing Participant](sharin 暗号鍵の更新を定期的に行い、UID2 Token をすみやかに復号化することが重要です。 -詳細については、*UID2 Sharing: Best Practices* の次のセクションを参照してください: +詳細は、*UID2 Sharing: Best Practices* の次のセクションを参照してください: - [Decryption Key Refresh Cadence for Sharing](sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) - [Best Practices for Managing Raw UID2s and UID2 Tokens](sharing-best-practices.md#best-practices-for-managing-raw-uid2s-and-uid2-tokens) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md index 6585e310c..5ac053412 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-from-raw.md @@ -134,7 +134,7 @@ UID2 Token を raw UID2 に復号化するには、UID2 Portal アカウント 暗号鍵を定期的に更新し、UID2 Token をすみやかに復号化することが重要です。 -詳細については、*UID2 Sharing: Best Practices* の次のセクションを参照してください: +詳細は、*UID2 Sharing: Best Practices* の次のセクションを参照してください: - [Decryption Key Refresh Cadence for Sharing](sharing-best-practices.md#decryption-key-refresh-cadence-for-sharing) - [Best Practices for Managing Raw UID2s and UID2 Tokens](sharing-best-practices.md#best-practices-for-managing-raw-uid2s-and-uid2-tokens) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md index 544295b97..20d6d7794 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/sharing/sharing-tokenized-overview.md @@ -171,7 +171,7 @@ raw UID2 から始める場合は、次の手順に従ってください: 2 K2jlbu2ldlpKL1z6n5bET7L3
g0xfqmldZPDdPTktdRQ= -UID2 Token を生成するために raw UID2 を暗号化する:
利用可能な SDK の `encrypt()` 関数を使用します。例えば Java の場合、Usage for UID2 Sharers step 3 を参照してください。 +UID2 Token を生成するために raw UID2 を暗号化する:
利用可能な SDK の `encrypt()` 関数を使用します。たとえば Java の場合、Usage for UID2 Sharers step 3 を参照してください。 KlKKKfE66A7xBnL/DsT1UV/Q+V/r3xwKL89Wp7hpNllxmNkPaF8vdzenDvfoatn6sSXbFf5DfW9wwbdDwMnnOVpPxojkb8KYSGUte/FLSHtg4CLKMX52UPRV7H9UbWYvXgXC4PaVrGp/Jl5zaxPIDbAW0chULHxS+3zQCiiwHbIHshM+oJ== @@ -183,7 +183,7 @@ raw UID2 から始める場合は、次の手順に従ってください: UID2 Token は、もととなる raw UID2 が同じであっても、UID2 Token が生成されるたびにトークンの値が異なるように設計されています。つまり、UID2 Token は誰でも見ることができますが、復号鍵にアクセスできる UID2 参加者のみが使用できます。 -例えば、UID2 Token は、パブリッシャーから DSP へビットストリームを通じて定期的に渡されます。UID2 Token は、パブリッシャーから SSP など複数の関係者を経由することがありますが、UID2 Token は、許可された UID2 参加者によってのみ復号化できます。ビットストリームを通じて UID2 Token が複数の中間者を通過する場合でも、UID2 Token は安全に渡されます。 +たとえば、UID2 Token は、パブリッシャーから DSP へビットストリームを通じて定期的に渡されます。UID2 Token は、パブリッシャーから SSP など複数の関係者を経由することがありますが、UID2 Token は、許可された UID2 参加者によってのみ復号化できます。ビットストリームを通じて UID2 Token が複数の中間者を通過する場合でも、UID2 Token は安全に渡されます。 UID2 共有参加者間の Tokenized sharing でも同じことが言えます。UID2 Token は、非 UID2 参加者を経由して渡すことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_integrating-with-sso.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_integrating-with-sso.mdx index 13edab828..f851c9327 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_integrating-with-sso.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_integrating-with-sso.mdx @@ -1 +1 @@ -For information about integrating with Single Sign-On (SSO) providers, see [Publisher Integration with SSO Providers](/docs/ref-info/ref-integration-sso-providers.md). \ No newline at end of file +シングルサインオン(SSO)プロバイダーとのインテグレーションに関する情報は、[Publisher Integration with SSO Providers](../ref-info/ref-integration-sso-providers.md) を参照してください。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile-docs-error-response-states.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile-docs-error-response-states.mdx index 1dad53c79..6673b939d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile-docs-error-response-states.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile-docs-error-response-states.mdx @@ -17,7 +17,7 @@ **Automatic refresh**: SDK で自動リフレッシュが有効になっている場合 (`automaticRefreshEnabled` プロパティ)、SDK がトークンを自動的にリフレッシュします。ただし、この状態が発生する可能性があるいくつかのシナリオがあります。 -例えば、アプリが起動され、SDK がすぐにクエリされた場合、レスポンスステータスが `Expired` になる可能性がありますが、バックグラウンドで SDK がトークンをリフレッシュしており、すぐに新しい ID で更新されます。 +たとえば、アプリが起動され、SDK がすぐにクエリされた場合、レスポンスステータスが `Expired` になる可能性がありますが、バックグラウンドで SDK がトークンをリフレッシュしており、すぐに新しい ID で更新されます。 この場合、何もする必要はありません。SDK が初期化されるとすぐにトークンがリフレッシュされます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile_docs_prebid-mobile.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile_docs_prebid-mobile.mdx index 84c792905..745ab2161 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile_docs_prebid-mobile.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile_docs_prebid-mobile.mdx @@ -44,7 +44,7 @@ UID2 Prebid for Mobile インテグレーションを設定するには、次の :::warning - Swift Package Manager を用いたインテグレーションは、Prebid Mobile SDK がサポートするまでサポートされません。詳細については、[Prebid's Mobile SDK documentation](https://docs.prebid.org/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-pm) を参照してください。 + Swift Package Manager を用いたインテグレーションは、Prebid Mobile SDK がサポートするまでサポートされません。詳細は、[Prebid's Mobile SDK documentation](https://docs.prebid.org/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-pm) を参照してください。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx index d8e55f9dc..08b165e17 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/snippets/_private-operator-attest-failure.mdx @@ -1,7 +1,7 @@ Private Operator が Core Service による検証に失敗した場合、次のいずれかのアクションが発生します: - HTTP 401 レスポンス。Private Operator はすぐに終了します。 - - 原因: API キーが取り消されたか、間違っています。 + - 原因: Operator Key が取り消されたか、間違っています。 - その他の 200 以外のレスポンスコード。Private Operator は 12 時間機能し続けます。この期間内に問題が解決されない場合、自動的に終了します。 Private Operator がエラーが発生した場合、アラートを処理し、オペレーターを再起動するためのインフラストラクチャを用意する必要があります。 \ No newline at end of file