diff --git a/src/content/docs/ja/sdk/unity/v5/index.mdoc b/src/content/docs/ja/sdk/unity/v5/index.mdoc index 1b1aaab19..e8a860dd2 100644 --- a/src/content/docs/ja/sdk/unity/v5/index.mdoc +++ b/src/content/docs/ja/sdk/unity/v5/index.mdoc @@ -1,78 +1,81 @@ --- -title: Unity SDK 連携ガイド -description: Unity SDKを使用して、UnityアプリでAdjust機能にアクセスしましょう。 -category-title: Unity SDK -slug: ja/sdk/unity +title: "Unity SDK 連携ガイド" +description: "Unity SDKを使用して、UnityアプリでAdjust機能にアクセスしましょう。" +category-title: "Unity SDK" +slug: "en/sdk/unity" sidebar-position: 3 -versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4 +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/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)を開きます。 -1. **Assets --> Import Package --> Custom Package** を選択します。 -1. ダウンロードしたSDKパッケージを選択します。 +2. **Assets \-\-> Import Package \-\-> Custom Package** を選択します。 +3. ダウンロードした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** ウィンドウを選択します。 -1. **Add package from git URLを** 選択します。 -1. 次のURLを入力します:`https://github.com/adjust/unity_sdk.git?path=Assets/Adjust`。 +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 %} +2\. 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 %} +\{% 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 %} +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番目のシーンに追加します。 -1. プレハブのInspector Menuを開きます。 -1. プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。 +2. プレハブのInspector Menuを開きます。 +3. プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。 ![UnityエディターのAdjust SDK プレハブ構成スクリプト](@images/unity/1-prefab.png) 以下の情報を入力して、Adjust SDKを設定します。 1. **アプリトークン** 。アプリトークンの確認方法については、アプリ設定をご覧ください。 - -1. **環境** : - +2. **環境** : * アプリをテスト中で、テストデータを送信する必要がある場合は、 **サンドボックス** を選択します。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。 * テストが完了し、アプリを公開する準備が整ったら、 **本番用** を選択します。 -1. **ログレベル** 。ログレベルは、受け取るログの内容を制御します。詳しくは、[ログレベルの設定](/ja/sdk/unity/configuration#set-your-logging-level)をご覧ください。 +3. **ログレベル** 。ログレベルは、受け取るログの内容を制御します。詳しくは、[ログレベルの設定](/en/sdk/unity/configuration#set-your-logging-level)をご覧ください。 Adjust SDKは、アプリのAwakeイベントが発生したときにデフォルトで開始します。この動作をオーバーライドするには、 **START SDK MANUALLY** オプションをONにしてください。これにより、configインスタンスを引数として`Adjust.InitSdk`を呼び出すことで、Adjust SDKを初期化できます。 @@ -81,47 +84,50 @@ 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 - - + + ``` -{% /tab %} -{% tab title="Manual installation" sync="manual" %} +\{% /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 %} +\{% /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 - - + + ``` -{% /tab %} -{% tab title="Manual installation" sync="manual" %} +\{% /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 %} +\{% /tab %\} +\{% /tabs %\} ### インストールリファラーを設定する @@ -129,8 +135,8 @@ ARR(Android Archive)を手動でインストールするには、[Mavenか 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 @@ -138,22 +144,25 @@ dependencies { implementation 'com.android.installreferrer:installreferrer:2.2' } ``` -{% /tab %} -{% tab title="Manual installation" sync="manual" %} +\{% /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 %} +\{% /tab %\} +\{% /tabs %\} #### Metaとのリファラー連携 -Adjust SDKは、Adjust Metaインストールリファラープラグインを使用して[Metaインストールリファラー](https://developers.facebook.com/docs/app-ads/meta-install-referrer)をサポートしています。[連携の詳細については、Metaインストール リファラープラグインをご覧ください](/ja/sdk/unity/plugins/meta-referrer-plugin)。 +Adjust SDKは、Adjust Metaインストールリファラープラグインを使用して[Metaインストールリファラー](https://developers.facebook.com/docs/app-ads/meta-install-referrer)をサポートしています。[連携の詳細については、Metaインストール リファラープラグインをご覧ください](/en/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)の手順に従ってください。 +Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、[AdjustヘルプセンターのSDKシグネチャーガイド](https://help.adjust.com/en/article/sdk-signature)の手順に従ってください。 -## 6. アプリをビルドする {% #build-your-app %} +6\. アプリをビルドする \{% \#build\-your\-app %\} +---------------------------------------------- アプリのビルドプロセスを完了し、アプリ内でAdjust SDKが動作することを確実にするため、Adjust Unityのパッケージはポストビルドを実行します。 このプロセスは、`AdjustEditor.cs`の`OnPostprocessBuild`メソッドによって実行されます。 @@ -161,17 +170,17 @@ Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグ ![UnityエディターのAdjust SDK ポストビルド構成スクリプト](@images/unity/2-postbuild.png) -{% tabs %} -{% tab title="iOS" icon="PlatformIos" %} -{% callout type="important" %} -iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート** がインストールされていることを確認してください。 -{% /callout %} +### iOS \{% \#ios %\} + +\{% callout type="important" %\} +iOSポストビルドプロセスを実行するには、Unityエディターに **iOSビルドサポート(iOS build support)** をインストールしてください。 +\{% /callout %\} iOSのポストビルドプロセスは、生成したXcodeプロジェクトを次のように変更します。 -* Objective-C exceptionsを有効にします。 +* Objective\-C exceptionsを有効にします。 -#### フレームワーク {% #frameworks %} +#### フレームワーク iOS機能にアクセスするために、以下のフレームワークを有効にすることができます。 @@ -180,23 +189,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機能にアクセスするには、以下のパーミッションを有効にしてください。 @@ -205,30 +214,30 @@ 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" %} +\{% callout type="tip" %\} 問題が発生した場合は、全ての詳細情報とログを添付し、[support@adjust.com](mailto:support@adjust.com)までメールをお送りください。 -{% /callout %} +\{% /callout %\} Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。 * 環境を`AdjustEnvironment.Sandbox`に設定します。 * Adjustダッシュボードにサンドボックスフィルターを追加します。 -* [ログレベル](/ja/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に設定します。 +* [ログレベル](/en/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を受信できるかどうかテストするには、[ログレベル](/ja/sdk/unity/configuration#set-your-logging-level)を`AdjustLogLevel.Verbose`に、環境を`AdjustEnvironment.Sandbox`に設定します。アプリを起動して`session`またはイベントを計測します。SDKが広告IDを読み取った場合、SDKはgps_adid(Google Play 開発者サービス広告ID)パラメーターをログに記録します。 +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)で質問を投稿するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 + diff --git a/src/content/docs/ko/sdk/unity/v5/index.mdoc b/src/content/docs/ko/sdk/unity/v5/index.mdoc index 529f2563c..d74b352e3 100644 --- a/src/content/docs/ko/sdk/unity/v5/index.mdoc +++ b/src/content/docs/ko/sdk/unity/v5/index.mdoc @@ -1,78 +1,81 @@ --- -title: Unity SDK 연동 가이드 -description: Unity SDK를 사용하여 Unity 앱의 Adjust 기능에 액세스합니다. -category-title: Unity SDK -slug: ko/sdk/unity +title: "Unity SDK 연동 가이드" +description: "Unity SDK를 사용하여 Unity 앱의 Adjust 기능에 액세스합니다." +category-title: "Unity SDK" +slug: "en/sdk/unity" sidebar-position: 3 -versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4 +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/unity/v4" --- - Adjust Unity SDK를 사용하면 Unity 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다. -## 시작에 앞서 {% #before-you-begin %} +시작에 앞서 \{% \#before\-you\-begin %\} +---------------------------------------- -Here's what you need to know before you get started: +시작 전 확인해야 할 사항은 다음과 같습니다. -* Adjust SDK는 iOS 12 이상 버전과 Android API level 21 (Lollipop) 이상을 지원합니다. -* The Adjust SDK is compatible with Unity Editor 2018.2 or later. +* Adjust SDK는 iOS 12 이상 버전과 Android API level 21 \(Lollipop\) 이상을 지원합니다. +* 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를 시작하려면 우선 프로젝트에 Adjust SDK를 추가해야 합니다. [GitHub releases 페이지](https://github.com/adjust/adjust_unity_sdk/releases/latest)에서 최신 버전을 다운로드합니다. Adjust SDK를 Unity 프로젝트로 불러오는 방법: 1. Unity Editor를 실행합니다. -1. **Assets --> Import Package --> Custom Package** 를 선택합니다. -1. 다운로드된 SDK 패키지를 선택합니다. +2. **Assets \-\-> Import Package \-\-> Custom Package** 를 선택합니다. +3. 다운로드된 SDK 패키지를 선택합니다. -### Unity 패키지 매니저 사용 {% #use-the-unity-package-manager %} +### Unity 패키지 매니저 사용 \{% \#use\-the\-unity\-package\-manager %\} Unity 패키지 매니저로 Adjust SDK를 설치하려면 다음의 단계를 수행하시기 바랍니다. 1. Unity 에디터에서 **패키지 매니저** 창을 선택합니다. -1. **git URL에서 패키지 추가** 를 선택합니다. -1. 다음 URL을 입력합니다. `https://github.com/adjust/unity_sdk.git?path=Assets/Adjust` +2. **git URL에서 패키지 추가** 를 선택합니다. +3. 다음 URL을 입력합니다. `https://github.com/adjust/unity_sdk.git?path=Assets/Adjust` -## 2. iOS와 Android SDK 설치 {% #install-ios-and-android-sdks %} +2\. 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 no longer uses the iOS and Android SDKs as binary dependencies. To install the underlying iOS and Android SDKs, you need to use the [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver) to install the packages from CocoaPods and Maven. -{% /minorversion %} +\{% 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를 설치하려면 [EDM4U\(External Dependency Manager for Unity\)](https://github.com/googlesamples/unity-jar-resolver)를 사용하여 CocoaPods 및 Maven의 패키지를 설치해야 합니다. +\{% /minorversion %\} -## 3. SDK 연동 {% #integrate-the-sdk %} +3\. SDK 연동 \{% \#integrate\-the\-sdk %\} +---------------------------------------------- -Adjust SDK는 Unity [프리팹(prefab)](https://docs.unity3d.com/Manual/Prefabs.html)을 포함하며, 프리팹에는 템플릿 게임 객체와 Adjust 스크립트가 있습니다. 이 스크립트를 사용해 SDK를 구성할 수 있습니다. Unity Editor에서 프리팹을 실행하려면 다음을 수행하시기 바랍니다. +Adjust SDK는 Unity [프리팹\(prefab\)](https://docs.unity3d.com/Manual/Prefabs.html)을 포함하며, 프리팹에는 템플릿 게임 객체와 Adjust 스크립트가 있습니다. 이 스크립트를 사용해 SDK를 구성할 수 있습니다. Unity Editor에서 프리팹을 실행하려면 다음을 수행하시기 바랍니다. 1. `Assets/Adjust/Adjust.prefab` 로부터의 프리팹을 첫 화면에 추가합니다. -1. 프리팹 Inspector Menu를 실행합니다. -1. 프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다. +2. 프리팹 Inspector Menu를 실행합니다. +3. 프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다. ![Unity Editor 내 Adjust SDK 프리팹 구성 스크립트의 스크린샷.](@images/unity/1-prefab.png) Adjust SDK를 설정하려면 다음의 정보를 입력하시기 바랍니다. 1. **앱 토큰** . 앱 토큰 확인 방법은 앱 설정 페이지를 참조하시기 바랍니다. - -1. **앱 환경** . - +2. **앱 환경** . * 앱을 테스트 중이며 테스트 데이터를 전송하고자 하는 경우 **샌드박스** 모드를 선택하시기 바랍니다. 테스트 데이터를 보려면 대시보드에서 샌드박스 모드를 활성화해야 합니다. * 테스트를 완료하고 앱 출시 준비가 된 경우 **프로덕션** 모드를 선택하시기 바랍니다. -1. **로그 수준** . 어느 로그를 받는지에 관한 것으로, 자세한 정보는 [로그 수준 설정 페이지](/ko/sdk/unity/configuration#set-your-logging-level)를 참조하시기 바랍니다. +3. **로그 수준** . 어느 로그를 받는지에 관한 것으로, 자세한 정보는 [로그 수준 설정 페이지](/en/sdk/unity/configuration#set-your-logging-level)를 참조하시기 바랍니다. Adjust SDK는 기본값 설정에 따라 앱의 Awake 이벤트가 발생한 경우 시작됩니다. 이 행동을 오버라이드하려면 **START SDK MANUALLY** 옵션을 확인하시기 바랍니다. 이를 통해 config 인스턴스를 인수로 `Adjust.InitSdk`를 호출하여 Adjust SDK를 초기화할 수 있습니다. @@ -81,47 +84,50 @@ AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment Adjust.InitSdk(adjustConfig); ``` -## 4. Android 기기 설정 {% #set-up-android-devices %} +4\. Android 기기 설정 \{% \#set\-up\-android\-devices %\} +------------------------------------------------------------ -### Google Play Services 추가 {% #add-google-play-services %} +### Google Play Services 추가 \{% \#add\-google\-play\-services %\} -Google 플레이 스토어를 타겟으로 하는 앱은 기기 식별을 위해 gps_adid(Google 광고 ID)를 사용해야 합니다. `gps_adid`에 액세스하기 위해 프로젝트에 `play-services-ads-identifier` AAR을 추가합니다. +Google 플레이 스토어를 타겟으로 하는 앱은 기기 식별을 위해 gps\_adid\(Google 광고 ID\)를 사용해야 합니다. `gps_adid`에 액세스하기 위해 프로젝트에 `play-services-ads-identifier` AAR을 추가합니다. -{% tabs %} -{% tab title="EDM4U" sync="edm4u" %} -[외부 디펜던시 매니저 플러그인](https://developers.google.com/unity/archive#external_dependency_manager_for_unity)을 사용하는 경우 `Dependencies.xml` 파일에 다음을 추가하시기 바랍니다. +\{% tabs %\} +\{% tab title="EDM4U" sync="edm4u" %\} +[외부 디펜던시 매니저 플러그인](https://developers.google.com/unity/archive#external_dependency_manager_for_unity)을 사용하는 경우 `Dependencies.xml` 파일에 다음을 추가하시기 바랍니다. ```xml - - + + ``` -{% /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 결과물(artifact) 링크.") 한 뒤 `Assets/Plugins/Android` 디렉토리에 추가하시기 바랍니다. -{% /tab %} -{% /tabs %} +\{% /tab %\} -### App Set ID 수집 {% #collect-app-set-identifier %} +\{% 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 결과물(artifact) 링크.") 한 뒤 `Assets/Plugins/Android` 디렉토리에 추가하시기 바랍니다. +\{% /tab %\} +\{% /tabs %\} + +### App Set ID 수집 \{% \#collect\-app\-set\-identifier %\} [앱 세트 ID](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/appsetid/AppSetId) 는 사용자가 기기에 설치한 앱 정보를 측정할 수 있도록 해주는 고유한 ID입니다. 동일한 개발자의 모든 앱은 App Set ID를 공유하기 때문에, 모든 앱 사용자로부터 유의미한 인사이트를 수집할 수 있습니다. -{% tabs %} -{% tab title="EDM4U" sync="edm4u" %} +\{% tabs %\} +\{% tab title="EDM4U" sync="edm4u" %\} 기기의 App Set ID를 기록하려면 다음의 디펜던시를 `Dependencies.xml` 파일에 추가해야 합니다. ```xml - - + + ``` -{% /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 결과물(artifact) 링크.") 한 뒤 `Assets/Plugins/Android` 디렉토리에 추가하시기 바랍니다. -{% /tab %} -{% /tabs %} +\{% /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 결과물(artifact) 링크.") 한 뒤 `Assets/Plugins/Android` 디렉토리에 추가하시기 바랍니다. +\{% /tab %\} +\{% /tabs %\} ### 설치 리퍼러 설정 @@ -129,8 +135,8 @@ ARR (Android Archive)을 수동으로 설치하려면, [Maven에서 다운로드 Google Play Referrer API를 지원하는 방법에는 두 가지가 있습니다. -{% 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)에 설치 리퍼러 라이브러리를 디펜던시로 추가 ```groovy @@ -138,40 +144,43 @@ 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)에서 설치 리퍼러 라이브러리를 다운로드하고, AAR(Android Archive) 파일을 `Plugins/Android` 폴더에 넣기. -{% /tab %} -{% /tabs %} +\{% /tab %\} + +\{% tab title="Manual installation" sync="manual" %\} +[Maven](https://maven.google.com/web/index.html?q=install#com.android.installreferrer:installreferrer)에서 설치 리퍼러 라이브러리를 다운로드하고, AAR\(Android Archive\) 파일을 `Plugins/Android` 폴더에 넣기. +\{% /tab %\} +\{% /tabs %\} #### Meta 리퍼러 연동 -Adjust SDK는 Adjust Meta 설치 리퍼러 플러그인을 사용하는 [Meta 설치 리퍼러](https://developers.facebook.com/docs/app-ads/meta-install-referrer)를 지원합니다. [연동에 대한 자세한 내용은 Unity Meta 설치 리퍼러 플러그인을 참조하시기 바랍니다](/ko/sdk/unity/plugins/meta-referrer-plugin). +Adjust SDK는 Adjust Meta 설치 리퍼러 플러그인을 사용하는 [Meta 설치 리퍼러](https://developers.facebook.com/docs/app-ads/meta-install-referrer)를 지원합니다. [연동에 대한 자세한 내용은 Unity Meta 설치 리퍼러 플러그인을 참조하시기 바랍니다](/en/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/ko/article/sdk-signature)의 지침을 따르시기 바랍니다. +Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 SDK 서명 라이브러리를 사용하려면 [Adjust 헬프 센터에 있는 SDK 서명 가이드](https://help.adjust.com/en/article/sdk-signature)의 지침을 따르시기 바랍니다. -## 6. 앱 빌드 {% #build-your-app %} +6\. 앱 빌드 \{% \#build\-your\-app %\} +----------------------------------------- Adjust Unity 패키지를 사용하면 앱 빌드 절차를 완료하기 위해 빌드 완료 후 커스텀 작업을 수행하여, Adjust SDK가 앱 내에서 작동하도록 할 수 있습니다. 이 과정은 `OnPostprocessBuild` 메서드에 의해 `AdjustEditor.cs` 내에서 수행됩니다. -빌드 후(post-build) 옵션을 구성하여 앱 빌드를 맞춤화할 수 있습니다. +빌드 후\(post\-build\) 옵션을 구성하여 앱 빌드를 맞춤화할 수 있습니다. ![Unity Editor 내 Adjust SDK의 빌드 완료 후 구성 스크립의 스크린샷.](@images/unity/2-postbuild.png) -{% tabs %} -{% tab title="iOS" icon="PlatformIos" %} -{% callout type="important" %} -iOS 빌드 이후 절차를 진행하려면, Unity Editor에서 **iOS 빌드 지원** 이 되는지 확인하시기 바랍니다. -{% /callout %} +### iOS \{% \#ios %\} + +\{% callout type="important" %\} +To run the iOS post\-build process, make sure that you have **iOS build support** installed in the Unity Editor. +\{% /callout %\} iOS 빌드 후 절차는 생성한 Xcode 프로젝트를 다음과 같이 변경합니다. -* Objective-C exceptions 활성화. +* Objective\-C exceptions 활성화. -#### 프레임워크 {% #frameworks %} +#### 프레임워크 iOS 기능에 액세스하기 위해 다음의 프레임워크를 활성화할 수 있습니다. @@ -180,55 +189,55 @@ iOS 기능에 액세스하기 위해 다음의 프레임워크를 활성화할 * `AppTrackingTransparency.framework`: 사용자에게 측정 동의 여부를 묻기 위해 필요 * `StoreKit.framework`: SKAdNetwork 프레임워크와 통신하기 위해 필요 -#### App Tracking Transparency 동의 다이얼로그 {% #app-tracking-transparency-consent-dialog %} +#### App Tracking Transparency 동의 대화 -ATT(App Tracking Transparency) 래퍼를 사용하는 경우, **User Tracking Description** 메시지를 입력하시기 바랍니다. 이는 사용자 화면에 ATT 동의 다이얼로그를 표시할 때 나타납니다. +ATT\(App Tracking Transparency\) 래퍼를 사용하는 경우, **User Tracking Description** 메시지를 입력하시기 바랍니다. 이는 사용자 화면에 ATT 동의 다이얼로그를 표시할 때 나타납니다. -#### 딥링크 {% #deep-linking %} +#### 딥링킹 딥링크를 활성화하려면, 다음의 정보를 추가하시기 바랍니다. * **iOS 유니버설 링크 도메인** : 유니버설 링크에 사용되는 관련 도메인. * **iOS URL 식별자** : 앱의 번들 ID. * **iOS URL 스킴** : 앱과 관련된 URL 스킴. -{% /tab %} -{% tab title="Android" icon="PlatformAndroid" %} +### Android \{% \#android %\} + Android 빌드 후 과정에서는 `AndroidManifest.xml` 파일이 `Assets/Plugins/Android/` 안에 있는지 찾습니다. 이 파일이 없는 경우, [`AdjustAndroidManifest.xml`](https://github.com/adjust/unity_sdk/blob/master/Assets/Adjust/Native/Android/AdjustAndroidManifest.xml "GitHub 내 AdjustAndroidManifest 파일 링크") 사본을 생성합니다. -#### 권한 {% #permissions %} +#### 권한 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`: Android 12(API 레벨 31) 이상에서 기기의 광고 ID를 읽기 위해 필요. 자세한 정보는 [Google의 `AdvertisingIdClient.info` 문서](https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient.Info#public-string-getid)를 참조하시기 바랍니다. +* `com.google.android.gms.permission.AD_ID`: Android 12\(API 레벨 31\) 이상에서 기기의 광고 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 Schemes** : 딥링크의 목적지. -{% /tab %} -{% /tabs %} 프로세스의 결과는 Unity IDE 콘솔 창에 표시됩니다. -## 7. 연동 테스트 {% #test-your-integration %} +7\. 연동 테스트 \{% \#test\-your\-integration %\} +-------------------------------------------------- -{% callout type="tip" %} +\{% callout type="tip" %\} 문제 발생 시, 모든 상세 내용과 로그를 [support@adjust.com](mailto:support@adjust.com)로 전송하시기 바랍니다. -{% /callout %} +\{% /callout %\} Adjust SDK는 연동 테스트와 문제 해결 툴을 제공합니다. 다음과 같이 설정을 테스트하시기 바랍니다. * 환경을 `AdjustEnvironment.Sandbox`로 설정합니다. * Adjust 대시보드 결과에 샌드박스 필터를 추가합니다. -* [로그 수준](/ko/sdk/unity/configuration#set-your-logging-level)을 `AdjustLogLevel.Verbose`로 설정합니다. +* [로그 수준](/en/sdk/unity/configuration#set-your-logging-level)을 `AdjustLogLevel.Verbose`로 설정합니다. -### Google Play Services 연동 테스트 {% #test-google-play-services-integration %} +### Google Play Services 연동 테스트 \{% \#test\-google\-play\-services\-integration %\} -Adjust SDK가 기기의 Google 광고 ID를 수신할 수 있는지 테스트하려면 [로그 수준](/ko/sdk/unity/configuration#set-your-logging-level)을 `AdjustLogLevel.Verbose`로 설정하고, 환경을 `AdjustEnvironment.Sandbox`로 설정합니다. 앱을 시작하고 `session` 또는 이벤트를 측정합니다. SDK가 광고 ID를 읽으면 gps_adid(Google 플레이 서비스 광고주 ID) 파라미터를 로깅합니다. +Adjust SDK가 기기의 Google 광고 ID를 수신할 수 있는지 테스트하려면 [로그 수준](/en/sdk/unity/configuration#set-your-logging-level)을 `AdjustLogLevel.Verbose`로 설정하고, 환경을 `AdjustEnvironment.Sandbox`로 설정합니다. 앱을 시작하고 `session` 또는 이벤트를 측정합니다. SDK가 광고 ID를 읽으면 gps\_adid\(Google 플레이 서비스 광고주 ID\) 파라미터를 로깅합니다. Google광고 ID를 읽을 수 없다면 Adjust의 [Github repository](https://github.com/adjust/unity_sdk)에 이슈를 제기하거나 [support@adjust.com](mailto:support@adjust.com)으로 메일 주시기 바랍니다. + diff --git a/src/content/docs/zh/sdk/unity/v5/index.mdoc b/src/content/docs/zh/sdk/unity/v5/index.mdoc index 3d6011b79..be6f833a2 100644 --- a/src/content/docs/zh/sdk/unity/v5/index.mdoc +++ b/src/content/docs/zh/sdk/unity/v5/index.mdoc @@ -1,78 +1,80 @@ --- -title: Unity SDK 集成 -description: 使用 Unity SDK,在 Unity 应用中使用 Adjust 功能。 -category-title: Unity SDK -slug: zh/sdk/unity +title: "Unity SDK 集成" +description: "使用 Unity SDK,在 Unity 应用中使用 Adjust 功能。" +category-title: "Unity SDK" +slug: "en/sdk/unity" sidebar-position: 3 -versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4 +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4" --- - 通过 Adjust Unity SDK,您可以在 Unity 应用中记录归因、事件以及更多信息。请按照本指南中说明的步骤操作,在应用内设置 Adjust SDK。 -## 操作前须知 {% #before-you-begin %} +操作前须知 \{% \#before\-you\-begin %\} +--------------------------------------- -Here's what you need to know before you get started: +以下是您在操作前需要了解的内容。 -* Adjust SDK 支持 iOS 12 或更新版本,以及安卓 API 级别 21 (Lollipop) 或更新版本。 -* The Adjust SDK is compatible with Unity Editor 2018.2 or later. +* Adjust SDK 支持 iOS 12 或更新版本,以及安卓 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,请选择下列方法之一。 -### 安装 Unity 包{% #install-unity-package %} +### 安装 Unity 包\{% \#install\-unity\-package %\} 要在您的 Unity 应用中使用 Adjust SDK,请先将 SDK 加入项目。您可以从[GitHub 发布页面](https://github.com/adjust/adjust_unity_sdk/releases/latest)下载最新版本的 SDK。 要向 Unity 项目中导入 Adjust SDK,请按照下列步骤操作: 1. 打开 Unity Editor。 -1. 选择 **Assets --> Import Package --> Custom Package** 。 -1. 选择已下载的 SDK 包。 +2. 选择 **Assets \-\-> Import Package \-\-> Custom Package** 。 +3. 选择已下载的 SDK 包。 -### 使用 Unity Package Manager{% #use-the-unity-package-manager %} +### 使用 Unity Package Manager\{% \#use\-the\-unity\-package\-manager %\} 要使用 Unity Package Manager 安装 Adjust SDK,请按照下列步骤操作: 1. 在 Unity 编辑器中选择 **Package Manager** 窗口。 -1. 选择 **Add package from git URL** 。 -1. 输入以下 URL:`https://github.com/adjust/unity_sdk.git?path=Assets/Adjust` . +2. 选择 **Add package from git URL** 。 +3. 输入以下 URL:`https://github.com/adjust/unity_sdk.git?path=Assets/Adjust` . -## 2. 安装 iOS 和安卓 SDK {% #install-ios-and-android-sdks %} +2\. 安装 iOS 和安卓 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 no longer uses the iOS and Android SDKs as binary dependencies. To install the underlying iOS and Android SDKs, you need to use the [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver) to install the packages from CocoaPods and Maven. -{% /minorversion %} +\{% 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 和安卓 SDK 作为二进制依赖。要安装底层 iOS 和安卓 SDK,您需要使用 [External Dependency Manager for Unity \(EDM4U\)](https://github.com/googlesamples/unity-jar-resolver) 从 CocoaPods 和 Maven 安装包。\{% /minorversion %\} -## 3. 集成 SDK{% #integrate-the-sdk %} +3\. 集成 SDK\{% \#integrate\-the\-sdk %\} +--------------------------------------------- Adjust SDK 包含一个 Unity [prefab](https://docs.unity3d.com/Manual/Prefabs.html),其中含有模板游戏对象和一个 Adjust 脚本。您可以使用该脚本配置 SDK。要在 Unity editor 中打开 prefab,请按照下列步骤操作: 1. 将 `Assets/Adjust/Adjust.prefab` 的 prefab 添加到您的第一个场景。 -1. 打开 prefab 的 Inspector Menu。 -1. prefab 菜单包含可编辑的字段,通过这些字段,您可以控制 Adjust SDK 的行为。 +2. 打开 prefab 的 Inspector Menu。 +3. prefab 菜单包含可编辑的字段,通过这些字段,您可以控制 Adjust SDK 的行为。 ![Adjust SDK 在 Unity editor 中的 prefab 配置脚本截图。](@images/unity/1-prefab.png) 要设置 Adjust SDK,请输入下列信息: 1. 您的 **应用识别码** 。请查看应用设置,了解查找识别码的办法。 - -1. 您的 **环境** : - +2. 您的 **环境** : * 如要测试应用并发送测试数据,请选择 **Sandbox** 。请在控制面板中启用 sandbox 模式,查看测试数据。 * 如果您已经完成测试,准备发布应用,请选择 **Production** 。 -1. 您的 **日志等级。** 这将控制您收到哪些日志。请查看[这篇文章](/zh/sdk/unity/configuration#set-your-logging-level),进一步了解日志等级设置。 +3. 您的 **日志等级。** 这将控制您收到哪些日志。请查看[这篇文章](/en/sdk/unity/configuration#set-your-logging-level),进一步了解日志等级设置。 当应用的 Awake 事件默认触发时,Adjust 就会初始化。要改变该行为,请勾选 **手动启动 SDK** 。这样您就能使用 config 实例作为参数,调用 `Adjust.InitSdk` 以初始化 Adjust SDK。 @@ -81,47 +83,50 @@ AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment Adjust.InitSdk(adjustConfig); ``` -## 4. 设置安卓设备{% #set-up-android-devices %} +4\. 设置安卓设备\{% \#set\-up\-android\-devices %\} +---------------------------------------------------- -### 添加 Google Play 服务{% #add-google-play-services %} +### 添加 Google Play 服务\{% \#add\-google\-play\-services %\} -定向到 Google Play 商店的应用必须使用 gps_adid (Google 广告 ID) 来识别设备。要访问 `play-services-ads-identifier`,请向项目中添加 `gps_adid` AAR。 +定向到 Google Play 商店的应用必须使用 gps\_adid \(Google 广告 ID\) 来识别设备。要访问 `play-services-ads-identifier`,请向项目中添加 `gps_adid` AAR。 -{% tabs %} -{% tab title="EDM4U" sync="edm4u" %} +\{% tabs %\} +\{% tab title="EDM4U" sync="edm4u" %\} 如果您使用的是[外部依赖管理器插件](https://developers.google.com/unity/archive#external_dependency_manager_for_unity),请将下列行添加至您的`Dependencies.xml`文件: ```xml - - + + ``` -{% /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 %} +\{% /tab %\} -### 收集 App Set Identifier{% #collect-app-set-identifier %} +\{% 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 %\} + +### 收集 App Set Identifier\{% \#collect\-app\-set\-identifier %\} [App Set Identifier](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/appsetid/AppSetId) 是一个唯一标识符,用户在设备上安装您的应用后,您可以通过此标识符监测这些应用的信息。同一位开发者开发的所有应用共享同一个 App Set ID,也就是说您可以从所有应用中收集有用的洞见。 -{% tabs %} -{% tab title="EDM4U" sync="edm4u" %} +\{% tabs %\} +\{% tab title="EDM4U" sync="edm4u" %\} 要记录设备的 App Set ID,您需要将以下依赖添加至您的 `Dependencies.xml`文件: ```xml - - + + ``` -{% /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 %} +\{% /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 %\} ### 设置 Install Referrer @@ -129,8 +134,8 @@ Install Referrer 是一种唯一标识符,可用来将应用安装归因至来 您可以使用两种方式为 Google Play Referrer API 添加支持: -{% 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)中将 Install Referrer 库添加为依赖 ```groovy @@ -138,22 +143,25 @@ 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)下载 Install Referrer 库,并将 ARR (Android Archive) 文件放入您的`Plugins/Android`文件夹中。 -{% /tab %} -{% /tabs %} +\{% /tab %\} + +\{% tab title="Manual installation" sync="manual" %\} +从 [Maven](https://maven.google.com/web/index.html?q=install#com.android.installreferrer:installreferrer)下载 Install Referrer 库,并将 ARR \(Android Archive\) 文件放入您的`Plugins/Android`文件夹中。 +\{% /tab %\} +\{% /tabs %\} #### Meta referrer 集成 -通过 Adjust Meta Install Referrer 插件,Adjust SDK 可以支持 [Meta Install Referrer](https://developers.facebook.com/docs/app-ads/meta-install-referrer)。[要了解集成细节,请参考 Unity Meta Install Referrer 插件。](/zh/sdk/unity/plugins/meta-referrer-plugin) +通过 Adjust Meta Install Referrer 插件,Adjust SDK 可以支持 [Meta Install Referrer](https://developers.facebook.com/docs/app-ads/meta-install-referrer)。[要了解集成细节,请参考 Unity Meta Install Referrer 插件。](/en/sdk/unity/plugins/meta-referrer-plugin) -## 5. 设置 SDK 签名{% #set-up-sdk-signature %} +5\. 设置 SDK 签名\{% \#set\-up\-sdk\-signature %\} +----------------------------------------------------- -如果您想使用 SDK 签名库来保护 Adjust SDK 与 Adjust 服务器之间的通信,请按照[Adjust 帮助中心 SDK 签名指南中的说明](https://help.adjust.com/zh/article/sdk-signature)进行操作。 +如果您想使用 SDK 签名库来保护 Adjust SDK 与 Adjust 服务器之间的通信,请按照[Adjust 帮助中心 SDK 签名指南中的说明](https://help.adjust.com/en/article/sdk-signature)进行操作。 -## 6. 构建您的应用{% #build-your-app %} +6\. 构建您的应用\{% \#build\-your\-app %\} +------------------------------------------ 如需完成应用创建流程,Adjust Unity 包需执行自定义创建后操作,以确保 Adjust SDK 可以在应用内如常运行。 此过程由 `AdjustEditor.cs` 中的 `OnPostprocessBuild` 方法执行。 @@ -161,17 +169,17 @@ dependencies { ![Adjust SDK 在 Unity editor 中的创建后配置脚本截图。](@images/unity/2-postbuild.png) -{% tabs %} -{% tab title="iOS" icon="PlatformIos" %} -{% callout type="important" %} -要执行 iOS 创建后流程,请确保已在 Unity Editor 中安装 **iOS build support** 。 -{% /callout %} +### iOS \{% \#ios %\} + +\{% callout type="important" %\} +要执行 iOS 创建后流程,请确保已在 Unity editor 中安装 **iOS 创建支持** 。 +\{% /callout %\} iOS 创建后流程会对生成的 Xcode 项目作出以下更改: -* 启用 Objective-C 例外情况 +* 启用 Objective\-C 例外情况 -#### 框架{% #frameworks %} +#### 框架 您可以启用下列框架,访问 iOS 功能: @@ -180,55 +188,55 @@ iOS 创建后流程会对生成的 Xcode 项目作出以下更改: * `AppTrackingTransparency.framework`: 用于向用户征求监测许可及获取许可状态 * `StoreKit.framework`: 用来与 SKAdNetwork 框架通讯。 -#### App Tracking Transparency 许可对话框{% #app-tracking-transparency-consent-dialog %} +#### App Tracking Transparency 许可对话 -如果您使用了 ATT (App Tracking Transparency) 包装器,请输入一条 **用户跟踪描述** 消息。该消息会在用户收到请求许可对话弹窗时展示。 +如果您使用了 ATT \(App Tracking Transparency\) 包装器,请输入一条 **用户跟踪描述** 消息。该消息会在用户收到请求许可对话弹窗时展示。 -#### 深度链接{% #deep-linking %} +#### 深度链接 要启用深度链接,请添加下列信息: * **iOS 通用链接域** :用于通用链接的关联域。 * **iOS URL 标识符** :应用的 bundle ID. * **iOS URL scheme** :与应用关联的 URL scheme。 -{% /tab %} -{% tab title="Android" icon="PlatformAndroid" %} -安卓创建后流程会在`Assets/Plugins/Android/`中查找`AndroidManifest.xml`文件。如果不存在该文件,则从[`AdjustAndroidManifest.xml`](https://github.com/adjust/unity_sdk/blob/master/Assets/Adjust/Native/Android/AdjustAndroidManifest.xml "GitHub 上 AdjustAndroidManifest 文件链接")中创建副本。 +### 安卓\{% \#android %\} -#### 权限{% #permissions %} +安卓创建后流程会在 `Assets/Plugins/Android/`中查找 `AndroidManifest.xml` 文件。如果不存在该文件,则从 [`AdjustAndroidManifest.xml`](https://github.com/adjust/unity_sdk/blob/master/Assets/Adjust/Native/Android/AdjustAndroidManifest.xml "GitHub 上 AdjustAndroidManifest 文件链接")中创建副本。 + +#### 权限 您可以启用下列许可,访问安卓功能: * `android.permission.INTERNET`: 用于连接至互联网。 * `android.permission.ACCESS_NETWORK_STATE`: 用于读取设备所连接到的网络类型。 * `com.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE` **已弃用** : 用于通过 Google Play Store intent 调取 install referrer 信息。 -* `com.google.android.gms.permission.AD_ID`: 用于在安卓12 (API level 31) 及更高版本中读取设备广告 ID。请查看 [Google 的`AdvertisingIdClient.info`文档](https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient.Info#public-string-getid) ,了解更多信息。 +* `com.google.android.gms.permission.AD_ID`: 用于在安卓12 \(API level 31\) 及更高版本中读取设备广告 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 Schemes** :深度链接的目的地。 -{% /tab %} -{% /tabs %} 该过程的输出显示在 Unity IDE 控制台窗口中。 -## 7. 测试集成{% #test-your-integration %} +7\. 测试集成\{% \#test\-your\-integration %\} +----------------------------------------------- -{% callout type="tip" %} +\{% callout type="tip" %\} 如果遇到任何问题,请发送邮件至 [support@adjust.com](mailto:support@adjust.com),并在邮件中说明所有详情和日志。 -{% /callout %} +\{% /callout %\} 采用 Adjust SDK 提供的工具,您可以测试并排除集成出现的问题。要测试集成,请按照下列步骤操作: * 将您的环境设为 `AdjustEnvironment.Sandbox` * 在 Adjust 控制面板结果中添加 sandbox 过滤器。 -* 将[日志级别](/zh/sdk/unity/configuration#set-your-logging-level)设为 `AdjustLogLevel.Verbose`。 +* 将[日志级别](/en/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,请将[日志级别](/zh/sdk/unity/configuration#set-your-logging-level)设为 `AdjustLogLevel.Verbose`,环境设为 `AdjustEnvironment.Sandbox`。启动应用,监测一次 `session` 或事件。如果 SDK 记录了 gps_adid (Google Play 服务广告主 ID) 参数,就说明已经成功读取广告 ID。 +要测试 Adjust SDK 能否接收设备的 Google 广告 ID,请将[日志级别](/en/sdk/unity/configuration#set-your-logging-level)设为 `AdjustLogLevel.Verbose`,环境设为 `AdjustEnvironment.Sandbox`。启动应用,监测一次 `session` 或事件。如果 SDK 记录了 gps\_adid \(Google Play 服务广告主 ID\) 参数,就说明已经成功读取广告 ID。 如果您在获取 Google 广告 ID 时遇到任何问题,请在 [GitHub 库](https://github.com/adjust/unity_sdk)中提问,或联系 [support@adjust.com](mailto:support@adjust.com)。 +