React Native SDKのオブザーバーモードでトランザクションを報告する
エージェントツールをインストール
AI コーディングツールから Adapty SDK の連携をまるごと実行できます。 詳細
スキル対応の任意のエージェントにインストールできます。更新するには npx skills update を実行してください。
インストール後、プロジェクトでスキルを実行します:
Observer modeでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡することができません。アプリストアからのトランザクションを手動で報告する必要があります。アナリティクスのエラーを避けるため、アプリをリリースする前にこの設定を行うことが重要です。
reportTransactionを使用して、各トランザクションをAdaptyに明示的に報告してください。
トランザクションのレポートをスキップしないでください!
reportTransaction を呼び出さないと、Adapty はトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adapty のペイウォールを使用している場合は、トランザクションをレポートする際に variationId を含めてください。これにより、購入がそのきっかけとなったペイウォールに紐付けられ、ペイウォールのアナリティクスが正確になります。
const variationId = paywall.variationId;
try {
await adapty.reportTransaction(transactionId, variationId);
} catch (error) {
// handle the `AdaptyError`
}パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 |
|
| variationId | 任意 | バリアントの文字列識別子。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 | 任意 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。 |
トランザクションの報告
- バージョン3.1.x以前は、App Storeのトランザクションを自動的に監視するため、手動での報告は不要です。
- バージョン3.2はオブザーバーモードをサポートしていません。
トランザクションの報告
restorePurchasesを使用して、Restore Purchases in Mobile Codeページで説明されているように、Observer ModeでAdaptyにトランザクションを報告します。
トランザクションの報告を忘れずに!
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 の場合:文字列識別子(購入オブジェクトの purchase.getOrderId。purchase は課金ライブラリの Purchase クラスのインスタンス)。 |
| variationId | 必須 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。 |