English 中文TürkçeРусскийEspañol日本語Tiếng Việt

フローとペイウォールのイベントを処理する - React Native

このガイドでは、購入・復元・プロダクト選択・フローのレンダリングに関するイベント処理について説明します。ボタンの処理（フローを閉じる、リンクを開く、カスタムアクションなど）も設定できます。詳細はボタンアクションの処理に関するガイドをご覧ください。

フローおよびフローに含まれるペイウォールビルダーで作成されたペイウォールでは、購入や復元のために追加のコードは必要ありません。ただし、アプリが応答できるいくつかのイベントが生成されます。これらのイベントには、ボタンの押下（閉じるボタン、URL、プロダクトの選択など）や、フロー上で行われた購入関連のアクションに関する通知が含まれます。これらのイベントへの対応方法については、以下をご覧ください。

モバイルアプリ内のフロー画面で発生するプロセスを制御または監視するには、イベントハンドラーを実装してください：

イベントの例（クリックして展開）
// onCloseButtonPress
{
  //イベントを記録する
}

// onAndroidSystemBack
{
  //イベントを記録する
}

// onUrlPress
{
  "url": "https://example.com/terms"
}

// onCustomAction
{
  "actionId": "login"
}

// onProductSelected
{
  "productId": "premium_monthly"
}

