ส่งข้อมูลการบริโภค

การใช้ การส่งข้อมูลการบริโภคจากบริการเพิ่มเติม เมื่อผู้ใช้แอปขอคืนเงิน คุณสามารถส่งข้อมูลพฤติกรรมการบริโภคของผู้ใช้ไปยังตลาดแอป API นี้ช่วยให้เซิร์ฟเวอร์ Hive สามารถส่งคำขอไปยังเซิร์ฟเวอร์แอปของนักพัฒนา และเซิร์ฟเวอร์ของนักพัฒนาจะส่งการตอบกลับไปยังเซิร์ฟเวอร์ Hive

ภาพรวม¶

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

URL ของเซิร์ฟเวอร์เกมคือ จุดสิ้นสุด API ที่เปิดโดยเซิร์ฟเวอร์เกม เพื่อให้เซิร์ฟเวอร์เกมส่งข้อมูลไปยังเซิร์ฟเวอร์ Hive หลังจากกำหนดค่าจุดสิ้นสุด API ตามโปรโตคอลด้านล่างและลงทะเบียนกับ URL ของเซิร์ฟเวอร์เกม เซิร์ฟเวอร์ Hive จะส่งคำขอ POST ไปยังจุดสิ้นสุด API นี้ทุกครั้งที่ผู้ใช้ขอคืนเงินและจะได้รับข้อมูลที่จำเป็นจากเซิร์ฟเวอร์เกม เซิร์ฟเวอร์ Hive จะรวมข้อมูลนี้และทำการส่งข้อมูลผู้บริโภคไปยังตลาดแอปในนามของนักพัฒนาแอป

สรุปได้ว่าทั้งหมดนี้เป็นกระบวนการดังต่อไปนี้

1. นักพัฒนาแอป: เตรียม URL เซิร์ฟเวอร์โดย กำหนดค่า API endpoint
2. นักพัฒนาแอป: เลือก เปิดใช้งานการส่งข้อมูลการบริโภค ในคอนโซล Hive และลงทะเบียน URL เซิร์ฟเวอร์
3. ผู้ใช้แอป: ตกลงที่จะ ส่งข้อมูลการบริโภคผลิตภัณฑ์ในแอป ขณะที่แอปกำลังทำงาน
4. ผู้ใช้แอป: ขอคืนเงินในแอป
5. เซิร์ฟเวอร์ Hive: POST API request ไปยัง URL เซิร์ฟเวอร์ที่ลงทะเบียนโดยนักพัฒนาแอป รับข้อมูลเป็นการตอบกลับ
6. เซิร์ฟเวอร์ Hive: ส่งข้อมูลการบริโภคไปยังตลาดแอป

การกำหนดค่าจุดสิ้นสุด API (URL เซิร์ฟเวอร์)¶

API endpoint ที่จะลงทะเบียนกับ URL ของเซิร์ฟเวอร์ต้องรวมข้อมูลเฉพาะของผู้ใช้เกม (consumption_status, play_time, refund_preference, sample_content_provided) เมื่อมีการรับคำขอ และตอบกลับด้วยข้อมูลที่รวมกันซึ่งสามารถเรียกดูได้โดยใช้ข้อมูลผู้ใช้ (CS_CODE) ในพารามิเตอร์คำขอ

ปิดกฎไฟร์วอลล์¶

การปิดกฎไฟร์วอลล์ขาเข้าช่วยให้การสื่อสาร API ระหว่างเซิร์ฟเวอร์เกมและเซิร์ฟเวอร์ Hive เป็นไปได้ คุณต้องปิดกฎไฟร์วอลล์ขาเข้าสำหรับที่อยู่ IP ด้านล่างบนเซิร์ฟเวอร์เกม

หลังจากปิดกฎไฟร์วอลล์แล้ว โปรดดูข้อมูลด้านล่างเพื่อกำหนดค่า API endpoint

การกำหนดค่า API request (Hive server → game server)¶

นี่คือข้อมูลการร้องขอ POST ที่ส่งจากเซิร์ฟเวอร์ Hive ไปยังเซิร์ฟเวอร์เกม

ข้อมูลใน Request Body มีดังนี้

ต่อไปนี้คือตัวอย่างของ Request Body.

{
    "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."
}

นี่คือรหัสการตอบสนอง