---
title: ZEPETO Analytics
slug: world-sdk-guide-th/zepeto-analytics
docTags: 
createdAt: 2024-09-02T08:34:13.137Z
---

ZEPETO Analytics เป็นแพ็คเกจที่ทำให้การใช้ API สถิติเป็นเรื่องง่าย

ขณะนี้ Google Analytics พร้อมใช้งานแล้ว

:::hint{type="success"}
**👍 **รองรับสเปค Google Analytics v4
:::



## ขั้นตอนที่ 1 : ติดตั้ง

Window → Package Manager → กรุณาติดตั้ง ZEPETO.World Package เวอร์ชัน 1.21.14 ก่อน

หลังจากนั้นให้ติดตั้งแพ็คเกจ ZEPETO Analytics

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Q9GHf4bWSzDtJKDscxofu-20240904-102420.png)



## ขั้นตอนที่ 2 : สร้างข้อมูลสตรีม Google Analytics

:::hint{type="info"}
**📘 Google Analytics**
[https://analytics.google.com/](https://analytics.google.com/)
:::

หลังจากที่คุณสร้างบัญชี Google Analytics ของคุณแล้ว คุณต้องสร้างข้อมูลสตรีมเพื่อใช้ใน World (โดยเฉลี่ยใช้เวลา 1 วันในการเปิดใช้งานบัญชีเริ่มต้น)

แนะนำให้คุณสร้างและจัดการข้อมูลสตรีมหนึ่งรายการต่อ WorldId

ZEPETO Analytics ส่งข้อมูลโดยใช้ httpService ดังนั้นโปรดตรวจสอบให้แน่ใจว่าได้เลือกแพลตฟอร์ม 'เว็บ'

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-F2EQU-9f5vCZhxAwHznsR-20240904-102420.png)



กรุณาเขียน WorldId ในที่ที่คุณเขียน URL

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Ix5U7B9awcHjgkfu76a_D-20240904-102420.png)



เมื่อการสร้างข้อมูลสตรีมเสร็จสมบูรณ์ คุณสามารถตรวจสอบ Measurement ID ได้

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-HR7au8peUWKhJ3l5NPHiX-20240904-102420.png)



ในการสร้างค่า API Key คุณต้องเข้าสู่เมนูความลับของ Measurement Protocol API

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-DFRX2sAW7sPZGErvm1ULC-20240904-102420.png)



หลังจากกดปุ่มสร้างที่ด้านขวา ให้กรอกชื่อเล่นเพื่อสร้างค่า Secret Value

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-y46tyxtPIp8_8ES5jLgG9-20240904-102420.png)



กรุณาคัดลอกค่า Measurement ID และค่า Secret Value สำหรับขั้นตอนถัดไป



## ขั้นตอนที่ 3 : วิธีการใช้งาน

ในหน้าต่าง Hierarchy ให้คลิกที่แท็บ ZEPETO → Zepeto Analytics

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-tBM2egUyLngJSmuyTTHv7-20240904-102420.png" size="48" width="377" height="635" position="center" showCaption="false"}



วัตถุที่เรียกว่า Zepeto Analytics จะถูกสร้างขึ้นโดยอัตโนมัติตามนี้:

ZepetoAnalyticsComponent เป็นส่วนประกอบที่รับผิดชอบในการส่งสถิติภายใน Scene

ในหน้าต่าง Inspector คุณสามารถกรอกการตั้งค่าที่จำเป็นในการส่งสถิติได้

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Z0YAAV8o55TQos-bzIBOL-20240904-102420.png "ZepetoAnalytics")



กรุณาเลือก Google Analytics เป็นประเภทการวิเคราะห์และกรอก Api key และ Measurement id.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-jn8yDfhxEWREew-1QZb7R-20240904-102420.png)



เมื่อคุณเล่นฉากที่มีส่วนประกอบ ZEPETO Analytics เพิ่มเข้ามา ค่าเวลาที่อยู่อาศัยรวมจะถูกสะสมโดยอัตโนมัติใน Google Analytics.

คุณสามารถดูค่าระยะเวลาในการมีส่วนร่วมจากเมนู Reports > Realtime overview. (รายการรายงานที่ไม่รวมแท็บ Realtime จะใช้เวลาสักครู่ในการสะท้อนผล.)

หากฉากถูกเปลี่ยนและส่วนประกอบถูกลบ สถิติจะไม่ถูกส่ง ดังนั้นหากคุณต้องการเก็บไว้ กรุณาประมวลผลเป็น Don't Destroy.

:::hint{type="danger"}
**❗️ ระวัง**
หากคุณตรวจสอบโหมดดีบักระหว่างการทดสอบในตัวแก้ไข ข้อมูลจะไม่ถูกส่งไปยังแดชบอร์ด
เมื่อคุณต้องการจัดเก็บข้อมูล ให้แน่ใจว่าโหมดดีบักถูกปิดอยู่.
:::

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-B2bWF3n-YNyz84yk8Bz-I-20240904-102420.png)



## การเพิ่มเหตุการณ์ที่กำหนดเอง

