ZEPETO Analytics

11min

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/﻿
หลังจากที่คุณสร้างบัญชี 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 คุณสามารถกรอกการตั้งค่าที่จำเป็นในการส่งสถิติได้
ZepetoAnalytics
﻿
﻿
กรุณาเลือก Google Analytics เป็นประเภทการวิเคราะห์และกรอก Api key และ Measurement id.
﻿
﻿
เมื่อคุณเล่นฉากที่มีส่วนประกอบ ZEPETO Analytics เพิ่มเข้ามา ค่าเวลาที่อยู่อาศัยรวมจะถูกสะสมโดยอัตโนมัติใน Google Analytics.
คุณสามารถดูค่าระยะเวลาในการมีส่วนร่วมจากเมนู Reports > Realtime overview. (รายการรายงานที่ไม่รวมแท็บ Realtime จะใช้เวลาสักครู่ในการสะท้อนผล.)
หากฉากถูกเปลี่ยนและส่วนประกอบถูกลบ สถิติจะไม่ถูกส่ง ดังนั้นหากคุณต้องการเก็บไว้ กรุณาประมวลผลเป็น Don't Destroy.
❗️ ระวัง
หากคุณตรวจสอบโหมดดีบักระหว่างการทดสอบในตัวแก้ไข ข้อมูลจะไม่ถูกส่งไปยังแดชบอร์ด
เมื่อคุณต้องการจัดเก็บข้อมูล ให้แน่ใจว่าโหมดดีบักถูกปิดอยู่.
﻿
﻿
การเพิ่มเหตุการณ์ที่กำหนดเอง
คุณสามารถจัดเรียงสถิติจากเหตุการณ์ที่กำหนดเองได้
ด้านล่างนี้คือตัวอย่างโค้ดที่ส่งเหตุการณ์ที่กำหนดเองไปยังแดชบอร์ด Google Analytics เมื่อคุณกดปุ่ม
TypeScript
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);
        });
    }
}
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﻿
เครื่องมือพัฒนา Google Analytics
﻿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

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

SetUserID
สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถตั้งค่า UserID สำหรับ Google Analytics เพื่อแยกแยะ ข้อมูลที่ตามมาจะถูกรวบรวมแยกต่างหากในส่วนผู้ใช้ของแดชบอร์ด Google Analytics
﻿https://support.google.com/analytics/answer/9213390

ตามค่าเริ่มต้น ผู้ใช้แต่ละคนจะถูกเก็บรวบรวมโดยอัตโนมัติ โดยการแมพไปยังหน่วยเซสชัน (GA4) ในหน่วย UserId ของ ZEPETO
﻿

ฟังก์ชัน	คำอธิบาย
LogEvent	ช่วยให้คุณส่งเหตุการณ์ที่กำหนดเองไปยังแดชบอร์ด Google Analytics ที่เชื่อมโยง รองรับพารามิเตอร์เดียว (สตริง, หมายเลข, บูลีน) และ Payload ทั่วไป สำหรับ Payload ในรูปแบบทั่วไป สามารถส่งเฉพาะฟอร์มที่ Google Analytics อนุญาตเท่านั้น 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
SetUserID	สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถตั้งค่า UserID สำหรับ Google Analytics เพื่อแยกแยะ ข้อมูลที่ตามมาจะถูกรวบรวมแยกต่างหากในส่วนผู้ใช้ของแดชบอร์ด Google Analytics https://support.google.com/analytics/answer/9213390 ตามค่าเริ่มต้น ผู้ใช้แต่ละคนจะถูกเก็บรวบรวมโดยอัตโนมัติ โดยการแมพไปยังหน่วยเซสชัน (GA4) ในหน่วย UserId ของ ZEPETO

อัปเดต 11 Oct 2024

หน้านี้ช่วยคุณได้หรือไม่?

สกุลเงินโลก

การสร้างแพ็คเกจด้วย CLI