Skip to content

Commit

Permalink
Merge pull request #721 from IABTechLab/jpn-translation-update-690-703
Browse files Browse the repository at this point in the history
Jpn translation update 690 703
  • Loading branch information
genwhittTTD authored Sep 26, 2024
2 parents ff2013d + bceb750 commit a1535f2
Show file tree
Hide file tree
Showing 17 changed files with 234 additions and 254 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -104,20 +104,7 @@ UID2 API のリクエストレスポンスワークフローは、以下のス

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

```json
{
"body": {
"advertising_token": "AgAAAQFt3aNLXKXEyWS8Tpezcymk1Acv3n+ClOHLdAgqR0kt0Y+pQWSOVaW0tsKZI4FOv9K/rZH9+c4lpm2DBpmFJqjdF6FAaAzva5vxDIX/67UOspsYtiwxH73zU7Fj8PhVf1JcpsxUHRHzuk3vHF+ODrM13A8NAVlO1p0Wkb+cccIIhQ==",
"user_token": "AgAAAPpTqz7/Z+40Ue5G3XOM2RiyU6RS9Q5yj1n7Tlg7PN1K1LZWejvo8Er7A+Q8KxdXdj0OrKRf/XEGWsyUJscRNu1bg/MK+5AozvoJKUca8b10eQdYU86ZOHPH7pFnFhD5WHs=",
"refresh_token": "AAAAAQLMcnV+YE6/xoPDZBJvJtWyPyhF9QTV4242kFdT+DE/OfKsQ3IEkgCqD5jmP9HuR4O3PNSVnCnzYq2BiDDz8SLsKOo6wZsoMIn95jVWBaA6oLq7uUGY5/g9SUOfFmX5uDXUvO0w2UCKi+j9OQhlMfxTsyUQUzC1VQOx6ed/gZjqH/Sw6Kyk0XH7AlziqSyyXA438JHqyJphGVwsPl2LGCH1K2MPxkLmyzMZ2ghTzrr0IgIOXPsL4lXqSPkl/UJqnO3iqbihd66eLeYNmyd1Xblr3DwYnwWdAUXEufLoJbbxifGYc+fPF+8DpykpyL9neq3oquxQWpyHsftnwYaZT5EBZHQJqAttHUZ4yQ==",
"identity_expires": 1654623500142,
"refresh_expires": 1657214600142,
"refresh_from": 1654622900142,
"refresh_response_key": "wR5t6HKMfJ2r4J7fEGX9Gw=="
},
"status": "success"
}
```
<IdentityGenerateResponse />

## Encryption and Decryption Code Examples

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

Snowflake Data Marketplace でホストされる Open Operator Service を使用する場合は、[Snowflake Integration Guide](../guides/snowflake_integration.md) も参照してください。

## Integration Steps
## Advertiser/Data Provider Routes to Use UID2