คุณสามารถจัดเรียงสถิติจากเหตุการณ์ที่กำหนดเองได้

ด้านล่างนี้คือตัวอย่างโค้ดที่ส่งเหตุการณ์ที่กำหนดเองไปยังแดชบอร์ด 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);
        });
    }
}
```



โปรดตรวจสอบให้แน่ใจว่าได้เชื่อมต่อส่วนประกอบ Zepeto Analytics หลังจากเขียนสคริปต์แล้ว

ภาพหน้าจอด้านล่างนี้เป็นตัวอย่างของส่วนประกอบที่กำหนดค่าเพื่อให้สคริปต์ตัวอย่างทำงานได้

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-F5ItqG8lwcMHFPcaLAPlI-20240904-102420.png)



จากเมนูรายงาน > ภาพรวมแบบเรียลไทม์ คุณสามารถเห็นค่าของเหตุการณ์ที่กำหนดเองถูกจัดเรียงในแบบเรียลไทม์.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-dDXNkX3iY7vN4Wf-X44O8-20240904-102420.png)



## เปิดโหมดดีบัก

Google Analytics จะตรวจสอบ Payload Body สำหรับ CustomEvent ที่คุณส่ง (ถ้าไม่ถูกต้อง จะไม่ถูกส่ง)

การตรวจสอบโหมดดีบักทำให้เห็นผลการตรวจสอบสำหรับ Payload ที่คุณส่งในหน้าต่างคอนโซลได้ง่ายขึ้น.

:::hint{type="danger"}
**❗️ ระวัง**
หากคุณตรวจสอบโหมดดีบักระหว่างการทดสอบในตัวแก้ไข ข้อมูลจะไม่ถูกส่งไปยังแดชบอร์ด
เมื่อคุณต้องการจัดเรียงข้อมูล ให้แน่ใจว่าโหมดดีบักถูกปิด.
:::

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-B1SjD1bWdnGI_RxBbIzeo-20240904-102420.png)



หากคุณสร้างเหตุการณ์ที่กำหนดเองซึ่งไม่ตรงตามข้อกำหนดของ Google การตรวจสอบจะล้มเหลวในโหมดดีบัก.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-xQ1Kz3JElk3T6GlluaE4o-20240904-102420.png)



สำหรับข้อมูลเกี่ยวกับข้อกำหนดของ Google และโหมดดีบัก โปรดเยี่ยมชม:

:::hint{type="info"}
📘  **สำหรับข้อมูลเกี่ยวกับข้อกำหนดของ 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 ที่เชื่อมโยง<br /><br />รองรับพารามิเตอร์เดียว (สตริง, หมายเลข, บูลีน) และ Payload ทั่วไป<br /><br />สำหรับ Payload ในรูปแบบทั่วไป สามารถส่งเฉพาะฟอร์มที่ Google Analytics อนุญาตเท่านั้น<br /><br />[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)<br /> |
| SetAnalyticsCollectionEnabled | เปิด/ปิดฟังก์ชันการส่งเหตุการณ์ของ ZEPETO Analytics Component สามารถใช้สำหรับการควบคุมแบบไดนามิก<br /><br />ตามค่าเริ่มต้น Analytics Component จะเป็น True เมื่อเปิดใช้งาน และ False เมื่อปิดใช้งาน<br /><br />(เวลาที่อยู่อาศัยพื้นฐานจะถูกบันทึกโดยอัตโนมัติจากเวลาที่เปิดใช้งาน ZEPETO Analytics Component)                                                                                                                                                                                           |
| SendDuration                  | สำหรับชื่อเหตุการณ์เฉพาะ คุณสามารถส่งเวลาที่อยู่อาศัยในมิลลิวินาที (ms)<br /><br />สามารถใช้เพื่อบันทึก Engagement Time สำหรับเหตุการณ์เฉพาะด้วยตนเอง (แยกจากเวลาที่อยู่อาศัยที่วัดโดยอัตโนมัติ)<br /><br />เช่น) ใช้เพื่อบันทึกด้วยตนเองว่า 'ฉันอยู่ในพื้นที่เฉพาะเป็นเวลา 3 วินาที (3000 ms)'                                                                                                                                                                                                          |
| SetUserProperty               | สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถเพิ่มคุณสมบัติผู้ใช้ที่กำหนดเองได้<br />[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)<br />                                                                                                                                                                             |
| SetUserID                     | สำหรับเหตุการณ์ที่คุณกำลังส่ง คุณสามารถตั้งค่า UserID สำหรับ Google Analytics เพื่อแยกแยะ ข้อมูลที่ตามมาจะถูกรวบรวมแยกต่างหากในส่วนผู้ใช้ของแดชบอร์ด Google Analytics<br />[https://support.google.com/analytics/answer/9213390](https://support.google.com/analytics/answer/9213390)<br /><br />**ตามค่าเริ่มต้น ผู้ใช้แต่ละคนจะถูกเก็บรวบรวมโดยอัตโนมัติ โดยการแมพไปยังหน่วยเซสชัน (GA4) ในหน่วย UserId ของ ZEPETO**                                                                                   |