React Native SDKのオブザーバーモードでトランザクションを報告する
オブザーバーモードでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡することができません。アプリストアからトランザクションを手動で報告する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了させることが重要です。
各トランザクションをAdaptyに明示的に報告するにはreportTransactionを使用します。
トランザクションの報告を省略しないでください!
reportTransactionを呼び出さない場合、Adaptyはトランザクションを認識せず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入が起動元のペイウォールに紐付けられ、正確なペイウォールアナリティクスが確保されます。
const variationId = paywall.variationId;
try {
await adapty.reportTransaction(transactionId, variationId);
} catch (error) {
// handle the `AdaptyError`
}パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 |
|
| variationId | 任意 | バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
オブザーバーモードでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡することができません。アプリストアからトランザクションを手動で報告するか、復元する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了させることが重要です。
両プラットフォームでreportTransactionを使用して各トランザクションを明示的に報告し、Androidでは追加ステップとしてrestorePurchasesを使用してAdaptyがトランザクションを認識できるようにしてください。
トランザクションの報告を省略しないでください! これらのメソッドを呼び出さない場合、Adaptyはトランザクションを認識せず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入が起動元のペイウォールに紐付けられ、正確なペイウォールアナリティクスが確保されます。
if (Platform.OS === 'android') {
try {
await adapty.restorePurchases();
} catch (error) {
// handle the error
}
}
...
const variationId = paywall.variationId;
try {
await adapty.reportTransaction(transactionId, variationId);
} catch (error) {
// handle the `AdaptyError`
}パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 |
|
| variationId | 任意 | バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
トランザクションの報告
- バージョン3.1.x以前は、App Storeのトランザクションを自動的に監視するため、手動での報告は不要です。
- バージョン3.2はオブザーバーモードをサポートしていません。
トランザクションの報告
オブザーバーモードでAdaptyにトランザクションを報告するにはrestorePurchasesを使用してください。詳細はモバイルコードでの購入の復元ページをご覧ください。
トランザクションの報告を省略しないでください!
restorePurchasesを呼び出さない場合、Adaptyはトランザクションを認識せず、アナリティクスに表示されず、インテグレーションにも送信されません。
ペイウォールとトランザクションの関連付け
Adapty SDKは購入の発生元を判断できません。購入処理はお客様自身が行うためです。そのため、オブザーバーモードでペイウォールやA/B テストを使用する場合は、アプリストアから受け取ったトランザクションをモバイルアプリのコードで対応するペイウォールに関連付ける必要があります。アプリをリリースする前にこれを正しく設定することが重要です。設定しないと、アナリティクスにエラーが生じます。
const variationId = paywall.variationId;
try {
await adapty.setVariationId('transactionId', variationId);
} catch (error) {
// handle the `AdaptyError`
}リクエストパラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | iOS、StoreKit 1 の場合: SKPaymentTransactionオブジェクト。 iOS、StoreKit 2 の場合: Transactionオブジェクト。 Android の場合: 購入のString識別子(purchase.getOrderId)。purchaseは課金ライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 必須 | バリアントのString識別子。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |