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

ในการใช้ฟีเจอร์ 'ส่งข้อมูลการบริโภค' จำเป็นต้องได้รับความยินยอมจากผู้ใช้สำหรับ การส่งข้อมูลการบริโภค เกี่ยวกับผลิตภัณฑ์ที่ซื้อในแอป ในเรื่องนี้ 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 และวัตถุ โดยการเรียกใช้ getConsumeInfoAgreement API จะไม่จำเป็นต้องจัดเก็บสถานะและเวลาการยินยอมของผู้ใช้แยกต่างหากในเกม ทำให้ประหยัดทรัพยากร

วัตถุที่ส่งกลับเป็นผลลัพธ์ประกอบด้วยค่าความยินยอมล่าสุดของผู้ใช้ (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 "HiveIAPV4.h"

FHiveIAPV4::ShowConsumeInfoAgreement(FHiveIAPV4OnShowConsumeInfoAgreementDelegate::CreateLambda([this](const FHiveResultAPI& Result, bool DidAgree) {
  if (Result.IsSuccess()) {
    // Find out whether the user agreed or declined the terms with didAgree.
}));

#include "HiveIAPV4.h"

FHiveIAPV4::GetConsumeInfoAgreement(
  FHiveIAPV4OnGetConsumeInfoAgreementDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveIAPV4ConsumeInfoUserAgreement& Info) {
    if (Result.IsSuccess()) {
      // รับค่าความยินยอมล่าสุดของผู้ใช้และเวลาตอบสนองจาก Info และตัดสินใจว่าจะให้แสดงป๊อปอัพหรือไม่
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;    
IAPV4::showConsumeInfoAgreement([=](ResultAPI const & result, bool didAgree) {    
  if (result.isSuccess()) {    
    // ตรวจสอบว่าผู้ใช้ได้ตกลงหรือปฏิเสธเงื่อนไขด้วย 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.
  }    
}];