การแจ้งเตือนการบรรลุ CPA

ในเกม เมื่อผู้ใช้บรรลุ CPA ที่ลงทะเบียนใน Promotion Console (Hive Console > Promotion) คุณสามารถส่งข้อมูลไปยัง Hive Server เพื่อจ่ายรางวัลให้กับผู้ใช้ กรุณาเรียกจากเซิร์ฟเวอร์เกมไปยังเซิร์ฟเวอร์โปรโมชั่นสำหรับการแจ้งเตือนการบรรลุ CPA

• คำขอ URL

  URL ทั่วไป	https://promotion.qpyou.cn/api/cpa
  URL Sandbox	https://sandbox-promotion.qpyou.cn/api/cpa
  HTTP Method	POST
  Content-Type	text/html
  รูปแบบข้อมูล	JSON

• หัวข้อ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  การอนุญาต	CertificationKey ที่ถูกต้องผ่านการอนุญาต Bearer	String	N

• หัวข้อ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  การอนุญาต	CertificationKey ที่ใช้ได้ผ่านการอนุญาต Bearer	String	N

• คำขอ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  appid	App ID ของเกมที่บรรลุ CPA	String	Y
  vid หรือ uid	จำเป็นต้องใช้หนึ่งใน vid หรือ uid - vid: Player ID เมื่อใช้ Authentication v4. VID เมื่อใช้ Authentication v1 - uid: User ID ที่จัดการโดยแพลตฟอร์มเช่น HIVE ID และ Kakao App Center ID	String	Y
  server_id	ค่าที่ใช้ในการแยกแยะเซิร์ฟเวอร์ของผู้ใช้เกม	String	Y
  cpa_code	รหัส CPA ที่กำลังดำเนินการ (จำเป็นต้องตรวจสอบกับ UA Operation PIC)	String	Y
  cpa_date	เวลาที่บรรลุ CPA, เวลามาตรฐานเกาหลี (KST) (ค่าเริ่มต้น: เวลาที่ดำเนินการ API)	String	N

• Response

  Field Name	Description	Type
  result_code	ผลลัพธ์ของคำขอ 0=สำเร็จ	Integer
  result_msg	ข้อความผลลัพธ์	String

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

  • เรียก

  curl -L -v
  -d '{"appid":"com.com2us.hivesdk.normal.freefull.google.global.android.common", "vid":"300000011", "server_id":"kr", "cpa_code":"113", "cpa_date":"2022-03-15 12:00:00"}'
  -H "Content-Type: application/json"
  https://sandbox-promotion.qpyou.cn/api/cpa
  

  • ขอร้อง

  > POST /api/cpa HTTP/1.1
  > User-Agent: curl/7.29.0
  > Host: sandbox-promotion.qpyou.cn
  > Accept: /
  > Content-Type: application/json
  > Content-Length: 164
  

  • การตอบสนอง

  < HTTP/1.1 200 OK
  < Server: nginx
  < Date: Tue, 15 Mar 2022 03:17:10 GMT
  < Content-Type: text/html; charset=UTF-8
  {"result_code":0,"result_message":"สำเร็จ."}