React Native SDKのオブザーバーモードでトランザクションを報告する
エージェントツールをインストール
AI コーディングツールから Adapty SDK の連携をまるごと実行できます。 詳細
スキル対応の任意のエージェントにインストールできます。更新するには npx skills update を実行してください。
スキルは SDK 連携、フローとペイウォールの作成、公開前の監査、プレースメントの移行などをカバーします。やりたいことを普通の言葉で伝えれば、エージェントが適切なスキルを選びます。
Observer modeでは、Adapty SDKは既存の購入システムで行われた購入を自動的に追跡することができません。アプリストアからのトランザクションを手動で報告する必要があります。アナリティクスのエラーを避けるため、アプリをリリースする前にこの設定を行うことが重要です。
reportTransactionを使用して、各トランザクションをAdaptyに明示的に報告してください。
reportTransactionの呼び出しを忘れずに!
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 ページで説明されているように、オブザーバーモードでトランザクションを Adapty に報告します。
トランザクションの報告をスキップしないでください!
restorePurchases を呼び出さない場合、Adapty はトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
フローとペイウォールのトランザクションへの関連付け
Adapty SDK は購入の発生元を判断できないため、購入の処理はお客様側で行う必要があります。そのため、オブザーバーモードでフロー、ペイウォール、A/B テストを使用する場合は、アプリストアからの transaction をモバイルアプリのコード内で対応するフローまたはペイウォールに紐付ける必要があります。アプリをリリースする前にこの設定を正しく行わないと、アナリティクスにエラーが生じます。
const variationId = paywall.variationId;
try {
await adapty.setVariationId('transactionId', variationId);
} catch (error) {
// handle the `AdaptyError`
}Request parameters:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | iOS、StoreKit 1 の場合:SKPaymentTransaction オブジェクト。 iOS、StoreKit 2 の場合:Transaction オブジェクト。 Android の場合:文字列識別子(購入オブジェクトの purchase.getOrderId。purchase は課金ライブラリの Purchase クラスのインスタンス)。 |
| variationId | 必須 | バリアントの文字列識別子。AdaptyPaywall オブジェクトの variationId プロパティから取得できます。 |