Unity SDKでObserverモードのトランザクションを報告する
エージェントツールをインストール
AI コーディングツールから Adapty SDK の連携をまるごと実行できます。 詳細
スキル対応の任意のエージェントにインストールできます。更新するには npx skills update を実行してください。
インストール後、プロジェクトでスキルを実行します:
Observerモードでは、Adapty SDKは既存の購入システムで行われた購入を単独で追跡することができません。アプリストアからトランザクションを報告する必要があります。アナリティクスのエラーを避けるために、アプリをリリースする前にこれを設定することが重要です。
reportTransactionを使用して、Adaptyが認識できるよう各トランザクションを明示的に報告してください。
トランザクションのレポートを忘れずに!
ReportTransaction を呼び出さないと、Adapty はトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adapty のフローやペイウォールを使用する場合は、トランザクションをレポートする際に variationId を含めてください。これにより、購入がトリガーとなったフローまたはペイウォールに紐付けられ、アナリティクスの精度が向上します。
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 |
|
| variationId | 任意 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。 |
オブザーバーモードでは、Adapty SDK は既存の購入システムを通じて行われた購入を単独で追跡することができません。アプリストアからトランザクションを報告するか、リストアする必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了することが重要です。
両プラットフォームで reportTransaction を使用して各トランザクションを明示的に報告し、Android では追加ステップとして restorePurchases を使用して Adapty がそれを認識できるようにしてください。
トランザクションの報告と購入の復元をスキップしないでください! これらのメソッドを呼び出さないと、Adaptyはトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adaptyのフローやペイウォールを使用している場合は、トランザクションを報告する際に PAYWALL_VARIATION_ID を含めてください。これにより、購入がそれを起動したフローまたはペイウォールに紐付けられ、正確なアナリティクスが確保されます。
// every time when calling transasction.finish()
#if UNITY_ANDROID && !UNITY_EDITOR
Adapty.RestorePurchases((profile, error) => {
// handle the error
});
#endif
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});パラメーター:
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 |
|
| variationId | 任意 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。 |
トランザクションのレポート
- バージョン3.1.x以前はApp Storeのトランザクションを自動的に監視するため、手動でのレポートは不要です。
- バージョン3.2はオブザーバーモードをサポートしていません。
トランザクションのレポート
restorePurchasesを使用してObserver ModeでAdaptyにトランザクションを報告します。詳細はモバイルコードでの購入の復元ページを参照してください。
トランザクションの報告をスキップしないでください!
restorePurchasesを呼び出さない場合、Adaptyはトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
フローとペイウォールのトランザクションへの関連付け
AdaptyのSDKは購入の発生元を特定できません(処理はお客様側で行うためです)。そのため、Observerモードでフロー、ペイウォール、またはA/Bテストを使用する場合は、アプリストアから届くトランザクションを、モバイルアプリのコード内で対応するフローまたはペイウォールと紐付ける必要があります。アプリのリリース前にこの設定を正しく行わないと、アナリティクスにエラーが生じますので、注意してください。
Adapty.SetVariationForTransaction("<variationId>", "<transactionId>", (error) => {
if(error != null) {
// handle the error
return;
}
// successful binding
});
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | iOS、StoreKit 1 の場合: SKPaymentTransaction オブジェクト。 iOS、StoreKit 2 の場合: Transaction オブジェクト。 Android の場合: 文字列識別子(purchase は billing library の Purchase クラスのインスタンスで、その purchase.getOrderId の値)。 |
| variationId | 必須 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。 |