AndroidManifest は次の 2 つの方法のいずれかで変更できます:

方法 1: Unity のカスタムマニフェスト

1. File > Build Settings > Player Settings > Publishing Settings に移動します。
2. Publishing Settings セクションの下で 「Custom Main Manifest」 を有効にします。
3. Unity がデフォルトの AndroidManifest.xml ファイルを Assets/Plugins/Android/AndroidManifest.xml に生成します。
4. このファイルを編集して、必要な権限と設定を追加します。

出典: Unity Android Manifest ドキュメント

方法 2: Android Studio

1. File > Build Settings > Export Project を使用して Unity からプロジェクトをエクスポートします。
2. エクスポートしたプロジェクトを Android Studio で開きます。
3. Android Studio で AndroidManifest.xml ファイルを直接編集します。

方法 1: Unity のカスタムテンプレート

1. File > Build Settings > Player Settings > Publishing Settings に移動します。
2. Publishing Settings セクションの下で 「Custom Gradle Template」 を有効にします。
3. Unity が mainTemplate.gradle ファイルを Assets/Plugins/Android/mainTemplate.gradle に生成します。
4. このファイルにカスタムの Gradle 設定を追加します。

出典: Unity Gradle 概要ドキュメント

方法 2: Android Studio

1. Unity からプロジェクトをエクスポートします。
2. プロジェクトを Android Studio で開きます。
3. アプリの build.gradle ファイルを直接編集します。

Unity で Android アプリをビルドする際、複数の SDK が同じ推移的依存関係を含めていることが原因で「Duplicate class」(重複クラス) エラーが発生する場合があります。これは、AppLovin SDK と Singular SDK の両方を使用している場合に、Android Vending Licensing ライブラリでよく発生します。

Duplicate class com.android.vending.licensing.ILicensingService found in modules
applovin-sdk-13.5.0.aar -> jetified-applovin-sdk-13.5.0-runtime (com.applovin:applovin-sdk:13.5.0)
and singular_sdk-12.11.0.aar -> jetified-singular_sdk-12.11.0-runtime (com.singular.sdk:singular_sdk:12.11.0)

解決策 1: External Dependency Manager (EDM4U) を使用する

プロジェクトで External Dependency Manager for Unity を使用している場合 (推奨)、Dependencies XML ファイルに除外ルールを追加します。

1. Unity プロジェクト内の *Dependencies.xml ファイルを見つけます (通常は Assets/Editor または同様の場所にあります)。
2. いずれかの SDK 依存関係に除外ルールを追加します:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.applovin:applovin-sdk:13.5.0">
      <androidSdkPackageIds>
        <exclude group="com.android.vending" module="licensing"/>
      </androidSdkPackageIds>
    </androidPackage>
    <androidPackage spec="com.singular.sdk:singular_sdk:12.11.0" />
  </androidPackages>
</dependencies>

解決策 2: カスタム Gradle テンプレートを使用する

EDM4U を使用していない場合は、Gradle 設定ファイルに直接除外ルールを適用します。

1. File > Build Settings > Player Settings > Publishing Settings に移動します。
2. 「Custom Main Gradle Template」 または 「Custom Launcher Gradle Template」 を有効にします。
3. Assets/Plugins/Android/mainTemplate.gradle (または launcherTemplate.gradle ) を開きます。
4. 依存関係ブロックに除外ルールを追加します:

dependencies {
    implementation('com.applovin:applovin-sdk:13.5.0') {
        exclude group: 'com.android.vending', module: 'licensing'
    }
    implementation 'com.singular.sdk:singular_sdk:12.11.0'
}

代替方法: 依存関係ブロックの後に次を追加して、グローバルな除外を適用します:

configurations.all {
    exclude group: 'com.android.vending', module: 'licensing'
}

解決を確認する

1. 除外を適用した後、 Library/Bee フォルダと Temp フォルダを削除してプロジェクトをクリーンにします。
2. Unity で Android プロジェクトを再ビルドします。
3. ビルド出力に重複クラスエラーが表示されなくなったことを確認します。

プロジェクトでコードの難読化に ProGuard を使用している場合は、Singular SDK が削除されないように、次の keep ルールを proguard-unity.txt ファイルに追加してください:

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

Unity プロジェクトを iOS 向けにビルドした後、Xcode でビルドする前に、最新の SDK バージョンを取得するために CocoaPods 依存関係を更新してください。

cd /path/to/your/ios/project
pod repo update
pod update

統合をテストするため、IDFV (Identifier for Vendor) をログ出力して、Singular SDK Console にテストデバイスをすばやく追加できます。

IDFV ログ出力を追加する

1. Unity からビルドした後、Xcode プロジェクトを開きます。
2. Classes > UnityAppController.mm に移動します。
3. applicationDidBecomeActive メソッドを見つけます。
4. IDFV をログ出力するために、次のコードを追加します:

// Log IDFV for testing
NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

5. Xcode でアプリをビルドして実行します。
6. Xcode コンソールログで IDFV の出力を確認します。
7. IDFV をコピーし、 Singular SDK Console にテストデバイスとして追加します。

