消費情報を送信する

追加サービスからの消費情報を送信するためにtransmitting consumption information from additional servicesを使用すると、アプリユーザーが返金を要求したときに、ユーザーの消費行動情報をアプリマーケットに送信できます。このAPIは、Hiveサーバーが開発者のアプリサーバーにリクエストを送信し、開発者のサーバーがHiveサーバーに応答を返すことを可能にします。

概要¶

アプリマーケットに送信される消費者情報には、ゲームサーバーにのみ存在するデータも含まれています。したがって、Hive サーバーがこのデータをアプリマーケットに送信するには、ゲームサーバーが Hive サーバーにデータを渡さなければなりません。

ゲームサーバーのURLは、ゲームサーバーがデータをHiveサーバーに送信するために開かれたAPIエンドポイントです。以下のプロトコルに従ってAPIエンドポイントを設定し、ゲームサーバーのURLに登録した後、Hiveサーバーはユーザーが返金をリクエストするたびにこのAPIエンドポイントにPOSTリクエストを送り、ゲームサーバーから必要なデータを受け取ります。Hiveサーバーはこのデータを集約し、アプリ開発者に代わってアプリマーケットへの消費者情報の送信を完了します。

要約すると、全体のプロセスは次のとおりです。

1. アプリ開発者: APIエンドポイントを設定してサーバーURLを準備する
2. アプリ開発者: Hive コンソールで 消費情報伝送を有効にする を選択し、サーバーURLを登録する
3. アプリユーザー: アプリが実行中の間に アプリ内製品の消費情報を伝送することに同意する
4. アプリユーザー: アプリ内で返金をリクエストする
5. Hive サーバー: アプリ開発者によって登録されたサーバーURLにPOST APIリクエストを送信し、データをレスポンスとして受け取る
6. Hive サーバー: アプリマーケットに消費情報を伝送する

APIエンドポイントの設定（サーバーURL）¶

サーバーURLに登録されるAPIエンドポイントは、リクエストを受信した際にゲームユーザー固有のデータ（consumption_status、play_time、refund_preference、sample_content_provided）を集約し、リクエストパラメータ内のユーザー情報（CS_CODE）を使用してクエリできる集約データで応答しなければなりません。

ファイアウォールルールを無効にする¶

ファイアウォールの受信ルールを無効にすると、ゲームサーバーとHiveサーバー間のAPI通信が可能になります。ゲームサーバーの以下のIPアドレスについて、ファイアウォールの受信ルールを無効にする必要があります。

ファイアウォールルールを無効にした後、APIエンドポイントを設定するための情報を以下に参照してください。

APIリクエスト (Hive サーバー → ゲームサーバー) 設定¶

これはHiveサーバーからゲームサーバーに送信されたPOSTリクエスト情報です。

以下はリクエストボディの情報です。

以下はリクエストボディの例です。

{
    "gameindex": "539",
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "user_seq": "222333"
}

APIレスポンス (ゲームサーバー → Hive サーバー) 設定¶

これは、応答が成功したときにゲームサーバーからHiveサーバーに送信されなければならない応答値情報です。

以下は、レスポンスが成功したときのレスポンス値の例です。

// success
{
    "code": 100,
    "message": "OK",
    "data": {
        "consumption_status": 0,
        "play_time": 1,
        "refund_preference": 2,
        "sample_content_provided": 0
    }
}

以下は、レスポンス失敗の場合のレスポンス値の例です。

// Errors due to wrong parameters
{
    "code": 400,
    "message": "No parameter, or invalid parameter name."
}

// Errors due to invalid user information
{
    "code": 200,
    "message": "No data, or invalid cs_code."
}

こちらがレスポンスコードです。