Unity SDKのObserverモードでトランザクションを報告する

Observerモードでは、Adapty SDKは既存の購入システムを通じて行われた購入を自動的に追跡できません。アプリストアからトランザクションを報告する必要があります。アナリティクスのエラーを防ぐため、アプリのリリース前にこの設定を行うことが重要です。

reportTransactionを使用して、各トランザクションをAdaptyに明示的に報告してください。

Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入がトリガーしたペイウォールと関連付けられ、正確なペイウォールアナリティクスが確保されます。

Adapty.ReportTransaction(
  "YOUR_TRANSACTION_ID", 
  "PAYWALL_VARIATION_ID", // optional
  (error) => {
  // handle the error
});

パラメーター：

パラメーター	必須／任意	説明
transactionId	必須	iOS の場合：トランザクションの識別子。 Android の場合：購入の文字列識別子 purchase.getOrderId。ここで purchase は billing library の Purchase クラスのインスタンスです。
variationId	任意	バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。

Observerモードでは、Adapty SDKは既存の購入システムを通じて行われた購入を自動的に追跡できません。アプリストアからトランザクションを報告するか、リストアする必要があります。アナリティクスのエラーを防ぐため、アプリのリリース前にこの設定を行うことが重要です。

両プラットフォームでreportTransactionを使用して各トランザクションを明示的に報告し、Androidでは追加のステップとしてrestorePurchasesを使用して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	必須	iOS、StoreKit 1 の場合：SKPaymentTransaction オブジェクト。 iOS、StoreKit 2 の場合：Transaction オブジェクト。 Android の場合：購入の文字列識別子（purchase.getOrderId）。ここで purchase は billing library の Purchase クラスのインスタンスです。
variationId	任意	バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。

トランザクションへのペイウォールの関連付け

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.getOrderId）。ここで purchase は billing library の Purchase クラスのインスタンスです。
variationId	必須	バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティを使用して取得できます。