消費情報送信同意照会

「消費情報を送信」機能を使用するには、アプリ内購入製品に関する 消費情報の送信 についてユーザーの同意が必要です。この点に関して、Hive SDKは、消費情報を市場に送信することに同意するかどうかをユーザーに問い合わせる機能 を提供します。

「消費情報を送信」について¶

「消費情報を送信する」は、ユーザーの消費情報を市場に送信し、ゲーム内購入商品の返金処理を行う前にユーザーの消費レベルと返金傾向を分析する機能です。
この情報に基づいて、市場は返金基準を提供し、ゲームがユーザーによる不正利用を防ぐことを可能にします。

「消費情報を送信」機能はHiveサーバーAPIによって提供されており、そのAPIの使用に関する詳細情報については、 HiveサーバーAPI > 消費情報を送信ガイドを参照してください。

消費情報送信に関する同意の確認¶

アプリ内購入商品の 消費情報送信に関する同意の問い合わせ を実装するには、まずHiveコンソールで各ゲームの消費情報送信機能の使用を設定する必要があります。詳細については、コンソールガイド > 請求 > 追加サービス設定ガイドを参照してください。

Hive コンソールで関連する設定を構成した後、消費情報送信の同意の問い合わせ は、以下の Hive SDK によって提供される 2 つの API を使用して実装できます。

• showConsumeInfoAgreement
• getConsumeInfoAgreement

showConsumeInfoAgreement¶

showConsumeInfoAgreement APIは、ユーザーに消費情報を送信することへの同意を尋ねるポップアップUIを表示します。これは、ユーザーがアプリ内製品を購入したときや別のボタンを押したときにポップアップUIを表示するために呼び出すことができ、呼び出し後には、送信する同意の結果をResultAPIおよびBooleanとして返します。

製品を購入する際、または購入完了時に、showConsumeInfoAgreement APIをHive SDKの呼び出して、ユーザーに消費情報の送信に関する同意を求めます。ゲーム内の「消費情報送信に関する同意確認」ポップアップUIを表示でき、同意の結果はHiveサーバーで保存および管理されます。

showConsumeInfoAgreement APIの機能は以下の通りです。

• ゲーム内で、「消費情報送信の同意」ポップアップUIも表示されることがあります。したがって、ユーザーはいつでも同意を変更または撤回できます。

• 初めて問い合わせを受けるユーザーや、以前に同意を拒否したユーザーには、消費情報を送信するための同意を求めるボタンが表示され、以前に同意したユーザーには同意を撤回するかどうかを尋ねるボタンが表示されます。

  送信のための「同意」の表示例	送信のための「同意の撤回」の表示例

• ユーザーが同意を撤回した場合、「消費情報送信に関する同意の確認」ポップアップUIを再表示できます。この時、getConsumeInfoAgreement APIを呼び出すことで、ユーザーの「最後の同意状況」や「最後の応答時間」など、再表示に必要な情報を提供します。その後、ゲームは受け取った値を参照して、以下の例のようにポップアップを再表示できます。

  例: N日間の撤回またはキャンセル後の再曝露

getConsumeInfoAgreement¶

getConsumeInfoAgreement APIは、ユーザーの最後の応答情報を取得し、結果をResultAPIとオブジェクトとして返します。getConsumeInfoAgreement APIを呼び出すことで、ゲーム内でユーザーの同意状況とタイミングを別途保存する必要がなくなり、リソースを節約できます。

結果として返されるオブジェクトには、ユーザーの最後の同意値（Boolean）、最初の応答の時間（Integer）、および最後の応答の時間（Integer）が含まれます。ポップアップに一度も触れたことがないユーザーにはnull値が返され、以前の応答情報が存在する場合、3つの値が1つのオブジェクトとして返されます。

例のコード¶

消費者情報送信の同意を取得する 提供されたAPIを使用した実装の例コードは以下の通りです。

using hive;    
IAPV4.showConsumeInfoAgreement((ResultAPI result, bool didAgree) => {    
  if (result.isSuccess()) {    
    // Check if the user agreed or declined the terms with didAgree.
  }    
});

using hive;    
IAPV4.getConsumeInfoAgreement((ResultAPI result, IAPV4.IAPV4ConsumeInfoUserAgreement info) => {    
  if (result.isSuccess()) {    
    // Get the user's last agreement value and response time from info, and decide whether to show the popup.
  }    
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;    
IAPV4::showConsumeInfoAgreement([=](ResultAPI const & result, bool didAgree) {    
  if (result.isSuccess()) {    
    // Check if the user agreed or rejected the terms with didAgree.
  }    
}

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;    
IAPV4::getConsumeInfoAgreement([=](ResultAPI const & result, IAPV4ConsumeInfoUserAgreement* _Nullable const & info) {    
  if (result.isSuccess()) {    
    // Get the user's last consent value and response time from info, and decide whether to show the popup.
  }    
}

import HIVEService    
IAPV4Interface.showConsumeInfoAgreement() { result, didAgree in    
  if result.isSuccess() {    
    // ユーザーが条件に同意したか拒否したかをdidAgreeで確認します。
  }    
}

import HIVEService    
IAPV4Interface.getConsumeInfoAgreement() { result, info in    
  if result.isSuccess() {    
    // ユーザーの最後の同意値と情報からの応答時間を取得し、ポップアップを表示するかどうかを決定します。
  }    
}

#import <HIVEService/HIVEService-Swift.h>    
[HIVEIAPV4 showConsumeInfoAgreementWithHandler:^(HIVEResultAPI * result, BOOL didAgree) {    
  if ([result isSuccess]) {    
    // Check if the user agreed or declined the terms with didAgree.
  }    
}];

#import <HIVEService/HIVEService-Swift.h>    
[HIVEIAPV4 getConsumeInfoAgreementWithHandler:^(HIVEResultAPI * result, HIVEIAPV4ConsumeInfoUserAgreement * info) {    
  if ([result isSuccess]) {    
    // ユーザーの最後の同意値と情報からの応答時間を取得し、ポップアップを表示するかどうかを決定します。
  }    
}];