ZEPETO 애널리틱스

12min

ZEPETO 분석은 통계 API를 쉽게 사용할 수 있게 해주는 패키지입니다.
현재 Google Analytics를 사용할 수 있습니다.
👍 Google Analytics v4 사양이 지원됩니다.
﻿
1단계 : 설치
Window → 패키지 관리자 → 먼저 ZEPETO.World 패키지 1.21.14 버전을 설치해 주세요.
그 후, ZEPETO Analytics 패키지를 설치하세요.
﻿
﻿
2단계 : Google Analytics 데이터 스트림 생성
📘 Google Analytics
https://analytics.google.com/﻿
Google Analytics 계정을 생성한 후, 월드에서 사용할 데이터 스트림을 생성해야 합니다. (초기 계정을 활성화하는 데 평균 1일이 소요됩니다.)
WorldId당 하나의 데이터 스트림을 생성하고 관리하는 것이 좋습니다.
ZEPETO Analytics는 httpService를 사용하여 데이터를 전송하므로, '웹' 플랫폼을 선택해야 합니다.
﻿
﻿
URL을 작성하는 곳에 WorldId를 적어주세요.
﻿
﻿
데이터 스트림 생성이 완료되면, 측정 ID를 확인할 수 있습니다.
﻿
﻿
API 키 값을 생성하려면, 측정 프로토콜 API 비밀 메뉴에 입력해야 합니다.
﻿
﻿
오른쪽의 생성 버튼을 누른 후, 닉네임 입력을 완료하여 비밀 값을 생성합니다.
﻿
﻿
다음 프로세스를 위해 측정 ID와 비밀 값 값을 복사하십시오.
﻿
3단계 : 사용 방법
계층 창에서 ZEPETO → Zepeto Analytics 탭을 클릭합니다.
﻿
﻿
Zepeto Analytics라는 객체가 자동으로 다음과 같이 생성됩니다:
ZepetoAnalyticsComponent는 씬 내에서 통계를 전송하는 책임이 있는 구성 요소입니다.
검사기 창에서 통계를 전송하는 데 필요한 설정을 입력할 수 있습니다.
ZepetoAnalytics
﻿
﻿
Google Analytics를 분석 유형으로 선택하고 API 키와 측정 ID를 입력하세요.
﻿
﻿
ZEPETO Analytics 구성 요소가 추가된 장면을 재생하면 누적 체류 시간 값이 Google Analytics에 자동으로 누적됩니다.
보고서 > 실시간 개요 메뉴에서 참여 시간 값을 확인할 수 있습니다. (실시간 탭을 제외한 보고서 항목은 반영되는 데 일정 시간이 걸립니다.)
장면이 변경되고 구성 요소가 삭제되면 통계가 전송되지 않습니다. 따라서 유지하려면 파괴하지 않도록 처리하세요.
❗️ 주의
편집기 테스트 중에 디버그 모드를 확인하면 데이터가 대시보드로 전송되지 않습니다.
데이터를 쌓고 싶을 때는 디버그 모드가 꺼져 있는지 확인하세요.
﻿
﻿
사용자 정의 이벤트 추가
사용자 정의 이벤트를 기반으로 통계를 쌓을 수 있습니다.
아래는 버튼을 클릭할 때 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는 전송하는 CustomEvent의 Payload Body를 검증합니다. (유효하지 않으면 전송되지 않음)
디버그 모드를 체크하면 콘솔 창에서 전송하는 Payload의 검증 결과를 쉽게 확인할 수 있습니다.
❗️ 주의
편집기 테스트 중에 디버그 모드를 체크하면 데이터가 대시보드로 전송되지 않습니다.
데이터를 쌓고 싶을 때는 디버그 모드가 꺼져 있는지 확인하세요.
﻿
﻿
Google 사양에 맞지 않는 사용자 정의 이벤트를 생성하면 디버그 모드에서 유효성 검사가 실패합니다.
﻿
﻿
Google 사양 및 디버그 모드에 대한 정보는 다음을 방문하십시오:
📘  Google 사양 및 디버그 모드에 대한 정보는 다음을 방문하십시오:
Google 사양 및 디버그 모드에 대한 정보는 다음을 방문하십시오:
﻿
구글 애널리틱스
﻿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/﻿
﻿
제페토베이스애널리틱스 API
기능
설명
LogEvent
연결된 Google Analytics 대시보드에 사용자 정의 이벤트를 보낼 수 있습니다.

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

일반 형식의 페이로드의 경우 Google Analytics에서 허용하는 형식만 전송할 수 있습니다.

﻿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

SetUserID
전송하는 이벤트에 대해 Google Analytics에서 구분할 수 있도록 UserID를 설정할 수 있습니다. 이후 데이터는 Google Analytics 대시보드의 사용자 섹션에서 별도로 수집됩니다.
﻿https://support.google.com/analytics/answer/9213390

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

기능	설명
LogEvent	연결된 Google Analytics 대시보드에 사용자 정의 이벤트를 보낼 수 있습니다. 단일 매개변수(문자열, 숫자, 불리언) 및 일반 페이로드를 지원합니다. 일반 형식의 페이로드의 경우 Google Analytics에서 허용하는 형식만 전송할 수 있습니다. 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
SetUserID	전송하는 이벤트에 대해 Google Analytics에서 구분할 수 있도록 UserID를 설정할 수 있습니다. 이후 데이터는 Google Analytics 대시보드의 사용자 섹션에서 별도로 수집됩니다. https://support.google.com/analytics/answer/9213390 기본적으로 각 사용자는 ZEPETO UserId 단위의 (GA4) 세션 단위에 매핑되어 자동으로 수집됩니다.

업데이트됨 11 Oct 2024

이 페이지가 도움이 되었습니까?

월드 통화

CLI로 패키지 빌드하기