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.
예시: 147https://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구매 상태 변경. 추가 필드:
  • currency - ISO 4217에 따른 3자리 통화 코드.
  • value - 명목상 구매 금액.
  • transaction_id - 엑솔라 시스템의 결제 ID.
  • coupon - 쿠폰 코드.
  • items - 아이템 매개변수.

콘텐츠 이벤트

이벤트설명
content_view콘텐츠의 75% 이상이 표시되었습니다. 그룹 상태의 콘텐츠는 이벤트가 전송되지 않습니다. 추가 필드:
  • content_name - 콘텐츠 ID.
  • content_name - 콘텐츠 이름.
  • content_type - 콘텐츠 유형.
  • banner_type - 배너 유형.
  • target_game_id - 퍼블리셔 계정의 ID 또는 게임의 Steam 앱 ID로부터 연결되는 링크의 대상.
  • content_link - 콘텐츠 유형이 링크 또는 동영상인 경우 URL 주소.
content_click사용자가 콘텐츠 요소를 클릭했습니다.

인증 이벤트

이벤트설명
login사용자가 런처에서 성공적으로 인증되었습니다. 추가 필드:
  • auth_type - 인증 옵션.
  • method - 인증에 사용되는 소셜 네트워크.

획득 방법

  1. Google 애널리틱스에 등록한 후 계정에 로그인합니다.
  2. 아래 표에 표시된 대로 Google 애널리틱스에서 사용자 정의 차원을 생성하고 편집합니다.
필드규격범위설명
analytics_target_game_idAnalytics Target Game IDEvent링크로 연결된 게임의 게시자 계정의 ID 혹은 Steam App ID.
auth_typeAuth TypeEventJWT에서 전달된 인증 옵션입니다. 가능한 값:
  • social - 소셜 로그인.
  • phone - 전화번호로 전송된 일회성 코드를 통한 암호 없는 로그인.
  • email - 이메일로 전송된 일회성 코드를 통한 암호 없는 로그인.
  • xsolla_login - 엑솔라 로그인 데이터 저장소를 사용하는 사용자 이름/이메일 및 암호를 통한 클래식 로그인.
  • firebase - Firebase 데이터 저장소를 사용하는 사용자 이름/이메일 및 암호를 통한 클래식 로그인.
  • playfab - Playfab 데이터 저장소를 사용하는 사용자 이름/이메일 및 암호를 통한 클래식 로그인.
  • proxy - 사용자 정의 데이터 저장소를 사용하는 사용자 이름/이메일 및 암호를 통한 클래식 로그인.
  • device - 장치 ID로 로그인.
  • server_custom_id — 사용자 정의 ID로 로그인(자체 서버에서 생성한 사용자 ID).
content_idContent IDEvent콘텐츠 타일 ID.
content_linkContent LinkEvent콘텐츠 유형이 링크 또는 동영상인 경우 URL 주소.
content_nameContent NameEvent콘텐츠 타일 이름(영어).
content_typeContent TypeEvent콘텐츠 유형. 가능한 값: news, link internal, link external, video.
distribution_platformDistribution PlatformEvent런처를 여는 데 사용된 플랫폼입니다.
가능한 값: Xsolla, Steam.
game_nameGame NameEvent게임 이름(영어).
game_platformGame PlatformEvent게임 플랫폼. 가능한 값: Xsolla, Steam.
build_numberLauncher Build NumberEvent빌드 번호.
예시: 런처 버전이 3.0.49-latest.1이면 빌드 번호는 1입니다.
launcher_project_idLauncher Project IDEvent게시자 계정의 런처 프로젝트 ID.
예시: 147https://publisher.xsolla.com/72209/projects/173640/new-launcher/147에 대한 프로젝트 ID
app_versionLauncher VersionEvent런처 코드 버전.
예시: 런처 버전이 3.0.49-latest.1인 경우 런처 코드 버전은 3.0.49-latest입니다.
login_project_idLogin Project IDEvent로그인 프로젝트 ID.
platform_game_idPlatform Game IDEvent플랫폼의 게임 ID. 플랫폼이 엑솔라인 경우 게시자 계정 프로젝트 ID가 전달됩니다.
publisher_account_game_idPublisher Account Game IDEvent콘텐츠와 관련된 게임의 관리자 페이지에서 가져온 ID. 콘텐츠가 게임과 관련이 없으면 이 필드는 비어 있습니다.
target_game_idTarget Game IDEvent링크로 연결된 게임의 게시자 계정의 ID 혹은 Steam App ID.
window_sizeWindow SizeEvent런처 창 크기.
예시: 800x600.
  1. 사이드 메뉴에서 관리자를 클릭합니다.
  2. Google 애널리틱스 4 속성을 생성합니다.
  3. 데이터 스트림을 추가합니다.
    1. 유형을 선택합니다.
    2. URL 필드에 URL 주소를 입력합니다.
  4. 데이터 스트림의 설정에서 측정 ID 필드 값을 복사합니다.
  5. 게시자 계정에서 프로젝트를 엽니다.
  6. 사이드 메뉴에서 런처를 클릭합니다.
  7. 대시보드에서 런처를 찾아 런처 편집을 클릭합니다.
  8. 설정 > 일반 정보 > 애널리틱스로 이동합니다.
  9. Google 애널리틱스 4 측정 ID 필드에 측정 ID를 붙여넣습니다.
  10. 변경 사항 저장을 클릭합니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2024년 1월 22일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!