オブザーバーモードでは、Adapty SDK は既存の購入システムで行われた購入を単独では追跡できません。アプリストアからトランザクションを報告する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を行うことが重要です。
reportTransaction を使用して、Adapty がトランザクションを認識できるよう各トランザクションを明示的に報告してください。
Warning
トランザクションの報告をスキップしないでください!
ReportTransaction を呼び出さないと、Adapty はトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adapty のフローやペイウォールを使用している場合は、トランザクションを報告する際に variationId を含めてください。これにより、購入がそれを起動したフローまたはペイウォールに紐付けられ、正確なアナリティクスが確保されます。
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});
パラメーター:
| パラメータ | 必須/任意 | 説明 |
|---|
| transactionId | 必須 | - iOS の場合: トランザクションの識別子。
- Android の場合: 購入の文字列識別子
purchase.getOrderId。ここで purchase は課金ライブラリの Purchase クラスのインスタンスです。
|
| variationId | 任意 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。 |
オブザーバーモードでは、Adapty SDK は既存の購入システムを通じて行われた購入を単独で追跡することができません。アプリストアからトランザクションを報告するか、リストアする必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了することが重要です。
両プラットフォームで reportTransaction を使用して各トランザクションを明示的に報告し、Android では追加ステップとして restorePurchases を使用して Adapty がそれを認識できるようにしてください。
Warning
トランザクションの報告と購入の復元をスキップしないでください!
これらのメソッドを呼び出さないと、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にトランザクションを報告します。詳細はモバイルコードでの購入の復元ページを参照してください。
Warning
トランザクションの報告をスキップしないでください!
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 プロパティから取得できます。 |