Xcode プロジェクトで Associated Domains を設定して、ディープリンク用の Universal Links を有効にします。

ディープリンク設定手順

1. Associated Domain を追加する: Xcode で、アプリターゲットの Signing & Capabilities タブに移動します。
2. 機能を有効にする: [+] Capability をクリックし、 「Associated Domains」 を追加します。
3. ドメインを追加する: Singular のトラッキングドメインを次の形式で追加します: applinks:yourdomain.sng.link
4. Team ID を設定する: Singular ダッシュボードで、アプリの設定に移動して Apple Team ID を追加します。これにより、Singular は Universal Links に必要な Apple App Site Association (AASA) ファイルを生成してホストできるようになります。

UnityAppController を登録する他の SDK (Firebase、Adjust、AppsFlyer など) を使用している場合、Singular が正しく初期化されない競合が発生する可能性があります。Unity では、一度に 1 つのクラスのみが UnityAppController として登録できます。

この競合を解決するには:

1. 開く: Xcode プロジェクトの SingularSwizzledAppController.m ファイルを開きます。
2. このファイル内のすべてのコードのコメントを解除します。
3. 開く: SingularAppDelegate.m を開き、次の行がコメントアウトされていないことを確認します:

   IMPL_APP_CONTROLLER_SUBCLASS(SingularAppDelegate)

これにより、UnityAppController をサブクラス化する代わりにメソッドスウィズリングを使用することで、Singular が他の SDK と並行して動作できるようになります。

プレハブをシーンに追加する

1. Project ペインで、 Packages > Singular > SingularSDK > Prefabs に移動します。
2. SingularSDKObject プレハブを Hierarchy ペインにドラッグします。
3. これでプレハブを Inspector で設定する準備が整いました。

GameObject の手動作成

1. Hierarchy ペインで右クリックし、 Create Empty を選択します。
2. GameObject に SingularSDKObject と名前を付けます (正確な名前が必要です)。
3. GameObject を選択した状態で、 Inspector ペインに移動します。
4. Add Component をクリックします。
5. 「Singular」 を検索し、 Singular SDK スクリプトコンポーネントを選択します。

• Initialize On Awake: デフォルトで有効です。GameObject が起動すると SDK が自動的に初期化されます。プライバシー同意やその他の要件のために初期化を遅延させる必要がある場合は、これを無効にしてください。
• SKAN Enabled: デフォルトで有効です (iOS のみ)。Managed Mode での SKAdNetwork アトリビューションを有効にします。このモードでは、Singular が設定したコンバージョンモデルに基づいてコンバージョン値を自動的に更新します。
• Wait For Tracking Authorization: 0 (無効) に設定されています。アプリで iOS App Tracking Transparency (ATT) プロンプトを表示する場合は、これを 300 秒に設定してください。これにより、ユーザーが ATT プロンプトに応答するまで SDK セッションが遅延され、同意が得られた場合に IDFA を取得できるようになります。ATT を使用しない場合は 0 のままにします。
• Enable Logging: デフォルトで有効です。統合とトラブルシューティングに役立つ SDK のデバッグログを出力します。本番ビルドでは無効にしてください。 Log Level 設定と連動して機能します (下記参照)。
• Log Level: デフォルトで 3 (Info) に設定されています。ログの詳細度を制御します。数値が小さいほど詳細なログが出力されます:
  C#

  // Based on Android Logger log levels
  public enum LogLevel {
     Verbose = 2,  // Most verbose
     Debug   = 3,
     Info    = 4,  // Default
     Warn    = 5,
     Error   = 6,
     Assert  = 7   // Least verbose
  }

  注: 詳細なログは主に Android で利用できます。

• DDL Timeout Sec: 0 (60 秒のデフォルトを使用) に設定されています。SDK がサーバーからの deferred deep link データを待機する時間を決定します。このタイムアウト後に deferred deep link が見つからない場合、サーバーは検索を停止します。
• Session Timeout Sec: 0 (60 秒のデフォルトを使用) に設定されています。フォアグラウンドに戻ったときに SDK が新しいセッションを作成するまでに、アプリをバックグラウンドにできる時間を定義します。
• Shortlink Resolve Timeout: 0 (10 秒のデフォルトを使用) に設定されています。短縮リンクの解決を待機する最大時間です。短縮リンクを解決できない場合に長時間待機することを防ぎ、ユーザー体験を保護します。

従来の Meta Install Referrer アトリビューション方式をサポートする必要がある場合は、SingularSDKObject の設定に Facebook App ID を追加してください。

設定手順

1. シーン階層内の SingularSDKObject を選択します。
2. Inspector ペインで、 「Facebook App ID」 フィールドを見つけます。
3. Facebook App ID を入力します (Facebook Developer Console で確認できます)。

追加リソース:

• Meta Install Referrer とは?
• Facebook App ID の確認場所

アップグレード手順

Unity Package Manager 経由で SDK をインストールする前に、これらの手順を順番に完了してください: