Skip to content

Commit

Permalink
Fix translated and formatted files
Browse files Browse the repository at this point in the history
  • Loading branch information
@github-actions
github-actions[bot] committed Jan 8, 2025
1 parent 0d29ddc commit 25d8e0d
Show file tree
Hide file tree
Showing 3 changed files with 290 additions and 264 deletions.
175 changes: 92 additions & 83 deletions src/content/docs/ja/sdk/unity/v5/index.mdoc
View file
Original file line number Diff line number Diff line change
@@ -1,81 +1,89 @@
---
title: "Unity SDK 連携ガイド"
description: "Unity SDKを使用して、UnityアプリでAdjust機能にアクセスしましょう。"
category-title: "Unity SDK"
slug: "en/sdk/unity"
title: Unity SDK 連携ガイド
description: Unity SDKを使用して、UnityアプリでAdjust機能にアクセスしましょう。
category-title: Unity SDK
slug: ja/sdk/unity
sidebar-position: 3
versions:
-
label: "v5"
value: "v5"
default: true
-
label: "v4"
value: "v4"
redirects:
v4: "/en/sdk/unity/v4"
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
redirects:
v4: /ja/sdk/unity/v4
---

Adjust Unity SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをUnityアプリで記録できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。

事前準備 \{% \#before\-you\-begin %\}
--------------------------------------
事前準備 {% #before-you-begin %}

---

事前準備として、以下の内容をご確認ください。

* Adjust SDKは、iOS 12以降またはAndroid APIレベル21（Lollipop）以降に対応しています。
* Adjust SDKはUnity Editor 2018\.2以降に対応しています。
* Adjust SDKはUnity Editor 2018.2以降に対応しています。

1\. Adjust SDKを取得する \{% \#get\-the\-adjust\-sdk %\}
----------------------------------------------------------
1. Adjust SDKを取得する {% #get-the-adjust-sdk %}

---

Adjust SDKをインストールするには、次のいずれかのメソッドを選択します。

### Unityのパッケージをインストールする \{% \#install\-unity\-package %\}
### Unityのパッケージをインストールする {% #install-unity-package %}

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パッケージを選択します。
1. **Assets --> Import Package --> Custom Package** を選択します。
1. ダウンロードしたSDKパッケージを選択します。

### UnityのPackage Managerを使用する \{% \#use\-the\-unity\-package\-manager %\}
### UnityのPackage Managerを使用する {% #use-the-unity-package-manager %}

Unity Package Managerを使用してAdjust SDKをインストールするには、以下の手順に従ってください。

1. Unity editorで、 **Package Manager** ウィンドウを選択します。
2. **Add package from git URLを** 選択します。
3. 次のURLを入力します：`https://github.com/adjust/unity_sdk.git?path=Assets/Adjust`。

2\. iOSとAndroid SDKをインストールする \{% \#install\-ios\-and\-android\-sdks %\}
-------------------------------------------------------------------------------
1. **Add package from git URLを** 選択します。

1. 次のURLを入力します：`https://github.com/adjust/unity_sdk.git?path=Assets/Adjust`。

\{% minorversion
changed="v5\.0\.4"
link="[https://github.com/adjust/unity\_sdk/releases/tag/v5\.0\.4](https://github.com/adjust/unity_sdk/releases/tag/v5.0.4)" %\}
SDK v5では、iOSおよびAndroid SDKがバイナリー依存関係として使用されなくなりました。iOSおよびAndroid SDKをインストールするには、[External Dependency Manager for Unity \(EDM4U\)](https://github.com/googlesamples/unity-jar-resolver)を使用して、CocoaPodsおよびMavenからパッケージをインストールする必要があります。
\{% /minorversion %\}
1. iOSとAndroid SDKをインストールする {% #install-ios-and-android-sdks %}

3\. SDKを実装する \{% \#integrate\-the\-sdk %\}
------------------------------------------------
---

{% minorversion
changed="v5.0.4"
link="[https://github.com/adjust/unity_sdk/releases/tag/v5.0.4](https://github.com/adjust/unity_sdk/releases/tag/v5.0.4)" %}
SDK v5では、iOSおよびAndroid SDKがバイナリー依存関係として使用されなくなりました。iOSおよびAndroid SDKをインストールするには、[External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver)を使用して、CocoaPodsおよびMavenからパッケージをインストールする必要があります。

{% minorversion /%}

3. 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の動作を制御する編集可能なフィールドが含まれています。
1. プレハブのInspector Menuを開きます。
1. プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。

![UnityエディターのAdjust SDK プレハブ構成スクリプト](@images/unity/1-prefab.png)

以下の情報を入力して、Adjust SDKを設定します。

1. **アプリトークン** 。アプリトークンの確認方法については、アプリ設定をご覧ください。
2. **環境** ：

1. **環境** ：

* アプリをテスト中で、テストデータを送信する必要がある場合は、 **サンドボックス** を選択します。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。
* テストが完了し、アプリを公開する準備が整ったら、 **本番用** を選択します。

3. **ログレベル** 。ログレベルは、受け取るログの内容を制御します。詳しくは、[ログレベルの設定](/en/sdk/unity/configuration#set-your-logging-level)をご覧ください。
1. **ログレベル** 。ログレベルは、受け取るログの内容を制御します。詳しくは、[ログレベルの設定](/ja/sdk/unity/configuration#set-your-logging-level)をご覧ください。

Adjust SDKは、アプリのAwakeイベントが発生したときにデフォルトで開始します。この動作をオーバーライドするには、 **START SDK MANUALLY** オプションをONにしてください。これにより、configインスタンスを引数として`Adjust.InitSdk`を呼び出すことで、Adjust SDKを初期化できます。

Expand All @@ -84,101 +92,101 @@ AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment
Adjust.InitSdk(adjustConfig);
```

4\. Androidデバイスを設定する \{% \#set\-up\-android\-devices %\}
---------------------------------------------------------------
4. Androidデバイスを設定する {% #set-up-android-devices %}

---

### Google Play 開発者サービスを追加する \{% \#add\-google\-play\-services %\}
### Google Play 開発者サービスを追加する {% #add-google-play-services %}

Google Playストアを対象とするアプリは、gps\_adid（Google広告ID）を使用してデバイスを識別する必要があります。`gps_adid`にアクセスするには、`play-services-ads-identifier` AARをプロジェクトに追加する必要があります。
Google Playストアを対象とするアプリは、gps_adid（Google広告ID）を使用してデバイスを識別する必要があります。`gps_adid`にアクセスするには、`play-services-ads-identifier` AARをプロジェクトに追加する必要があります。

\{% tabs %\}
\{% tab title="EDM4U" sync="edm4u" %\}
{% tabs %}
{% tab title="EDM4U" 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 %\}

\{% tab title="Manual installation" sync="manual" %\}
{% 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 %\}
{% /tab %}
{% /tabs %}

### アプリセットIDを収集する \{% \#collect\-app\-set\-identifier %\}
### アプリセットIDを収集する {% #collect-app-set-identifier %}

[アプリセットID](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/appsetid/AppSetId) は、ユーザーがデバイスにインストールしたアプリの情報を計測するための一意の識別子です。同じ開発者のアプリは全て同じアプリセットIDを共有しているため、全てのアプリのユーザーから有意義なインサイトを収集できます。

\{% tabs %\}
\{% tab title="EDM4U" sync="edm4u" %\}
{% tabs %}
{% tab title="EDM4U" 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 %\}

\{% tab title="Manual installation" sync="manual" %\}
{% 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 %\}
{% /tab %}
{% /tabs %}

### インストールリファラーを設定する

インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。そこで、 [Google Play Referrer API](https://developer.android.com/google/play/installreferrer)を使用してこの情報を収集します。

Google Play Referrer APIをサポートするには、以下の2つの方法があります。

\{% tabs %\}
\{% tab title="EDM4U" sync="edm4u" %\}
{% tabs %}
{% tab title="EDM4U" 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 %\}

\{% tab title="Manual installation" sync="manual" %\}
{% 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 %\}
{% /tab %}
{% /tabs %}

#### Metaとのリファラー連携

Adjust SDKは、Adjust Metaインストールリファラープラグインを使用して[Metaインストールリファラー](https://developers.facebook.com/docs/app-ads/meta-install-referrer)をサポートしています。[連携の詳細については、Metaインストール リファラープラグインをご覧ください](/en/sdk/unity/plugins/meta-referrer-plugin)。
Adjust SDKは、Adjust Metaインストールリファラープラグインを使用して[Metaインストールリファラー](https://developers.facebook.com/docs/app-ads/meta-install-referrer)をサポートしています。[連携の詳細については、Metaインストール リファラープラグインをご覧ください](/ja/sdk/unity/plugins/meta-referrer-plugin)。

5\. SDKシグネチャーを設定する \{% \#set\-up\-sdk\-signature %\}
-----------------------------------------------------------
5. SDKシグネチャーを設定する {% #set-up-sdk-signature %}

Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、[AdjustヘルプセンターのSDKシグネチャーガイド](https://help.adjust.com/en/article/sdk-signature)の手順に従ってください。
---

6\. アプリをビルドする \{% \#build\-your\-app %\}
----------------------------------------------
Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、[AdjustヘルプセンターのSDKシグネチャーガイド](https://help.adjust.com/ja/article/sdk-signature)の手順に従ってください。

6. アプリをビルドする {% #build-your-app %}

---

アプリのビルドプロセスを完了し、アプリ内でAdjust SDKが動作することを確実にするため、Adjust Unityのパッケージはポストビルドを実行します。 このプロセスは、`AdjustEditor.cs`の`OnPostprocessBuild`メソッドによって実行されます。

ポストビルドオプションを設定して、アプリのビルドをカスタマイズできます。

![UnityエディターのAdjust SDK ポストビルド構成スクリプト](@images/unity/2-postbuild.png)

### iOS \{% \#ios %\}
### iOS {% #ios %}

\{% callout type="important" %\}
{% callout type="important" %}
iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート（iOS build support）** をインストールしてください。
\{% /callout %\}
{% /callout %}

iOSのポストビルドプロセスは、生成したXcodeプロジェクトを次のように変更します。

* Objective\-C exceptionsを有効にします。
* Objective-C exceptionsを有効にします。

#### フレームワーク

Expand All @@ -201,7 +209,7 @@ ATT（App Tracking Transparency）ラッパーを使用している場合は、
* **iOS URL Identifier** ：アプリのバンドルID。
* **iOS URLスキーム** ：アプリに関連するURLスキーム。

### Android \{% \#android %\}
### 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ファイルへのリンク")からコピーを作成します。

Expand All @@ -222,22 +230,23 @@ Android機能にアクセスするには、以下のパーミッションを有

プロセスの出力は、Unity IDEコンソールウィンドウに表示されます。

7\. 連携をテストする \{% \#test\-your\-integration %\}
----------------------------------------------------
7. 連携をテストする {% #test-your-integration %}

\{% callout type="tip" %\}
---

{% callout type="tip" %}
問題が発生した場合は、全ての詳細情報とログを添付し、[[email protected]](mailto:[email protected])までメールをお送りください。
\{% /callout %\}
{% /callout %}

Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。

* 環境を`AdjustEnvironment.Sandbox`に設定します。
* Adjustダッシュボードにサンドボックスフィルターを追加します。
* [ログレベル](/en/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に設定します。
* [ログレベル](/ja/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に設定します。

### Google Play 開発者サービスの連携をテストする \{% \#test\-google\-play\-services\-integration %\}
### 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\)パラメーターをログに記録します。
Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、[ログレベル](/ja/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])までお問い合わせください。

{% /minorversion %}
Loading

0 comments on commit 25d8e0d

Please sign in to comment.