From 37c06fbf55c61f1685308fcdaa8affb0790c06f0 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Fri, 8 Sep 2023 06:58:57 +0900 Subject: [PATCH 01/32] New translation files added --- .../guides/mobile-plugin-ima-android.md | 20 +++++++++---------- .../current/guides/mobile-plugin-ima-ios.md | 16 +++++++-------- 2 files changed, 18 insertions(+), 18 deletions(-) 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 6a346b2f0..9ae4c2345 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 @@ -1,33 +1,33 @@ --- title: UID2 IMA Plugin for Android -description: A guide for publishers using GIA for ad requests on Android apps. +description: Android アプリの広告リクエストに IMA を使用するパブリッシャー向けのガイドです。 hide_table_of_contents: false sidebar_position: 14 --- # UID2 IMA Plugin for Android Integration Guide -The UID2 Interactive Media Ads (IMA) Plugin for Android enables publishers that use the [Google Interactive Media Ads (IMA) SDK for Android](https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side) to send [UID2 tokens](../ref-info/glossary-uid.md#gl-uid2-token) as [secure signals](https://support.google.com/admob/answer/11556288) in ad requests from Android apps. This is done automatically, with no direct coding needed from the app developer. +UID2 Interactive Media Ads (IMA) Plugin for Android は、[Google Interactive Media Ads (IMA) SDK for Android](https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side) を使用するパブリッシャーが、Android アプリからの広告リクエストで [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を [Secure Signal](https://support.google.com/admob/answer/11556288) として送信できるようにします。これは自動的に行われるため、アプリ開発者が直接コーディングする必要はありません。 ## Functionality -This plugin simplifies integration with Google Interactive Media Ads (IMA) for any publishers who want to support UID2 for apps running on Android devices. +このプラグインは、Android 端末で動作するアプリの UID2 をサポートしたいパブリッシャー向けに、Google Interactive Media Ads(IMA)とのインテグレーションを簡素化します。 ## Version -This documentation is for the UID2 IMA Plugin for Android version 0.5.0 and later. +このドキュメントは、UID2 IMA Plugin for Android version 0.5.0 以降用です。 ## GitHub Repository -This plugin is in the following open-source GitHub repository: +このプラグインは以下のオープンソースの GitHub リポジトリにあります: - [https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-ima](https://github.com/IABTechLab/uid2-android-sdk/tree/main/securesignals-ima) ## Requirements -To run this plugin, install the following: +このプラグインを実行するには、以下をインストールします: 1. Google IMA SDK v3.30.3: - [SDK](https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side) @@ -39,16 +39,16 @@ To run this plugin, install the following: ## Installation -Prerequisite: Install the Google Interactive Media Ads SDK and the UID2 Android SDK. +前提条件: Google Interactive Media Ads SDKとUID2 Android SDK をインストールします。 -Install the UID2 Android IMA Plugin to an existing app with the UID2 Android SDK and Google IMA SDK installed. There are two installation options: +UID2 Android SDK と Google IMA SDK がインストールされている既存のアプリに、UID2 Android IMA Plugin をインストールします。インストールオプションは2つあります: - [Gradle](#gradle) - [Maven](#maven) ### Gradle -To install with Gradle, add the SDK as a dependency in the `build.gradle` file: +Gradle でインストールするには、`build.gradle` ファイルに依存関係として SDK を追加します: ``` javascript implementation 'com.uid2:uid2-android-sdk-ima:0.5.0' @@ -56,7 +56,7 @@ implementation 'com.uid2:uid2-android-sdk-ima:0.5.0' ### Maven -To install with Maven, add the SDK as a dependency in the `pom.xml` file: +Maven でインストールするには、`pom.xml` ファイルに依存関係として SDK を追加します: ``` xml 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 48ae37408..afa3d512f 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 @@ -1,33 +1,33 @@ --- title: UID2 IMA Plugin for iOS -description: A guide for publishers using IMA for ad requests on iOS apps. +description: iOS アプリの広告リクエストに IMA を使用するパブリッシャー向けのガイド。 hide_table_of_contents: false sidebar_position: 15 --- # UID2 IMA Plugin for iOS Integration Guide -The UID2 Interactive Media Ads (IMA) Plugin for iOS enables publishers that use the [Google Interactive Media Ads SDK for iOS](https://developers.google.com/interactive-media-ads/docs/sdks/ios/client-side) to send [UID2 tokens](../ref-info/glossary-uid.md#gl-uid2-token) as [secure signals](https://support.google.com/admob/answer/11556288) in ad requests from iOS apps. This is done automatically, with no direct coding needed from the app developer. +UID2 Interactive Media Ads (IMA) Plugin for iOS は、[Google Interactive Media Ads SDK for iOS](https://developers.google.com/interactive-media-ads/docs/sdks/ios/client-side) を使用するパブリッシャーが、iOS アプリからの広告リクエストで [UID2 Token](../ref-info/glossary-uid.md#gl-uid2-token) を [Secure Signal](https://support.google.com/admob/answer/11556288) として送信できるようにします。これは自動的に行われるため、アプリ開発者が直接コーディングする必要はありません。 ## Functionality -This plugin simplifies integration with Google Interactive Media Ads (IMA) for any publishers who want to support UID2 for apps running on iOS devices. +このプラグインは、iOS デバイス上で動作するアプリの UID2 をサポートしたいパブリッシャー向けに、Google Interactive Media Ads(IMA)とのインテグレーションを簡素化します。 ## Version -This documentation is for the UID2 IMA Plugin for iOS version 0.2.0. +このドキュメントはUID2 IMA Plugin for iOS version 0.2.0 用です。 ## GitHub Repository -This plugin is in the following open-source GitHub repository: +このプラグインは以下のオープンソースの GitHub リポジトリにあります: - [https://github.com/IABTechLab/uid2-ios-plugin-google-ima](https://github.com/IABTechLab/uid2-ios-plugin-google-ima) ## Requirements -To run this plugin, install the following: +このプラグインを実行するには、以下をインストールします: 1. Google IMA SDK v3.19.1 or later: - [SDK](https://developers.google.com/interactive-media-ads/docs/sdks/ios/client-side) @@ -39,9 +39,9 @@ To run this plugin, install the following: ## Installation -Prerequisite: Install the Google Interactive Media Ads SDK and the UID2 iOS SDK. +前提条件: Google Interactive Media Ads SDK と UID2 iOS SDK をインストールします。 -Install the UID2 iOS IMA Plugin v0.2.0 via Swift Package Manager to an existing app with the UID2 iOS SDK and the Google Interactive Media Ads SDK installed. +UID2 iOS SDK と Google Interactive Media Ads SDK がインストールされている既存のアプリに、Swift Package Manager 経由で UID2 iOS IMA Plugin v0.2.0 をインストールします。 ``` .package(url: https://github.com/IABTechLab/uid2-ios-plugin-google-ima.git, exact: "0.2.0") From aff82b34f6ed0cf6bbfa48d4259a70f10fbc3db9 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Mon, 16 Oct 2023 13:06:16 +0900 Subject: [PATCH 02/32] Translation improvements --- .../guides/operator-guide-aws-marketplace.md | 20 ++++--------------- 1 file changed, 4 insertions(+), 16 deletions(-) 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 36368ff8f..247b2706f 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 @@ -193,31 +193,19 @@ UID2 Operator を AWS Marketplace をデプロイするには、次の手順を ### Stack Configuration Options -以下は、スタック作成ウィザード ([デプロイ](#deployment) Step 6)の [スタックオプションの設定](#stack-configuration-options) ページのスクリーンショットです。 +次の図は、スタックの作成ウィザード ([Deployment](#deployment) Step 6)の**スタックオプションの設定**ページを示しています。 ![Configure Stack Options](images/cloudformation-step-3.png) -次の表は、[デプロイ](#deployment) の Step 6 で指定するパラメータ値について説明したものです。 +次の表は、[Deployment](#deployment) の Step 6 で指定するパラメータ値について説明したものです。 | Parameter | Description | | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tags | (オプション) スタックにタグをつけます。 | -| Permissions | AWS Marketplace に登録する IAM ロールとスタックをデプロイする IAM ロールが分かれている場合、スタックをデプロイするために使用するロールの名前/ARN を入力します。 | -| Stack failure options | デプロイメントに失敗したときの処理を選択します。`すべてのスタックリソースをロールバックする`オプションを推奨します。 | +| Permissions | AWS Marketplace にサブスクライブする IAM ロールとスタックをデプロイする IAM ロールが分かれている場合、スタックをデプロイするために使用するロールの名前/ARN を入力します。 | +| Stack failure options | デプロイメントに失敗したときの処理を選択します。`Roll back all stack resources (すべてのスタックリソースをロールバックする)` オプションを推奨します。 | | Advanced options | これらはオプションです。 | -### Stack Configuration Options - -次の画像は、スタックの作成ウィザード ([デプロイメント](#deployment) Step 6)の**スタックオプションの設定**ページを示しています。 - -![Configure Stack Options](images/cloudformation-step-3.png) - -| Parameter | Description | -| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Tags | (Optional) Tag your stack. | -| Permissions | AWS Marketplace に加入する IAM ロールとスタックをデプロイする IAM ロールが分かれている場合、スタックのデプロイに使用するロールの名前/ARN を入力してください。 | -| Advanced options | これらはオプションです。 | - ## Checking UID2 Operator Status EC2 インスタンスを見つけるには、次の手順を実行します: From a02bb0e12b29b287bce70514868ded09e06d5f42 Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Mon, 16 Oct 2023 13:29:51 +0900 Subject: [PATCH 03/32] Snowflake doc, clarification re example scenario --- .../current/guides/snowflake_integration.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md index ef8c748ac..7dd10f510 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/snowflake_integration.md @@ -387,6 +387,8 @@ select a.ID, a.PHONE_HASH, m.UID2, m.BUCKET_ID, m.UNMAPPED from AUDIENCE a LEFT #### Targeted Input Table +このシナリオ例では、広告主/データプロバイダーは UID2 を `AUDIENCE_WITH_UID2` という名前のテーブルに格納しています。最後の列 `LAST_UID2_UPDATE_UTC` は、UID2 が生成された時刻を記録するために使用されます。UID2 が生成されていない場合、3番目の例に示すように値は `NULL` となります。広告主/データプロバイダーはこのタイムスタンプ値を使って、どのUID2 を再生成する必要があるかを判断できます。 + ``` select * from AUDIENCE_WITH_UID2; ``` From 0838c74a34e850877671181608024d5a307c96cb Mon Sep 17 00:00:00 2001 From: Yoshihiko Miyaichi Date: Mon, 16 Oct 2023 13:36:23 +0900 Subject: [PATCH 04/32] add links from publisher guides to new FAQ --- .../current/guides/custom-publisher-integration.md | 2 ++ .../current/guides/publisher-client-side.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/custom-publisher-integration.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/custom-publisher-integration.md index 8e7c4befa..f03a806e8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/custom-publisher-integration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/custom-publisher-integration.md @@ -69,6 +69,8 @@ UID2 ID 情報をどのように管理し、ターゲティング広告に使用 | :--- | :------- | :-------------------------------------------------------------------------------------------------------------------------------- | | 2-a | N/A | Step [1-e](#establish-identity-user-login) の `advertising_token` を入札のために SSP に送信します。そのままの値を送信します。 | +>NOTE: UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例については、[What does a UID2 token look like in the bid stream?](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bid-stream) を参照してください。 + ### Refresh Tokens リフレッシュエンドポイントを活用して、最新バージョンの UID2 Token を取得します。ユーザーの UID2 ローテーションとオプトアウトの状態を同期させるには、UID2 Token をリフレッシュする必要があります。ユーザーがオプトアウトした場合、その Refresh Token を使用すると、トークン更新チェーンが終了します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/publisher-client-side.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/publisher-client-side.md index 13760808c..60196cd21 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/publisher-client-side.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/publisher-client-side.md @@ -94,6 +94,8 @@ SDK は、有効な ID の状態と利用可能性に基づいて、バックグ | :--- | :----------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | | 2-a | UID2 SDK for JavaScript | 以下に示すように、[getAdvertisingToken() 関数](../sdks/client-side-identity.md#getadvertisingtoken-string) を使用して、現在のユーザーの Advertising Token を取得します。| +>NOTE: UID2 Token が SSP から DSP に送信されるとき、ビッドストリーム内でどのように見えるかの例については、[What does a UID2 token look like in the bid stream?](../getting-started/gs-faqs.md#what-does-a-uid2-token-look-like-in-the-bid-stream) を参照してください。 + ```html