สอบถามความยินยอมในการส่งข้อมูล

ในการใช้ฟีเจอร์ 'ส่งข้อมูลการบริโภค' จำเป็นต้องได้รับความยินยอมจากผู้ใช้สำหรับ การส่งข้อมูลการบริโภค เกี่ยวกับผลิตภัณฑ์ที่ซื้อภายในแอป ในเรื่องนี้ SDK ของ Hive มีฟีเจอร์ที่ สอบถามผู้ใช้เกี่ยวกับการยินยอมในการส่งข้อมูลการบริโภคไปยังตลาด

เกี่ยวกับ 'ส่งข้อมูลการบริโภค'¶

ฟีเจอร์ 'ส่งข้อมูลการบริโภค' เป็นฟีเจอร์ที่ส่งข้อมูลการบริโภคของผู้ใช้ไปยังตลาดเพื่อวิเคราะห์ระดับการบริโภคและแนวโน้มการขอคืนเงินของผู้ใช้ก่อนที่จะดำเนินการคืนเงินสำหรับผลิตภัณฑ์ที่ซื้อในแอปในเกม
จากข้อมูลนี้ ตลาดจะกำหนดเกณฑ์การคืนเงิน ซึ่งช่วยให้เกมสามารถป้องกันการใช้งานที่ฉ้อโกงโดยผู้ใช้

ฟีเจอร์ 'ส่งข้อมูลการบริโภค' ถูกจัดเตรียมโดย API เซิร์ฟเวอร์ Hive และสำหรับข้อมูลรายละเอียดเกี่ยวกับการใช้ API นั้น โปรดดูที่คู่มือ Hive Server API > ส่งข้อมูลการบริโภค

การสอบถามเกี่ยวกับความยินยอมในการส่งข้อมูลการบริโภค¶

ในการดำเนินการ สอบถามเกี่ยวกับความยินยอมในการส่งข้อมูลการบริโภค สำหรับผลิตภัณฑ์ที่ซื้อภายในแอป คุณต้องตั้งค่าการใช้งานฟีเจอร์การส่งข้อมูลการบริโภคสำหรับแต่ละเกมในคอนโซล Hive ก่อน สำหรับรายละเอียดเพิ่มเติม โปรดดูที่คู่มือ Console Guide > Billing > Additional Service Settings

หลังจากกำหนดค่าการตั้งค่าที่เกี่ยวข้องในคอนโซล Hive แล้ว การสอบถามความยินยอมในการส่งข้อมูลการบริโภค สามารถดำเนินการได้โดยใช้สอง API ที่ให้โดย Hive SDK ด้านล่าง

• showConsumeInfoAgreement
• getConsumeInfoAgreement

showConsumeInfoAgreement¶

API showConsumeInfoAgreement จะแสดง UI ป๊อปอัพที่สอบถามผู้ใช้เกี่ยวกับความยินยอมในการส่งข้อมูลการบริโภค สามารถเรียกใช้เพื่อแสดง UI ป๊อปอัพเมื่อผู้ใช้ซื้อผลิตภัณฑ์ในแอปหรือกดปุ่มแยกต่างหาก และหลังจากการเรียกใช้ จะส่งคืนผลลัพธ์ของความยินยอมในการส่งเป็น ResultAPI และ Boolean.

เมื่อทำการซื้อผลิตภัณฑ์หรือเมื่อเสร็จสิ้นการซื้อ ให้เรียกใช้ API showConsumeInfoAgreement ของ SDK Hive เพื่อขอความยินยอมจากผู้ใช้เกี่ยวกับการส่งข้อมูลการบริโภค คุณสามารถแสดง UI ป๊อปอัพ 'การสอบถามความยินยอมในการส่งข้อมูลการบริโภค' ในเกม และผลลัพธ์ของความยินยอมจะถูกจัดเก็บและจัดการบนเซิร์ฟเวอร์ Hive

คุณสมบัติของ API showConsumeInfoAgreement มีดังนี้

• ในเกม UI ป๊อปอัพ 'การยินยอมในการส่งข้อมูลการบริโภค' ก็สามารถแสดงได้เช่นกัน ดังนั้นผู้ใช้สามารถเปลี่ยนแปลงหรือถอนการยินยอมได้ตลอดเวลา

• สำหรับผู้ใช้ที่ถูกสอบถามเป็นครั้งแรกหรือที่เคยปฏิเสธการยินยอม จะมีปุ่มที่ขอให้ยินยอมในการส่งข้อมูลการบริโภคแสดงขึ้น ขณะที่ปุ่มที่ถามว่าต้องการถอนการยินยอมจะแสดงสำหรับผู้ใช้ที่เคยให้การยินยอมแล้ว

  ตัวอย่างการแสดง 'ความยินยอม' สำหรับการส่ง	ตัวอย่างการแสดง 'การถอนความยินยอม' สำหรับการส่ง

• หากผู้ใช้ถอนความยินยอม UI ป๊อปอัพ 'สอบถามเกี่ยวกับความยินยอมในการส่งข้อมูลการบริโภค' สามารถแสดงอีกครั้งได้ ในขณะนี้ การเรียกใช้ getConsumeInfoAgreement API จะให้ข้อมูลที่จำเป็นสำหรับการแสดงอีกครั้ง เช่น 'สถานะความยินยอมล่าสุด' และ 'เวลาตอบกลับล่าสุด' ของผู้ใช้ จากนั้น เกมสามารถอ้างอิงค่าที่ได้รับเพื่อนำไปแสดงป๊อปอัพอีกครั้งตามที่แสดงในตัวอย่างด้านล่าง

  ตัวอย่าง: การสัมผัสซ้ำหลังจาก N วันของการถอนหรือการยกเลิก

getConsumeInfoAgreement¶

getConsumeInfoAgreement API จะดึงข้อมูลการตอบสนองล่าสุดของผู้ใช้และส่งคืนผลลัพธ์เป็น ResultAPI และวัตถุ โดยการเรียกใช้ API getConsumeInfoAgreement จะไม่จำเป็นต้องจัดเก็บสถานะการยินยอมและเวลาของผู้ใช้แยกต่างหากในเกม ซึ่งช่วยประหยัดทรัพยากร

วัตถุที่ส่งคืนเป็นผลลัพธ์ประกอบด้วยค่าความยินยอมล่าสุดของผู้ใช้ (Boolean), เวลาของการตอบสนองครั้งแรก (Integer), และเวลาของการตอบสนองครั้งสุดท้าย (Integer) สำหรับผู้ใช้ที่ไม่เคยเห็นป๊อปอัพ จะส่งค่าที่เป็น null คืนกลับมา และหากมีข้อมูลการตอบสนองก่อนหน้านี้อยู่ จะส่งคืนสามค่าเป็นวัตถุเดียว

ตัวอย่างโค้ด¶

การขอความยินยอมในการส่งข้อมูลผู้บริโภค ตัวอย่างโค้ดที่ใช้ 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() {    
    // Check whether the user agreed or refused to the terms with 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]) {    
    // Get the user's last consent value and response time from info, and decide whether to show the popup.
  }    
}];