--- title: ZEPETO 애널리틱스 slug: world-sdk-guide-kr/syV--zepeto docTags: createdAt: 2024-09-02T08:34:13.137Z --- ZEPETO 분석은 통계 API를 쉽게 사용할 수 있게 해주는 패키지입니다. 현재 Google Analytics를 사용할 수 있습니다. :::hint{type="success"} **👍 **Google Analytics v4 사양이 지원됩니다. ::: ## 1단계 : 설치 Window → 패키지 관리자 → 먼저 ZEPETO.World 패키지 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 계정을 생성한 후, 월드에서 사용할 데이터 스트림을 생성해야 합니다. (초기 계정을 활성화하는 데 평균 1일이 소요됩니다.) WorldId당 하나의 데이터 스트림을 생성하고 관리하는 것이 좋습니다. ZEPETO Analytics는 httpService를 사용하여 데이터를 전송하므로, '웹' 플랫폼을 선택해야 합니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-F2EQU-9f5vCZhxAwHznsR-20240904-102420.png) URL을 작성하는 곳에 WorldId를 적어주세요. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Ix5U7B9awcHjgkfu76a_D-20240904-102420.png) 데이터 스트림 생성이 완료되면, 측정 ID를 확인할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-HR7au8peUWKhJ3l5NPHiX-20240904-102420.png) API 키 값을 생성하려면, 측정 프로토콜 API 비밀 메뉴에 입력해야 합니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-DFRX2sAW7sPZGErvm1ULC-20240904-102420.png) 오른쪽의 생성 버튼을 누른 후, 닉네임 입력을 완료하여 비밀 값을 생성합니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-y46tyxtPIp8_8ES5jLgG9-20240904-102420.png) 다음 프로세스를 위해 측정 ID와 비밀 값 값을 복사하십시오. ## 3단계 : 사용 방법 계층 창에서 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는 씬 내에서 통계를 전송하는 책임이 있는 구성 요소입니다. 검사기 창에서 통계를 전송하는 데 필요한 설정을 입력할 수 있습니다. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Z0YAAV8o55TQos-bzIBOL-20240904-102420.png "ZepetoAnalytics") Google Analytics를 분석 유형으로 선택하고 API 키와 측정 ID를 입력하세요. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-jn8yDfhxEWREew-1QZb7R-20240904-102420.png) ZEPETO Analytics 구성 요소가 추가된 장면을 재생하면 누적 체류 시간 값이 Google Analytics에 자동으로 누적됩니다. 보고서 > 실시간 개요 메뉴에서 참여 시간 값을 확인할 수 있습니다. (실시간 탭을 제외한 보고서 항목은 반영되는 데 일정 시간이 걸립니다.) 장면이 변경되고 구성 요소가 삭제되면 통계가 전송되지 않습니다. 따라서 유지하려면 파괴하지 않도록 처리하세요. :::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("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는 전송하는 CustomEvent의 Payload Body를 검증합니다. (유효하지 않으면 전송되지 않음) 디버그 모드를 체크하면 콘솔 창에서 전송하는 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 사양 및 디버그 모드에 대한 정보는 다음을 방문하십시오:** - - 구글 애널리틱스 - [https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?hl=en\&client\_type=gtag](https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?hl=en\&client_type=gtag) - 구글 애널리틱스 개발 도구 - [https://ga-dev-tools.web.app/ga4/event-builder/](https://ga-dev-tools.web.app/ga4/event-builder/) ::: ## 제페토베이스애널리틱스 API | **기능** | **설명** | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | LogEvent | 연결된 Google Analytics 대시보드에 사용자 정의 이벤트를 보낼 수 있습니다.

단일 매개변수(문자열, 숫자, 불리언) 및 일반 페이로드를 지원합니다.

일반 형식의 페이로드의 경우 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 구성 요소의 이벤트 전송 기능을 활성화/비활성화합니다. 동적 제어에 사용할 수 있습니다.

기본적으로 Analytics 구성 요소는 활성화되면 True가 되고 비활성화되면 False가 됩니다.

(기본 체류 시간은 ZEPETO Analytics 구성 요소가 활성화된 시점부터 자동으로 기록됩니다.) | | SendDuration | 특정 이벤트 이름에 대해 밀리초(ms) 단위의 체류 시간을 전송할 수 있습니다.

특정 이벤트에 대한 참여 시간을 수동으로 기록하는 데 사용할 수 있습니다. (자동으로 측정된 체류 시간과는 독립적입니다.)

예) '특정 지역에 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 | 전송하는 이벤트에 대해 Google Analytics에서 구분할 수 있도록 UserID를 설정할 수 있습니다. 이후 데이터는 Google Analytics 대시보드의 사용자 섹션에서 별도로 수집됩니다.
[https://support.google.com/analytics/answer/9213390](https://support.google.com/analytics/answer/9213390)

**기본적으로 각 사용자는 ZEPETO UserId 단위의 (GA4) 세션 단위에 매핑되어 자동으로 수집됩니다.** |