Adapty Unity SDK を v4.3 へ移行する

Adapty Unity SDK 4.3 は Unity 6 を必須とし、Adapty.GetLogLevel を削除し、Google Play アプリ内メッセージをデフォルトで表示するようになり、Android 上の一部のフローイベントデータの C# 型が変更されました。アプリの動作を維持するために、このガイドで各変更点を確認してください。

3.x をお使いの場合は、まず v4.1 への移行 を行ってから、このガイドに従ってください。

クイックリファレンス

v4.1v4.3
Unity 2022.3 以降Unity 6.0 (6000.0) 以降
Adapty.GetLogLevel(...)削除 — builder.LogLevel または Adapty.SetLogLevel で設定したレベルは自分で管理してください
Google Play メッセージはリクエストされないAndroid ではデフォルトで Google Play メッセージが表示される(フロー上でも)
フローイベントの整数パラメーターは Android では double で届く両プラットフォームで long で届く

インストール

Adapty Unity SDK 4.3 には Unity 6.0 (6000.0) 以降が必要です。プロジェクトが Unity 2022.3 の場合は、先にプロジェクトをアップグレードするか、Adapty SDK 4.1.x を使い続けてください。

Warning

Adapty SDK 4.1.x は、Unity 6 の新規プロジェクトでデフォルトの Android エントリーポイントである GameActivity では動作しません。コンプリーションハンドラーとイベントが C# に届かなくなります。SDK より先に Unity をアップグレードする場合は、Adapty SDK 4.3 に移行するまで Application Entry Point を Activity に設定したままにしてください。SDK 4.3 は両方のエントリーポイントに対応しています。

Unity Package Manager 経由で SDK 4.3 をインストールするには、次の Git URL を使用してください。

https://github.com/adaptyteam/AdaptySDK-Unity.git?path=/Packages/com.adapty.unity-sdk#4.3.0-beta.1

Unity パッケージからインストールする場合は、4.3.0-beta.1 リリース から adapty-unity-plugin-4.3.0-beta.1.unitypackage をダウンロードしてください。インポートする前に Assets/AdaptySDK/Plugins/Android/Local フォルダを削除してください。SDK 4.3 では、このフォルダに含まれる Android Java の内部ラッパーが同梱されなくなりました。.unitypackage のインポートではファイルが削除されないため、削除しないと古いラッパーがプロジェクトに残り続けます。

その他の要件は4.1と変わりません:iOS 15.0およびXcode 26。完全なセットアップについてはAdapty SDKのインストールを参照してください。

GetLogLevel の削除

Adapty.GetLogLevel は使用できなくなりました。ログレベルは、SDK をアクティベートする際に builder.LogLevel で設定した値、または後から Adapty.SetLogLevel で設定した値が使用されます。コード内でログレベルを読み取っている場合は、設定した値を変数に保存して使用してください:

- Adapty.GetLogLevel((level, error) => {
-     // use level
- });
+ var logLevel = AdaptyLogLevel.Verbose;
+ builder.LogLevel = logLevel;
+ // use logLevel

Google Playのメッセージはデフォルトで表示されます

4.3以降、SDKはアクティベーション後にアプリのActivityが起動するたびに、支払い拒否通知などのGoogle Playアプリ内メッセージをリクエストします。これには、アプリがフォアグラウンドに戻るときや、フローやオンボーディングが開閉するときも含まれるため、ペイウォールの上にメッセージが表示される場合があります。

アプリの動作としてこれで問題なければ、変更は不要です。メッセージの表示タイミングを制御したい場合は、Androidで手動処理を有効にしてSDKをアクティベートし、適切なタイミングでAdapty.ShowStoreMessagesを呼び出してください。

var builder = new AdaptyConfiguration.Builder("YOUR_PUBLIC_SDK_KEY");
#if UNITY_ANDROID
builder.SetStoreMessagesHandling(AdaptyStoreMessagesHandling.Manual);
#endif

Adapty.Activate(builder.Build(), (error) => {
    // handle the error
});

Androidのみ手動処理を設定することで、iOSの動作は変わりません。iOS 16以降では、手動処理を有効にすると、アプリがAdapty.ShowStoreMessagesを呼び出すまでApp Storeのメッセージが保留されます。APIの詳細については、ストアメッセージの制御を参照してください。

Warning

手動モードでは、ストアは独自にメッセージを表示しません。アプリが Adapty.ShowStoreMessages を呼び出さない場合、ユーザーは支払い拒否の通知を受け取れません。

Androidでは、フローイベントのパラメーターが数値の場合はlong型になります

Androidでは、FlowViewDidReceiveAnalyticEventの整数パラメーターがこれまでdoubleとして渡されていました。4.3から、iOSと同様にlongとして渡されるようになりました。これにはフロー入力イベントの日時値も含まれます。

doubleへのキャストはAndroidでは例外をスローするようになりました。キャストの代わりに数値パラメーターを変換してください:

- var timestamp = (double)parameters["value"];
+ var timestamp = Convert.ToInt64(parameters["value"]);

4.3 の新機能

これらの追加機能はオプトインです。既存のコードはそのまま動作します。

  • ストアメッセージを制御する:App Store と Google Play のメッセージが表示されるタイミングを選択します。
  • プレースメントをプリロードする:Adapty.PreloadFlows と Adapty.PreloadFlowsForDefaultAudience でフローキャッシュをウォームアップします。
  • フロービューを保持する:view.Dismiss(false, ...) はビューを保持して再表示できるようにし、view.Destroy(...) はビューを解放します。
  • 12ヶ月コミットメントプラン:AdaptySubscription.PricingTerms プロパティは iOS でのプランを表し、アクセスレベルとサブスクリプションは BillingPlan と CommitmentInfo を報告します。
  • 新しいエラーコード:AdaptyErrorCode.BillingPlanUnavailable(1060、iOS のみ)。MakePurchase は、プロダクトがデバイスまたはストアフロントで要求された請求プランを提供していない場合にこれを返します。すべての AdaptyErrorCode の値を switch で処理している場合は、この新しいコードを追加してください。
  • オブザーバーモード:Adapty.ReportTransaction は iOS でオプションの appleJWSTransaction を受け取ります。
  • バリエーション名:AdaptyFlow.VariationName は、Adapty ダッシュボードで設定したバリエーション名を返します。