次の図は、データコレクターがオーディエンスの構築とターゲティングのために [directly identifying information (DII)](../ref-info/glossary-uid.md#gl-dii) を UID2 識別子にマッピングするために完了する必要がある手順の概要を示しています。
アドテクノロジー業界では、広告主は ID を使用してオーディエンスを構築し、コンバージョンを追跡し、グラフを生成します。広告主または広告主の代理としてデータプロバイダーが UID2 を使用してこれらの目標を達成する方法の例を以下に示します。

:::note
これらのユースケース以外にも、UID2 を使用する方法はあります。これらはいくつかの例です。
:::

| Send/Receive? | Action | Advantage/Result |
| --- | --- | --- |
| Send | UID2 を API またはピクセルを介して送信 | オーディエンスを作成します。 |
| Send | UID2 をコンバージョン情報として送信 | コンバージョン情報を使用して測定 (アトリビューション) またはリターゲティングに使用します。 |
| Receive | API またはピクセルを介してグラフ/データプロバイダーから UID2 を受信 | グラフデータを構築します。 |

<!-- - **Create/send in audiences**: You can send UID2s to create audiences via API or pixels
- **Send in conversions**: You can send UID2s as conversion information that can be used for measurement (attribution) or retargeting via API or pixels
- **Receive graph data**: You can receive UID2s from graph/data providers via API or pixels. -->

### High-Level Steps

広告主およびデータプロバイダーが UID2 とインテグレーションする手順は次のとおりです:


1. <Link href="../ref-info/glossary-uid#gl-dii">directly identifying information (DII)</Link> から UID2 を生成するか、広告主やデータプロバイダーなどの他の UID2 参加者から UID2 を受け取ります。

1. Step1 で受け取った UID2 を使用します。たとえば、以下のいずれかを行うかもしれません:
- 何らかの操作を行う: たとえば、DII から生成した UID2 と広告主やデータプロバイダーなどの他の参加者から受け取った UID2 を組み合わせます。
- 既存のオーディエンスに新しい UID2 を追加します。

1. Raw UID2 を計測目的で使用します。

## Integration Diagram

以下の図は、オーディエンスの構築とターゲティングのために DII を raw UID2 にマッピングするためにデータコレクターが完了する必要がある手順を示しています。

DII とは、正規化されたメールアドレスや電話番号、あるいは正規化され SHA-256 ハッシュ化されたメールアドレスや電話番号のことです。

Expand All @@ -27,7 +58,7 @@ DII とは、正規化されたメールアドレスや電話番号、あるい

図の各部の詳細については、以下のセクションを参照してください:
1. [Retrieve a raw UID2 for DII using the identity map endpoints](#1-retrieve-a-raw-uid2-for-dii-using-the-identity-map-endpoint)
2. [Send stored raw UID2s to DSPs to create audiences](#2-send-stored-raw-uid2s-to-dsps-to-create-audiences)
2. [Send stored raw UID2s to DSPs to create audiences or conversions](#2-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions)
3. [Monitor for salt bucket rotations related to your stored raw UID2s](#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s)

### 1: Retrieve a raw UID2 for DII using the identity map endpoint
Expand All @@ -37,7 +68,7 @@ DII とは、正規化されたメールアドレスや電話番号、あるい
| 1-a | [POST&nbsp;/identity/map](../endpoints/post-identity-map.md)リクエスト | DII を含むリクエストを ID マッピングエンドポイントに送信します。 |
| 1-b | [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) レスポンス | レスポンスで返される `advertising_id` (raw UID2) は、関連する DSP でオーディエンスをターゲティングするために使用できます。<br/>このレスポンスは、ユーザーの raw UID2 と、ソルトバケットに対応する `bucket_id` を返します。バケットに割り当てられたソルトは毎年ローテーションされ、生成される raw UID2 に影響を与えます。ソルトバケットのローテーションをチェックする方法の詳細は [3: Monitor for salt bucket rotations](#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s) を参照してください。<br/>メンテナンスを簡単にするために、ユーザの raw UID2 と `bucket_id` をマッピングテーブルに格納することを推奨します。インクリメンタルな更新に関するガイダンスについては、[Use an incremental process to continuous-update raw UID2s](#use-an-incremental-process-to-continuously-update-raw-uid2s) を参照してください。|

### 2: Send stored raw UID2s to DSPs to create audiences
### 2: Send stored raw UID2s to DSPs to create audiences or conversions

Step 1-b で返された `advertising_id` (raw UID2) を、オーディエンスを構築しながら DSP に送信します。各 DSP はオーディエンスを構築するための独自のインテグレーションプロセスを持っています。raw UID2 を送信してオーディエンスを構築するには、DSP が提供するインテグレーションガイダンスに従ってください。

Expand Down Expand Up @@ -66,7 +97,7 @@ UID2 ベースのオーディエンス情報を正確かつ最新の状態に保
- 最新の `last_updated` タイムスタンプ。
2. Step 3の結果を使用して、[Monitor for salt bucket rotations related to your stored raw UID2s](#3-monitor-for-salt-bucket-rotations-related-to-your-stored-raw-uid2s)、 Step1 の [Retrieve a raw UID2 for DII using the identity map endpoint](#1-retrieve-a-raw-uid2-for-dii-using-the-identity-map-endpoint) に従って、ソルトバケットがローテーションされた ID の新しい raw UID2 を取得して、ソルトバケットの raw UID2 を再マッピングします。

次に、Step 2の[send raw UID2 to a DSP](#2-send-stored-raw-uid2s-to-dsps-to-create-audiences) に従って、リフレッシュされた UID2 を使ってオーディエンスを更新します
次に、Step 2 の[send raw UID2 to a DSP](#2-send-stored-raw-uid2s-to-dsps-to-create-audiences-or-conversions) に従って、リフレッシュされた UID2 を使ってオーディエンスまたはコンバージョンを更新します

## Check Opt-Out Status

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,13 @@ Google Ad Manager アカウントで暗号化 UID2 Token を受け取るには

詳しくは、[セキュア シグナルをビッダーと共有する](https://support.google.com/admanager/answer/10488752) (Google reference documentation) を確認し、[サードパーティのシグナルプロバイダーを使用する](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/securesignals) の手順に従って、シグナルプロバイダーとして UID2 をオンに設定してください。

:::important
When you're following the steps, in [Select allowed secure signals](https://support.google.com/admanager/answer/10488752#select-signals), under **Web Signal Deploy Option**, choose **Google Deploy**.
以下の手順に従って、[Select allowed secure signals](https://support.google.com/admanager/answer/10488752#select-signals)**Web Signal Deploy Option** として **Google Deploy** を選択してください。
**Prebid User ID Module** を選択した場合、**Use your Prebid configuration to automatically configure your Secure signals settings** フィールドも選択しない限り、UID2 は正しく処理されません。
設定を保存する前に、選択したオプションが正しいことを再確認してください。
:::

## Publisher Integration

暗号化されたシグナルがキャッシュされると、セキュアシグナル機能は、新しいシグナルを生成するためのハンドラを実行しません。このため、データキャプチャの前後にキャッシュをクリアする必要があります。
Expand Down Expand Up @@ -92,3 +99,17 @@ Google Ad Manager のセキュアシグナル機能との連携方法につい
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)

各サンプルアプリケーションには独自のインストラクションがあります。

## Troubleshooting Tips for UID2 Integration with Google Secure Signals

UID2 インテグレーションで Google Secure Signals を使用する際に役立つトラブルシューティング情報です:

- [I enabled Secure Signals within Google Ad Manager, but UID2s are not being passed through Google](#i-enabled-secure-signals-within-google-ad-manager-but-uid2s-are-not-being-passed-through-google)

#### I enabled Secure Signals within Google Ad Manager, but UID2s are not being passed through Google

Google Ad Manager で Secure Signals を有効にした後、Google を介して正常な UID2 が渡されない場合があります。これは、参加者が誤った **Web Signal Deployment Method** 構成を持っている場合があります。

UID2 が Google を介して渡されない場合は、セットアップ時に正しい **Web Signal Deployment Method** を選択したことを確認してください。

詳細は、[Allow Secure Signals Sharing](#allow-secure-signals-sharing)**Important** ノートを参照してください。
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@


<!-- 8/30/24: Update "2. Send stored UID2s to DSPs to create audiences." > "2. Send stored UID2s to DSPs to create audiences and conversions." (2242) -->
<!-- 8/14/24: update to change UID2 Service to UID2 Operator per 2503: -->

<!-- 8/14/24: Code: -->
<!-- 8/30/24: Code: -->

sequenceDiagram
participant DP as Data Provider
Expand All @@ -12,7 +13,7 @@
DP->>UID2: 1-a. DII を含むリクエストを ID マッピングエンドポイントに送信します。
UID2->>DP: 1-b. ID マッピングサービスから返された raw UID2 とソルトバケットを格納します。
end
DP-->>DSP: 2. 蓄積した raw UID2 を DSP に送信し、オーディエンスを作成します
DP-->>DSP: 2. 蓄積した raw UID2 を DSP に送信し、オーディエンスとコンバージョンを作成します

loop 3. 蓄積されている UID2 に関連するソルトバケットのローテーションを監視します。
DP->>UID2: 3-a. バケットサービスを利用して、ソルトバケットのローテーションを返します。
Expand All @@ -28,7 +29,7 @@
}
-->

<!-- 8/14/24: URL:
<!-- 8/30/24: URL:

https://mermaid-js.github.io/mermaid-live-editor/edit#pako:eNq1VM9PGkEU_lcme1Ya9UYaTtsDhyYkpDcuIzu2m8guXRabxpgwM0QxaEqUgra10tJalSg2tWmaovwxj-XHf9GZ2YJQliYeygGWN2_f973ve2_WtaRtEC2sIZQhz7PEShLdxE8dnEpYSHzS2HHNpJnGlov0GMIZpGMXo5hjr5kGcaaTnkT1RZmmfuPEWTOTJKBUPOYHV207jRZCKKoDfw-cA68COwX-Dfg28CNgn9RzAdhe56bdK58CrQI9gRzVo1GglxJGnHmvKt5tVZ3dAj2EHPPL67H5SETmhNHCPA4h-ZLILjWA5YCfA2tKNPbTR7gjUZao7CqYCm0McrTT_jANJ5EEoB6TcMuyKzRV8TvwFvB9CUqLwLb77TLQ18B2gB4jB7_wlQMqaN0Ab0hAXgL2VVWRLLu1Vu96dxqcWMaoaUkiLlgshlB_P98789OPh-VFFXE80UiOAjtX1LaA1f80LjhK3d91C6VpPGXd0h2A38MJ0DywokIR9SsfB7m6fIsVg_uhl8AvFO6m_GY_gH9R0Hu9t_X-SWUad9LWJWnrpEJjCguvC2fjU3NfEsqdAAZjTi9Jp7s7W97lm5GRwNpqXmqKRFsNTrXz6_PgUAjVCAZTDs0yfRaPCSWSUol7lqannfaRd3EQ5N-sAWyW-y0-TufhsvMg8g9or3btlQRWUzjQrVypYH40jEJ9yY4KZfz9DNjD8a1peJu7szbwb2uM_7SEQ9ECllCb01LESWHTENfqugwnNPcZSZGEFhaPK7ZDMm5CS1gbIhNnXTv-0kpqYdfJkjktmzawO7yCtfAKXs2Moo8M07WdUZCov4_961vd4hu_ARRLHw0

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -249,11 +249,6 @@ UID2Manager.init(
context = this,
UID2Manager.Environment.Custom("https://global.prod.uidapi.com")
)
// or use a named environment
UID2Manager.init(
context = this,
UID2Manager.Environment.Sydney
)
```

</TabItem>
Expand Down Expand Up @@ -323,7 +318,7 @@ UID2Manager.shared.generateIdentity(

SDK は、ハッシュ化された DIIUID2 Service に送信する前に暗号化します。

ユーザーごとに、DII のフォーマットが異なる場合でも、任意のフォーマットで `generateIdentity` メソッドを呼び出すことができます。ただし、ユーザーごとに 1 つの値のみを送信できます
ユーザーごとに、DII のフォーマットが異なる場合でも、任意のフォーマットで `generateIdentity` メソッドを呼び出すことができます。DIIのフォーマットはユーザごとに異なる場合がありますが、ユーザーごと送信できる値は 1 つだけです

以下の例は、UID2 mobile SDK を構成する異なる方法を示し、SDK に渡す DII に必要な要件を示しています:

Expand Down Expand Up @@ -711,7 +706,7 @@ If the response status indicates that the DII has been opted out of UID2, you mi
## Optional: UID2 Prebid Mobile SDK Integration

:::important
UID2 Prebid Mobile SDK インテグレーションは、Android のみに対応しています。UID2 Prebid Mobile SDK インテグレーションを実装するには、SDK for Android のバージョン 1.4.0 が必要です。
UID2 Prebid Mobile SDK インテグレーションは、UID2 SDK for Android version 1.4.0 または UID2 SDK for iOS version 1.5.0 が必要です。
:::

<PrebidMobileSDK />
Loading

0 comments on commit a1535f2

Please sign in to comment.