Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Smartling translations are completed for commit e99142c6517d6aee9b2ca16195d2ea6d9c4b80e2 from main #1242

80 changes: 49 additions & 31 deletions src/content/docs/ja/sdk/unity/v5/index.mdoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,25 +5,29 @@ category-title: Unity SDK
slug: ja/sdk/unity
sidebar-position: 3
versions:
- label: v5
value: v5
default: true
- label: v4
value: v4
- 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以降に対応しています。

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

---

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

Expand All @@ -42,18 +46,25 @@ UnityアプリでAdjust SDKを使うには、プロジェクトに追加する
Unity Package Managerを使用してAdjust SDKをインストールするには、以下の手順に従ってください。

1. Unity editorで、 **Package Manager** ウィンドウを選択します。

1. **Add package from git URLを** 選択します。

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

## 2. iOSとAndroid SDKをインストールする {% #install-ios-and-android-sdks %}
1. iOSとAndroid SDKをインストールする {% #install-ios-and-android-sdks %}

---

{% 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 %}
{% minorversion /%}

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

---

Adjust SDKには、ゲームオブジェクトのテンプレートとAdjustスクリプトを含むUnity[プレハブ(Prefab)](https://docs.unity3d.com/Manual/Prefabs.html)が格納されています。このスクリプトを使用してSDKを設定できます。Unityエディターでプレハブを開くには、以下の手順に従ってください。

Expand Down Expand Up @@ -81,7 +92,9 @@ 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 %}

Expand All @@ -92,8 +105,8 @@ Google Playストアを対象とするアプリは、gps_adid(Google広告ID
[External Dependency Managerプラグイン](https://developers.google.com/unity/archive#external_dependency_manager_for_unity)を使用している場合は、`Dependencies.xml`ファイルに以下を追加します。

```xml
<androidpackages>
<androidpackage spec="com.google.android.gms:play-services-ads-identifier:18.0.1" />
<androidpackages id="sl-md0000000">
<androidpackage spec="com.google.android.gms:play-services-ads-identifier:18.0.1" id="sl-md0000000" />
</androidPackages>
```
{% /tab %}
Expand All @@ -112,8 +125,8 @@ ARR(Android Archive)を手動でインストールするには、[Mavenか
デバイスのApp Set IDを記録するには、以下のdependencyを`Dependencies.xml`ファイルに追加する必要があります。

```xml
<androidpackages>
<androidpackage spec="com.google.android.gms:play-services-appset:16.0.2" />
<androidpackages id="sl-md0000000">
<androidpackage spec="com.google.android.gms:play-services-appset:16.0.2" id="sl-md0000000" />
</androidPackages>
```
{% /tab %}
Expand Down Expand Up @@ -149,29 +162,33 @@ dependencies {

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/ja/article/sdk-signature)の手順に従ってください。

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

---

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

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

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

{% tabs %}
{% tab title="iOS" icon="PlatformIos" %}
### iOS {% #ios %}

{% callout type="important" %}
iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート** がインストールされていることを確認してください
iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート(iOS build support)** をインストールしてください
{% /callout %}

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

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

#### フレームワーク {% #frameworks %}
#### フレームワーク

iOS機能にアクセスするために、以下のフレームワークを有効にすることができます。

Expand All @@ -180,23 +197,23 @@ iOS機能にアクセスするために、以下のフレームワークを有
* `AppTrackingTransparency.framework`: ユーザーに計測への同意を求め、その同意ステータスを取得するために必要。
* `StoreKit.framework`: SKAdNetworkフレームワークとの通信に必要。

#### AppTrackingTransparencyの同意ダイアログ {% #app-tracking-transparency-consent-dialog %}
#### AppTrackingTransparencyの同意ダイアログ

ATT(App Tracking Transparency)ラッパーを使用している場合は、 **User Tracking Description** メッセージを入力します。このメッセージは、ATT同意ダイアログをユーザーに示す場合に表示されます。

#### ディープリンク {% #deep-linking %}
#### ディープリンク

ディープリンクを有効化するには、次の情報を追加します。

* **iOSユニバーサルリンクドメイン** :ユニバーサルリンクに使用されるAssociated Domain。
* **iOS URL Identifier** :アプリのバンドルID。
* **iOS URLスキーム** :アプリに関連するURLスキーム。
{% /tab %}

{% tab title="Android" icon="PlatformAndroid" %}
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 %}

#### パーミッション {% #permissions %}
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機能にアクセスするには、以下のパーミッションを有効にしてください。

Expand All @@ -205,17 +222,17 @@ Android機能にアクセスするには、以下のパーミッションを有
* `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)を参照してください。

#### ディープリンク {% #deep-linking-1 %}
#### ディープリンク

ディープリンクを有効化するには、次の情報を追加します。

**Android URIスキーム** :ディープリンクの遷移先。
{% /tab %}
{% /tabs %}

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

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

---

{% callout type="tip" %}
問題が発生した場合は、全ての詳細情報とログを添付し、[[email protected]](mailto:[email protected])までメールをお送りください。
Expand All @@ -232,3 +249,4 @@ Adjust SDKは、実装をテストとトラブルシューティングのため
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
Loading