ZEPETO Analytics

zepeto analytics เป็นแพ็คเกจที่ทำให้การใช้ api สถิติเป็นเรื่องง่าย ขณะนี้ google analytics พร้อมใช้งานแล้ว 👍 รองรับสเปค google analytics v4 ขั้นตอนที่ 1 ติดตั้ง window → package manager → กรุณาติดตั้ง zepeto world package เวอร์ชัน 1 21 14 ก่อน หลังจากนั้นให้ติดตั้งแพ็คเกจ zepeto analytics ขั้นตอนที่ 2 สร้างข้อมูลสตรีม google analytics 📘 google analytics https //analytics google com/ https //analytics google com/ หลังจากที่คุณสร้างบัญชี google analytics ของคุณแล้ว คุณต้องสร้างข้อมูลสตรีมเพื่อใช้ใน world (โดยเฉลี่ยใช้เวลา 1 วันในการเปิดใช้งานบัญชีเริ่มต้น) แนะนำให้คุณสร้างและจัดการข้อมูลสตรีมหนึ่งรายการต่อ worldid zepeto analytics ส่งข้อมูลโดยใช้ httpservice ดังนั้นโปรดตรวจสอบให้แน่ใจว่าได้เลือกแพลตฟอร์ม 'เว็บ' กรุณาเขียน worldid ในที่ที่คุณเขียน url เมื่อการสร้างข้อมูลสตรีมเสร็จสมบูรณ์ คุณสามารถตรวจสอบ measurement id ได้ ในการสร้างค่า api key คุณต้องเข้าสู่เมนูความลับของ measurement protocol api หลังจากกดปุ่มสร้างที่ด้านขวา ให้กรอกชื่อเล่นเพื่อสร้างค่า secret value กรุณาคัดลอกค่า measurement id และค่า secret value สำหรับขั้นตอนถัดไป ขั้นตอนที่ 3 วิธีการใช้งาน ในหน้าต่าง hierarchy ให้คลิกที่แท็บ zepeto → zepeto analytics วัตถุที่เรียกว่า zepeto analytics จะถูกสร้างขึ้นโดยอัตโนมัติตามนี้ zepetoanalyticscomponent เป็นส่วนประกอบที่รับผิดชอบในการส่งสถิติภายใน scene ในหน้าต่าง inspector คุณสามารถกรอกการตั้งค่าที่จำเป็นในการส่งสถิติได้ กรุณาเลือก google analytics เป็นประเภทการวิเคราะห์และกรอก api key และ measurement id เมื่อคุณเล่นฉากที่มีส่วนประกอบ zepeto analytics เพิ่มเข้ามา ค่าเวลาที่อยู่อาศัยรวมจะถูกสะสมโดยอัตโนมัติใน google analytics คุณสามารถดูค่าระยะเวลาในการมีส่วนร่วมจากเมนู reports > realtime overview (รายการรายงานที่ไม่รวมแท็บ realtime จะใช้เวลาสักครู่ในการสะท้อนผล ) หากฉากถูกเปลี่ยนและส่วนประกอบถูกลบ สถิติจะไม่ถูกส่ง ดังนั้นหากคุณต้องการเก็บไว้ กรุณาประมวลผลเป็น don't destroy ❗️ ระวัง หากคุณตรวจสอบโหมดดีบักระหว่างการทดสอบในตัวแก้ไข ข้อมูลจะไม่ถูกส่งไปยังแดชบอร์ด เมื่อคุณต้องการจัดเก็บข้อมูล ให้แน่ใจว่าโหมดดีบักถูกปิดอยู่ การเพิ่มเหตุการณ์ที่กำหนดเอง คุณสามารถจัดเรียงสถิติจากเหตุการณ์ที่กำหนดเองได้ ด้านล่างนี้คือตัวอย่างโค้ดที่ส่งเหตุการณ์ที่กำหนดเองไปยังแดชบอร์ด google analytics เมื่อคุณกดปุ่ม import { zepetoscriptbehaviour } from 'zepeto script'; import { analyticstype, zepetoanalyticscomponent } from 'zepeto analytics'; import { button } from 'unityengine ui'; export default class customevent extends zepetoscriptbehaviour { public zepetoanalytics zepetoanalyticscomponent; public mybutton button; start() { this mybutton onclick addlistener(() => { // เมื่อปุ่มถูกคลิก เหตุการณ์สุ่มจะถูกส่งไปยัง google analytics const ga = this zepetoanalytics analytics(analyticstype googleanalytics); interface customevent { param 01 string; param 02 number; } const event customevent = { param 01 "param string val 01", param 02 3, } ga logevent\<customevent>("custom sub param", event); }); } } โปรดตรวจสอบให้แน่ใจว่าได้เชื่อมต่อส่วนประกอบ zepeto analytics หลังจากเขียนสคริปต์แล้ว ภาพหน้าจอด้านล่างนี้เป็นตัวอย่างของส่วนประกอบที่กำหนดค่าเพื่อให้สคริปต์ตัวอย่างทำงานได้ จากเมนูรายงาน > ภาพรวมแบบเรียลไทม์ คุณสามารถเห็นค่าของเหตุการณ์ที่กำหนดเองถูกจัดเรียงในแบบเรียลไทม์ เปิดโหมดดีบัก google analytics จะตรวจสอบ payload body สำหรับ customevent ที่คุณส่ง (ถ้าไม่ถูกต้อง จะไม่ถูกส่ง) การตรวจสอบโหมดดีบักทำให้เห็นผลการตรวจสอบสำหรับ payload ที่คุณส่งในหน้าต่างคอนโซลได้ง่ายขึ้น ❗️ ระวัง หากคุณตรวจสอบโหมดดีบักระหว่างการทดสอบในตัวแก้ไข ข้อมูลจะไม่ถูกส่งไปยังแดชบอร์ด เมื่อคุณต้องการจัดเรียงข้อมูล ให้แน่ใจว่าโหมดดีบักถูกปิด หากคุณสร้างเหตุการณ์ที่กำหนดเองซึ่งไม่ตรงตามข้อกำหนดของ google การตรวจสอบจะล้มเหลวในโหมดดีบัก สำหรับข้อมูลเกี่ยวกับข้อกำหนดของ google และโหมดดีบัก โปรดเยี่ยมชม 📘 สำหรับข้อมูลเกี่ยวกับข้อกำหนดของ google และโหมดดีบัก โปรดเยี่ยมชม สำหรับข้อมูลเกี่ยวกับข้อกำหนดของ google และโหมดดีบัก โปรดเยี่ยมชม google analytics https //developers google com/analytics/devguides/collection/protocol/ga4/sending events?hl=th\&client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/sending events?hl=th\&client type=gtag เครื่องมือพัฒนา google analytics https //ga dev tools web app/ga4/event builder/ https //ga dev tools web app/ga4/event builder/ zepetobaseanalytics api ฟังก์ชัน คำอธิบาย logevent ช่วยให้คุณส่งเหตุการณ์ที่กำหนดเองไปยังแดชบอร์ด google analytics ที่เชื่อมโยง รองรับพารามิเตอร์เดียว (สตริง, หมายเลข, บูลีน) และ payload ทั่วไป สำหรับ payload ในรูปแบบทั่วไป สามารถส่งเฉพาะฟอร์มที่ google analytics อนุญาตเท่านั้น https //developers google com/analytics/devguides/collection/protocol/ga4/validating events?client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/validating events?client type=gtag setanalyticscollectionenabled เปิด/ปิดฟังก์ชันการส่งเหตุการณ์ของ zepeto analytics component สามารถใช้สำหรับการควบคุมแบบไดนามิก ตามค่าเริ่มต้น analytics component จะเป็น true เมื่อเปิดใช้งาน และ false เมื่อปิดใช้งาน (เวลาที่อยู่อาศัยพื้นฐานจะถูกบันทึกโดยอัตโนมัติจากเวลาที่เปิดใช้งาน zepeto analytics component) sendduration สำหรับชื่อเหตุการณ์เฉพาะ คุณสามารถส่งเวลาที่อยู่อาศัยในมิลลิวินาที (ms) สามารถใช้เพื่อบันทึก engagement time สำหรับเหตุการณ์เฉพาะด้วยตนเอง (แยกจากเวลาที่อยู่อาศัยที่วัดโดยอัตโนมัติ) เช่น) ใช้เพื่อบันทึกด้วยตนเองว่า 'ฉันอยู่ในพื้นที่เฉพาะเป็นเวลา 3 วินาที (3000 ms)' setuserproperty สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถเพิ่มคุณสมบัติผู้ใช้ที่กำหนดเองได้ https //developers google com/analytics/devguides/collection/protocol/ga4/user properties?hl=en\&client type=gtag https //developers google com/analytics/devguides/collection/protocol/ga4/user properties?hl=en\&client type=gtag setuserid สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถตั้งค่า userid สำหรับ google analytics เพื่อแยกแยะ ข้อมูลที่ตามมาจะถูกรวบรวมแยกต่างหากในส่วนผู้ใช้ของแดชบอร์ด google analytics https //support google com/analytics/answer/9213390 https //support google com/analytics/answer/9213390 ตามค่าเริ่มต้น ผู้ใช้แต่ละคนจะถูกเก็บรวบรวมโดยอัตโนมัติ โดยการแมพไปยังหน่วยเซสชัน (ga4) ในหน่วย userid ของ zepeto