Google 애널리틱스4로 데이터를 전송하는 방법
작동 방식
Google 애널리틱스 4로부터 사용자 활동 및 런처 작업에 관한 데이터를 이벤트로 수신하면 아래 표에 나열된 페이로드로 데이터가 전송됩니다.
| 규격 | 설명 |
|---|---|
| Distrubution platform | 런처를 여는 데 사용된 플랫폼입니다. 가능한 값: Xsolla, Steam. |
| Language | 런처 언어. |
| Page title | 런처 화면. 가능한 값: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen. |
| Platform game ID | 플랫폼의 게임 ID. 플랫폼이 엑솔라인 경우 게시자 계정 프로젝트 ID가 전달됩니다. |
| Stream name | 런처 이름. |
| Launcher project ID | 게시자 계정의 런처 프로젝트 ID. 예시: 147은 https://publisher.xsolla.com/72209/projects/173640/new-launcher/147에 대한 프로젝트 ID |
| Login project ID | 로그인 프로젝트 ID. |
| App version | 런처 버전. |
| Build number | 빌드 번호. 예시: 런처 버전이 3.0.49-latest.1이면 빌드 번호는 1입니다. |
| Window size | 런처 창 크기. 예시: 800x600. |
| Screen resolution | 화면 해상도. |
| Operating system, Operating system with version, OS version. | 사용자의 운영 체제를 감지하기 위한 사용자 에이전트. |
| Publisher Account game ID | 콘텐츠와 관련된 게임의 관리자 페이지에서 가져온 ID. 콘텐츠가 게임과 관련이 없으면 이 필드는 비어 있습니다. |
| City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent ID | 지리 데이터. |
일반 이벤트
| 이벤트 | 설명 |
|---|---|
| launcher_start | 런처 시작. 업데이트 후에 런처가 시작되면 이 항목은 전송되지 않습니다. |
| close_app | 런처 종료. 업데이트 전에 런처가 종료되면 이 항목은 전송되지 않습니다. |
UI 이벤트
| 이벤트 | 설명 |
|---|---|
| page_view | 런처 화면을 연 사용자. |
| logout | 사용자가 로그아웃을 클릭했습니다. |
런처 업데이트 이벤트
| 이벤트 | 설명 |
|---|---|
| launcher_update_check_start | 런처가 업데이트 확인을 시작합니다. |
| launcher_update_check_complete | 런처가 업데이트 확인을 완료했습니다. CDN에서 최신 버전이 발견되면 추가 value 필드에 update_found 값이 표시됩니다. 그렇지 않은 경우에는 값이 no_updates입니다. |
| launcher_update_check_skip | 사용자가 런처 업데이트를 건너뛰었습니다. |
| launcher_update_download_start | 런처가 업데이트 다운로드를 시작했습니다. |
| launcher_update_download_complete | 런처가 업데이트 다운로드를 완료했습니다. |
| launcher_update_start | 런처가 업데이트를 완료했습니다. |
| launcher_update_complete | 런처가 성공적으로 업데이트되었습니다. |
게임 소유권 이벤트
| 이벤트 | 설명 |
|---|---|
| purchase | 구매 상태 변경. 추가 필드: |
콘텐츠 이벤트
| 이벤트 | 설명 |
|---|---|
| content_view | 콘텐츠의 75% 이상이 표시되었습니다. 그룹 상태의 콘텐츠는 이벤트가 전송되지 않습니다. 추가 필드:
|
| content_click | 사용자가 콘텐츠 요소를 클릭했습니다. |
인증 이벤트
| 이벤트 | 설명 |
|---|---|
| login | 사용자가 런처에서 성공적으로 인증되었습니다. 추가 필드:
|
획득 방법
- Google 애널리틱스에 등록한 후 계정에 로그인합니다.
- 아래 표에 표시된 대로 Google 애널리틱스에서 사용자 정의 차원을 생성하고 편집합니다.
| 필드 | 규격 | 범위 | 설명 |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | 링크로 연결된 게임의 게시자 계정의 ID 혹은 Steam App ID. |
| auth_type | Auth Type | Event | JWT에서 전달된 인증 옵션입니다. 가능한 값:
|
| content_id | Content ID | Event | 콘텐츠 타일 ID. |
| content_link | Content Link | Event | 콘텐츠 유형이 링크 또는 동영상인 경우 URL 주소. |
| content_name | Content Name | Event | 콘텐츠 타일 이름(영어). |
| content_type | Content Type | Event | 콘텐츠 유형. 가능한 값: news, link internal, link external, video. |
| distribution_platform | Distribution Platform | Event | 런처를 여는 데 사용된 플랫폼입니다. 가능한 값: Xsolla, Steam. |
| game_name | Game Name | Event | 게임 이름(영어). |
| game_platform | Game Platform | Event | 게임 플랫폼. 가능한 값: Xsolla, Steam. |
| build_number | Launcher Build Number | Event | 빌드 번호. 예시: 런처 버전이 3.0.49-latest.1이면 빌드 번호는 1입니다. |
| launcher_project_id | Launcher Project ID | Event | 게시자 계정의 런처 프로젝트 ID. 예시: 147은 https://publisher.xsolla.com/72209/projects/173640/new-launcher/147에 대한 프로젝트 ID |
| app_version | Launcher Version | Event | 런처 코드 버전. 예시: 런처 버전이 3.0.49-latest.1인 경우 런처 코드 버전은 3.0.49-latest입니다. |
| login_project_id | Login Project ID | Event | 로그인 프로젝트 ID. |
| platform_game_id | Platform Game ID | Event | 플랫폼의 게임 ID. 플랫폼이 엑솔라인 경우 게시자 계정 프로젝트 ID가 전달됩니다. |
| publisher_account_game_id | Publisher Account Game ID | Event | 콘텐츠와 관련된 게임의 관리자 페이지에서 가져온 ID. 콘텐츠가 게임과 관련이 없으면 이 필드는 비어 있습니다. |
| target_game_id | Target Game ID | Event | 링크로 연결된 게임의 게시자 계정의 ID 혹은 Steam App ID. |
| window_size | Window Size | Event | 런처 창 크기. 예시: 800x600. |
- 사이드 메뉴에서 관리자를 클릭합니다.
- Google 애널리틱스 4 속성을 생성합니다.
- 데이터 스트림을 추가합니다.
- 웹 유형을 선택합니다.
- URL 필드에 URL 주소를 입력합니다.
- 데이터 스트림의 설정에서 측정 ID 필드 값을 복사합니다.
- 게시자 계정에서 프로젝트를 엽니다.
- 사이드 메뉴에서 런처를 클릭합니다.
- 대시보드에서 런처를 찾아 런처 편집을 클릭합니다.
- 설정 > 일반 정보 > 애널리틱스로 이동합니다.
- Google 애널리틱스 4 측정 ID 필드에 측정 ID를 붙여넣습니다.
- 변경 사항 저장을 클릭합니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
