Skip to content

Commit

Permalink
Merge pull request #797 from IABTechLab/jpn-translation-update-2024-12
Browse files Browse the repository at this point in the history
Jpn translation update 2024-12
  • Loading branch information
genwhittTTD authored Jan 7, 2025
2 parents 37612cb + e4c29d4 commit 192b9c6
Show file tree
Hide file tree
Showing 17 changed files with 64 additions and 41 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@ Used by: このエンドポイントは、主にパブリッシャーが使用

## Request Format

認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。

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

認証の詳細については、 [Authentication and Authorization](../getting-started/gs-auth.md) を参照してください。

このエンドポイントリクエストについて知っておくべきことは、以下のとおりです:
- サービスにアクセスする際に使用する <Link href="../ref-info/glossary-uid#gl-api-key">API key</Link> を秘密にするため、 UID2 Token は認証後に Server-Side でのみ生成する必要があります。
- すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は [リクエストの暗号化とレスポンスの復号化](../getting-started/gs-encryption-decryption.md) を参照してください。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -121,24 +121,28 @@ Refresh Token のワークフローをテストするにはどうすればよい

`[email protected]` のメールアドレスまたは `+00000000002` の電話番号を使用して、トークンリフレッシュのワークフローをテストすることができます。どちらかのパラメータ値をリクエストに使用すると、常に `refresh_token` を含む identity レスポンスが生成され、ログアウトレスポンスが返されます。

