ระบบแนะนำ

สร้างระบบแนะนำที่กำหนดเองในเกมของคุณ เพื่อให้เนื้อหาที่คัดสรร เช่น สินทรัพย์ 2D และ 3D, มินิเกม, เกมอื่น ๆ และอื่น ๆ Recommendation Service API ช่วยให้คุณสามารถบันทึกกิจกรรมของผู้ใช้, บันทึกการแสดงผล, และมอบผลลัพธ์ที่เป็นส่วนตัวสำหรับการมีส่วนร่วมในแทบทุกประเภท

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

ใช้ขั้นตอนทั่วไปและแนวปฏิบัติที่ดีที่สุดต่อไปนี้เพื่อกำหนดระบบแนะนำของคุณ:

1. ลงทะเบียนเนื้อหาของคุณ
2. บันทึกการแสดงผลของผู้ใช้
3. บันทึกการกระทำที่มีคุณภาพ
4. ดึงคำแนะนำ
5. ติดตามการวิเคราะห์

ลงทะเบียนเนื้อหาของคุณ

เพื่อเติมเต็มเนื้อหาที่ระบบแนะนำของคุณสามารถให้บริการแก่ผู้ใช้ ใช้ RegisterItemAsync เมื่อลงทะเบียนรายการ ให้ระบุ referenceId, สตริงที่ผู้พัฒนากำหนดซึ่งระบุตัวตนรายการในฐานข้อมูลของคุณอย่างไม่ซ้ำกัน referenceId นี้มักใช้ในการค้นหาข้อมูลเมตาของรายการ เช่น ชื่อ, คำอธิบาย, หรือ ID ของสินทรัพย์ จากที่เก็บข้อมูลของคุณเพื่อแสดงใน UI

เป็นแนวทางที่ดีที่สุด ให้ลงทะเบียนรายการเมื่อมันถูกสร้างขึ้นเพื่อให้แน่ใจว่าชุดแนะนำจะสดใหม่อยู่เสมอ

บันทึกการแสดงผลของผู้ใช้

ทันทีที่บริการทราบเกี่ยวกับรายการของคุณและเริ่มแนะนำมัน ให้บอกบริการเมื่อผู้ใช้มองดูคำแนะนำด้วย LogImpressionEvent

เมื่อไหร่ที่จะบันทึก

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

• บันทึกครั้งเดียว: บันทึกการแสดงผล เพียงครั้งเดียว ต่อเซสชันสำหรับรายการเฉพาะ

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

ระยะเวลา

ระยะเวลาใช้ติดตามเวลาการแสดงผล คุณสามารถคิดว่านี่คือระยะเวลาที่ผู้ใช้มองไปที่ภาพหรือคำแนะนำ

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

บันทึกการกระทำที่มีคุณภาพ

เมื่อผู้ใช้ตัดสินใจที่จะมีปฏิสัมพันธ์กับคำแนะนำ ให้ใช้ LogActionEvent ในตัวอย่างนี้ การคลิก "เล่น" บนคำแนะนำนั้นไม่เพียงพอเป็นสัญญาณสำหรับระบบแนะนำที่มีคุณภาพสูง สิ่งสำคัญคือต้องแยกแยะระหว่างการคลิกโดยบังเอิญกับเซสชันที่แท้จริง

ประเภทการกระทำที่จำเป็น

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

กลยุทธ์ "การเล่นที่มีคุณภาพ"

ขึ้นอยู่กับเกมของคุณ คุณอาจมีการกำหนดที่แตกต่างกันว่าหมายถึง "การเล่นที่มีคุณภาพ" ใช้ขั้นตอนต่อไปนี้เพื่อช่วยปรับแต่งสิ่งที่ทำให้การเล่นมีคุณภาพแตกต่างกันในสถานการณ์ของคุณ

1. ติดตามภายใน: เมื่อผู้ใช้เข้าสู่เกมมินิ ติดตามระยะเวลาเซสชันของพวกเขาในสคริปต์ของคุณ
2. กลั่นกรอง: กำหนดเกณฑ์สำหรับความพึงพอใจ เช่น การเล่นเกิน 60 วินาที
3. บันทึก: ให้เรียกใช้ LogActionEvent เฉพาะเมื่อผู้ใช้ผ่านเกณฑ์นี้

ดึงคำแนะนำ

เพื่อดึงคำแนะนำ ใช้ GenerateItemListAsync GenerateItemListAsync ยอมรับพจนานุกรมที่รวมตัวเลือกต่าง ๆ สำหรับการสอบถามรายการคำแนะนำ ในขณะที่ตั้งค่าหลายรายการเหล่านี้ตรงไปตรงมา สิ่งสำคัญคือต้องเข้าใจพารามิเตอร์ ConfigName ที่รองรับเพื่อให้แน่ใจว่าคุณให้คำแนะนำที่ประสบความสำเร็จ

ConfigName

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

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าที่รองรับแต่ละรายการ ให้ตรวจสอบที่ GenerateItemListAsync

ติดตามการวิเคราะห์

เมื่อคุณได้รวมบริการเข้าด้วยกันแล้ว คุณสามารถติดตามประสิทธิภาพของมันโดยตรงใน Creator Hub เพื่อเข้าถึงการวิเคราะห์คำแนะนำของคุณ:

1. ใน Creator Hub ไปที่หน้าเกมของคุณ
2. ในแถบด้านข้าง ไปที่ Engagement > Recommendation Service

เมตริกหลักที่ต้องติดตาม:

• จำนวนการกระทำรวมตามเวลา: ผู้ใช้มีส่วนร่วมกับคำแนะนำจริงหรือไม่?
• จำนวนผู้ใช้ที่ไม่ซ้ำกันทั้งหมด: มีผู้กี่คนใช้คุณสมบัติการค้นพบ?
• ค่าเฉลี่ยของรายการที่แสดงต่อผู้ใช้: ผู้ใช้กำลังเลื่อนดูคาราวานอยู่หรือไม่?
• ค่าเฉลี่ยของเวลาที่ใช้แต่ละผู้ใช้: คุณภาพของคำแนะนำทำให้พวกเขาอยู่ในเกมนานขึ้นหรือไม่?

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

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

ในขณะที่กระบวนการนี้ครอบคลุมกระบวนการสำหรับระบบแนะนำที่เพิ่มเวลาเล่น คุณสามารถใช้ลำดับการดำเนินการและแนวคิดพื้นฐานที่คล้ายกันเพื่อสร้างบริการแนะนำที่เหมาะสมกับความต้องการของเกมของคุณ