// onPurchaseStarted
{
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Success
{
  "purchaseResult": {
    "type": "success",
    "profile": {
      "accessLevels": {
        "premium": {
          "id": "premium",
          "isActive": true,
          "expiresAt": "2024-02-15T10:30:00Z"
        }
      }
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Cancelled
{
  "purchaseResult": {
    "type": "user_cancelled"
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseFailed
{
  "error": {
    "code": "purchase_failed",
    "message": "Purchase failed due to insufficient funds",
    "details": {
      "underlyingError": "Insufficient funds in account"
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onRestoreCompleted
{
  "profile": {
    "accessLevels": {
      "premium": {
        "id": "premium",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    },
    "subscriptions": [
      {
        "vendorProductId": "premium_monthly",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    ]
  }
}

// onRestoreFailed
{
  "error": {
    "code": "restore_failed",
    "message": "Purchase restoration failed",
    "details": {
      "underlyingError": "No previous purchases found"
    }
  }
}

// onError
{
  "error": {
    "code": "rendering_failed",
    "message": "Failed to render flow interface",
    "details": {
      "underlyingError": "Invalid flow configuration"
    }
  }
}

// onLoadingProductsFailed
{
  "error": {
    "code": "products_loading_failed",
    "message": "Failed to load products from the server",
    "details": {
      "underlyingError": "Network timeout"
    }
  }
}

// onAppeared
{
  //イベントを記録する
}

// onDisappeared
{
  //イベントを記録する
}

// onWebPaymentNavigationFinished
{
  //イベントを記録する
}

必要なイベントハンドラーだけ登録すれば、不要なものは省略できます。未使用のイベントリスナーは作成されません。必須のイベントハンドラーはありません。

イベントハンドラーはブール値を返します。true が返された場合、表示プロセスが完了したとみなされ、フロー画面が閉じてそのビューのイベントリスナーが削除されます。 一部のイベントハンドラーには、必要に応じて上書きできるデフォルトの動作があります。

  • onCloseButtonPress: 閉じるボタンが押されたときにフローを閉じます。
  • onUrlPress: タップされた URL を開き、フローを開いたままにします。
  • onAndroidSystemBack（モーダル表示のみ）: Back ボタンが押されたときにフローを開いたままにします。true を返すと閉じます。
  • onRestoreCompleted: リストアが成功した後もフローを開いたままにします。true を返すと閉じます。
  • onPurchaseCompleted: 購入完了後もフローを開いたままにします。true を返すと閉じます。
  • onError: フローのレンダリングに失敗した場合、フローを閉じます。

イベントハンドラー

イベントハンドラー説明
onCustomActionユーザーがカスタムアクション（例：カスタムボタンのクリック）を実行したときに呼び出されます。
onUrlPressユーザーがフロー内のURLをクリックしたときに呼び出されます。
onAndroidSystemBackモーダル表示のみ：ユーザーがAndroidシステムの Back ボタンをタップしたときに呼び出されます。
onCloseButtonPress閉じるボタンが表示されているときにユーザーがタップすると呼び出されます。このハンドラーでフロー画面を閉じることを推奨します。
onPurchaseCompleted購入が完了したとき（成功・ユーザーによるキャンセル・承認待ちを問わず）に呼び出されます。購入が成功した場合は、更新された AdaptyProfile が提供されます。ユーザーによるキャンセルや保留中の支払い（例：保護者の承認が必要な場合）は、onPurchaseFailed ではなくこのイベントをトリガーします。
onPurchaseStartedユーザーが「購入」アクションボタンをタップして購入プロセスを開始したときに呼び出されます。
onPurchaseFailedエラー（例：支払い制限、無効なプロダクト、ネットワーク障害、トランザクション検証エラー）により購入が失敗したときに呼び出されます。ユーザーによるキャンセルや保留中の支払いには呼び出されず、それらは代わりに onPurchaseCompleted をトリガーします。
onRestoreStartedユーザーが購入の復元プロセスを開始したときに呼び出されます。
onRestoreCompleted購入の復元が成功したときに呼び出され、更新された AdaptyProfile が提供されます。ユーザーが必要な accessLevel を持っている場合は画面を閉じることを推奨します。確認方法についてはサブスクリプションステータスのトピックを参照してください。
onRestoreFailed復元プロセスが失敗したときに呼び出され、AdaptyError が提供されます。
onProductSelectedフロービュー内のプロダクトが選択されたときに呼び出されます。購入前にユーザーが何を選択したかを監視できます。
onErrorビューのレンダリング中にエラーが発生したときに呼び出され、AdaptyError が提供されます。このエラーは本来発生しないものですので、もし発生した場合はご連絡ください。
onLoadingProductsFailedプロダクトの読み込みが失敗したときに呼び出され、AdaptyError が提供されます。ビュー作成時に prefetchProducts: true を設定していない場合、AdaptyUI が必要なオブジェクトをサーバーから自動的に取得します。
onAppearedフローがユーザーに表示されたときに呼び出されます。iOS では、ユーザーがフロー内のウェブペイウォールボタンをタップしてインアプリブラウザでウェブペイウォールが開いたときにも呼び出されます。
onDisappearedモーダル表示のみ：ユーザーによってフローが閉じられたときに呼び出されます。iOS では、フローからインアプリブラウザで開いたウェブペイウォールが画面から消えたときにも呼び出されます。
onWebPaymentNavigationFinishedウェブペイウォールを購入のために開こうとした後（成功・失敗を問わず）に呼び出されます。
onAnalyticsフローからのカスタム分析イベント用に予約されています。フローはまだこれらをコードに送信しないため、実装する必要はありません。
onRequestAppReviewフローからのアプリレビューリクエスト用に予約されています。フローはまだアプリレビューリクエストをトリガーしないため、実装する必要はありません。
onRequestPermissionフローからのシステム権限リクエスト（プッシュ通知やカメラアクセスなど）用に予約されています。フローはまだ権限リクエストをトリガーしないため、実装する必要はありません。
onObserverPurchaseInitiatedオブザーバーモードのみ：ユーザーがフロー内の購入ボタンをタップしたときに呼び出されます。Adapty は購入を実行しません。独自の購入コードで購入を行い、その後トランザクションを Adapty に報告してください。詳しくは下記のオブザーバーモードでの購入処理を参照してください。
onObserverRestoreInitiatedオブザーバーモードのみ：ユーザーがフロー内の復元ボタンをタップしたときに呼び出されます。Adapty は復元を実行しません。自分で復元を行い、復元されたトランザクションを報告してください。詳しくは下記のオブザーバーモードでの購入処理を参照してください。

オブザーバーモードでの購入処理

SDKをオブザーバーモード（observerMode: true）で有効化し、Adaptyがレンダリングするフローを表示している場合、SDKは代わりに購入処理を行いません。ユーザーが購入ボタンまたは復元ボタンをタップすると、SDKはonObserverPurchaseInitiatedまたはonObserverRestoreInitiatedを呼び出します。独自のコードで購入または復元を実行し、提供されたコールバックでフローのローディングインジケーターを制御した後、Adaptyにトランザクションを報告してください。

const unsubscribe = view.setEventHandlers({
  onObserverPurchaseInitiated(product, onStartPurchase, onFinishPurchase) {
    onStartPurchase(); // show the flow's loading indicator
    myPurchaseApi(product.vendorProductId)
      .then((transactionId) => adapty.reportTransaction(transactionId))
      .finally(() => onFinishPurchase()); // hide the loading indicator
    return false; // keep the flow open; dismiss it yourself after success
  },
  onObserverRestoreInitiated(onStartRestore, onFinishRestore) {
    onStartRestore();
    myRestoreApi()
      .finally(() => onFinishRestore());
    return false;
  },
});

このガイドは、購入・復元・プロダクト選択・ペイウォール表示に関するイベント処理について説明します。ボタン操作（ペイウォールを閉じる、リンクを開くなど）の処理も実装する必要があります。詳細はボタン操作の処理に関するガイドをご覧ください。

ペイウォールビルダーで設定されたペイウォールは、購入や復元のために追加のコードを書く必要はありません。ただし、アプリが応答できるイベントが生成されます。これらのイベントには、ボタン押下（閉じるボタン、URL、プロダクト選択など）や、ペイウォールでの購入関連アクションの通知が含まれます。これらのイベントへの対応方法については、以下をご覧ください。

このガイドは、Adapty SDK v3.0以降が必要な新しいペイウォールビルダーのペイウォール専用です。

ペイウォール画面上で発生するプロセスを制御・監視するには、イベントハンドラーを実装します。

イベントの例（クリックして展開）
// onCloseButtonPress
{
  //イベントを記録する
}

// onAndroidSystemBack
{
  //イベントを記録する
}

// onUrlPress
{
  "url": "https://example.com/terms"
}

// onCustomAction
{
  "actionId": "login"
}

// onProductSelected
{
  "productId": "premium_monthly"
}

// onPurchaseStarted
{
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Success
{
  "purchaseResult": {
    "type": "success",
    "profile": {
      "accessLevels": {
        "premium": {
          "id": "premium",
          "isActive": true,
          "expiresAt": "2024-02-15T10:30:00Z"
        }
      }
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Cancelled
{
  "purchaseResult": {
    "type": "user_cancelled"
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseFailed
{
  "error": {
    "code": "purchase_failed",
    "message": "Purchase failed due to insufficient funds",
    "details": {
      "underlyingError": "Insufficient funds in account"
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onRestoreCompleted
{
  "profile": {
    "accessLevels": {
      "premium": {
        "id": "premium",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    },
    "subscriptions": [
      {
        "vendorProductId": "premium_monthly",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    ]
  }
}

// onRestoreFailed
{
  "error": {
    "code": "restore_failed",
    "message": "Purchase restoration failed",
    "details": {
      "underlyingError": "No previous purchases found"
    }
  }
}

// onRenderingFailed
{
  "error": {
    "code": "rendering_failed",
    "message": "Failed to render paywall interface",
    "details": {
      "underlyingError": "Invalid paywall configuration"
    }
  }
}

// onLoadingProductsFailed
{
  "error": {
    "code": "products_loading_failed",
    "message": "Failed to load products from the server",
    "details": {
      "underlyingError": "Network timeout"
    }
  }
}

// onPaywallShown
{
  //イベントを記録する
}

// onPaywallClosed
{
  //イベントを記録する
}

// onWebPaymentNavigationFinished
{
  //イベントを記録する
}

必要なイベントハンドラのみを登録し、不要なものは省略できます。未使用のイベントリスナーは作成されません。必須のイベントハンドラはありません。

イベントハンドラはブール値を返します。true が返された場合、表示プロセスが完了したとみなされ、ペイウォール画面が閉じられ、このビューのイベントリスナーが削除されます。 一部のイベントハンドラーにはデフォルトの動作があり、必要に応じて上書きできます：

  • onCloseButtonPress: 閉じるボタンが押されたときにペイウォールを閉じます。
  • onUrlPress: タップされたURLを開き、ペイウォールは表示したままにします。
  • onAndroidSystemBack（モーダル表示のみ）: Back ボタンが押されたときにペイウォールを閉じます。
  • onRestoreCompleted: リストアが成功した後にペイウォールを閉じます。
  • onPurchaseCompleted: ユーザーがキャンセルしない限り、ペイウォールを閉じます。
  • onRenderingFailed: レンダリングに失敗した場合にペイウォールを閉じます。

イベントハンドラー

イベントハンドラー説明
onCustomActionユーザーがカスタムアクションを実行したとき（例：カスタムボタンをクリックしたとき）に呼び出されます。
onUrlPressユーザーがペイウォール内のURLをクリックしたときに呼び出されます。
onAndroidSystemBackモーダル表示のみ：ユーザーがAndroidのシステム Back ボタンをタップしたときに呼び出されます。
onCloseButtonPress閉じるボタンが表示されており、ユーザーがそれをタップしたときに呼び出されます。このハンドラー内でペイウォール画面を閉じることを推奨します。
onPurchaseCompleted購入が完了したとき（成功・ユーザーによるキャンセル・承認待ちのいずれの場合も）に呼び出されます。購入が成功した場合は更新された AdaptyProfile が提供されます。ユーザーによるキャンセルや保護者の承認待ちなどの保留中の支払いはこのイベントをトリガーし、onPurchaseFailed はトリガーされません。
onPurchaseStartedユーザーが「購入」アクションボタンをタップして購入プロセスを開始したときに呼び出されます。
onPurchaseFailedエラー（支払い制限、無効なプロダクト、ネットワーク障害、トランザクション検証の失敗など）により購入が失敗したときに呼び出されます。ユーザーによるキャンセルや保留中の支払いでは呼び出されず、その場合は onPurchaseCompleted がトリガーされます。
onRestoreStartedユーザーが購入の復元プロセスを開始したときに呼び出されます。
onRestoreCompleted購入の復元が成功し、更新された AdaptyProfile が提供されたときに呼び出されます。ユーザーが必要な accessLevel を持っている場合はこの画面を閉じることを推奨します。確認方法についてはサブスクリプションのステータスをご参照ください。
onRestoreFailed復元プロセスが失敗し、AdaptyError が提供されたときに呼び出されます。
onProductSelectedペイウォールビュー内のプロダクトが選択されたときに呼び出されます。購入前にユーザーが何を選択しているかを確認できます。
onRenderingFailedビューのレンダリング中にエラーが発生し、AdaptyError が提供されたときに呼び出されます。このようなエラーは本来発生しないため、もし発生した場合はお知らせください。
onLoadingProductsFailedプロダクトの読み込みに失敗し、AdaptyError が提供されたときに呼び出されます。ビューの作成時に prefetchProducts: true を設定していない場合、AdaptyUI が必要なオブジェクトをサーバーから自動的に取得します。
onPaywallShownペイウォールがユーザーに表示されたときに呼び出されます。iOS では、ユーザーがペイウォール内のウェブペイウォールボタンをタップしてアプリ内ブラウザでウェブペイウォールが開いたときにも呼び出されます。
onPaywallClosedモーダル表示のみ：ユーザーによってペイウォールが閉じられたときに呼び出されます。iOS では、ペイウォールからアプリ内ブラウザで開いたウェブペイウォールが画面から消えたときにも呼び出されます。
onWebPaymentNavigationFinished購入のためにウェブペイウォールを開こうとした後、成功・失敗に関わらず呼び出されます。