注文状況を追跡する

ユーザーが購入した後、アプリケーションは以下のアクションを実行することができます：

• アプリケーションUIに注文状態を表示する
• 支払い完了後、ユーザーの残高を計上する
• 支払い完了後、購入したアイテムを付与する

これらのアクションのロジックを実装するには、OrderTracking.Instance.AddOrderForTracking SDKメソッドを使用して、注文状態を追跡する必要があります。メソッドに以下のパラメータを渡します：

• projectId — パブリッシャーアカウントからのプロジェクトID
• orderId — ショッピングカート経由で購入、ワンクリック購入または仮想通貨で購入から受信した注文ID
• onSuccess — 注文状態が「done」に変更されました場合のコールバック
• onError — エクソーラサーバーがエラーを返した場合のコールバック

このメソッドは、注文ステータスを追跡するためのいくつかのメソッドをカプセル化します。メカニズムは、以下の原因でアプリケーションが構築されているプラットフォームによって異なります：

• WebGLビルドの場合、追跡は決済インターフェイスウィジェットのpostMessageイベントに基づいています。「決済ステーション」ウィジェットが注文状態が「done」または「cancel」に変更されたというメッセージを送信すると、追跡は停止します。

• 他のプラットフォーム向けのビルドの場合、追跡には単純なHTTPリクエスト（ショートポーリング）とウェブソケットリクエストが使用されます。追跡は、次のアルゴリズムに従って実行されます：

1. 1. ウェブソケット接続が確立されます。
   2. 5分以内に注文状態が「done」または「cancel」に変更されなかった場合、ウェブソケット接続閉じられています。注文状態が「done」または「cancel」に変更された場合、追跡は停止します。
   3. 注文状態の追跡は、ショートポーリングで続行されます。シンプルなHTTP注文状態リクエストが3秒ごとに送信されます。追跡は以下の場合に停止します：
      • 注文状態が「done」または「cancel」に変更されます
      • 注文状態が10分以内に「done」または「cancel」に変更されます

以下を実装することもできます：

• CheckOrderStatus SDKメソッドを使用して注文状態と注文内容をリクエストする
• エクソーラのトランザクションイベント用のアプリケーションのサーバー側でのウェブフック処理

お役立ちリンク