:::tip
メールアドレスの正規化、ハッシュ化、Base64 エンコードされたハッシュ値、または、電話番号のハッシュ化、Base64 エンコードされたハッシュ値を取得するには、ハッシングツールを使用できます。詳細は、[UID2 Hashing Tool](gs-normalization-encoding.md#uid2-hashing-tool) を参照してください。
:::

SDKを使うかどうかで手順は少し異なります。

##### With SDK:

1. DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して [POST&nbsp;/token/generate](../endpoints/post-token-generate.md) リクエストを送信します:
- `email` の値として `[email protected]` を指定します。
- ``[email protected]` のハッシュを `email_hash` 値として指定します
- `phone` の値として `+00000000002` を指定します。
- `phone_hash` 値として `+00000000002` のハッシュを指定します
- `email` の値: `[email protected]`.
- `email_hash` の値: `[email protected]` をハッシュ化し Base64 エンコードした値は `NaNI8RU0bL1Jpp1jJLC5aJO/lchc6gGhgXQIAwJ7cV4=` です
- `phone` の値: `+00000000002`.
- `phone_hash` `+00000000002` をハッシュ化し Base64 エンコードした値は `0VoxsIuk88qt7TnZaTC//C9Vur3pR1zBMIr1cJe7xjE=` です
2. SDK の [background auto-refresh](../sdks/sdk-ref-javascript.md#background-token-auto-refresh) が Advertising Token のリフレッシュを試み(これには数時間かかることがあります)、リフレッシュの試みが `OPTOUT` ステータスで失敗するのを観察するまで待ちます。この時点で SDK はファーストパーティクッキーもクリアします。

##### Without SDK:

1. DII がメールアドレスか電話番号かに応じて、以下の値のいずれかを使用して [POST&nbsp;/token/generate](../endpoints/post-token-generate.md) リクエストを送信します:
- `email` の値として `[email protected]` を指定します。
- `[email protected]` のハッシュを `email_hash` 値として指定します
- `phone` の値として `+00000000002` を指定します。
- `phone_hash` 値として `+00000000002` のハッシュを指定します
- `email` の値: `[email protected]`.
- `email_hash` の値: `[email protected]` をハッシュ化し Base64 エンコードした値は `NaNI8RU0bL1Jpp1jJLC5aJO/lchc6gGhgXQIAwJ7cV4=` です
- `phone` の値: `+00000000002`.
- `phone_hash` `+00000000002` をハッシュ化し Base64 エンコードした値は `0VoxsIuk88qt7TnZaTC//C9Vur3pR1zBMIr1cJe7xjE=` です

2. 返された `refresh_token` を次のステップで使用するために保存します。

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

## Introduction

メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。情報を正規化する必要があろうがなかろうが、ハッシュ化する必要があろうがなかろうが、手順には正確に従ってください。そうすることで、作成した UID2 の値を、同じユーザーによる他のオンライン行動の事例と安全かつ匿名で照合できるようになります
メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。メールアドレスを正規化するか否か、メールアドレスや電話番号をハッシュ化するか否かに関わらず、手順を正確に実行してください。そうすることで、作成した UID2 値を、同じユーザーによる他のオンライン行動と安全かつ匿名で照合できるようになります

:::important
- Raw UID2 とそれに関連する UID2 Token は、大文字と小文字を区別します。UID2 を扱う際には、大文字小文字を変えずにすべての ID とトークンを渡すことが重要です。ID が不一致の場合、ID の解析やトークンの復号化でエラーが発生する可能性があります。
Expand Down Expand Up @@ -72,7 +72,7 @@ Base64 エンコードを適用する場合、ハッシュの Raw バイトを
## Phone Number Normalization

:::important
ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります
UID2 Operator Service にリクエストを送信する前に、電話番号を正規化する **必要** があります。ハッシュ化とエンコードを適用するかどうかに関わらず、電話番号を正規化する必要があります
:::

ここでは、電話番号の正規化ルールについて説明します:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link';

# UID2 Sharing

UID2 において共有 (Sharing) とは、UID2 参加者間で [UID2](../ref-info/glossary-uid.md#gl-raw-uid2) を直接または [UID2 Token](../ref-info/glossary-uid.md#gl-raw-uid2) に暗号化して配布するプロセスです。
UID2 において共有 (Sharing) とは、UID2 参加者間で [UID2](../ref-info/glossary-uid.md#gl-raw-uid2) を直接または [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) に暗号化して配布するプロセスです。

Raw UID2 または UID2 Token が他の参加者と共有される場合はすべて、共有の定義に該当します。すべての共有参加者は、以下のセクション [Legal Requirements for UID2 Sharing](#legal-requirements-for-uid2-sharing) で指定された法的要件を満たす必要があります。

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

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

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

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-re

## Sample Implementation

アプリケーションの例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
実装例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
- コードとドキュメント: [UID2 SDK Secure Signals Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
- ランニングサイト: [Client-Server UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ SDK のデバッグビルドを使用したい場合は、代わりに以下の

## Sample Implementation

アプリケーションの例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
実装例については、次の例を参照してください:
- Code: [Example Client-Side Integration for JavaScript](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)
- ランニングサイト: [Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,11 +87,11 @@ UID2 Token をビッドストリームに送信する方法はいくつかあり

| Scenario | Integration Guide |
| :--- | :--- |
| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を Android アプリに統合したい | 以下の順番で:<ol><li>[UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を iOS アプリに統合したい | 以下の順番で:<ol><li>[UID2 GMA Plugin for iOS Integration Guide](../guides/mobile-plugin-gma-ios.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google IMA を使用して、Android アプリにマルチメディア広告を統合したい | 以下の順番で:<ol><li>[UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google IMA を使用して、iOS アプリにマルチメディア広告を統合したい | 以下の順番で:<ol><li>[UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Prebid Mobile SDKとPrebid Serverを使用して、AndroidまたはiOSアプリから広告リクエストを送信したい | 以下のいずれか:<ul><li>Client-side: [Optional: UID2 Integration with Prebid Mobile SDK](../guides/integration-mobile-client-side.md#optional-uid2-integration-with-prebid-mobile-sdk)</li><li>Client-server: [Optional: UID2 Integration with Prebid Mobile SDK](../guides/integration-mobile-client-server.md#optional-uid2-integration-with-prebid-mobile-sdk)</li></ul> |
| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を Android アプリにインテグレーションしたい | 以下の順番で:<ol><li>[UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を iOS アプリにインテグレーションしたい | 以下の順番で:<ol><li>[UID2 GMA Plugin for iOS Integration Guide](../guides/mobile-plugin-gma-ios.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google IMA を使用して、Android アプリにマルチメディア広告をインテグレーションしたい | 以下の順番で:<ol><li>[UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Google IMA を使用して、iOS アプリにマルチメディア広告をインテグレーションしたい | 以下の順番で:<ol><li>[UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios.md)</li><li>以下のいずれか:<ul><li>Client-side: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-side.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li><li>Client-server: [Optional: UID2 GMA/IMA Plugin for GAM Secure Signals integration](../guides/integration-mobile-client-server.md#optional-uid2-gmaima-plugin-for-gam-secure-signals-integration)</li></ul></li></ol> |
| Prebid Mobile SDK と Prebid Server を使用して、Android または iOS アプリから広告リクエストを送信したい | 以下のいずれか:<ul><li>Client-side: [Optional: UID2 Integration with Prebid Mobile SDK](../guides/integration-mobile-client-side.md#optional-uid2-integration-with-prebid-mobile-sdk)</li><li>Client-server: [Optional: UID2 Integration with Prebid Mobile SDK](../guides/integration-mobile-client-server.md#optional-uid2-integration-with-prebid-mobile-sdk)</li></ul> |

### Functionality Summary

Expand All @@ -107,7 +107,7 @@ UID2 Token をビッドストリームに送信する方法はいくつかあり
| GMA Plugin for iOS<br/>(Requires UID2 SDK for iOS) | &#8212; | &#8212; | iOS | &#9989;&ast;&ast; |
| IMA Plugin for Android <br/>(Requires UID2 SDK for Android)| &#8212; | &#8212; | Android | &#9989;&ast;&ast; |
| IMA Plugin for iOS<br/>(Requires UID2 SDK for iOS)| &#8212; | &#8212; | iOS | &#9989;&ast;&ast; |
| Prebid Mobile SDK | &#8212; | &#8212; | Either | &#9989;&ast;&ast;&ast; |
| UID2 Integration with Prebid Mobile SDK | &#8212; | &#8212; | Either | &#9989;&ast;&ast;&ast; |

&ast;SDK を IMA/GMA プラグインまたは Prebid Mobile SDK と組み合わせて、Google または Prebid Server を介してトークンをビッドストリームに送信するか、SDK からトークンを手動で取得して別の方法でビッドストリームに渡すことができます。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ UID2 module が正常に UID2 Token を生成したかどうかを確認する
インテグレーションに問題がある場合、以下のような手順があります:

- ブラウザのコンソールログを確認してください。
- **Subscription ID****Public Key** の値を確認してください:
- **Subscription ID** (**subscriptionId** の値) **Public Key** (**serverPublicKey** の値) を確認してください:
- UID2 チームから受け取った値と同一であることを確認してください。
- 使用している環境の値が正しいことを確認してください。[environment](../getting-started/gs-environments.md) ごとに **Subscription IDID****Public Key** の値が異なります。
- アカウントのセットアップ中に、サイトのドメイン名を UID2 チームに提供したことを確認してください。必要に応じて、UID2 の担当者に確認してください。
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Mobile Integration for Prebid Mobile SDK
sidebar_label: Mobile Integration for Prebid Mobile SDK
pagination_label: Mobile Integration for Prebid Mobile SDK
title: Mobile Integration with Prebid Mobile SDK
sidebar_label: Mobile Integration with Prebid Mobile SDK
pagination_label: Mobile Integration with Prebid Mobile SDK
description: モバイルデバイスでの Prebid インテグレーションの設定に関する情報リソースのまとめ。
hide_table_of_contents: false
sidebar_position: 04
Expand All @@ -11,7 +11,7 @@ import Link from '@docusaurus/Link';

# UID2 Mobile Integration with Prebid Mobile SDK

Prebid Mobile SDK Android モバイルデバイスでの UID2 インテグレーションをサポートしています
UID2 の Prebid とのインテグレーションは、Prebid Mobile SDK オプションの UID2 インテグレーションを使用することで、Android と iOSの モバイルデバイスでもサポートされます

詳細は以下のモバイルインテグレーションガイドのセクションを参照してください:

Expand Down
Loading

0 comments on commit 192b9c6

Please sign in to comment.