Smartling translations are completed for commit 0bc4c19db00811cfbd3ab3763254a0d72935c257 from main

src/content/docs/ja/sdk/unity/v4/index.mdoc

@@ -0,0 +1,294 @@
+---
+title: "Unity SDK 連携ガイド"
+description: "Unity SDKを使用して、UnityアプリでAdjust機能にアクセスしましょう。"
+category-title: "Unity SDK"
+slug: "en/sdk/unity/v4"
+sidebar-position: 3
+versions: 
+    - 
+        label: "v5"
+        value: "v5"
+        default: true
+    - 
+        label: "v4"
+        value: "v4"
+redirects: 
+    v5: "/en/sdk/unity"
+---
+Adjust Unity SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをUnityアプリで記録できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。
+
+\{% callout type="note" %\}
+Adjust SDKは、iOS 9以降またはAndroid APIレベル9（Gingerbread）以降に対応しています。
+\{% /callout %\}
+
+1\. Adjust SDKを取得する \{% \#get\-the\-adjust\-sdk %\}
+----------------------------------------------------------
+
+UnityアプリでAdjust SDKを使うには、プロジェクトに追加する必要があります。[GitHubのリリースページ](https://github.com/adjust/adjust_unity_sdk/releases/latest)から最新バージョンをダウンロードできます。
+
+以下の手順に従って、Adjust SDKをUnityプロジェクトにインポートしてください。
+
+1. Unityエディター（Unity Editor）を開きます。
+2. **Assets \-\-> Import Package \-\-> Custom Package** を選択します。
+3. ダウンロードしたSDKパッケージを選択します。
+
+2\. SDKを実装する \{% \#integrate\-the\-sdk %\}
+------------------------------------------------
+
+Adjust SDKには、ゲームオブジェクトのテンプレートとAdjustスクリプトを含むUnity[プレハブ（Prefab）](https://docs.unity3d.com/Manual/Prefabs.html)が格納されています。このスクリプトを使用してSDKを設定できます。Unityエディターでプレハブを開くには、以下の手順に従ってください。
+
+1. `Assets/Adjust/Adjust.prefab`のプレハブを1番目のシーンに追加します。
+2. プレハブのInspector Menuを開きます。
+3. プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。
+
+![UnityエディターのAdjust SDK プレハブ構成スクリプト](@images/unity/1-prefab.png)
+
+以下の情報を入力して、Adjust SDKを設定します。
+
+1. **アプリトークン** 。アプリトークンの確認方法については、アプリ設定をご覧ください。
+2. **環境** ： 
+   * アプリをテスト中で、テストデータを送信する必要がある場合は、 **サンドボックス** を選択します。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。
+   * テストが完了し、アプリを公開する準備が整ったら、 **本番用** を選択します。
+
+3. **ログレベル** 。ログレベルは、受け取るログの内容を制御します。詳しくは、[ログレベルの設定](/en/sdk/unity/configuration#set-your-logging-level)をご覧ください。
+
+Adjust SDKは、アプリのAwakeイベントが発生したときにデフォルトで開始します。この動作をオーバーライドするには、 **START SDK MANUALLY** オプションをONにしてください。これにより、configインスタンスを引数として`Adjust.start()`を呼び出すことで、Adjust SDKを初期化できます。
+
+```cs
+AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
+// ...
+Adjust.start(adjustConfig);
+```
+
+3\. Androidデバイスを設定する \{% \#set\-up\-android\-devices %\}
+---------------------------------------------------------------
+
+### Google Play 開発者サービスを追加する \{% \#add\-google\-play\-services %\}
+
+Google Playストアを対象とするアプリは、gps\_adid（Google広告ID）を使用してデバイスを識別する必要があります。`gps_adid`にアクセスするには、`play-services-ads-identifier` AARをプロジェクトに追加する必要があります。
+
+\{% tabs %\}
+\{% tab title="External Dependency Manager" sync="edm4u" %\}
+[External Dependency Managerプラグイン](https://developers.google.com/unity/archive#external_dependency_manager_for_unity)を使用している場合は、`Dependencies.xml`ファイルに以下を追加します。
+
+```xml
+<androidpackages id="sl-md0000000">
+   <androidpackage spec="com.google.android.gms:play-services-ads-identifier:18.0.1" id="sl-md0000000" />
+</androidPackages>
+```
+
+\{% /tab %\}
+
+\{% tab title="Manual installation" sync="manual" %\}
+ARR（Android Archive）を手動でインストールするには、[Mavenからダウンロード](https://maven.google.com/web/index.html#com.google.android.gms:play-services-ads-identifier:18.0.1 "MavenのAARアーティファクトへのリンク。")して`Assets/Plugins/Android`ディレクトリに追加してください。
+\{% /tab %\}
+\{% /tabs %\}
+
+### アプリセットIDを収集する \{% \#collect\-app\-set\-identifier %\}
+
+[アプリセットID](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/appsetid/AppSetId) は、ユーザーがデバイスにインストールしたアプリの情報を計測するための一意の識別子です。同じ開発者のアプリは全て同じアプリセットIDを共有しているため、全てのアプリのユーザーから有意義なインサイトを収集できます。
+
+\{% tabs %\}
+\{% tab title="External Dependency Manager" sync="edm4u" %\}
+デバイスのApp Set IDを記録するには、以下のdependencyを`Dependencies.xml`ファイルに追加する必要があります。
+
+```xml
+<androidpackages id="sl-md0000000">
+   <androidpackage spec="com.google.android.gms:play-services-appset:16.0.2" id="sl-md0000000" />
+</androidPackages>
+```
+
+\{% /tab %\}
+
+\{% tab title="Manual installation" sync="manual" %\}
+ARR（Android Archive）を手動でインストールするには、[Mavenからダウンロード](https://maven.google.com/web/index.html#com.google.android.gms:play-services-appset:16.0.2 "MavenのAARアーティファクトへのリンク。")して`Assets/Plugins/Android`ディレクトリに追加してください。
+\{% /tab %\}
+\{% /tabs %\}
+
+### Proguardを設定する \{% \#set\-up\-proguard %\}
+
+ProGuardを使用している場合は、以下のルールを[カスタムのProGuardファイル](https://docs.unity3d.com/Manual/class-PlayerSettingsAndroid.html#build)に追加してください。
+
+```groovy
+-keep public class com.adjust.sdk.** { *; }
+-keep class com.google.android.gms.common.ConnectionResult {
+   int SUCCESS;
+}
+-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
+   com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
+}
+-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
+   java.lang.String getId();
+   boolean isLimitAdTrackingEnabled();
+}
+-keep public class com.android.installreferrer.** { *; }
+```
+
+### インストールリファラーを設定する \{% \#set\-up\-install\-referrer %\}
+
+インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。対象とするアプリストアによって異なる情報の収集方法が2つあります。
+
+* [Google Play Referrer API](https://developer.android.com/google/play/installreferrer)を使用する
+* Huawei Referrer APIを使用する
+
+#### Google Play Referrer API \{% \#google\-play\-referrer\-api %\}
+
+Google Play Referrer APIをサポートするには、以下の2つの方法があります。
+
+\{% tabs %\}
+\{% tab title="External Dependency Manager" sync="edm4u" %\}
+[カスタム`build.gradle`ファイル](https://docs.unity3d.com/2023.1/Documentation/Manual/android-gradle-overview.html)に、インストールリファラーライブラリをdependencyとして追加します。
+
+```groovy
+dependencies {
+   implementation 'com.android.installreferrer:installreferrer:2.2'
+}
+```
+
+\{% /tab %\}
+
+\{% tab title="Manual installation" sync="manual" %\}
+[Maven](https://maven.google.com/web/index.html?q=install#com.android.installreferrer:installreferrer)からインストールリファラーライブラリをダウンロードし、ARR（Android Archive）ファイルを`Plugins/Android`フォルダーに入れてください。
+\{% /tab %\}
+\{% /tabs %\}
+
+#### Huawei Referrer API \{% \#huawei\-referrer\-api %\}
+
+バージョン4\.21\.1以降より、Adjust SDKはHuawei AppGalleryバージョン10\.4以降のHuaweiデバイスでのインストール計測をサポートしています。Huawei Referrer APIの使用を開始するために行う設定変更はありません。
+
+#### Metaとのリファラー連携 \{% \#meta\-referrer\-integration %\}
+
+\{% minorversion added="v4\.36\.0" %\}
+Adjust SDKはv4\.36\.0以降で[Metaインストールリファラー](https://developers.facebook.com/docs/app-ads/meta-install-referrer)をサポートしています。この機能を有効にする方法：
+\{% /minorversion %\}
+
+1. [App Dashboard](https://developers.facebook.com/apps)でMetaアプリIDを検索します。詳しくはMetaの[アプリダッシュボードのドキュメント](https://developers.facebook.com/docs/development/create-an-app/app-dashboard)をご覧ください。
+
+2. [Metaアプリを`AndroidManifest.xml`ファイルに追加します](https://developers.facebook.com/docs/app-ads/meta-install-referrer#step-1--add-the-meta-apps)。
+
+   \{% codeblock title="AndroidManifest.xml" %\}
+
+   ```xml
+   <queries id="sl-md0000000">
+      <package android:name="com.facebook.katana" id="sl-md0000000" />
+   </queries>
+
+   <queries id="sl-md0000000">
+      <package android:name="com.instagram.android" id="sl-md0000000" />
+   </queries>
+   ```
+
+   \{% /codeblock %\}
+3. `AdjustConfig.setFbAppId`メソッドに`string`引数としてアプリIDをパスします。
+
+   ```cs
+   AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
+   //...
+   config.setFbAppId("{FB_APP_ID_STRING}");
+   //...
+   Adjust.start(config);
+   ```
+
+4\. iOSプライバシーマニフェストを追加する \{% \#add\-the\-ios\-privacy\-manifest %\}
+---------------------------------------------------------------------------
+
+\{% minorversion added="v4\.38\.0" %\}
+iOS 17は、アプリの[プライバシー要件](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files)をApp Storeに通知するメカニズムであるプライバシーマニフェストを導入しました。Adjust Unity SDKはこのプライバシーマニフェストファイルをバンドルしていません。よって、iOS 17以降を搭載しているデバイスをアプリがターゲットにしている場合、Adjust iOS SDKのプライバシーマニフェストファイルの内容がアプリのプライバシーマニフェストに存在している必要があります。
+\{% /minorversion %\}
+
+Adjustプライバシーマニフェストを追加する方法：
+
+1. Adjust Unity SDKバージョン4\.38\.0以降が使用されていることを確認します。
+2. [プライバシーマニフェストをまだ作成していない場合は、作成します](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files#4284009)。
+3. [GitHubから](https://raw.githubusercontent.com/adjust/ios_sdk/master/Adjust/PrivacyInfo.xcprivacy)`PrivacyInfo.xcprivacy`ファイルをダウンロードするか、内容をコピーします。
+4. Adjustの`PrivacyInfo.xcprivacy`ファイルの内容が独自のプライバシーマニフェストファイルに存在することを確認します。
+
+App Storeにアプリを提出すると、Adjustのプライバシー宣言がアプリに同梱されます。
+
+5\. アプリをビルドする \{% \#build\-your\-app %\}
+----------------------------------------------
+
+アプリのビルドプロセスを完了し、アプリ内でAdjust SDKが動作することを確実にするため、Adjust Unityのパッケージはポストビルドを実行します。
+
+このプロセスは、`AdjustEditor.cs`の`OnPostprocessBuild`メソッドによって実行されます。出力ログは、Unity IDEコンソールの出力ウィンドウに表示されます。
+
+![UnityエディターのAdjust SDK ポストビルド構成スクリプト](@images/unity/2-postbuild.png)
+
+### iOS \{% \#ios %\}
+
+\{% callout type="important" %\}
+iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート（iOS build support）** をインストールしてください。
+\{% /callout %\}
+
+iOSのポストビルドプロセスは、生成したXcodeプロジェクトを次のように変更します。
+
+* その他のリンカーフラグ `-ObjC` を追加します：ビルド時にAdjustのObjective\-Cカテゴリーを認識するために必要です。
+* Objective\-C exceptionsを有効にします。
+
+#### フレームワーク
+
+iOS機能にアクセスするために、以下のフレームワークを有効にすることができます。
+
+* `AdServices.framework`: Apple Search Adsの計測に必要。
+* `AdSupport.framework`: デバイスのIDFAの読み取りに必要。
+* `AppTrackingTransparency.framework`: ユーザーに計測への同意を求め、その同意ステータスを取得するために必要。
+* `StoreKit.framework`: SKAdNetworkフレームワークとの通信に必要。
+* `iAd.framework` **（廃止済み）** ：次をご利用ください。 `AdServices.framework`
+
+#### AppTrackingTransparencyの同意ダイアログ
+
+ATT（App Tracking Transparency）ラッパーを使用している場合は、 **User Tracking Description** メッセージを入力します。このメッセージは、ATT同意ダイアログをユーザーに示す場合に表示されます。
+
+#### ディープリンク
+
+ディープリンクを有効化するには、次の情報を追加します。
+
+* **iOSユニバーサルリンクドメイン** ：ユニバーサルリンクに使用されるAssociated Domain。
+* **iOS URL Identifier** ：アプリのバンドルID。
+* **iOS URLスキーム** ：アプリに関連するURLスキーム。
+
+### Android \{% \#android %\}
+
+Androidのポストビルドプロセスは、 `Assets/Plugins/Android/`内の `AndroidManifest.xml` ファイルを確認します。このファイルが存在しない場合、[`AdjustAndroidManifest.xml`](https://github.com/adjust/unity_sdk/blob/master/Assets/Adjust/Native/Android/AdjustAndroidManifest.xml "GitHubのAdjustAndroidManifestファイルへのリンク")からコピーを作成します。
+
+#### アクセス権限
+
+Android機能にアクセスするには、以下のパーミッションを有効にしてください。
+
+* `android.permission.INTERNET`: インターネットに接続するために必要。
+* `android.permission.ACCESS_NETWORK_STATE`: デバイスが接続されているネットワークタイプの読み取りに必要。
+* `com.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE` **（廃止済み）** ：Google Play Storeインテント経由でインストールリファラー情報を取得するのに必要
+* `com.google.android.gms.permission.AD_ID`: 詳細は、[Googleの`AdvertisingIdClient.info`ドキュメント](https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient.Info#public-string-getid)を参照してください。
+
+#### ディープリンク
+
+ディープリンクを有効化するには、次の情報を追加します。
+
+**Android URIスキーム** ：ディープリンクの遷移先。
+
+6\. Adjust SDKシグネチャーを追加する \{% \#add\-the\-adjust\-sdk\-signature %\}
+----------------------------------------------------------------------------
+
+Adjust SDKシグネチャーを使用して、Adjust SDKによって送信される全ての通信に署名できます。これによりAdjustのサーバーは、シグネチャーがない不正インストールを検出し、拒否することができます。
+
+Adjust SDKシグネチャーの使用を開始するには、担当のテクニカルアカウントマネージャーまたは[[email protected]](mailto:[email protected])までお問い合わせください。
+
+7\. 連携をテストする \{% \#test\-your\-integration %\}
+----------------------------------------------------
+
+\{% callout type="tip" %\}
+問題が発生した場合は、全ての詳細情報とログを添付し、[[email protected]](mailto:[email protected])までメールをお送りください。
+\{% /callout %\}
+
+Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。
+
+* 環境を`AdjustEnvironment.sandbox`に設定します。
+* Adjustダッシュボードにサンドボックスフィルターを追加します。
+* [ログレベル](/en/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に設定します。
+
+### Google Play 開発者サービスの連携をテストする \{% \#test\-google\-play\-services\-integration %\}
+
+Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、[ログレベル](/en/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に、環境を`AdjustEnvironment.sandbox`に設定します。アプリを起動して`session`またはイベントを計測します。SDKが広告IDを読み取った場合、SDKはgps\_adid（Google Play 開発者サービス広告ID\)パラメーターをログに記録します。
+
+Google広告IDを取得する際に問題が発生した場合は、[Githubリポジトリ](https://github.com/adjust/unity_sdk)で質問を投稿するか、[[email protected]](mailto:[email protected])までお問い合わせください。
+