Unity Analytics 원시 데이터 익스포트 가이드
Unity 애널리틱스 원시 데이터 익스포트는 이벤트 발생 데이터를 완전하게 접근 및 사용할 수 있게 해줍니다. 이를 통해 사용자들은 데이터를 매개해 커스텀 쿼리나 데이터 시각화를 생성할 수 있습니다. 이 문서에서는 원시 데이터 익스포트에 대한 기본 정보, REST API 사용법, 데이터 형식, 그리고 여러 활용 예제에 대해 설명합니다.
원시 데이터 익스포트 개요
원시 데이터 익스포트 기능을 사용하면 Unity 애널리틱스 대시보드 혹은 REST API를 통해 이벤트 데이터를 내보낼 수 있습니다. 다음 두 가지 방법으로 원시 데이터에 접근할 수 있습니다:
- Unity 애널리틱스 대시보드 사용자 인터페이스
- REST API 호출
원시 데이터 익스포트는 2016년 6월 이후의 데이터를 제공하며, 기본 파일 형식은 JSON입니다.
Unity 애널리틱스 대시보드 사용 방법
- Unity 애널리틱스 대시보드(analytics.cloud.unity3d.com)에 접속합니다.
- 프로젝트를 선택하고, "Analytics > Raw Data Export"로 이동합니다.
- "Export" 섹션에서 익스포트할 데이터 세트를 선택하고 필요한 날짜 범위를 설정합니다.
- 원하는 파일 형식을 선택한 후, 데이터 작업을 시작합니다.
REST API 사용법
REST API를 통해 원시 이벤트 데이터를 요청하기 위해 다음과 같은 요구사항이 있습니다:
- 모든 요청은 Unity 프로젝트 ID와 API 키를 사용한 HTTP 기본 인증이 필요합니다.
- 요청 기간은 최대 31일로 제한됩니다.
- 요청 시 생성된 원시 데이터 파일은 14일간 보관됩니다.
API 요청 예시
POST 요청을 통해 원시 데이터 익스포트를 생성할 수 있습니다.
- HTTP 메서드: POST
- URL:
https://analytics.cloud.unity3d.com/api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports - 요청 본문 예시:
{
"startDate": "2016-05-15",
"endDate": "2016-05-16",
"format": "tsv",
"dataset": "appStart"
}
응답 예시
응답은 JSON 포맷으로 제공되며, 주요 속성은 다음과 같습니다:
- id: 원시 데이터 익스포트 ID
- upid: Unity 프로젝트 ID
- status: 익스포트의 현재 상태
- duration: 데이터 익스포트에 소요된 시간
데이터 집합
Unity 애널리틱스에서 지원하는 데이터 집합 유형은 다음과 같습니다:
| 데이터 집합 | 설명 |
|---|---|
appStart |
앱 시작 이벤트 |
appRunning |
앱 실행 중 이벤트 |
custom |
사용자 정의 이벤트 |
deviceInfo |
기기 정보 이벤트 |
transaction |
거래 관련 이벤트 |
데이터 형식
원시 데이터 익스포트 시 JSON 또는 TSV 포맷으로 데이터를 내보낼 수 있습니다. 각 포맷은 다음과 같은 특징이 있습니다:
- JSON 포맷: 각 필드가 명시되며, 데이터가 없는 필드는 포함되지 않음.
- TSV 포맷: 헤더가 별도의 파일로 제공되며, 데이터 파일에는 헤더가 없음.
JSON 포맷 예시
{
"ts": 1616161616161,
"appid": "com.example.game",
"userid": "unique_user_id",
"sessionid": "session_id",
"platform": "iOS",
"submit_time": 1616161616161
}
TSV 포맷 예시
헤더 파일 내용:
ts appid type userid sessionid platform sdk_ver user_agent submit_time
밑에 데이터 파일은 헤더를 포함하지 않음.
활용 및 응용 예제
- 사용자 행동 분석: 앱의 사용 패턴을 분석하여 기능 개선 및 마케팅 전략을 수립할 수 있습니다.
- 실시간 데이터 피드: REST API를 사용해 실시간 분석 시스템을 구축하여 사용자 경험을 개선할 수 있습니다.
- 커스텀 대시보드: 원시 데이터를 가공하여 맞춤형 대시보드를 생성할 수 있습니다.
참고 사항
- 모든 날짜와 시간은 UTC 기준입니다.
- 파일은 .gzip 압축 형식으로 제공되므로, 다운로드 후 압축 해제한 뒤 사용할 수 있습니다.
- 사용자 속성이나 기타 데이터의 세부 사항은 Unity 문서 및 API 설명서를 참조하세요.
Unity Analytics 원시 데이터 익스포트를 통해 더 나은 데이터 기반 결정을 내릴 수 있습니다.